From 0b97a240f74e67a1cf4c8ff2592621815ec559a0 Mon Sep 17 00:00:00 2001 From: Denis Kenzior Date: Tue, 28 Sep 2010 19:22:34 -0500 Subject: doc: Add PushNotification & PushNotificationAgent --- doc/pushnotification-api.txt | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 doc/pushnotification-api.txt (limited to 'doc/pushnotification-api.txt') diff --git a/doc/pushnotification-api.txt b/doc/pushnotification-api.txt new file mode 100644 index 00000000..62d6b723 --- /dev/null +++ b/doc/pushnotification-api.txt @@ -0,0 +1,37 @@ +Push Notification hierarchy +=============== + +Service org.ofono +Interface org.ofono.PushNotification +Object path [variable prefix]/{modem0,modem1,...} + +Methods void RegisterAgent(object path) + + Registers an agent which will be called whenever a + new Smart Messaging based SMS arrives. + + void UnregisterAgent(object path) + + Unregisters an agent. + +PushNotificationAgent Hierarchy [experimental] +=============== + +Service unique name +Interface org.ofono.PushNotificationAgent +Object path freely definable + +Methods void ReceiveNotification(array{byte} appointment, dict info) + + Requests the agent to process a new SMS that has + arrived containing a WAP PUSH. The dictionary + info contains 'Sender', 'LocalSentTime' and + 'SentTime' properties. + + Possible Errors: None + + void Release() + + Agent is being released, possibly because of oFono + terminating, SMS interface is being torn down or modem + off. No UnregisterAgent call is needed. -- cgit v1.2.3