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
17 Connect this service. It will attempt to connect
18 WiFi, WiMAX or Bluetooth services.
20 For Ethernet devices this method can only be used
21 if it has previously been disconnected. Otherwise
22 the plugging of a cable will trigger connecting
23 automatically. If no cable is plugged in this method
26 Possible Errors: [service].Error.InvalidArguments
30 Disconnect this service. If the service is not
31 connected an error message will be generated.
33 On Ethernet devices this will disconnect the IP
34 details from the service. It will not magically
35 unplug the cable. When no cable is plugged in this
38 Possible Errors: [service].Error.InvalidArguments
42 A successfully connected service with Favorite=true
43 can be removed this way. If it is connected, it will
44 be automatically disconnected first.
46 This is similar to setting the Favorite property
47 to false, but that is currently not supported.
49 Calling this method on Ethernet devices will cause
50 an error message. It is not possible to remove these
53 Possible Errors: [service].Error.InvalidArguments
55 void MoveBefore(object service)
57 If a service has been used before, this allows a
58 reorder of the favorite services.
60 The target service object must be part of this
61 profile. Moving between profiles is not supported.
63 Possible Errors: [service].Error.InvalidArguments
65 void MoveAfter(object service)
67 If a service has been used before, this allows a
68 reorder of the favorite services.
70 The target service object must be part of this
71 profile. Moving between profiles is not supported.
73 Possible Errors: [service].Error.InvalidArguments
75 Signals PropertyChanged(string name, variant value)
77 This signal indicates a changed value of the given
80 Properties string State [readonly]
82 The service state information.
84 Valid states are "idle", "failure", "association",
85 "configuration" and "ready".
87 string Error [readonly]
89 The service error status details.
91 When error occur during connection or disconnection
92 the detailed information are represented in this
93 property to help the user interface to present the
94 user with alternate options.
96 This property is only valid when the service is in
97 the "failure" state. Otherwise it might be empty or
100 The detailed error codes will be defined later.
102 string Name [readonly]
104 The service name (for example "Wireless" etc.)
106 This name can be used for directly displaying it in
107 the application. It has pure informational purpose.
109 For Ethernet devices and hidden WiFi networks it is
110 not guaranteed that this property is present.
112 string Type [readonly]
114 The service type (for example "ethernet", "wifi" etc.)
116 This information should only be used to determine
117 advanced properties or showing the correct icon
120 string Mode [readonly]
122 If the service type is WiFi, then this property is
123 present and contains the mode of the network. The
124 possible values are "managed" or "adhoc".
126 This property might be only present for WiFi
129 string Security [readonly]
131 If the service type is WiFi, then this property is
132 present and contains the security method or key
135 Possible values are "none", "wep", "wpa" and "rsn".
137 This property might be only present for WiFi
140 string Passphrase [readwrite]
142 If the service type is WiFi, then this property
143 can be used to store a passphrase.
145 This property is still experimental and might be
146 removed in future version.
148 uint8 Strength [readonly]
150 Indicates the signal strength of the service. This
151 is a normalized value between 0 and 100.
153 This property will not be present for Ethernet
156 boolean Favorite [readonly]
158 Will be true if a cable is plugged in or the user
159 selected and successfully connected to this service.
161 Setting this property to true has no effect at all
162 and setting it to false is similar to the Remove()
163 method. So for now it will be considered a read