]>
Commit | Line | Data |
---|---|---|
f6b25ca5 JM |
1 | wpa_supplicant and Wi-Fi P2P |
2 | ============================ | |
3 | ||
4 | This document describes how the Wi-Fi P2P implementation in | |
5 | wpa_supplicant can be configured and how an external component on the | |
6 | client (e.g., management GUI) is used to enable WPS enrollment and | |
7 | registrar registration. | |
8 | ||
9 | ||
10 | Introduction to Wi-Fi P2P | |
11 | ------------------------- | |
12 | ||
13 | TODO | |
14 | ||
15 | More information about Wi-Fi P2P is available from Wi-Fi Alliance: | |
16 | http://www.wi-fi.org/Wi-Fi_Direct.php | |
17 | ||
18 | ||
19 | wpa_supplicant implementation | |
20 | ----------------------------- | |
21 | ||
22 | TODO | |
23 | ||
24 | ||
25 | wpa_supplicant configuration | |
26 | ---------------------------- | |
27 | ||
28 | Wi-Fi P2P is an optional component that needs to be enabled in the | |
29 | wpa_supplicant build configuration (.config). Here is an example | |
30 | configuration that includes Wi-Fi P2P support and Linux nl80211 | |
31 | -based driver interface: | |
32 | ||
33 | CONFIG_DRIVER_NL80211=y | |
34 | CONFIG_CTRL_IFACE=y | |
35 | CONFIG_P2P=y | |
36 | CONFIG_AP=y | |
37 | CONFIG_WPS=y | |
38 | ||
39 | ||
40 | In run-time configuration file (wpa_supplicant.conf), some parameters | |
41 | for P2P may be set. In order to make the devices easier to recognize, | |
42 | device_name and device_type should be specified. For example, | |
43 | something like this should be included: | |
44 | ||
45 | ctrl_interface=/var/run/wpa_supplicant | |
46 | device_name=My P2P Device | |
47 | device_type=1-0050F204-1 | |
48 | ||
49 | ||
50 | wpa_cli | |
51 | ------- | |
52 | ||
53 | Actual Wi-Fi P2P operations are requested during runtime. These can be | |
54 | done for example using wpa_cli (which is described below) or a GUI | |
55 | like wpa_gui-qt4. | |
56 | ||
57 | ||
58 | wpa_cli starts in interactive mode if no command string is included on | |
59 | the command line. By default, it will select the first network interface | |
60 | that it can find (and that wpa_supplicant controls). If more than one | |
61 | interface is in use, it may be necessary to select one of the explicitly | |
62 | by adding -i argument on the command line (e.g., 'wpa_cli -i wlan1'). | |
63 | ||
64 | Most of the P2P operations are done on the main interface (e.g., the | |
65 | interface that is automatically added when the driver is loaded, e.g., | |
66 | wlan0). When using a separate virtual interface for group operations | |
67 | (e.g., wlan1), the control interface for that group interface may need | |
68 | to be used for some operations (mainly WPS activation in GO). This may | |
69 | change in the future so that all the needed operations could be done | |
70 | over the main control interface. | |
71 | ||
72 | Device Discovery | |
73 | ||
37448ede | 74 | p2p_find [timeout in seconds] [type=<social|progressive>] \ |
2b384109 | 75 | [dev_id=<addr>] [dev_type=<device type>] \ |
fa9f381f | 76 | [delay=<search delay in ms>] [seek=<service name>] [freq=<MHz>] |
f6b25ca5 JM |
77 | |
78 | The default behavior is to run a single full scan in the beginning and | |
79 | then scan only social channels. type=social will scan only social | |
80 | channels, i.e., it skips the initial full scan. type=progressive is | |
81 | like the default behavior, but it will scan through all the channels | |
82 | progressively one channel at the time in the Search state rounds. This | |
83 | will help in finding new groups or groups missed during the initial | |
fa9f381f DN |
84 | full scan. When the type parameter is not included (i.e., full scan), the |
85 | optional freq parameter can be used to override the first scan to use only | |
86 | the specified channel after which only social channels are scanned. | |
f6b25ca5 | 87 | |
37448ede JM |
88 | The optional dev_id option can be used to specify a single P2P peer to |
89 | search for. The optional delay parameter can be used to request an extra | |
90 | delay to be used between search iterations (e.g., to free up radio | |
91 | resources for concurrent operations). | |
92 | ||
2b384109 JM |
93 | The optional dev_type option can be used to specify a single device type |
94 | (primary or secondary) to search for, e.g., | |
95 | "p2p_find dev_type=1-0050F204-1". | |
96 | ||
f92446fb RR |
97 | |
98 | With one or more seek arguments, the command sends Probe Request frames | |
99 | for a P2PS service. For example, | |
100 | p2p_find 5 dev_id=11:22:33:44:55:66 seek=alt.example.chat seek=alt.example.video | |
101 | ||
102 | Parameters description: | |
103 | Timeout - Optional ASCII base-10-encoded u16. If missing, request will not | |
104 | time out and must be canceled manually | |
105 | dev_id - Optional to request responses from a single known remote device | |
106 | Service Name - Mandatory UTF-8 string for ASP seeks | |
107 | Service name must match the remote service being advertised exactly | |
108 | (no prefix matching). | |
109 | Service name may be empty, in which case all ASP services will be | |
110 | returned, and may be filtered with p2p_serv_disc_req settings, and | |
111 | p2p_serv_asp_resp results. | |
112 | Multiple service names may be requested, but if it exceeds internal | |
113 | limit, it will automatically revert to requesting all ASP services. | |
114 | ||
f6b25ca5 JM |
115 | p2p_listen [timeout in seconds] |
116 | ||
117 | Start Listen-only state (become discoverable without searching for | |
118 | other devices). Optional parameter can be used to specify the duration | |
119 | for the Listen operation in seconds. This command may not be of that | |
120 | much use during normal operations and is mainly designed for | |
121 | testing. It can also be used to keep the device discoverable without | |
122 | having to maintain a group. | |
123 | ||
124 | p2p_stop_find | |
125 | ||
126 | Stop ongoing P2P device discovery or other operation (connect, listen | |
127 | mode). | |
128 | ||
129 | p2p_flush | |
130 | ||
131 | Flush P2P peer table and state. | |
132 | ||
133 | Group Formation | |
134 | ||
0918c4bf | 135 | p2p_prov_disc <peer device address> <display|keypad|pbc> [join|auto] |
f6b25ca5 JM |
136 | |
137 | Send P2P provision discovery request to the specified peer. The | |
138 | parameters for this command are the P2P device address of the peer and | |
139 | the desired configuration method. For example, "p2p_prov_disc | |
140 | 02:01:02:03:04:05 display" would request the peer to display a PIN for | |
141 | us and "p2p_prov_disc 02:01:02:03:04:05 keypad" would request the peer | |
142 | to enter a PIN that we display. | |
143 | ||
8c5f7309 JJ |
144 | The optional "join" parameter can be used to indicate that this command |
145 | is requesting an already running GO to prepare for a new client. This is | |
0918c4bf JM |
146 | mainly used with "display" to request it to display a PIN. The "auto" |
147 | parameter can be used to request wpa_supplicant to automatically figure | |
148 | out whether the peer device is operating as a GO and if so, use | |
149 | join-a-group style PD instead of GO Negotiation style PD. | |
8c5f7309 | 150 | |
f92446fb | 151 | p2p_connect <peer device address> <pbc|pin|PIN#|p2ps> [display|keypad|p2ps] |
23c84252 | 152 | [persistent|persistent=<network id>] [join|auth] |
5b74e086 | 153 | [go_intent=<0..15>] [freq=<in MHz>] [ht40] [vht] [provdisc] [auto] |
f6b25ca5 JM |
154 | |
155 | Start P2P group formation with a discovered P2P peer. This includes | |
156 | optional group owner negotiation, group interface setup, provisioning, | |
157 | and establishing data connection. | |
158 | ||
159 | The <pbc|pin|PIN#> parameter specifies the WPS provisioning | |
160 | method. "pbc" string starts pushbutton method, "pin" string start PIN | |
161 | method using an automatically generated PIN (which will be returned as | |
162 | the command return code), PIN# means that a pre-selected PIN can be | |
61ff2c80 JM |
163 | used (e.g., 12345670). [display|keypad] is used with PIN method |
164 | to specify which PIN is used (display=dynamically generated random PIN | |
165 | from local display, keypad=PIN entered from peer display). "persistent" | |
23c84252 JM |
166 | parameter can be used to request a persistent group to be formed. The |
167 | "persistent=<network id>" alternative can be used to pre-populate | |
168 | SSID/passphrase configuration based on a previously used persistent | |
169 | group where this device was the GO. The previously used parameters will | |
170 | then be used if the local end becomes the GO in GO Negotiation (which | |
171 | can be forced with go_intent=15). | |
f6b25ca5 JM |
172 | |
173 | "join" indicates that this is a command to join an existing group as a | |
174 | client. It skips the GO Negotiation part. This will send a Provision | |
175 | Discovery Request message to the target GO before associating for WPS | |
176 | provisioning. | |
177 | ||
178 | "auth" indicates that the WPS parameters are authorized for the peer | |
179 | device without actually starting GO Negotiation (i.e., the peer is | |
180 | expected to initiate GO Negotiation). This is mainly for testing | |
181 | purposes. | |
182 | ||
183 | "go_intent" can be used to override the default GO Intent for this GO | |
184 | Negotiation. | |
185 | ||
186 | "freq" can be used to set a forced operating channel (e.g., freq=2412 | |
187 | to select 2.4 GHz channel 1). | |
188 | ||
3bc462cb JM |
189 | "provdisc" can be used to request a Provision Discovery exchange to be |
190 | used prior to starting GO Negotiation as a workaround with some deployed | |
191 | P2P implementations that require this to allow the user to accept the | |
192 | connection. | |
193 | ||
5b74e086 JM |
194 | "auto" can be used to request wpa_supplicant to automatically figure |
195 | out whether the peer device is operating as a GO and if so, use | |
196 | join-a-group operation rather than GO Negotiation. | |
197 | ||
f92446fb RR |
198 | P2PS attribute changes to p2p_connect command: |
199 | ||
200 | P2PS supports two WPS provisioning methods namely PIN method and P2PS default. | |
201 | The remaining paramters hold same role as in legacy P2P. In case of P2PS default | |
202 | config method "p2ps" keyword is added in p2p_connect command. | |
203 | ||
204 | For example: | |
205 | p2p_connect 02:0a:f5:85:11:00 12345670 p2ps persistent join | |
206 | (WPS Method = P2PS default) | |
207 | ||
208 | p2p_connect 02:0a:f5:85:11:00 45629034 keypad persistent | |
209 | (WPS Method = PIN) | |
210 | ||
211 | p2p_asp_provision <peer MAC address> <adv_id=peer adv id> | |
212 | <adv_mac=peer MAC address> [role=2|4|1] <session=session id> | |
213 | <session_mac=initiator mac address> | |
214 | [info='service info'] <method=Default|keypad|Display> | |
215 | ||
216 | This command starts provision discovery with the P2PS enabled peer device. | |
217 | ||
218 | For example, | |
219 | p2p_asp_provision 00:11:22:33:44:55 adv_id=4d6fc7 adv_mac=00:55:44:33:22:11 role=1 session=12ab34 session_mac=00:11:22:33:44:55 info='name=john' method=1000 | |
220 | ||
221 | Parameter description: | |
222 | MAC address - Mandatory | |
223 | adv_id - Mandatory remote Advertising ID of service connection is being | |
224 | established for | |
225 | adv_mac - Mandatory MAC address that owns/registered the service | |
226 | role - Optional | |
227 | 2 (group client only) or 4 (group owner only) | |
228 | if not present (or 1) role is negotiated by the two peers. | |
229 | session - Mandatory Session ID of the first session to be established | |
230 | session_mac - Mandatory MAC address that owns/initiated the session | |
231 | method - Optional method to request for provisioning (1000 - P2PS Default, | |
232 | 100 - Keypad(PIN), 8 - Display(PIN)) | |
233 | info - Optional UTF-8 string. Hint for service to indicate possible usage | |
234 | parameters - Escape single quote & backslash: | |
235 | with a backslash 0x27 == ' == \', and 0x5c == \ == \\ | |
236 | ||
237 | p2p_asp_provision_resp <peer mac address> <adv_id= local adv id> | |
238 | <adv_mac=local MAC address> <role=1|2|4> <status=0> | |
239 | <session=session id> <session_mac=peer MAC address> | |
240 | ||
241 | This command sends a provision discovery response from responder side. | |
242 | ||
243 | For example, | |
244 | p2p_asp_provision_resp 00:55:44:33:22:11 adv_id=4d6fc7 adv_mac=00:55:44:33:22:11 role=1 status=0 session=12ab34 session_mac=00:11:22:33:44:55 | |
245 | ||
246 | Parameters definition: | |
247 | MAC address - Mandatory | |
248 | adv_id - Mandatory local Advertising ID of service connection is being | |
249 | established for | |
250 | adv_mac - Mandatory MAC address that owns/registered the service | |
251 | role - Optional 2 (group client only) or 4 (group owner only) | |
252 | if not present (or 1) role is negotiated by the two peers. | |
253 | status - Mandatory Acceptance/Rejection code of Provisioning | |
254 | session - Mandatory Session ID of the first session to be established | |
255 | session_mac - Mandatory MAC address that owns/initiated the session | |
256 | ||
20ea1ca4 EP |
257 | p2p_group_add [persistent|persistent=<network id>] [freq=<freq in MHz>] |
258 | [ht40] [vht] | |
f6b25ca5 JM |
259 | |
260 | Set up a P2P group owner manually (i.e., without group owner | |
261 | negotiation with a specific peer). This is also known as autonomous | |
262 | GO. Optional persistent=<network id> can be used to specify restart of | |
263 | a persistent group. Optional freq=<freq in MHz> can be used to force | |
264 | the GO to be started on a specific frequency. Special freq=2 or freq=5 | |
265 | options can be used to request the best 2.4 GHz or 5 GHz band channel | |
266 | to be selected automatically. | |
267 | ||
268 | p2p_reject <peer device address> | |
269 | ||
270 | Reject connection attempt from a peer (specified with a device | |
271 | address). This is a mechanism to reject a pending GO Negotiation with | |
272 | a peer and request to automatically block any further connection or | |
273 | discovery of the peer. | |
274 | ||
275 | p2p_group_remove <group interface> | |
276 | ||
277 | Terminate a P2P group. If a new virtual network interface was used for | |
278 | the group, it will also be removed. The network interface name of the | |
279 | group interface is used as a parameter for this command. | |
280 | ||
281 | p2p_cancel | |
282 | ||
058da39c JM |
283 | Cancel an ongoing P2P group formation and joining-a-group related |
284 | operation. This operations unauthorizes the specific peer device (if any | |
285 | had been authorized to start group formation), stops P2P find (if in | |
286 | progress), stops pending operations for join-a-group, and removes the | |
287 | P2P group interface (if one was used) that is in the WPS provisioning | |
288 | step. If the WPS provisioning step has been completed, the group is not | |
289 | terminated. | |
f6b25ca5 | 290 | |
eac8dab8 JM |
291 | p2p_remove_client <peer's P2P Device Address|iface=<interface address>> |
292 | ||
293 | This command can be used to remove the specified client from all groups | |
294 | (operating and persistent) from the local GO. Note that the peer device | |
295 | can rejoin the group if it is in possession of a valid key. See p2p_set | |
296 | per_sta_psk command below for more details on how the peer can be | |
297 | removed securely. | |
298 | ||
f6b25ca5 JM |
299 | Service Discovery |
300 | ||
f92446fb RR |
301 | p2p_service_add asp <auto accept> <adv id> <status 0/1> <Config Methods> |
302 | <Service name> [Service Information] [Response Info] | |
303 | ||
304 | This command can be used to search for a P2PS service which includes | |
305 | Play, Send, Display, and Print service. The parameters for this command | |
306 | are "asp" to identify the command as P2PS one, auto accept value, | |
307 | advertisement id which uniquely identifies the service requests, state | |
308 | of the service whether the service is available or not, config methods | |
309 | which can be either P2PS method or PIN method, service name followed by | |
310 | two optional parameters service information, and response info. | |
311 | ||
312 | For example, | |
313 | p2p_service_add asp 1 4d6fc7 0 1108 alt.example.chat svc_info='name=john' rsp_info='enter PIN 1234' | |
314 | ||
315 | Parameters definition: | |
316 | asp - Mandatory for ASP service registration | |
317 | auto accept - Mandatory ASCII hex-encoded boolean (0 == no auto-accept, | |
318 | 1 == auto-accept ANY role, 2 == auto-accept CLIENT role, | |
319 | 4 == auto-accept GO role) | |
320 | Advertisement ID - Mandatory non-zero ASCII hex-encoded u32 | |
321 | (Must be unique/not yet exist in svc db) | |
322 | State - Mandatory ASCII hex-encoded u8 (0 -- Svc not available, | |
323 | 1 -- Svc available, 2-0xff Application defined) | |
324 | Config Methods - Mandatory ASCII hex-encoded u16 (bitmask of WSC config | |
325 | methods) | |
326 | Service Name - Mandatory UTF-8 string | |
327 | Service Information - Optional UTF-8 string | |
328 | Escape single quote & backslash with a backslash: | |
329 | 0x27 == ' == \', and 0x5c == \ == \\ | |
330 | Session response information - Optional (used only if auto accept is TRUE) | |
331 | UTF-8 string | |
332 | Escape single quote & backslash with a backslash: | |
333 | 0x27 == ' == \', and 0x5c == \ == \\ | |
334 | ||
335 | p2p_service_rep asp <auto accept> <adv id> <status 0/1> <Config Methods> | |
336 | <Service name> [Service Information] [Response Info] | |
337 | ||
338 | This command can be used to replace the existing service request | |
339 | attributes from the initiator side. The replacement is only allowed if | |
340 | the advertisement id issued in the command matches with any one entry in | |
341 | the list of existing SD queries. If advertisement id doesn't match the | |
342 | command returns a failure. | |
343 | ||
344 | For example, | |
345 | p2p_service_rep asp 1 4d6fc7 1 1108 alt.example.chat svc_info='name=john' rsp_info='enter PIN 1234' | |
346 | ||
347 | Parameters definition: | |
348 | asp - Mandatory for ASP service registration | |
349 | auto accept - Mandatory ASCII hex-encoded boolean (1 == true, 0 == false) | |
350 | Advertisement ID - Mandatory non-zero ASCII hex-encoded u32 | |
351 | (Must already exist in svc db) | |
352 | State - Mandatory ASCII hex-encoded u8 (can be used to indicate svc | |
353 | available or not available for instance) | |
354 | Config Methods - Mandatory ASCII hex-encoded u16 (bitmask of WSC config | |
355 | methods) | |
356 | Service Name - Mandatory UTF-8 string (Must match existing string in svc db) | |
357 | Service Information - Optional UTF-8 string | |
358 | Escape single quote & backslash with a backslash: | |
359 | 0x27 == ' == \', and 0x5c == \ == \\ | |
360 | Session response information - Optional (used only if auto accept is TRUE) | |
361 | UTF-8 string | |
362 | Escape single quote & backslash with a backslash: | |
363 | 0x27 == ' == \', and 0x5c == \ == \\ | |
364 | ||
f6b25ca5 JM |
365 | p2p_serv_disc_req |
366 | ||
367 | Schedule a P2P service discovery request. The parameters for this | |
368 | command are the device address of the peer device (or 00:00:00:00:00:00 | |
369 | for wildcard query that is sent to every discovered P2P peer that | |
370 | supports service discovery) and P2P Service Query TLV(s) as hexdump. For | |
371 | example, | |
372 | ||
373 | p2p_serv_disc_req 00:00:00:00:00:00 02000001 | |
374 | ||
375 | schedules a request for listing all available services of all service | |
376 | discovery protocols and requests this to be sent to all discovered | |
377 | peers (note: this can result in long response frames). The pending | |
378 | requests are sent during device discovery (see p2p_find). | |
379 | ||
f667e031 JJ |
380 | There can be multiple pending peer device specific queries (each will be |
381 | sent in sequence whenever the peer is found). | |
f6b25ca5 JM |
382 | |
383 | This command returns an identifier for the pending query (e.g., | |
384 | "1f77628") that can be used to cancel the request. Directed requests | |
385 | will be automatically removed when the specified peer has replied to | |
386 | it. | |
387 | ||
9aadb877 JM |
388 | Service Query TLV has following format: |
389 | Length (2 octets, little endian) - length of following data | |
390 | Service Protocol Type (1 octet) - see the table below | |
391 | Service Transaction ID (1 octet) - nonzero identifier for the TLV | |
392 | Query Data (Length - 2 octets of data) - service protocol specific data | |
393 | ||
394 | Service Protocol Types: | |
395 | 0 = All service protocols | |
396 | 1 = Bonjour | |
397 | 2 = UPnP | |
398 | 3 = WS-Discovery | |
399 | 4 = Wi-Fi Display | |
400 | ||
f6b25ca5 JM |
401 | For UPnP, an alternative command format can be used to specify a |
402 | single query TLV (i.e., a service discovery for a specific UPnP | |
403 | service): | |
404 | ||
405 | p2p_serv_disc_req 00:00:00:00:00:00 upnp <version hex> <ST: from M-SEARCH> | |
406 | ||
407 | For example: | |
408 | ||
409 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:device:InternetGatewayDevice:1 | |
410 | ||
411 | Additional examples for queries: | |
412 | ||
413 | # list of all Bonjour services | |
414 | p2p_serv_disc_req 00:00:00:00:00:00 02000101 | |
415 | ||
416 | # list of all UPnP services | |
417 | p2p_serv_disc_req 00:00:00:00:00:00 02000201 | |
418 | ||
419 | # list of all WS-Discovery services | |
420 | p2p_serv_disc_req 00:00:00:00:00:00 02000301 | |
421 | ||
422 | # list of all Bonjour and UPnP services | |
423 | p2p_serv_disc_req 00:00:00:00:00:00 0200010102000202 | |
424 | ||
425 | # Apple File Sharing over TCP | |
426 | p2p_serv_disc_req 00:00:00:00:00:00 130001010b5f6166706f766572746370c00c000c01 | |
427 | ||
428 | # Bonjour SSTH (supported service type hash) | |
429 | p2p_serv_disc_req 00:00:00:00:00:00 05000101000000 | |
430 | ||
431 | # UPnP examples | |
432 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 ssdp:all | |
433 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 upnp:rootdevice | |
434 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:service:ContentDirectory:2 | |
435 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 uuid:6859dede-8574-59ab-9332-123456789012 | |
436 | p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:device:InternetGatewayDevice:1 | |
437 | ||
347d6a5b JM |
438 | # Wi-Fi Display examples |
439 | # format: wifi-display <list of roles> <list of subelements> | |
440 | p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source] 2,3,4,5 | |
441 | p2p_serv_disc_req 02:01:02:03:04:05 wifi-display [pri-sink] 3 | |
442 | p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [sec-source] 2 | |
443 | p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source+sink] 2,3,4,5 | |
444 | p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source][pri-sink] 2,3,4,5 | |
445 | ||
f92446fb RR |
446 | p2p_serv_disc_req <Unicast|Broadcast mac address> asp <Transaction ID> |
447 | <Service Name> [Service Information] | |
448 | ||
449 | The command can be used for service discovery for P2PS enabled devices. | |
450 | ||
451 | For example: p2p_serv_disc_req 00:00:00:00:00:00 asp a1 alt.example 'john' | |
452 | ||
453 | Parameters definition: | |
454 | MAC address - Mandatory Existing | |
455 | asp - Mandatory for ASP queries | |
456 | Transaction ID - Mandatory non-zero ASCII hex-encoded u8 for GAS | |
457 | Service Name Prefix - Mandatory UTF-8 string. | |
458 | Will match from beginning of remote Service Name | |
459 | Service Information Substring - Optional UTF-8 string | |
460 | If Service Information Substring is not included, all services matching | |
461 | Service Name Prefix will be returned. | |
462 | If Service Information Substring is included, both the Substring and the | |
463 | Service Name Prefix must match for service to be returned. | |
464 | If remote service has no Service Information, all Substring searches | |
465 | will fail. | |
466 | ||
f6b25ca5 JM |
467 | p2p_serv_disc_cancel_req <query identifier> |
468 | ||
469 | Cancel a pending P2P service discovery request. This command takes a | |
470 | single parameter: identifier for the pending query (the value returned | |
471 | by p2p_serv_disc_req, e.g., "p2p_serv_disc_cancel_req 1f77628". | |
472 | ||
473 | p2p_serv_disc_resp | |
474 | ||
475 | Reply to a service discovery query. This command takes following | |
476 | parameters: frequency in MHz, destination address, dialog token, | |
477 | response TLV(s). The first three parameters are copied from the | |
478 | request event. For example, "p2p_serv_disc_resp 2437 02:40:61:c2:f3:b7 | |
479 | 1 0300000101". This command is used only if external program is used | |
480 | to process the request (see p2p_serv_disc_external). | |
481 | ||
482 | p2p_service_update | |
483 | ||
484 | Indicate that local services have changed. This is used to increment | |
485 | the P2P service indicator value so that peers know when previously | |
486 | cached information may have changed. This is only needed when external | |
487 | service discovery processing is enabled since the commands to | |
488 | pre-configure services for internal processing will increment the | |
489 | indicator automatically. | |
490 | ||
491 | p2p_serv_disc_external <0|1> | |
492 | ||
493 | Configure external processing of P2P service requests: 0 (default) = | |
494 | no external processing of requests (i.e., internal code will process | |
495 | each request based on pre-configured services), 1 = external | |
496 | processing of requests (external program is responsible for replying | |
497 | to service discovery requests with p2p_serv_disc_resp). Please note | |
498 | that there is quite strict limit on how quickly the response needs to | |
499 | be transmitted, so use of the internal processing is strongly | |
500 | recommended. | |
501 | ||
502 | p2p_service_add bonjour <query hexdump> <RDATA hexdump> | |
503 | ||
504 | Add a local Bonjour service for internal SD query processing. | |
505 | ||
506 | Examples: | |
507 | ||
508 | # AFP Over TCP (PTR) | |
509 | p2p_service_add bonjour 0b5f6166706f766572746370c00c000c01 074578616d706c65c027 | |
510 | # AFP Over TCP (TXT) (RDATA=null) | |
511 | p2p_service_add bonjour 076578616d706c650b5f6166706f766572746370c00c001001 00 | |
512 | ||
513 | # IP Printing over TCP (PTR) (RDATA=MyPrinter._ipp._tcp.local.) | |
514 | p2p_service_add bonjour 045f697070c00c000c01 094d795072696e746572c027 | |
515 | # IP Printing over TCP (TXT) (RDATA=txtvers=1,pdl=application/postscript) | |
516 | p2p_service_add bonjour 096d797072696e746572045f697070c00c001001 09747874766572733d311a70646c3d6170706c69636174696f6e2f706f7374736372797074 | |
517 | ||
518 | # Supported Service Type Hash (SSTH) | |
519 | p2p_service_add bonjour 000000 <32-byte bitfield as hexdump> | |
520 | (note: see P2P spec Annex E.4 for information on how to construct the bitfield) | |
521 | ||
522 | p2p_service_del bonjour <query hexdump> | |
523 | ||
524 | Remove a local Bonjour service from internal SD query processing. | |
525 | ||
526 | p2p_service_add upnp <version hex> <service> | |
527 | ||
528 | Add a local UPnP service for internal SD query processing. | |
529 | ||
530 | Examples: | |
531 | ||
532 | p2p_service_add upnp 10 uuid:6859dede-8574-59ab-9332-123456789012::upnp:rootdevice | |
533 | p2p_service_add upnp 10 uuid:5566d33e-9774-09ab-4822-333456785632::upnp:rootdevice | |
534 | p2p_service_add upnp 10 uuid:1122de4e-8574-59ab-9322-333456789044::urn:schemas-upnp-org:service:ContentDirectory:2 | |
535 | p2p_service_add upnp 10 uuid:5566d33e-9774-09ab-4822-333456785632::urn:schemas-upnp-org:service:ContentDirectory:2 | |
536 | p2p_service_add upnp 10 uuid:6859dede-8574-59ab-9332-123456789012::urn:schemas-upnp-org:device:InternetGatewayDevice:1 | |
537 | ||
538 | p2p_service_del upnp <version hex> <service> | |
539 | ||
540 | Remove a local UPnP service from internal SD query processing. | |
541 | ||
f92446fb RR |
542 | p2p_service_del asp <adv id> |
543 | ||
544 | Removes the local asp service from internal SD query list. | |
545 | For example: p2p_service_del asp 4d6fc7 | |
546 | ||
f6b25ca5 JM |
547 | p2p_service_flush |
548 | ||
549 | Remove all local services from internal SD query processing. | |
550 | ||
551 | Invitation | |
552 | ||
553 | p2p_invite [persistent=<network id>|group=<group ifname>] [peer=address] | |
20ea1ca4 EP |
554 | [go_dev_addr=address] [freq=<freq in MHz>] [ht40] [vht] |
555 | [pref=<MHz>] | |
f6b25ca5 JM |
556 | |
557 | Invite a peer to join a group (e.g., group=wlan1) or to reinvoke a | |
558 | persistent group (e.g., persistent=4). If the peer device is the GO of | |
781d8e0f | 559 | the persistent group, the peer parameter is not needed. Otherwise it is |
f6b25ca5 JM |
560 | used to specify which device to invite. go_dev_addr parameter can be |
561 | used to override the GO device address for Invitation Request should | |
562 | it be not known for some reason (this should not be needed in most | |
4d32c0c4 | 563 | cases). When reinvoking a persistent group, the GO device can specify |
f5877af0 JM |
564 | the frequency for the group with the freq parameter. When reinvoking a |
565 | persistent group, the P2P client device can use freq parameter to force | |
566 | a specific operating channel (or invitation failure if GO rejects that) | |
567 | or pref parameter to request a specific channel (while allowing GO to | |
568 | select to use another channel, if needed). | |
f6b25ca5 JM |
569 | |
570 | Group Operations | |
571 | ||
572 | (These are used on the group interface.) | |
573 | ||
574 | wps_pin <any|address> <PIN> | |
575 | ||
576 | Start WPS PIN method. This allows a single WPS Enrollee to connect to | |
577 | the AP/GO. This is used on the GO when a P2P client joins an existing | |
578 | group. The second parameter is the address of the Enrollee or a string | |
579 | "any" to allow any station to use the entered PIN (which will restrict | |
580 | the PIN for one-time-use). PIN is the Enrollee PIN read either from a | |
581 | label or display on the P2P Client/WPS Enrollee. | |
582 | ||
583 | wps_pbc | |
584 | ||
585 | Start WPS PBC method (i.e., push the button). This allows a single WPS | |
586 | Enrollee to connect to the AP/GO. This is used on the GO when a P2P | |
587 | client joins an existing group. | |
588 | ||
589 | p2p_get_passphrase | |
590 | ||
591 | Get the passphrase for a group (only available when acting as a GO). | |
592 | ||
593 | p2p_presence_req [<duration> <interval>] [<duration> <interval>] | |
594 | ||
595 | Send a P2P Presence Request to the GO (this is only available when | |
596 | acting as a P2P client). If no duration/interval pairs are given, the | |
597 | request indicates that this client has no special needs for GO | |
c64e3a08 | 598 | presence. The first parameter pair gives the preferred duration and |
f6b25ca5 | 599 | interval values in microseconds. If the second pair is included, that |
c64e3a08 JM |
600 | indicates which value would be acceptable. This command returns OK |
601 | immediately and the response from the GO is indicated in a | |
602 | P2P-PRESENCE-RESPONSE event message. | |
f6b25ca5 JM |
603 | |
604 | Parameters | |
605 | ||
606 | p2p_ext_listen [<period> <interval>] | |
607 | ||
608 | Configure Extended Listen Timing. If the parameters are omitted, this | |
609 | feature is disabled. If the parameters are included, Listen State will | |
610 | be entered every interval msec for at least period msec. Both values | |
611 | have acceptable range of 1-65535 (with interval obviously having to be | |
612 | larger than or equal to duration). If the P2P module is not idle at | |
613 | the time the Extended Listen Timing timeout occurs, the Listen State | |
614 | operation will be skipped. | |
615 | ||
616 | The configured values will also be advertised to other P2P Devices. The | |
617 | received values are available in the p2p_peer command output: | |
618 | ||
619 | ext_listen_period=100 ext_listen_interval=5000 | |
620 | ||
621 | p2p_set <field> <value> | |
622 | ||
623 | Change dynamic P2P parameters | |
624 | ||
625 | p2p_set discoverability <0/1> | |
626 | ||
627 | Disable/enable advertisement of client discoverability. This is | |
628 | enabled by default and this parameter is mainly used to allow testing | |
629 | of device discoverability. | |
630 | ||
631 | p2p_set managed <0/1> | |
632 | ||
633 | Disable/enable managed P2P Device operations. This is disabled by | |
634 | default. | |
635 | ||
636 | p2p_set listen_channel <1/6/11> | |
637 | ||
638 | Set P2P Listen channel. This is mainly meant for testing purposes and | |
639 | changing the Listen channel during normal operations can result in | |
640 | protocol failures. | |
641 | ||
642 | p2p_set ssid_postfix <postfix> | |
643 | ||
644 | Set postfix string to be added to the automatically generated P2P SSID | |
645 | (DIRECT-<two random characters>). For example, postfix of "-testing" | |
646 | could result in the SSID becoming DIRECT-ab-testing. | |
647 | ||
eac8dab8 JM |
648 | p2p_set per_sta_psk <0/1> |
649 | ||
650 | Disabled(default)/enables use of per-client PSK in the P2P groups. This | |
651 | can be used to request GO to assign a unique PSK for each client during | |
652 | WPS provisioning. When enabled, this allow clients to be removed from | |
653 | the group securily with p2p_remove_client command since that client's | |
654 | PSK is removed at the same time to prevent it from connecting back using | |
655 | the old PSK. When per-client PSK is not used, the client can still be | |
656 | disconnected, but it will be able to re-join the group since the PSK it | |
657 | learned previously is still valid. It should be noted that the default | |
658 | passphrase on the GO that is normally used to allow legacy stations to | |
659 | connect through manual configuration does not change here, so if that is | |
660 | shared, devices with knowledge of that passphrase can still connect. | |
661 | ||
f6b25ca5 JM |
662 | set <field> <value> |
663 | ||
664 | Set global configuration parameters which may also affect P2P | |
665 | operations. The format on these parameters is same as is used in | |
666 | wpa_supplicant.conf. Only the parameters listen here should be | |
667 | changed. Modifying other parameters may result in incorrect behavior | |
668 | since not all existing users of the parameters are updated. | |
669 | ||
670 | set uuid <UUID> | |
671 | ||
672 | Set WPS UUID (by default, this is generated based on the MAC address). | |
673 | ||
674 | set device_name <device name> | |
675 | ||
676 | Set WPS Device Name (also included in some P2P messages). | |
677 | ||
678 | set manufacturer <manufacturer> | |
679 | ||
680 | Set WPS Manufacturer. | |
681 | ||
682 | set model_name <model name> | |
683 | ||
684 | Set WPS Model Name. | |
685 | ||
686 | set model_number <model number> | |
687 | ||
688 | Set WPS Model Number. | |
689 | ||
690 | set serial_number <serial number> | |
691 | ||
692 | Set WPS Serial Number. | |
693 | ||
694 | set device_type <device type> | |
695 | ||
696 | Set WPS Device Type. | |
697 | ||
698 | set os_version <OS version> | |
699 | ||
700 | Set WPS OS Version. | |
701 | ||
702 | set config_methods <config methods> | |
703 | ||
704 | Set WPS Configuration Methods. | |
705 | ||
706 | set sec_device_type <device type> | |
707 | ||
708 | Add a new Secondary Device Type. | |
709 | ||
710 | set p2p_go_intent <GO intent> | |
711 | ||
712 | Set the default P2P GO Intent. Note: This value can be overridden in | |
713 | p2p_connect command and as such, there should be no need to change the | |
714 | default value here during normal operations. | |
715 | ||
716 | set p2p_ssid_postfix <P2P SSID postfix> | |
717 | ||
718 | Set P2P SSID postfix. | |
719 | ||
720 | set persistent_reconnect <0/1> | |
721 | ||
722 | Disable/enabled persistent reconnect for reinvocation of persistent | |
723 | groups. If enabled, invitations to reinvoke a persistent group will be | |
724 | accepted without separate authorization (e.g., user interaction). | |
725 | ||
726 | set country <two character country code> | |
727 | ||
728 | Set country code (this is included in some P2P messages). | |
729 | ||
d3b20469 NS |
730 | set p2p_search_delay <delay> |
731 | ||
732 | Set p2p_search_delay which adds extra delay in milliseconds between | |
733 | concurrent search iterations to make p2p_find friendlier to concurrent | |
734 | operations by avoiding it from taking 100% of radio resources. The | |
735 | default value is 500 ms. | |
736 | ||
f6b25ca5 JM |
737 | Status |
738 | ||
739 | p2p_peers [discovered] | |
740 | ||
741 | List P2P Device Addresses of all the P2P peers we know. The optional | |
742 | "discovered" parameter filters out the peers that we have not fully | |
743 | discovered, i.e., which we have only seen in a received Probe Request | |
744 | frame. | |
745 | ||
746 | p2p_peer <P2P Device Address> | |
747 | ||
748 | Fetch information about a known P2P peer. | |
749 | ||
750 | Group Status | |
751 | ||
752 | (These are used on the group interface.) | |
753 | ||
754 | status | |
755 | ||
756 | Show status information (connection state, role, use encryption | |
757 | parameters, IP address, etc.). | |
758 | ||
759 | sta | |
760 | ||
761 | Show information about an associated station (when acting in AP/GO role). | |
762 | ||
763 | all_sta | |
764 | ||
765 | Lists the currently associated stations. | |
766 | ||
767 | Configuration data | |
768 | ||
769 | list_networks | |
770 | ||
771 | Lists the configured networks, including stored information for | |
772 | persistent groups. The identifier in this list is used with | |
773 | p2p_group_add and p2p_invite to indicate which persistent group is to | |
774 | be reinvoked. | |
775 | ||
776 | remove_network <network id> | |
777 | ||
778 | Remove a network entry from configuration. | |
779 | ||
780 | ||
f92446fb RR |
781 | P2PS Events/Responses: |
782 | ||
783 | P2PS-PROV-START: This events gets triggered when provisioning is issued for | |
784 | either seeker or advertiser. | |
785 | ||
786 | For example, | |
787 | P2PS-PROV-START 00:55:44:33:22:11 adv_id=111 adv_mac=00:55:44:33:22:11 conncap=1 session=1234567 session_mac=00:11:22:33:44:55 info='xxxx' | |
788 | ||
789 | Parameters definition: | |
790 | MAC address - always | |
791 | adv_id - always ASCII hex-encoded u32 | |
792 | adv_mac - always MAC address that owns/registered the service | |
793 | conncap - always mask of 0x01 (new), 0x02 (group client), 0x04 (group owner) | |
794 | bits | |
795 | session - always Session ID of the first session to be established | |
796 | session_mac - always MAC address that owns/initiated the session | |
797 | info - if available, UTF-8 string | |
798 | Escaped single quote & backslash with a backslash: | |
799 | \' == 0x27 == ', and \\ == 0x5c == \ | |
800 | ||
801 | P2PS-PROV-DONE: When provisioning is completed then this event gets triggered. | |
802 | ||
803 | For example, | |
804 | P2PS-PROV-DONE 00:11:22:33:44:55 status=0 adv_id=111 adv_mac=00:55:44:33:22:11 conncap=1 session=1234567 session_mac=00:11:22:33:44:55 [dev_passwd_id=8 | go=p2p-wlan0-0 | join=11:22:33:44:55:66 | persist=0] | |
805 | ||
806 | Parameters definition: | |
807 | MAC address - always main device address of peer. May be different from MAC | |
808 | ultimately connected to. | |
809 | status - always ascii hex-encoded u8 (0 == success, 12 == deferred success) | |
810 | adv_id - always ascii hex-encoded u32 | |
811 | adv_mac - always MAC address that owns/registered the service | |
812 | conncap - always One of: 1 (new), 2 (group client), 4 (group owner) bits | |
813 | session - always Session ID of the first session to be established | |
814 | session_mac - always MAC address that owns/initiated the session | |
815 | dev_passwd_id - only if conncap value == 1 (New GO negotiation) | |
816 | 8 - "p2ps" password must be passed in p2p_connect command | |
817 | 1 - "display" password must be passed in p2p_connect command | |
818 | 5 - "keypad" password must be passed in p2p_connect command | |
819 | join only - if conncap value == 2 (Client Only). Display password and "join" | |
820 | must be passed in p2p_connect and address must be the MAC specified | |
821 | go only - if conncap value == 4 (GO Only). Interface name must be set with a | |
822 | password | |
823 | persist - only if previous persistent group existed between peers and shall | |
824 | be re-used. Group is restarted by sending "p2p_group_add persistent=0" | |
825 | where value is taken from P2P-PROV-DONE | |
826 | ||
827 | Extended Events/Response | |
828 | ||
829 | P2P-DEVICE-FOUND 00:11:22:33:44:55 p2p_dev_addr=00:11:22:33:44:55 pri_dev_type=0-00000000-0 name='' config_methods=0x108 dev_capab=0x21 group_capab=0x0 adv_id=111 asp_svc=alt.example.chat | |
830 | ||
831 | Parameters definition: | |
832 | adv_id - if ASP ASCII hex-encoded u32. If it is reporting the | |
833 | "wildcard service", this value will be 0 | |
834 | asp_svc - if ASP this is the service string. If it is reporting the | |
835 | "wildcard service", this value will be org.wi-fi.wfds | |
836 | ||
837 | ||
f6b25ca5 JM |
838 | wpa_cli action script |
839 | --------------------- | |
840 | ||
841 | See examples/p2p-action.sh | |
842 | ||
843 | TODO: describe DHCP/DNS setup | |
844 | TODO: cross-connection |