From 538cc3d1b3c63180f5fc3020a9006b617512d0af Mon Sep 17 00:00:00 2001
From: Daniel Wagner <daniel.wagner@bmw-carit.de>
Date: Tue, 22 Nov 2011 13:54:58 +0100
Subject: [PATCH] ofono: Add documentation

---
 plugins/ofono.c | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

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;
-- 
2.7.4