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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
Network registration hierarchy
==============================
Service org.ofono
Interface org.ofono.NetworkRegistration
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Returns all network registration properties. See the
properties section for available properties.
Possible Errors: [service].Error.InvalidArguments
void SetProperty(string name, variant value)
Changes the value of the specified property. Only
properties that are listed as read-write are
changeable. On success a PropertyChanged signal
will be emitted.
Possible Errors: [service].Error.InvalidArguments
[service].Error.DoesNotExist
void Register()
Attempts to register to the default network. The
default network is normally selected by the settings
from the SIM card.
Possible Errors: [service].Error.InvalidArguments
void Deregister()
Completely unregisters from the network
Possible Errors: [service].Error.InvalidArguments
Signals PropertyChanged(string property, variant value)
This signal indicates a changed value of the given
property.
Properties string Mode [readwrite]
The current registration mode. The deault of this
is "auto", but can be changed during operation. This
property will change to "manual" if the Register()
method of an operator is called.
The possible values are:
"auto" Network registration is performed
automatically.
"manual" Network operator is selected
manually. If the operator is
currently not selected, registration
is notattempted
"off" Unregisters from currently selected
network, if any, and does not
attempt to register again.
string Status [readonly]
The current 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.
TODO: Agent based location signalling would be better.
uint32 CellId [readonly, optional]
Contains the current network cell id.
TODO: Agent based location signalling would be better.
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"
TODO: Values for CDMA and EVDO based networks.
string Name [readonly]
Contains the current operator name, suitable for
display on the idle screen or an empty string if
not registered to a network.
This value is idential to the Name property from
the network operator object. It is provided here
for simplicity of application that don't allow
manual registration.
byte Strength [readonly, optional]
Contains the current signal strength as a percentage
between 0-100 percent.
string BaseStation [readonly, optional]
If the Cell Broadcast service is available and
properly configured, this attribute will contain the
name of the current service cell. This is typically a
descriptive name of the local area, e.g. name of the
suburb. If no name is provided or becomes
unavailable, this property will not be returned by
GetProperties or will be set to an empty string.
array{object} Operators [readonly]
List of all operator object paths known to the
telephony stack. The scanning for new operators is
done in the background.
The list of operators is only useful when attempting
manual registration. The automatic registration is
the preferred method.
Network operator hierarchy
==========================
Service org.ofono
Interface org.ofono.NetworkOperator
Object path [variable prefix]/{modem0,modem1,...}/{operator0,operator1,...}
Methods dict GetProperties()
Returns all network operator properties. See the
properties section for available properties.
Possible Errors: [service].Error.InvalidArguments
void Register()
Attempts to register to this network operator.
The method will return immediately, the result should
be observed by tracking the NetworkRegistration Status
property.
Possible Errors: [service].Error.InvalidArguments
Signals PropertyChanged(string property, variant value)
This signal indicates a changed value of the given
property.
Properties string Name [readonly]
Contains the name of the operator
string Status [readonly]
Contains the status of the operator.
The possible values are: "unknown", "available",
"current" and "forbidden"
uint16 MobileCountryCode [readonly, optional]
Contains the Mobile Country Code (MCC).
uint16 MobileNetworkCode [readonly, optional]
Contains the Mobile Network Code (MNC)
string Technology [readonly, optional]
Contains the technology of the network provider.
The possible values are: "GSM", "GSMCompact", "UTRAN",
"GSM+EGPS", "UTRAN+HSDPA",
"UTRAN+HSUPA",
"UTRAN+HSDPA+HSUPA"
|
