4 Service org.moblin.connman
5 Interface org.moblin.connman.Manager
8 Methods dict GetProperties()
10 Returns all global system properties. See the
11 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
27 Return global connection state of a system. The
28 same value is return via the State property.
30 Possible Errors: [service].Error.InvalidArguments
32 object CreateProfile(string name)
34 Create and add new profile with the specified
37 Possible Errors: [service].Error.InvalidArguments
39 void RemoveProfile(object path)
41 Remove profile with specified object path.
43 It is not possible to remove the current active
44 profile. To remove the active profile a different
45 one must be selected via ActiveProfile property
48 At minimum one profile must be available all the time.
50 Possible Errors: [service].Error.InvalidArguments
52 void RequestScan(string type)
54 Request to trigger a scan for the specified
55 technology. The empty string "" triggers scanning
58 Possible Errors: [service].Error.InvalidArguments
60 void EnableTechnology(string type)
62 Enable specified type of technologies.
64 Possible Errors: [service].Error.InvalidArguments
66 void DisableTechnology(string type)
68 Disable specified type of technologies.
70 Possible Errors: [service].Error.InvalidArguments
72 arracy{object,dict} GetServices()
74 Returns a sorted list of tuples with service
75 object path and dictionary of service properties.
77 This list will not contain sensitive information
80 Possible Errors: [service].Error.InvalidArguments
82 object LookupService(string pattern)
84 Lookup a service matching the specific pattern.
86 Examples are interface names like "eth0", "wlan0"
87 etc. or service names like "hotspot" etc.
89 In case of multiple services match the the pattern
92 Possible Errors: [service].Error.InvalidArguments
93 [service].Error.NotUnique
94 [service].Error.NotFound
96 object ConnectService(dict network)
98 Connect to a network specified by the given
101 For connecting to a hidden WiFi network for example
102 it is required that Type = "wifi" and the SSID
103 properties are provided.
105 When successful this method will return object
106 path of the service object.
108 This method can also be used to connect to an
109 already existing service. It works exactly the
110 same as executing the Connect method from the
113 This method call will only return in case of an
114 error or when the service is fully connected. So
115 setting a longer D-Bus timeout might be a really
118 Possible Errors: [service].Error.InvalidArguments
120 void RegisterAgent(object path)
122 Register new agent for handling user requests.
124 Possible Errors: [service].Error.InvalidArguments
126 void UnregisterAgent(object path)
128 Unregister an existing agent.
130 Possible Errors: [service].Error.InvalidArguments
132 void RegisterCounter(object path, uint32 accuracy, uint32 period)
134 Register a new counter for user notifications.
136 The accuracy is specified in kilo-bytes and defines
137 a threshold for counter updates. Together with the
138 period value it defines how often user space needs
139 to be updated. The period value is in seconds.
141 This interface is not meant for time tracking. If
142 the time needs to be tracked down to the second, it
143 is better to have a real timer running inside the
144 application than using this interface.
146 Also getting notified for every kilo-byte is a bad
147 choice (even if the interface supports it). Something
148 like 10 kilo-byte units or better 1 mega-byte seems
149 to be a lot more reasonable and better for the user.
151 Possible Errors: [service].Error.InvalidArguments
153 void UnregisterCounter(object path)
155 Unregister an existing counter.
157 Possible Errors: [service].Error.InvalidArguments
159 object RequestSession(string bearer)
161 Request a networking session.
163 If the bearer is an empty string the best available
164 service will be picked.
166 When successful this method will return the object
167 path of the corresponding service.
169 Possible Errors: [service].Error.InvalidArguments
171 void ReleaseSession()
173 Release a networking session.
175 Possible Errors: [service].Error.InvalidArguments
177 Signals PropertyChanged(string name, variant value)
179 This signal indicates a changed value of the given
182 StateChanged(string state)
184 This signal is similar to the PropertyChanged signal
185 for the State property.
187 It exists for application state only care about the
188 current state and so can avoid to be woken up when
189 other details changes.
191 Properties string State [readonly]
193 The global connection state of a system. Possible
194 values are "online" if at least one connection exists
195 and "offline" if no device is connected.
197 In certain situations the state might change to
198 the value "connected". This can only be seen if
199 previously no connection was present.
201 array{string} AvailableTechnologies [readonly]
203 The list of available technologies. The strings
204 are the same as the ones from the service types.
206 array{string} EnabledTechnologies [readonly]
208 The list of enabled technologies. The strings
209 are the same as the ones from the service types.
211 array{string} ConnectedTechnologies [readonly]
213 The list of connected technologies. The strings
214 are the same as the ones from the service type.
216 string DefaultTechnology [readonly]
218 The current connected technology which holds the
221 boolean OfflineMode [readwrite]
223 The offline mode indicates the global setting for
224 switching all radios on or off. Changing offline mode
225 to true results in powering down all devices. When
226 leaving offline mode the individual policy of each
227 device decides to switch the radio back on or not.
229 During offline mode, it is still possible to switch
230 certain technologies manually back on. For example
231 the limited usage of WiFi or Bluetooth devices might
232 be allowed in some situations.
234 boolean Tethering [readwrite]
236 This option allows to enable or disable the support
237 for tethering. When tethering is enabled then the
238 default service is bridged to all client where
239 connection sharing is supported.
241 object ActiveProfile [readwrite]
243 Object path of the current active profile.
245 array{object} Profiles [readonly]
247 List of profile object paths.
249 array{object} Technologies [readonly]
251 List of technology object paths.
253 array{object} Services [readonly]
255 List of service object paths. The list is sorted
256 internally to have the service with the default
257 route always first and then the favorite services
258 followed by scan results.
260 This list represents the available services for the
261 current selected profile. If the profile gets changed
262 then this list will be updated.
264 The same list is available via the profile object
265 itself. It is just provided here for convenience of
266 applications only dealing with the current active