Lines Matching +full:on +full:- +full:the +full:- +full:go
1 wpa_supplicant and Wi-Fi P2P
4 This document describes how the Wi-Fi P2P implementation in
5 wpa_supplicant can be configured and how an external component on the
10 Introduction to Wi-Fi P2P
11 -------------------------
15 More information about Wi-Fi P2P is available from Wi-Fi Alliance:
16 http://www.wi-fi.org/Wi-Fi_Direct.php
20 -----------------------------
26 ----------------------------
28 Wi-Fi P2P is an optional component that needs to be enabled in the
30 configuration that includes Wi-Fi P2P support and Linux nl80211
31 -based driver interface:
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,
47 device_type=1-0050F204-1
51 -------
53 Actual Wi-Fi P2P operations are requested during runtime. These can be
55 like wpa_gui-qt4.
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
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').
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.,
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.
78 The default behavior is to run a single full scan in the beginning and
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
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.
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
93 The optional dev_type option can be used to specify a single device type
95 "p2p_find dev_type=1-0050F204-1".
98 With one or more seek arguments, the command sends Probe Request frames
103 Timeout - Optional ASCII base-10-encoded u16. If missing, request will not
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
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
121 testing. It can also be used to keep the device discoverable without
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
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
146 mainly used with "display" to request it to display a PIN. The "auto"
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.
160 The <pbc|pin|PIN#> parameter specifies the WPS provisioning
163 the command return code), PIN# means that a pre-selected PIN can be
167 parameter can be used to request a persistent group to be formed. The
168 "persistent=<network id>" alternative can be used to pre-populate
169 SSID/passphrase configuration based on a previously used persistent
170 group where this device was the GO. The previously used parameters will
171 then be used if the local end becomes the GO in GO Negotiation (which
175 client. It skips the GO Negotiation part. This will send a Provision
176 Discovery Request message to the target GO before associating for WPS
179 "auth" indicates that the WPS parameters are authorized for the peer
180 device without actually starting GO Negotiation (i.e., the peer is
181 expected to initiate GO Negotiation). This is mainly for testing
184 "go_intent" can be used to override the default GO Intent for this GO
191 used prior to starting GO Negotiation as a workaround with some deployed
192 P2P implementations that require this to allow the user to accept the
196 out whether the peer device is operating as a GO and if so, use
197 join-a-group operation rather than GO Negotiation.
199 "ssid=<hexdump>" can be used to specify the Group SSID for join
200 operations. This allows the P2P Client interface to filter scan results
201 based on SSID to avoid selecting an incorrect BSS entry in case the same
208 The remaining parameters hold same role as in legacy P2P. In case of P2PS
223 This command starts provision discovery with the P2PS enabled peer device.
229 MAC address - Mandatory
230 adv_id - Mandatory remote Advertising ID of service connection is being
232 adv_mac - Mandatory MAC address that owns/registered the service
233 role - Optional
235 if not present (or 1) role is negotiated by the two peers.
236 session - Mandatory Session ID of the first session to be established
237 session_mac - Mandatory MAC address that owns/initiated the session
238 method - Optional method to request for provisioning (1000 - P2PS Default,
239 100 - Keypad(PIN), 8 - Display(PIN))
240 info - Optional UTF-8 string. Hint for service to indicate possible usage
241 parameters - Escape single quote & backslash:
254 MAC address - Mandatory
255 adv_id - Mandatory local Advertising ID of service connection is being
257 adv_mac - Mandatory MAC address that owns/registered the service
258 role - Optional 2 (group client only) or 4 (group owner only)
259 if not present (or 1) role is negotiated by the two peers.
260 status - Mandatory Acceptance/Rejection code of Provisioning
261 session - Mandatory Session ID of the first session to be established
262 session_mac - Mandatory MAC address that owns/initiated the session
269 GO. Optional persistent=<network id> can be used to specify restart of
271 the GO to be started on a specific frequency. Special freq=2 or freq=5
272 options can be used to request the best 2.4 GHz or 5 GHz band channel
278 address). This is a mechanism to reject a pending GO Negotiation with
280 discovery of the peer.
285 the group, it will also be removed. The network interface name of the
290 Cancel an ongoing P2P group formation and joining-a-group related
291 operation. This operation unauthorizes the specific peer device (if any
293 progress), stops pending operations for join-a-group, and removes the
294 P2P group interface (if one was used) that is in the WPS provisioning
295 step. If the WPS provisioning step has been completed, the group is not
300 This command can be used to remove the specified client from all groups
301 (operating and persistent) from the local GO. Note that the peer device
302 can rejoin the group if it is in possession of a valid key. See p2p_set
303 per_sta_psk command below for more details on how the peer can be
312 Play, Send, Display, and Print service. The parameters for this command
313 are "asp" to identify the command as P2PS one, auto accept value,
314 advertisement id which uniquely identifies the service requests, state
315 of the service whether the service is available or not, config methods
323 asp - Mandatory for ASP service registration
324 auto accept - Mandatory ASCII hex-encoded boolean (0 == no auto-accept,
325 1 == auto-accept ANY role, 2 == auto-accept CLIENT role,
326 4 == auto-accept GO role)
327 Advertisement ID - Mandatory non-zero ASCII hex-encoded u32
329 State - Mandatory ASCII hex-encoded u8 (0 -- Svc not available,
330 1 -- Svc available, 2-0xff Application defined)
331 Config Methods - Mandatory ASCII hex-encoded u16 (bitmask of WSC config
333 Service Name - Mandatory UTF-8 string
334 Service Information - Optional UTF-8 string
337 Session response information - Optional (used only if auto accept is TRUE)
338 UTF-8 string
345 This command can be used to replace the existing service request
346 attributes from the initiator side. The replacement is only allowed if
347 the advertisement id issued in the command matches with any one entry in
348 the list of existing SD queries. If advertisement id doesn't match the
355 asp - Mandatory for ASP service registration
356 auto accept - Mandatory ASCII hex-encoded boolean (1 == true, 0 == false)
357 Advertisement ID - Mandatory non-zero ASCII hex-encoded u32
359 State - Mandatory ASCII hex-encoded u8 (can be used to indicate svc
361 Config Methods - Mandatory ASCII hex-encoded u16 (bitmask of WSC config
363 Service Name - Mandatory UTF-8 string (Must match existing string in svc db)
364 Service Information - Optional UTF-8 string
367 Session response information - Optional (used only if auto accept is TRUE)
368 UTF-8 string
374 Schedule a P2P service discovery request. The parameters for this
375 command are the device address of the peer device (or 00:00:00:00:00:00
384 peers (note: this can result in long response frames). The pending
388 sent in sequence whenever the peer is found).
390 This command returns an identifier for the pending query (e.g.,
391 "1f77628") that can be used to cancel the request. Directed requests
392 will be automatically removed when the specified peer has replied to
396 Length (2 octets, little endian) - length of following data
397 Service Protocol Type (1 octet) - see the table below
398 Service Transaction ID (1 octet) - nonzero identifier for the TLV
399 Query Data (Length - 2 octets of data) - service protocol specific data
405 3 = WS-Discovery
406 4 = Wi-Fi Display
412 p2p_serv_disc_req 00:00:00:00:00:00 upnp <version hex> <ST: from M-SEARCH>
416 p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:device:InternetGatewayDevice:1
426 # list of all WS-Discovery services
441 p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:service:ContentDirectory:2
442 p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 uuid:6859dede-8574-59ab-9332-123456789012
443 p2p_serv_disc_req 00:00:00:00:00:00 upnp 10 urn:schemas-upnp-org:device:InternetGatewayDevice:1
445 # Wi-Fi Display examples
446 # format: wifi-display <list of roles> <list of subelements>
447 p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source] 2,3,4,5
448 p2p_serv_disc_req 02:01:02:03:04:05 wifi-display [pri-sink] 3
449 p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [sec-source] 2
450 p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source+sink] 2,3,4,5
451 p2p_serv_disc_req 00:00:00:00:00:00 wifi-display [source][pri-sink] 2,3,4,5
456 The command can be used for service discovery for P2PS enabled devices.
461 MAC address - Mandatory Existing
462 asp - Mandatory for ASP queries
463 Transaction ID - Mandatory non-zero ASCII hex-encoded u8 for GAS
464 Service Name Prefix - Mandatory UTF-8 string.
466 Service Information Substring - Optional UTF-8 string
469 If Service Information Substring is included, both the Substring and the
477 single parameter: identifier for the pending query (the value returned
484 response TLV(s). The first three parameters are copied from the
487 to process the request (see p2p_serv_disc_external).
492 the P2P service indicator value so that peers know when previously
494 service discovery processing is enabled since the commands to
495 pre-configure services for internal processing will increment the
502 each request based on pre-configured services), 1 = external
505 that there is quite strict limit on how quickly the response needs to
506 be transmitted, so use of the internal processing is strongly
526 p2p_service_add bonjour 000000 <32-byte bitfield as hexdump>
527 (note: see P2P spec Annex E.4 for information on how to construct the bitfield)
539 p2p_service_add upnp 10 uuid:6859dede-8574-59ab-9332-123456789012::upnp:rootdevice
540 p2p_service_add upnp 10 uuid:5566d33e-9774-09ab-4822-333456785632::upnp:rootdevice
541 p2p_service_add upnp 10 uuid:1122de4e-8574-59ab-9322-333456789044::urn:schemas-upnp-org:service:Con…
542 p2p_service_add upnp 10 uuid:5566d33e-9774-09ab-4822-333456785632::urn:schemas-upnp-org:service:Con…
543 p2p_service_add upnp 10 uuid:6859dede-8574-59ab-9332-123456789012::urn:schemas-upnp-org:device:Inte…
551 Removes the local asp service from internal SD query list.
565 persistent group (e.g., persistent=4). If the peer device is the GO of
566 the persistent group, the peer parameter is not needed. Otherwise it is
568 used to override the GO device address for Invitation Request should
570 cases). When reinvoking a persistent group, the GO device can specify
571 the frequency for the group with the freq parameter. When reinvoking a
572 persistent group, the P2P client device can use freq parameter to force
573 a specific operating channel (or invitation failure if GO rejects that)
574 or pref parameter to request a specific channel (while allowing GO to
579 (These are used on the group interface.)
584 the AP/GO. This is used on the GO when a P2P client joins an existing
585 group. The second parameter is the address of the Enrollee or a string
586 "any" to allow any station to use the entered PIN (which will restrict
587 the PIN for one-time-use). PIN is the Enrollee PIN read either from a
588 label or display on the P2P Client/WPS Enrollee.
592 Start WPS PBC method (i.e., push the button). This allows a single WPS
593 Enrollee to connect to the AP/GO. This is used on the GO when a P2P
598 Get the passphrase for a group (only available when acting as a GO).
602 Send a P2P Presence Request to the GO (this is only available when
603 acting as a P2P client). If no duration/interval pairs are given, the
604 request indicates that this client has no special needs for GO
605 presence. The first parameter pair gives the preferred duration and
606 interval values in microseconds. If the second pair is included, that
608 immediately and the response from the GO is indicated in a
609 P2P-PRESENCE-RESPONSE event message.
615 Configure Extended Listen Timing. If the parameters are omitted, this
616 feature is disabled. If the parameters are included, Listen State will
618 have acceptable range of 1-65535 (with interval obviously having to be
619 larger than or equal to duration). If the P2P module is not idle at
620 the time the Extended Listen Timing timeout occurs, the Listen State
623 The configured values will also be advertised to other P2P Devices. The
624 received values are available in the p2p_peer command output:
646 changing the Listen channel during normal operations can result in
649 When specifying a social channel on the 2.4 GHz band (1/6/11) there is
650 no need to specify the operating class since it defaults to 81. When
651 specifying a social channel on the 60 GHz band (2), specify the 60 GHz
656 Set postfix string to be added to the automatically generated P2P SSID
657 (DIRECT-<two random characters>). For example, postfix of "-testing"
658 could result in the SSID becoming DIRECT-ab-testing.
662 Disabled(default)/enables use of per-client PSK in the P2P groups. This
663 can be used to request GO to assign a unique PSK for each client during
665 the group securely with p2p_remove_client command since that client's
666 PSK is removed at the same time to prevent it from connecting back using
667 the old PSK. When per-client PSK is not used, the client can still be
668 disconnected, but it will be able to re-join the group since the PSK it
669 learned previously is still valid. It should be noted that the default
670 passphrase on the GO that is normally used to allow legacy stations to
677 operations. The format on these parameters is same as is used in
678 wpa_supplicant.conf. Only the parameters listen here should be
680 since not all existing users of the parameters are updated.
684 Set WPS UUID (by default, this is generated based on the MAC address).
722 set p2p_go_intent <GO intent>
724 Set the default P2P GO Intent. Note: This value can be overridden in
725 p2p_connect command and as such, there should be no need to change the
746 operations by avoiding it from taking 100% of radio resources. The
753 List P2P Device Addresses of all the P2P peers we know. The optional
754 "discovered" parameter filters out the peers that we have not fully
764 (These are used on the group interface.)
773 Show information about an associated station (when acting in AP/GO role).
777 Lists the currently associated stations.
783 Lists the configured networks, including stored information for
784 persistent groups. The identifier in this list is used with
795 P2PS-PROV-START: This events gets triggered when provisioning is issued for
799 P2PS-PROV-START 00:55:44:33:22:11 adv_id=111 adv_mac=00:55:44:33:22:11 conncap=1 session=1234567 se…
802 MAC address - always
803 adv_id - always ASCII hex-encoded u32
804 adv_mac - always MAC address that owns/registered the service
805 conncap - always mask of 0x01 (new), 0x02 (group client), 0x04 (group owner)
807 session - always Session ID of the first session to be established
808 session_mac - always MAC address that owns/initiated the session
809 info - if available, UTF-8 string
813 P2PS-PROV-DONE: When provisioning is completed then this event gets triggered.
816 …-PROV-DONE 00:11:22:33:44:55 status=0 adv_id=111 adv_mac=00:55:44:33:22:11 conncap=1 session=12345…
819 MAC address - always main device address of peer. May be different from MAC
821 status - always ascii hex-encoded u8 (0 == success, 12 == deferred success)
822 adv_id - always ascii hex-encoded u32
823 adv_mac - always MAC address that owns/registered the service
824 conncap - always One of: 1 (new), 2 (group client), 4 (group owner) bits
825 session - always Session ID of the first session to be established
826 session_mac - always MAC address that owns/initiated the session
827 dev_passwd_id - only if conncap value == 1 (New GO negotiation)
828 8 - "p2ps" password must be passed in p2p_connect command
829 1 - "display" password must be passed in p2p_connect command
830 5 - "keypad" password must be passed in p2p_connect command
831 join only - if conncap value == 2 (Client Only). Display password and "join"
832 must be passed in p2p_connect and address must be the MAC specified
833 go only - if conncap value == 4 (GO Only). Interface name must be set with a
835 persist - only if previous persistent group existed between peers and shall
836 be re-used. Group is restarted by sending "p2p_group_add persistent=0"
837 where value is taken from P2P-PROV-DONE
841 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=''…
844 adv_id - if ASP ASCII hex-encoded u32. If it is reporting the
846 asp_svc - if ASP this is the service string. If it is reporting the
847 "wildcard service", this value will be org.wi-fi.wfds
851 ---------------------
853 See examples/p2p-action.sh
856 TODO: cross-connection