Evolve the netreg driver

1 files changed, 112 insertions, 0 deletions

diff --git a/include/netreg.h b/include/netreg.h
new file mode 100644
index 00000000..d5247517
--- /dev/null
+++ b/include/netreg.h
@@ -0,0 +1,112 @@
+/*
+ *
+ *  oFono - Open Source Telephony
+ *
+ *  Copyright (C) 2008-2009  Intel Corporation. All rights reserved.
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ */
+
+#ifndef __OFONO_NETREG_H
+#define __OFONO_NETREG_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <ofono/types.h>
+
+struct ofono_netreg;
+
+/* Theoretical limit is 16, but each GSM char can be encoded into
+ *  * 3 UTF8 characters resulting in 16*3=48 chars
+ *   */
+#define OFONO_MAX_OPERATOR_NAME_LENGTH 63
+
+struct ofono_network_operator {
+	char name[OFONO_MAX_OPERATOR_NAME_LENGTH + 1];
+	char mcc[OFONO_MAX_MCC_LENGTH + 1];
+	char mnc[OFONO_MAX_MNC_LENGTH + 1];
+	int status;
+	int tech;
+};
+
+typedef void (*ofono_netreg_operator_cb_t)(const struct ofono_error *error,
+					const struct ofono_network_operator *op,
+					void *data);
+
+typedef void (*ofono_netreg_register_cb_t)(const struct ofono_error *error,
+					void *data);
+
+typedef void (*ofono_netreg_operator_list_cb_t)(const struct ofono_error *error,
+					int total,
+					const struct ofono_network_operator *list,
+					void *data);
+
+typedef void (*ofono_netreg_status_cb_t)(const struct ofono_error *error,
+					int status, int lac, int ci, int tech,
+					void *data);
+
+typedef void (*ofono_netreg_strength_cb_t)(const struct ofono_error *error,
+					int strength, void *data);
+
+/* Network related functions, including registration status, operator selection
+ * and signal strength indicators.
+ *
+ * It is up to the plugin to implement CSQ polling if the modem does not support
+ * vendor extensions for signal strength notification.
+ */
+struct ofono_netreg_driver {
+	const char *name;
+	int (*probe)(struct ofono_netreg *netreg);
+	int (*remove)(struct ofono_netreg *netreg);
+	void (*registration_status)(struct ofono_netreg *netreg,
+			ofono_netreg_status_cb_t cb, void *data);
+	void (*current_operator)(struct ofono_netreg *netreg,
+			ofono_netreg_operator_cb_t cb, void *data);
+	void (*list_operators)(struct ofono_netreg *netreg,
+			ofono_netreg_operator_list_cb_t cb, void *data);
+	void (*register_auto)(struct ofono_netreg *netreg,
+			ofono_netreg_register_cb_t cb, void *data);
+	void (*register_manual)(struct ofono_netreg *netreg,
+			const struct ofono_network_operator *oper,
+			ofono_netreg_register_cb_t cb, void *data);
+	void (*deregister)(struct ofono_netreg *netreg,
+			ofono_netreg_register_cb_t cb, void *data);
+	void (*strength)(struct ofono_netreg *netreg,
+			ofono_netreg_strength_cb_t, void *data);
+};
+
+void ofono_netreg_strength_notify(struct ofono_netreg *netreg, int strength);
+void ofono_netreg_status_notify(struct ofono_netreg *netreg, int status,
+					int lac, int ci, int tech);
+
+int ofono_netreg_driver_register(const struct ofono_netreg_driver *d);
+void ofono_netreg_driver_unregister(const struct ofono_netreg_driver *d);
+
+struct ofono_netreg *ofono_netreg_create(struct ofono_modem *modem,
+					const char *driver, void *data);
+
+void ofono_netreg_register(struct ofono_netreg *netreg);
+void ofono_netreg_remove(struct ofono_netreg *netreg);
+
+void ofono_netreg_set_data(struct ofono_netreg *netreg, void *data);
+void *ofono_netreg_get_data(struct ofono_netreg *netreg);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __OFONO_SSN_H */