]>
Commit | Line | Data |
---|---|---|
612bb516 JM |
1 | /** |
2 | \page dbus %wpa_supplicant D-Bus API | |
3 | ||
4 | This section documents the %wpa_supplicant D-Bus API. Every D-Bus | |
5 | interface implemented by %wpa_supplicant is described here including | |
6 | their methods, signals, and properties with arguments, returned | |
7 | values, and possible errors. | |
8 | ||
9 | Interfaces: | |
10 | - \ref dbus_main | |
11 | - \ref dbus_interface | |
12 | - \ref dbus_wps | |
13 | - \ref dbus_bss | |
14 | - \ref dbus_network | |
15 | ||
16 | ||
17 | \section dbus_main fi.w1.wpa_supplicant1 | |
18 | ||
19 | Interface implemented by the main %wpa_supplicant D-Bus object | |
20 | registered in the bus with fi.w1.wpa_supplicant1 name. | |
21 | ||
22 | \subsection dbus_main_methods Methods | |
23 | ||
24 | <ul> | |
25 | <li> | |
26 | <h3>CreateInterface ( a{sv} : args ) --> o : interface</h3> | |
27 | <p>Registers a wireless interface in %wpa_supplicant.</p> | |
28 | <h4>Arguments</h4> | |
29 | <dl> | |
30 | <dt>a{sv} : args</dt> | |
31 | <dd> | |
32 | A dictionary with arguments used to add the interface to %wpa_supplicant. The dictionary may contain the following entries: | |
33 | <table> | |
34 | <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th> | |
35 | <tr><td>Ifname</td><td>s</td><td>Name of the network interface to control, e.g., wlan0</td><td>Yes</td> | |
36 | <tr><td>Bridge_ifname</td><td>s</td><td>Name of the bridge interface to control, e.g., br0</td><td>No</td> | |
37 | <tr><td>Driver</td><td>s</td><td>Driver name which the interface uses, e.g., nl80211</td><td>No</td> | |
38 | </table> | |
39 | </dd> | |
40 | </dl> | |
41 | <h4>Returns</h4> | |
42 | <dl> | |
43 | <dt>o : interface</dt> | |
44 | <dd>A D-Bus path to object representing created interface</dd> | |
45 | </dl> | |
46 | <h4>Possible errors</h4> | |
47 | <dl> | |
48 | <dt>fi.w1.wpa_supplicant1.InterfaceExists</dt> | |
49 | <dd>%wpa_supplicant already controls this interface.</dd> | |
50 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
51 | <dd>Creating interface failed for an unknown reason.</dd> | |
52 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
53 | <dd>Invalid entries were found in the passed argument.</dd> | |
54 | </dl> | |
55 | </li> | |
56 | ||
57 | <li> | |
58 | <h3>RemoveInterface ( o : interface ) --> nothing</h3> | |
59 | <p>Deregisters a wireless interface from %wpa_supplicant.</p> | |
60 | <h4>Arguments</h4> | |
61 | <dl> | |
62 | <dt>o : interface</dt> | |
63 | <dd>A D-Bus path to an object representing an interface to remove returned by CreateInterface</dd> | |
64 | </dl> | |
65 | <h4>Possible errors</h4> | |
66 | <dl> | |
67 | <dt>fi.w1.wpa_supplicant1.InterfaceUnknown</dt> | |
68 | <dd>Object pointed by the path doesn't exist or doesn't represent an interface.</dd> | |
69 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
70 | <dd>Removing interface failed for an unknown reason.</dd> | |
71 | </dl> | |
72 | </li> | |
73 | ||
74 | <li> | |
75 | <h3>GetInterface ( s : ifname ) --> o : interface</h3> | |
76 | <p>Returns a D-Bus path to an object related to an interface which %wpa_supplicant already controls.</p> | |
77 | <h4>Arguments</h4> | |
78 | <dl> | |
79 | <dt>s : ifname</dt> | |
80 | <dd>Name of the network interface, e.g., wlan0</dd> | |
81 | </dl> | |
82 | <h4>Returns</h4> | |
83 | <dl> | |
84 | <dt>o : interface</dt> | |
85 | <dd>A D-Bus path to an object representing an interface</dd> | |
86 | </dl> | |
87 | <h4>Possible errors</h4> | |
88 | <dl> | |
89 | <dt>fi.w1.wpa_supplicant1.InterfaceUnknown</dt> | |
90 | <dd>An interface with the passed name in not controlled by %wpa_supplicant.</dd> | |
91 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
92 | <dd>Getting an interface object path failed for an unknown reason.</dd> | |
93 | </dl> | |
94 | </li> | |
95 | </ul> | |
96 | ||
97 | \subsection dbus_main_properties Properties | |
98 | ||
99 | <ul> | |
100 | <li> | |
a2753c28 | 101 | <h3>DebugLevel - s - (read/write)</h3> |
2ea856aa | 102 | <p>Global %wpa_supplicant debugging level. Possible values are |
a2753c28 MH |
103 | "msgdump" (verbose debugging), "debug" (debugging), |
104 | "info" (informative), "warning" (warnings), and "error" (errors).</p> | |
db9133ac WS |
105 | </li> |
106 | ||
107 | <li> | |
108 | <h3>DebugTimestamp - b - (read/write)</h3> | |
2ea856aa | 109 | <p>Global %wpa_supplicant debugging parameter. Determines if timestamps are shown in debug logs.</p> |
db9133ac WS |
110 | </li> |
111 | ||
112 | <li> | |
113 | <h3>DebugShowKeys - b - (read/write)</h3> | |
2ea856aa | 114 | <p>Global %wpa_supplicant debugging parameter. Determines if secrets are shown in debug logs.</p> |
612bb516 JM |
115 | </li> |
116 | ||
117 | <li> | |
118 | <h3>Interfaces - ao - (read)</h3> | |
119 | <p>An array with paths to D-Bus objects representing controlled interfaces each.</p> | |
120 | </li> | |
121 | ||
122 | <li> | |
123 | <h3>EapMethods - as - (read)</h3> | |
124 | <p>An array with supported EAP methods names.</p> | |
125 | </li> | |
126 | </ul> | |
127 | ||
128 | \subsection dbus_main_signals Signals | |
129 | ||
130 | <ul> | |
131 | <li> | |
e376f119 | 132 | <h3>InterfaceAdded ( o : interface, a{sv} : properties )</h3> |
612bb516 JM |
133 | <p>A new interface was added to %wpa_supplicant.</p> |
134 | <h4>Arguments</h4> | |
135 | <dl> | |
136 | <dt>o : interface</dt> | |
137 | <dd>A D-Bus path to an object representing the added interface</dd> | |
138 | </dl> | |
e376f119 WS |
139 | <dl> |
140 | <dt>a{sv} : properties</dt> | |
141 | <dd>A dictionary containing properties of added interface.</dd> | |
142 | </dl> | |
612bb516 JM |
143 | </li> |
144 | ||
145 | <li> | |
146 | <h3>InterfaceRemoved ( o : interface )</h3> | |
147 | <p>An interface was removed from %wpa_supplicant.</p> | |
148 | <h4>Arguments</h4> | |
149 | <dl> | |
150 | <dt>o : interface</dt> | |
151 | <dd>A D-Bus path to an object representing the removed interface</dd> | |
152 | </dl> | |
153 | </li> | |
154 | ||
155 | <li> | |
156 | <h3>PropertiesChanged ( a{sv} : properties )</h3> | |
157 | <p>Some properties have changed.</p> | |
158 | <h4>Arguments</h4> | |
159 | <dl> | |
160 | <dt>a{sv} : properties</dt> | |
161 | <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "DebugParams"</dd> | |
162 | </dl> | |
163 | </li> | |
164 | </ul> | |
165 | ||
166 | ||
167 | \section dbus_interface fi.w1.wpa_supplicant1.Interface | |
168 | ||
169 | Interface implemented by objects related to network interface added to | |
170 | %wpa_supplicant, i.e., returned by | |
171 | fi.w1.wpa_supplicant1.CreateInterface. | |
172 | ||
173 | \subsection dbus_interface_methods Methods | |
174 | ||
175 | <ul> | |
176 | <li> | |
177 | <h3>Scan ( a{sv} : args ) --> nothing</h3> | |
178 | <p>Triggers a scan.</p> | |
179 | <h4>Arguments</h4> | |
180 | <dl> | |
181 | <dt>a{sv} : args</dt> | |
182 | <dd> | |
183 | A dictionary with arguments describing scan type: | |
184 | <table> | |
185 | <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th> | |
186 | <tr><td>Type</td><td>s</td><td>Type of the scan. Possible values: "active", "passive"</td><td>Yes</td> | |
187 | <tr><td>SSIDs</td><td>aay</td><td>Array of SSIDs to scan for (applies only if scan type is active)</td><td>No</td> | |
188 | <tr><td>IEs</td><td>aay</td><td>Information elements to used in active scan (applies only if scan type is active)</td><td>No</td> | |
189 | <tr><td>Channels</td><td>a(uu)</td><td>Array of frequencies to scan in form of (center, width) in MHz.</td><td>No</td> | |
190 | </table> | |
191 | </dd> | |
192 | </dl> | |
193 | <h4>Possible errors</h4> | |
194 | <dl> | |
195 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
196 | <dd>Invalid entries were found in the passed argument.</dd> | |
197 | </dl> | |
198 | </li> | |
199 | ||
200 | <li> | |
201 | <h3>Disconnect ( ) --> nothing</h3> | |
202 | <p>Disassociates the interface from current network.</p> | |
203 | <h4>Possible errors</h4> | |
204 | <dl> | |
8e5568f8 | 205 | <dt>fi.w1.wpa_supplicant1.NotConnected</dt> |
612bb516 JM |
206 | <dd>Interface is not connected to any network.</dd> |
207 | </dl> | |
208 | </li> | |
209 | ||
210 | <li> | |
211 | <h3>AddNetwork ( a{sv} : args ) --> o : network</h3> | |
212 | <p>Adds a new network to the interface.</p> | |
213 | <h4>Arguments</h4> | |
214 | <dl> | |
215 | <dt>a{sv} : args</dt> | |
216 | <dd>A dictionary with network configuration. Dictionary entries are equivalent to entries in the "network" block in %wpa_supplicant configuration file. Entry values should be appropriate type to the entry, e.g., an entry with key "frequency" should have value type int.</dd> | |
217 | </dl> | |
218 | <h4>Returns</h4> | |
219 | <dl> | |
220 | <dt>o : network</dt> | |
221 | <dd>A D-Bus path to an object representing a configured network</dd> | |
222 | </dl> | |
223 | <h4>Possible errors</h4> | |
224 | <dl> | |
225 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
226 | <dd>Invalid entries were found in the passed argument.</dd> | |
227 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
228 | <dd>Adding network failed for an unknown reason.</dd> | |
229 | </dl> | |
230 | </li> | |
231 | ||
232 | <li> | |
233 | <h3>RemoveNetwork ( o : network ) --> nothing</h3> | |
234 | <p>Removes a configured network from the interface.</p> | |
235 | <h4>Arguments</h4> | |
236 | <dl> | |
237 | <dt>o : network</dt> | |
238 | <dd>A D-Bus path to an object representing a configured network returned by fi.w1.wpa_supplicant1.Interface.AddNetwork</dd> | |
239 | </dl> | |
240 | <h4>Possible errors</h4> | |
241 | <dl> | |
8e5568f8 | 242 | <dt>fi.w1.wpa_supplicant1.NetworkUnknown</dt> |
612bb516 JM |
243 | <dd>A passed path doesn't point to any network object.</dd> |
244 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
245 | <dd>A passed path doesn't point to any network object.</dd> | |
246 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
247 | <dd>Removing network failed for an unknown reason.</dd> | |
248 | </dl> | |
249 | </li> | |
250 | ||
251 | <li> | |
252 | <h3>SelectNetwork ( o : network ) --> nothing</h3> | |
253 | <p>Attempt association with a configured network.</p> | |
254 | <h4>Arguments</h4> | |
255 | <dl> | |
256 | <dt>o : network</dt> | |
257 | <dd>A D-Bus path to an object representing a configured network returned by fi.w1.wpa_supplicant1.Interface.AddNetwork</dd> | |
258 | </dl> | |
259 | <h4>Possible errors</h4> | |
260 | <dl> | |
8e5568f8 | 261 | <dt>fi.w1.wpa_supplicant1.NetworkUnknown</dt> |
612bb516 JM |
262 | <dd>A passed path doesn't point to any network object.</dd> |
263 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
264 | <dd>A passed path doesn't point to any network object.</dd> | |
265 | </dl> | |
266 | </li> | |
267 | ||
268 | <li> | |
269 | <h3>AddBlob ( s : name, ay : data ) --> nothing</h3> | |
270 | <p>Adds a blob to the interface.</p> | |
271 | <h4>Arguments</h4> | |
272 | <dl> | |
273 | <dt>s : name</dt> | |
274 | <dd>A name of a blob</dd> | |
275 | <dt>ay : data</dt> | |
276 | <dd>A blob data</dd> | |
277 | </dl> | |
278 | <h4>Possible errors</h4> | |
279 | <dl> | |
8e5568f8 | 280 | <dt>fi.w1.wpa_supplicant1.BlobExists</dt> |
612bb516 JM |
281 | <dd>A blob with the specified name already exists.</dd> |
282 | </dl> | |
283 | </li> | |
284 | ||
285 | <li> | |
286 | <h3>RemoveBlob ( s : name ) --> nothing</h3> | |
287 | <p>Removes the blob from the interface.</p> | |
288 | <h4>Arguments</h4> | |
289 | <dl> | |
290 | <dt>s : name</dt> | |
291 | <dd>A name of the blob to remove</dd> | |
292 | </dl> | |
293 | <h4>Possible errors</h4> | |
294 | <dl> | |
8e5568f8 | 295 | <dt>fi.w1.wpa_supplicant1.BlobUnknown</dt> |
612bb516 JM |
296 | <dd>A blob with the specified name doesn't exist.</dd> |
297 | </dl> | |
298 | </li> | |
299 | ||
300 | <li> | |
301 | <h3>GetBlob ( s : name ) --> ay : data</h3> | |
302 | <p>Returns the blob data of a previously added blob.</p> | |
303 | <h4>Arguments</h4> | |
304 | <dl> | |
305 | <dt>s : name</dt> | |
306 | <dd>A name of the blob</dd> | |
307 | </dl> | |
308 | <h4>Returns</h4> | |
309 | <dl> | |
310 | <dt>ay : data</dt> | |
311 | <dd>A blob data</dd> | |
312 | </dl> | |
313 | <h4>Possible errors</h4> | |
314 | <dl> | |
8e5568f8 | 315 | <dt>fi.w1.wpa_supplicant1.BlobUnknown</dt> |
612bb516 JM |
316 | <dd>A blob with the specified name doesn't exist.</dd> |
317 | </dl> | |
318 | </li> | |
319 | </ul> | |
320 | ||
321 | \subsection dbus_interface_properties Properties | |
322 | ||
323 | <ul> | |
324 | <li> | |
325 | <h3>Capabilities - a{sv} - (read)</h3> | |
326 | <p>Capabilities of the interface. Dictionary contains following entries:</p> | |
327 | <table> | |
328 | <tr><th>Key</th><th>Value type</th><th>Description</th> | |
329 | <tr><td>Pairwise</td><td>as</td><td>Possible array elements: "ccmp", "tkip", "none"</td> | |
330 | <tr><td>Group</td><td>as</td><td>Possible array elements: "ccmp", "tkip", "wep104", "wep40"</td> | |
c56ce48a | 331 | <tr><td>KeyMgmt</td><td>as</td><td>Possible array elements: "wpa-psk", "wpa-ft-psk", "wpa-psk-sha256", "wpa-eap", "wpa-ft-eap", "wpa-eap-sha256", "ieee8021x", "wpa-none", "wps", "none"</td> |
612bb516 JM |
332 | <tr><td>Protocol</td><td>as</td><td>Possible array elements: "rsn", "wpa"</td> |
333 | <tr><td>AuthAlg</td><td>as</td><td>Possible array elements: "open", "shared", "leap"</td> | |
334 | <tr><td>Scan</td><td>as</td><td>Possible array elements: "active", "passive", "ssid"</td> | |
335 | <tr><td>Modes</td><td>as</td><td>Possible array elements: "infrastructure", "ad-hoc", "ap"</td> | |
336 | </table> | |
337 | </li> | |
338 | ||
339 | <li> | |
340 | <h3>State - s - (read)</h3> | |
341 | <p>A state of the interface. Possible values are: return "disconnected", "inactive", "scanning", "authenticating", "associating", "associated", "4way_handshake", "group_handshake", "completed","unknown".</p> | |
342 | </li> | |
343 | ||
344 | <li> | |
345 | <h3>Scanning - b - (read)</h3> | |
346 | <p>Determines if the interface is already scanning or not</p> | |
347 | </li> | |
348 | ||
349 | <li> | |
350 | <h3>ApScan - u - (read/write)</h3> | |
351 | <p>Identical to ap_scan entry in %wpa_supplicant configuration file. Possible values are 0, 1 or 2.</p> | |
352 | </li> | |
353 | ||
354 | <li> | |
355 | <h3>Ifname - s - (read)</h3> | |
356 | <p>Name of network interface controlled by the interface, e.g., wlan0.</p> | |
357 | </li> | |
358 | ||
359 | <li> | |
360 | <h3>BridgeIfname - s - (read)</h3> | |
361 | <p>Name of bridge network interface controlled by the interface, e.g., br0.</p> | |
362 | </li> | |
363 | ||
364 | <li> | |
365 | <h3>Driver - s - (read)</h3> | |
366 | <p>Name of driver used by the interface, e.g., nl80211.</p> | |
367 | </li> | |
368 | ||
369 | <li> | |
370 | <h3>CurrentBSS - o - (read)</h3> | |
371 | <p>Path to D-Bus object representing BSS which %wpa_supplicant is associated with, or "/" if is not associated at all.</p> | |
372 | </li> | |
373 | ||
374 | <li> | |
375 | <h3>CurrentNetwork - o - (read)</h3> | |
376 | <p>Path to D-Bus object representing configured network which %wpa_supplicant uses at the moment, or "/" if doesn't use any.</p> | |
377 | </li> | |
378 | ||
379 | <li> | |
380 | <h3>Blobs - as - (read)</h3> | |
381 | <p>List of blobs names added to the Interface.</p> | |
382 | </li> | |
383 | ||
384 | <li> | |
385 | <h3>BSSs - ao - (read)</h3> | |
386 | <p>List of D-Bus objects paths representing BSSs known to the interface, i.e., scan results.</p> | |
387 | </li> | |
388 | ||
389 | <li> | |
390 | <h3>Networks - ao - (read)</h3> | |
391 | <p>List of D-Bus objects paths representing configured networks.</p> | |
392 | </li> | |
393 | </ul> | |
394 | ||
395 | \subsection dbus_interface_signals Signals | |
396 | ||
397 | <ul> | |
398 | <li> | |
399 | <h3>ScanDone ( b : success )</h3> | |
400 | <p>Scanning finished. </p> | |
401 | <h4>Arguments</h4> | |
402 | <dl> | |
403 | <dt>s : success</dt> | |
404 | <dd>Determines if scanning was successful. If so, results are available.</dd> | |
405 | </dl> | |
406 | </li> | |
407 | ||
612bb516 | 408 | <li> |
e376f119 | 409 | <h3>BSSAdded ( o : BSS, a{sv} : properties )</h3> |
612bb516 JM |
410 | <p>Interface became aware of a new BSS.</p> |
411 | <h4>Arguments</h4> | |
412 | <dl> | |
413 | <dt>o : BSS</dt> | |
414 | <dd>A D-Bus path to an object representing the new BSS.</dd> | |
415 | </dl> | |
e376f119 WS |
416 | <dl> |
417 | <dt>a{sv} : properties</dt> | |
418 | <dd>A dictionary containing properties of added BSS.</dd> | |
419 | </dl> | |
612bb516 JM |
420 | </li> |
421 | ||
422 | <li> | |
423 | <h3>BSSRemoved ( o : BSS )</h3> | |
424 | <p>BSS disappeared.</p> | |
425 | <h4>Arguments</h4> | |
426 | <dl> | |
427 | <dt>o : BSS</dt> | |
428 | <dd>A D-Bus path to an object representing the BSS.</dd> | |
429 | </dl> | |
430 | </li> | |
431 | ||
432 | <li> | |
433 | <h3>BlobAdded ( s : blobName )</h3> | |
434 | <p>A new blob has been added to the interface.</p> | |
435 | <h4>Arguments</h4> | |
436 | <dl> | |
437 | <dt>s : blobName</dt> | |
438 | <dd>A name of the added blob.</dd> | |
439 | </dl> | |
440 | </li> | |
441 | ||
442 | <li> | |
443 | <h3>BlobRemoved ( s : blobName )</h3> | |
444 | <p>A blob has been removed from the interface.</p> | |
445 | <h4>Arguments</h4> | |
446 | <dl> | |
447 | <dt>s : blobName</dt> | |
448 | <dd>A name of the removed blob.</dd> | |
449 | </dl> | |
450 | </li> | |
451 | ||
452 | <li> | |
e376f119 | 453 | <h3>NetworkAdded ( o : network, a{sv} : properties )</h3> |
612bb516 JM |
454 | <p>A new network has been added to the interface.</p> |
455 | <h4>Arguments</h4> | |
456 | <dl> | |
457 | <dt>o : network</dt> | |
458 | <dd>A D-Bus path to an object representing the added network.</dd> | |
459 | </dl> | |
e376f119 WS |
460 | <dl> |
461 | <dt>a{sv} : properties</dt> | |
462 | <dd>A dictionary containing properties of added network.</dd> | |
463 | </dl> | |
612bb516 JM |
464 | </li> |
465 | ||
466 | <li> | |
467 | <h3>NetworkRemoved ( o : network )</h3> | |
468 | <p>The network has been removed from the interface.</p> | |
469 | <h4>Arguments</h4> | |
470 | <dl> | |
471 | <dt>o : network</dt> | |
472 | <dd>A D-Bus path to an object representing the removed network.</dd> | |
473 | </dl> | |
474 | </li> | |
475 | ||
476 | <li> | |
477 | <h3>NetworkSelected ( o : network )</h3> | |
478 | <p>The network has been selected.</p> | |
479 | <h4>Arguments</h4> | |
480 | <dl> | |
481 | <dt>o : network</dt> | |
482 | <dd>A D-Bus path to an object representing the selected network.</dd> | |
483 | </dl> | |
484 | </li> | |
485 | ||
486 | <li> | |
487 | <h3>PropertiesChanged ( a{sv} : properties )</h3> | |
488 | <p>Some properties have changed.</p> | |
489 | <h4>Arguments</h4> | |
490 | <dl> | |
491 | <dt>a{sv} : properties</dt> | |
27f43d8d | 492 | <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "ApScan", "Scanning", "State", "CurrentBSS", "CurrentNetwork"</dd> |
612bb516 JM |
493 | </dl> |
494 | </li> | |
495 | </ul> | |
496 | ||
497 | ||
498 | \section dbus_wps fi.w1.wpa_supplicant1.Interface.WPS | |
499 | ||
500 | Interface implemented by objects related to network interface added to | |
d89530f7 | 501 | %wpa_supplicant, i.e., returned by fi.w1.wpa_supplicant1.CreateInterface. |
612bb516 JM |
502 | |
503 | \subsection dbus_wps_methods Methods | |
504 | ||
505 | <ul> | |
506 | <li> | |
507 | <h3>Start ( a{sv} : args ) --> a{sv} : output</h3> | |
508 | <p>Starts WPS configuration.</p> | |
509 | <h4>Arguments</h4> | |
510 | <dl> | |
511 | <dt>a{sv} : args</dt> | |
512 | <dd> | |
513 | A dictionary with arguments used to start WPS configuration. The dictionary may contain the following entries: | |
514 | <table> | |
515 | <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th> | |
516 | <tr><td>Role</td><td>s</td><td>The device's role. Possible values are "enrollee" and "registrar".</td><td>Yes</td> | |
517 | <tr><td>Type</td><td>s</td><td>WPS authentication type. Applies only for enrollee role. Possible values are "pin" and "pbc".</td><td>Yes, for enrollee role; otherwise no</td> | |
518 | <tr><td>Pin</td><td>s</td><td>WPS Pin.</td><td>Yes, for registrar role; otherwise optional</td> | |
519 | <tr><td>Bssid</td><td>ay</td><td></td><td>No</td> | |
520 | </table> | |
521 | </dd> | |
522 | </dl> | |
523 | <h4>Returns</h4> | |
524 | <dl> | |
525 | <dt>a{sv} : output</dt> | |
526 | <dd> | |
527 | <table> | |
528 | <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th> | |
529 | <tr><td>Pin</td><td>s</td><td>Newly generated PIN, if not specified for enrollee role and pin authentication type.</td><td>No</td> | |
530 | </table> | |
531 | </dd> | |
532 | </dl> | |
533 | <h4>Possible errors</h4> | |
534 | <dl> | |
535 | <dt>fi.w1.wpa_supplicant1.UnknownError</dt> | |
536 | <dd>Starting WPS configuration failed for an unknown reason.</dd> | |
537 | <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt> | |
538 | <dd>Invalid entries were found in the passed argument.</dd> | |
539 | </dl> | |
540 | </li> | |
541 | </ul> | |
542 | ||
543 | \subsection dbus_wps_properties Properties | |
544 | ||
545 | <ul> | |
546 | <li> | |
547 | <h3>ProcessCredentials - b - (read/write)</h3> | |
548 | <p>Determines if the interface will process the credentials (credentials_processed configuration file parameter).</p> | |
549 | </li> | |
550 | </ul> | |
551 | ||
552 | \subsection dbus_wps_signals Signals | |
553 | ||
554 | <ul> | |
555 | <li> | |
556 | <h3>Event ( s : name, a{sv} : args )</h3> | |
557 | <p>WPS event occurred.</p> | |
558 | <h4>Arguments</h4> | |
559 | <dl> | |
560 | <dt>s : event</dt> | |
561 | <dd>Event type. Possible values are: "success, "fail" and "m2d"</dd> | |
562 | <dt>a{sv} : args</dt> | |
563 | <dd> | |
564 | Event arguments. Empty for success event, one entry ( "msg" : i ) for fail event and following entries for m2d event: | |
565 | <table> | |
566 | <tr><th>config_methods</th><th>Value type</th> | |
567 | <tr><td>manufacturer</td><td>q</td> | |
568 | <tr><td>model_name</td><td>ay</td> | |
569 | <tr><td>model_number</td><td>ay</td> | |
570 | <tr><td>serial_number</td><td>ay</td> | |
571 | <tr><td>dev_name</td><td>ay</td> | |
572 | <tr><td>primary_dev_type</td><td>ay</td> | |
573 | <tr><td>config_error</td><td>q</td> | |
574 | <tr><td>dev_password_id</td><td>q</td> | |
575 | </table> | |
576 | </dd> | |
577 | </dl> | |
578 | </li> | |
579 | ||
580 | <li> | |
581 | <h3>Credentials ( a{sv} : credentials )</h3> | |
582 | <p>WPS credentials. Dictionary contains:</p> | |
583 | <table> | |
584 | <tr><th>Key</th><th>Value type</th><th>Description</th> | |
585 | <tr><td>BSSID</td><td>ay</td><td></td> | |
586 | <tr><td>SSID</td><td>s</td><td></td> | |
587 | <tr><td>AuthType</td><td>as</td><td>Possible array elements: "open", "shared", "wpa-psk", "wpa-eap", "wpa2-eap", "wpa2-psk"</td> | |
588 | <tr><td>EncrType</td><td>as</td><td>Possible array elements: "none", "wep", "tkip", "aes"</td> | |
589 | <tr><td>Key</td><td>ay</td><td>Key data</td> | |
590 | <tr><td>KeyIndex</td><td>u</td><td>Key index</td> | |
591 | </table> | |
592 | </li> | |
593 | ||
594 | <li> | |
595 | <h3>PropertiesChanged ( a{sv} : properties )</h3> | |
596 | <p>Some properties have changed.</p> | |
597 | <h4>Arguments</h4> | |
598 | <dl> | |
599 | <dt>a{sv} : properties</dt> | |
600 | <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "ProcessCredentials"</dd> | |
601 | </dl> | |
602 | </li> | |
603 | </ul> | |
604 | ||
605 | ||
8e5568f8 | 606 | \section dbus_bss fi.w1.wpa_supplicant1.BSS |
612bb516 JM |
607 | |
608 | Interface implemented by objects representing a scanned BSSs, i.e., | |
609 | scan results. | |
610 | ||
611 | \subsection dbus_bss_properties Properties | |
612 | ||
613 | <ul> | |
614 | <li> | |
58605c6e WS |
615 | <h3>BSSID - ay - (read)</h3> |
616 | <p>BSSID of the BSS.</p> | |
617 | </li> | |
618 | <li> | |
619 | <h3>SSID - ay - (read)</h3> | |
620 | <p>SSID of the BSS.</p> | |
621 | </li> | |
622 | <li> | |
7899e2f4 WS |
623 | <h3>WPA - a{sv} - (read)</h3> |
624 | <p>WPA information of the BSS. Empty dictionary indicates no WPA support. Dictionary entries are:</p> | |
625 | <table> | |
626 | <tr><td>KeyMgmt</td><td>as</td><td>Key management suite. Possible array elements: "wpa-psk", "wpa-eap", "wpa-none"</td> | |
627 | <tr><td>Pairwise</td><td>as</td><td>Pairwise cipher suites. Possible array elements: "ccmp", "tkip"</td> | |
628 | <tr><td>Group</td><td>s</td><td>Group cipher suite. Possible values are: "ccmp", "tkip", "wep104", "wep40"</td> | |
629 | </table> | |
58605c6e WS |
630 | </li> |
631 | <li> | |
7899e2f4 WS |
632 | <h3>RSN - a{sv} - (read)</h3> |
633 | <p>RSN information of the BSS. Empty dictionary indicates no RSN support. Dictionary entries are:</p> | |
634 | <table> | |
635 | <tr><td>KeyMgmt</td><td>as</td><td>Key management suite. Possible array elements: "wpa-psk", "wpa-eap", "wpa-ft-psk", "wpa-ft-eap", "wpa-psk-sha256", "wpa-eap-sha256",</td> | |
636 | <tr><td>Pairwise</td><td>as</td><td>Pairwise cipher suites. Possible array elements: "ccmp", "tkip"</td> | |
637 | <tr><td>Group</td><td>s</td><td>Group cipher suite. Possible values are: "ccmp", "tkip", "wep104", "wep40"</td> | |
638 | <tr><td>MgmtGroup</td><td>s</td><td>Mangement frames cipher suite. Possible values are: "aes128cmac"</td> | |
639 | </table> | |
58605c6e WS |
640 | </li> |
641 | <li> | |
7899e2f4 WS |
642 | <h3>IEs - ay - (read)</h3> |
643 | <p>All IEs of the BSS as a chain of TLVs</p> | |
58605c6e WS |
644 | </li> |
645 | <li> | |
646 | <h3>Privacy - b - (read)</h3> | |
647 | <p>Indicates if BSS supports privacy.</p> | |
648 | </li> | |
649 | <li> | |
650 | <h3>Mode - s - (read)</h3> | |
651 | <p>Describes mode of the BSS. Possible values are: "ad-hoc" and "infrastructure".</p> | |
652 | </li> | |
653 | <li> | |
654 | <h3>Frequency - q - (read)</h3> | |
655 | <p>Frequency of the BSS in MHz.</p> | |
656 | </li> | |
657 | <li> | |
75d328af WS |
658 | <h3>Rates - au - (read)</h3> |
659 | <p>Descending ordered array of rates supported by the BSS in bits per second.</p> | |
58605c6e WS |
660 | </li> |
661 | <li> | |
662 | <h3>Signal - n - (read)</h3> | |
663 | <p>Signal strength of the BSS.</p> | |
612bb516 JM |
664 | </li> |
665 | </ul> | |
12694895 JM |
666 | |
667 | \subsection dbus_bss_signals Signals | |
668 | ||
669 | <ul> | |
670 | <li> | |
671 | <h3>PropertiesChanged ( a{sv} : properties )</h3> | |
672 | <p>Some properties have changed.</p> | |
673 | <h4>Arguments</h4> | |
674 | <dl> | |
675 | <dt>a{sv} : properties</dt> | |
676 | <dd>A dictionary with pairs of properties names which have changed and theirs new values.</dd> | |
677 | </dl> | |
678 | </li> | |
679 | </ul> | |
612bb516 JM |
680 | |
681 | ||
8e5568f8 | 682 | \section dbus_network fi.w1.wpa_supplicant1.Network |
612bb516 JM |
683 | |
684 | Interface implemented by objects representing configured networks, | |
685 | i.e., returned by fi.w1.wpa_supplicant1.Interface.AddNetwork. | |
686 | ||
687 | \subsection dbus_network_properties Properties | |
688 | ||
689 | <ul> | |
690 | <li> | |
691 | <h3>Enabled - b - (read/write)</h3> | |
692 | <p>Determines if the configured network is enabled or not.</p> | |
693 | </li> | |
694 | ||
695 | <li> | |
696 | <h3>Properties - a{sv} - (read)</h3> | |
697 | <p>Properties of the configured network. Dictionary contains entries from "network" block of %wpa_supplicant configuration file. All values are string type, e.g., frequency is "2437", not 2437. | |
698 | </li> | |
699 | </ul> | |
700 | ||
701 | \subsection dbus_network_signals Signals | |
702 | ||
703 | <ul> | |
704 | <li> | |
705 | <h3>PropertiesChanged ( a{sv} : properties )</h3> | |
706 | <p>Some properties have changed.</p> | |
707 | <h4>Arguments</h4> | |
708 | <dl> | |
709 | <dt>a{sv} : properties</dt> | |
710 | <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "Enabled"</dd> | |
711 | </dl> | |
712 | </li> | |
713 | </ul> | |
714 | ||
715 | */ |