Lines Matching +full:pin +full:- +full:group

1 wpa_supplicant and Wi-Fi P2P
4 This document describes how the Wi-Fi P2P implementation in
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
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.
62 by adding -i argument on the command line (e.g., 'wpa_cli -i wlan1').
66 wlan0). When using a separate virtual interface for group operations
67 (e.g., wlan1), the control interface for that group interface may need
95 "p2p_find dev_type=1-0050F204-1".
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
117 Start Listen-only state (become discoverable without searching for
122 having to maintain a group.
133 Group Formation
140 02:01:02:03:04:05 display" would request the peer to display a PIN for
142 to enter a PIN that we display.
146 mainly used with "display" to request it to display a PIN. The "auto"
149 join-a-group style PD instead of GO Negotiation style PD.
151 p2p_connect <peer device address> <pbc|pin|PIN#|p2ps> [display|keypad|p2ps]
156 Start P2P group formation with a discovered P2P peer. This includes
157 optional group owner negotiation, group interface setup, provisioning,
160 The <pbc|pin|PIN#> parameter specifies the WPS provisioning
161 method. "pbc" string starts pushbutton method, "pin" string start PIN
162 method using an automatically generated PIN (which will be returned as
163 the command return code), PIN# means that a pre-selected PIN can be
164 used (e.g., 12345670). [display|keypad] is used with PIN method
165 to specify which PIN is used (display=dynamically generated random PIN
166 from local display, keypad=PIN entered from peer display). "persistent"
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
170 group where this device was the GO. The previously used parameters will
174 "join" indicates that this is a command to join an existing group as a
197 join-a-group operation rather than GO Negotiation.
199 "ssid=<hexdump>" can be used to specify the Group SSID for join
207 P2PS supports two WPS provisioning methods namely PIN method and P2PS default.
216 (WPS Method = PIN)
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
234 2 (group client only) or 4 (group owner only)
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)
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
267 Set up a P2P group owner manually (i.e., without group owner
270 a persistent group. Optional freq=<freq in MHz> can be used to force
282 p2p_group_remove <group interface>
284 Terminate a P2P group. If a new virtual network interface was used for
285 the group, it will also be removed. The network interface name of the
286 group interface is used as a parameter for this command.
290 Cancel an ongoing P2P group formation and joining-a-group related
292 had been authorized to start group formation), stops P2P find (if in
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
302 can rejoin the group if it is in possession of a valid key. See p2p_set
316 which can be either P2PS method or PIN method, service name followed by
320 p2p_service_add asp 1 4d6fc7 0 1108 alt.example.chat svc_info='name=john' rsp_info='enter PIN 1234'
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
352 p2p_service_rep asp 1 4d6fc7 1 1108 alt.example.chat svc_info='name=john' rsp_info='enter PIN 1234'
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
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
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
495 pre-configure services for internal processing will increment the
502 each request based on pre-configured services), 1 = external
526 p2p_service_add bonjour 000000 <32-byte bitfield as hexdump>
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…
560 p2p_invite [persistent=<network id>|group=<group ifname>] [peer=address]
564 Invite a peer to join a group (e.g., group=wlan1) or to reinvoke a
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
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
577 Group Operations
579 (These are used on the group interface.)
581 wps_pin <any|address> <PIN>
583 Start WPS PIN method. This allows a single WPS Enrollee to connect to
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
594 client joins an existing group.
598 Get the passphrase for a group (only available when acting as a GO).
609 P2P-PRESENCE-RESPONSE event message.
618 have acceptable range of 1-65535 (with interval obviously having to be
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
665 the group securely with p2p_remove_client command since that client's
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
735 groups. If enabled, invitations to reinvoke a persistent group will be
762 Group Status
764 (These are used on the group interface.)
785 p2p_group_add and p2p_invite to indicate which persistent group is to
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"
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