summaryrefslogtreecommitdiffstats
path: root/doc/cdma-messagemanager-api.txt
blob: 8e6b9ea06c1e301ab57963c57063da89d26d0395 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
CDMA Message Manager hierarchy [experimental]
==============================

Service		org.ofono
Interface	org.ofono.cdma.MessageManager
Object path	[variable prefix]/{modem0,modem1,...}

Methods		dict GetProperties()

			Returns properties for the manager object. See
			the properties section for available properties.

			Possible Errors: [service].Error.InvalidArguments

		array{object,dict} GetMessages()

			Get an array of message object paths and properties
			that represents the currently pending messages.

			This method call should only be used once when an
			application starts up.  Further message additions
			and removal shall be monitored via MessageAdded and
			MessageRemoved signals.

		void SetProperty(string name, variant value)

			Changes the value of the specified property. Only
			properties that are listed as readwrite are
			changeable. On success a PropertyChanged signal
			will be emitted.

			Possible Errors: [service].Error.InvalidArguments
					 [service].Error.DoesNotExist

		object SendMessage(dict message_info)

			The dictionary can contain the following keys:

			string "To" - Address of the receiver

			string "Text" - The text to send

			string "Priority" - The value can be one of:
				"normal",
				"interactive",
				"urgent",
				"emergency",

			TODO: Figure out where this is really needed

			string "Privacy" - The value can be one of:
				"not restricted",
				"restricted",
				"confidential",
				"secret"

			TODO: Figure out where this is really needed

			If the message could be queued successfully, this
			method returns an object path to the created Message
			object.

Signals		PropertyChanged(string name, variant value)

			This signal indicates a changed value of the given
			property.

		ImmediateMessage(string message, dict info)

			New immediate SMS received. Info has Sender,
			LocalSentTime, SentTime, Priority, Privacy and
			CallbackNumber information.  Sender address is given
			in string format.  LocalSentTime and SentTime are
			given in string form using ISO8601 format.

		IncomingMessage(string message, dict info)

			New incoming text SMS received. Info has Sender,
			LocalSentTime, SentTime, Priority, Privacy, and
			CallbackNumber.

		MessageAdded(object path, dict properties)

			This signal is emitted whenever a new Message object
			has been created.

		MessageRemoved(object path)

			This signal is emitted whenever a Message object
			has been removed, e.g. when it reaches a final state.

Properties	boolean UseDeliveryAcknowledgement

			Request to be notified when the SMSC has delivered
			the message to the receiving user.  In effect this
			is the same as the GSM Status Report.

		boolean UseUserAcknowledgement

			Request to be notified when the receiving user has
			acknowledged the message.

		boolean UseReadAcknowledgement

			Request to be notified when the receiving User has
			read the message.

		string CallbackNumber

			The call back number for the user.  If the number is
			empty, then the optional field is not included
			in the encoded PDU.