From: Daniel Wagner <daniel.wagner@bmw-carit.de>
Date: Tue, 22 Nov 2011 12:54:58 +0000 (+0100)
Subject: ofono: Add documentation
X-Git-Tag: 0.79~306
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=538cc3d1b3c63180f5fc3020a9006b617512d0af;p=platform%2Fupstream%2Fconnman.git

ofono: Add documentation
---

diff --git a/plugins/ofono.c b/plugins/ofono.c
index 6ac4f2e..2c31b52 100644
--- a/plugins/ofono.c
+++ b/plugins/ofono.c
@@ -69,6 +69,21 @@ enum ofono_api {
 	OFONO_API_CM =		0x4,
 };
 
+/*
+ * The way this plugin works is following:
+ *
+ *   powered -> SubscriberIdentity or Online = True -> gprs, context ->
+ *     attached -> netreg -> ready
+ *
+ * Enabling and disabling modems are steered through the rfkill
+ * interface. That means when ConnMan toggles the rfkill bit oFono
+ * will add or remove the modems.
+ *
+ * ConnMan will always power up (set Powered and Online) the
+ * modems. No need to power them down because this will be done
+ * through the rfkill inteface.
+ */
+
 static DBusConnection *connection;
 
 static GHashTable *modem_hash;