summaryrefslogtreecommitdiffstats
path: root/doc/dataconnectionmanager-api.txt
blob: b8cc9c3efe9d23505493b25dab940724fc020ea5 (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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
Data Connection Manager hierarchy
=================

Service		org.ofono
Interface	org.ofono.DataConnectionManager
Object path	[variable]

Methods		dict GetProperties()

			Returns all global system properties. See the
			properties section for available properties.

			Possible Errors: [service].Error.InvalidArguments

		void SetProperty(string property, variant value)

			Sets the property to a desired value

			Possible Errors: [service].Error.InvalidArguments
					 [service].Error.InvalidFormat
					 [service].Error.Failed

		void DeactivateAll()

			Deactivates all active contexts.

		object CreateContext()

			Creates a new Primary context.  Returns the object
			path of the created context.

		void RemoveContext(object context)

			Removes a primary context.  All secondary contexts, if
			any, associated with the primary context are also
			removed.

Signals		PropertyChanged(string property, variant value)

			This signal indicates a changed value of the given
			property.

Properties	array{object} PrimaryContexts [readonly]

			List of all primary contexts objects.

		boolean Attached [readonly]

			Contains whether the Packet Radio Service is attached.
			The attach state might change dynamically based on
			availability of network resources.  If this value
			changes to false, the user can assume that all
			contexts have been deactivated.

			If the modem is detached, certain features will not
			be available, e.g. receiving SMS over packet radio
			or network initiated PDP activation.

		boolean RoamingAllowed [readwrite]

			Contains whether data roaming is allowed.  In the off
			setting, if the packet radio registration state
			indicates that the modem is roaming, oFono will
			automatically detach and no further connection
			establishment will be possible.

		boolean Powered [readwrite]

			Controls whether packet radio use is allowed. Setting
			this value to off detaches the modem from the
			Packet Domain network.

		string Status [readonly]

			The current packet radio registration status of a modem.

			The possible values are:
				"unregistered"  Not registered to any network
				"registered"    Registered to home network
				"searching"     Not registered, but searching
				"denied"        Registration has been denied
				"unknown"       Status is unknown
				"roaming"       Registered, but roaming

		uint16 LocationAreaCode [readonly, optional]

			Contains the current location area code.

		uint32 CellId [readonly, optional]

			Contains the current network cell id.

		string Technology [readonly, optional]

			Contains the technology of the current network.

			The possible values are: "GSM", "GSMCompact", "UTRAN",
						 "GSM+EGPS", "UTRAN+HSDPA",
						 "UTRAN+HSUPA",
						 "UTRAN+HSDPA+HSUPA",
						 "E-UTRAN"

Primary Data Context hierarchy
=================

Service		org.ofono
Interface	org.ofono.PrimaryDataContext
Object path	[variable]

Methods		dict GetProperties()
			Returns all properties for the context object.

			Possible Errors: [service].Error.InvalidArguments

		void SetProperty(string property, variant value)

			Sets the property to a desired value

			Possible Errors: [service].Error.InvalidArguments
					 [service].Error.InvalidFormat
					 [service].Error.Failed

Signals		PropertyChanged(string property, variant value)

			This signal indicates a changed value of the given
			property.

Properties	boolean Activated [readwrite]

			Holds whether the context is activated.  This value
			can be set to activate / deactivate the context.

		string AccessPointName [readwrite]

			Holds the name of the access point.  This is
			abbreviated as APN.  This value cannot be changed when
			the context is active.

		string Username [readwrite]

			Holds the username to be used for authentication
			purposes.  This value cannot be changed when the
			context is active.

		string Password [readwrite]

			Holds the password to be used for authentication
			purposes.  This value cannot be changed when the
			context is active.

		string Interface [readonly, optional]

			Holds the interface of the network interface created
			by this context (e.g. "ppp0")

		array{string} DomainNameServers [readonly, optional]

			Holds the list of domain name servers for this
			context.

		string Gateway [readonly, optional]

			Holds the gateway IP for this connection.