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 Calling this method on Ethernet devices will cause
78 an error message. It is not possible to remove these
81 Possible Errors: [service].Error.InvalidArguments
83 void MoveBefore(object service)
85 If a service has been used before, this allows a
86 reorder of the favorite services.
88 The target service object must be part of this
89 profile. Moving between profiles is not supported.
91 Possible Errors: [service].Error.InvalidArguments
93 void MoveAfter(object service)
95 If a service has been used before, this allows a
96 reorder of the favorite services.
98 The target service object must be part of this
99 profile. Moving between profiles is not supported.
101 Possible Errors: [service].Error.InvalidArguments
103 Signals PropertyChanged(string name, variant value)
105 This signal indicates a changed value of the given
108 Properties string State [readonly]
110 The service state information.
112 Valid states are "idle", "failure", "association",
113 "configuration" and "ready".
115 string Error [readonly]
117 The service error status details.
119 When error occur during connection or disconnection
120 the detailed information are represented in this
121 property to help the user interface to present the
122 user with alternate options.
124 This property is only valid when the service is in
125 the "failure" state. Otherwise it might be empty or
128 Current defined error code is "dhcp-failed".
130 string Name [readonly]
132 The service name (for example "Wireless" etc.)
134 This name can be used for directly displaying it in
135 the application. It has pure informational purpose.
137 For Ethernet devices and hidden WiFi networks it is
138 not guaranteed that this property is present.
140 string Type [readonly]
142 The service type (for example "ethernet", "wifi" etc.)
144 This information should only be used to determine
145 advanced properties or showing the correct icon
148 string Mode [readonly]
150 If the service type is WiFi, then this property is
151 present and contains the mode of the network. The
152 possible values are "managed" or "adhoc".
154 This property might be only present for WiFi
157 string Security [readonly]
159 If the service type is WiFi, then this property is
160 present and contains the security method or key
163 Possible values are "none", "wep", "wpa" and "rsn".
165 This property might be only present for WiFi
168 string Passphrase [readwrite]
170 If the service type is WiFi, then this property
171 can be used to store a passphrase.
173 No PropertyChanged signals will be send for this
174 property. The PassphraseRequired property should
175 be monitored instead.
177 This property might also not always be included
178 since it is protected by a different security policy.
180 boolean PassphraseRequired [readonly]
182 If the service type is WiFi, then this property
183 indicates if a passphrase is required.
185 If a passphrase has been set already or if no
186 passphrase is needed, then this property will
189 uint8 Strength [readonly]
191 Indicates the signal strength of the service. This
192 is a normalized value between 0 and 100.
194 This property will not be present for Ethernet
197 boolean Favorite [readonly]
199 Will be true if a cable is plugged in or the user
200 selected and successfully connected to this service.
202 This value is automatically changed and to revert
203 it back to false the Remove() method needs to be
206 boolean AutoConnect [readwrite]
208 If set to true, this service will auto-connect
209 when not other connection is available.
211 For favorite services it is possible to change
212 this value to prevent or permit automatic
215 string IPv4.Method [readwrite]
217 The IPv4 configuration method. Possible values here
218 are "dhcp" and "static".
220 string IPv4.Address [readwrite]
222 The current configured IPv4 address.