4 Service org.moblin.connman
5 Interface org.moblin.connman.Service
6 Object path [variable prefix]/{service0,service1,...}
8 Methods dict GetProperties()
10 Returns properties for the service object. See
11 the properties section for available properties.
13 Possible Errors: [service].Error.InvalidArguments
15 void SetProperty(string name, variant value)
17 Changes the value of the specified property. Only
18 properties that are listed as read-write are
19 changeable. On success a PropertyChanged signal
22 Possible Errors: [service].Error.InvalidArguments
23 [service].Error.InvalidProperty
25 void ClearProperty(string name)
27 Clears the value of the specified property.
29 Possible Errors: [service].Error.InvalidArguments
30 [service].Error.InvalidProperty
34 Connect this service. It will attempt to connect
35 WiFi, WiMAX or Bluetooth services.
37 For Ethernet devices this method can only be used
38 if it has previously been disconnected. Otherwise
39 the plugging of a cable will trigger connecting
40 automatically. If no cable is plugged in this method
43 This method call will only return in case of an
44 error or when the service is fully connected. So
45 setting a longer D-Bus timeout might be a really
48 Possible Errors: [service].Error.InvalidArguments
52 Disconnect this service. If the service is not
53 connected an error message will be generated.
55 On Ethernet devices this will disconnect the IP
56 details from the service. It will not magically
57 unplug the cable. When no cable is plugged in this
60 This method can also be used to abort a previous
61 connectiong attempt via the Connect method.
63 Possible Errors: [service].Error.InvalidArguments
67 A successfully connected service with Favorite=true
68 can be removed this way. If it is connected, it will
69 be automatically disconnected first.
71 If the service requires a passphrase it will be
72 cleared and forgotten when removing.
74 This is similar to setting the Favorite property
75 to false, but that is currently not supported.
77 In the case a connection attempt failed and the
78 service is in the State=failure, this method can
79 also be used to reset the service.
81 Calling this method on Ethernet devices will cause
82 an error message. It is not possible to remove these
85 Possible Errors: [service].Error.InvalidArguments
87 void MoveBefore(object service)
89 If a service has been used before, this allows a
90 reorder of the favorite services.
92 The target service object must be part of this
93 profile. Moving between profiles is not supported.
95 Possible Errors: [service].Error.InvalidArguments
97 void MoveAfter(object service)
99 If a service has been used before, this allows a
100 reorder of the favorite services.
102 The target service object must be part of this
103 profile. Moving between profiles is not supported.
105 Possible Errors: [service].Error.InvalidArguments
107 Signals PropertyChanged(string name, variant value)
109 This signal indicates a changed value of the given
112 Properties string State [readonly]
114 The service state information.
116 Valid states are "idle", "failure", "association",
117 "configuration" and "ready".
119 string Error [readonly]
121 The service error status details.
123 When error occur during connection or disconnection
124 the detailed information are represented in this
125 property to help the user interface to present the
126 user with alternate options.
128 This property is only valid when the service is in
129 the "failure" state. Otherwise it might be empty or
132 Current defined error code is "dhcp-failed".
134 string Name [readonly]
136 The service name (for example "Wireless" etc.)
138 This name can be used for directly displaying it in
139 the application. It has pure informational purpose.
141 For Ethernet devices and hidden WiFi networks it is
142 not guaranteed that this property is present.
144 string Type [readonly]
146 The service type (for example "ethernet", "wifi" etc.)
148 This information should only be used to determine
149 advanced properties or showing the correct icon
152 string Mode [readonly]
154 If the service type is WiFi or Cellular, then this
155 property is present and contains the mode of the
158 For WiFi services the possible values are "managed"
159 and "adhoc". For Cellular services it describes the
160 network technology. Possible values are "gprs", "edge"
163 This property might be only present for WiFi and
166 string Security [readonly]
168 If the service type is WiFi, then this property is
169 present and contains the security method or key
172 Possible values are "none", "wep", "psk" and
173 also "ieee8021x". Alternate values for "psk"
174 can also be "wpa" and "rsn".
176 This property might be only present for WiFi
179 string Passphrase [readwrite]
181 If the service type is WiFi, then this property
182 can be used to store a passphrase.
184 No PropertyChanged signals will be send for this
185 property. The PassphraseRequired property should
186 be monitored instead.
188 This property might also not always be included
189 since it is protected by a different security policy.
191 boolean PassphraseRequired [readonly]
193 If the service type is WiFi, then this property
194 indicates if a passphrase is required.
196 If a passphrase has been set already or if no
197 passphrase is needed, then this property will
200 uint8 Strength [readonly]
202 Indicates the signal strength of the service. This
203 is a normalized value between 0 and 100.
205 This property will not be present for Ethernet
208 boolean Favorite [readonly]
210 Will be true if a cable is plugged in or the user
211 selected and successfully connected to this service.
213 This value is automatically changed and to revert
214 it back to false the Remove() method needs to be
217 boolean Immutable [readonly]
219 This value will be set to true if the service is
220 configured externally via a configuration file.
222 The only valid operation are Connect() and of
223 course Disconnect(). The Remove() method will
226 boolean AutoConnect [readwrite]
228 If set to true, this service will auto-connect
229 when not other connection is available.
231 For favorite services it is possible to change
232 this value to prevent or permit automatic
235 boolean SetupRequired [readonly]
237 If the service is Cellular, then this property
238 indicates that some extra setup steps are required.
240 In most cases it is required to fill in the APN
243 string APN [readwrite]
245 If the service is Cellular, then this property
246 contains the APN details.
248 The APN is network provider specific and even
249 sometimes data plan specific. Possible examples
250 are "isp.cingular" or "internet.t-mobile".
252 string MCC [readonly]
254 If the service is Cellular, then this property
255 contains the Mobile Country Code.
257 string MNC [readonly]
259 If the service is Cellular, then this property
260 contains the Mobile Network Code.
262 boolean Roaming [readonly]
264 This property indicates if this service is roaming.
266 In the case of Cellular services this normally
267 indicates connections to a foreign provider when
270 array{string} Nameservers [readwrite]
272 The list of manually configured domain name
273 servers. Some 3G networks don't provide correct
274 name servers and this allows for an override.
276 array{string} Domains [readwrite]
278 The list of manually configured search domains.
282 string Method [readonly]
284 Possible values are "dhcp", "manual"
287 string Address [readonly]
289 The current configured IPv4 address.
291 string Netmask [readonly]
293 The current configured IPv4 netmask.
295 string Gateway [readonly]
297 The current configured IPv4 gateway.
299 dict IPv4.Configuration [readwrite]
301 Same values as IPv4 property. The IPv4 represents
302 the actual system configuration while this allows
305 dict Ethernet [readonly]
307 string Method [readonly]
309 Possible values are "auto" and "manual".
311 string Address [readonly]
313 Ethernet device address (MAC address).
315 uint16 MTU [readonly]
317 The Ethernet MTU (default is 1500).
319 uint16 Speed [readonly]
321 Selected speed of the line.
323 This information might not always be
326 string Duplex [readonly]
328 Selected duplex settings of the line.
330 Possible values are "half" and "full".
332 This information might not always be