
===============================================================================

        S E T U P  I N S T R U C T I O N S F O R  *WifiDirect*

Driver,FW release:

1. Make sure, bg_scan.conf,uaputl.conf has SSID starting with "DIRECT-"
2. Download uAP configuration and BG scan configuration.
3. This version of wifidirectutl breaks the backward compatibility and will work
with following releases -
    8797 >= 14.xx.16.p15
         >= 14.xx.11.p138
    8766 >= 14.xx.11.p138
    8787 >= 14.xx.9.p89

    However, In case one needs to run the utility in backward compatibility mode
    he can do so by running following command before running the utility -

    # export WIFIDIR_USE_FIXED_IE_INDICES=1

    To disable backward comaptibility mode run following command -

    # export WIFIDIR_USE_FIXED_IE_INDICES=0

WPSWIFIDIRECT release:

1. Modify the wifidirect.conf file to specify the correct HW addresses of
   devices. The DUT mac address and peer mac address needs to be correctly
   entered.

===============================================================================
        U S E R  M A N U A L  F O R  WIFIDIRECTUTL

NAME
	wifidirectutl

This tool can be used to configure WifiDirect parameters.

------------------
Supported Commands
------------------
wifidirect_mode [MODE]
wifidirect_config [*.conf]
wifidirect_params_config [*.conf]
wifidirect_action_frame <*.conf> | [<PeerAddr> <Category> <OuiSubtype> <DialogToken>]
wifidirect_discovery_request <*.conf>
wifidirect_discovery_response <*.conf>

wifidirect_cfg_discovery_period [<MinDiscPeriod> <MaxDiscPeriod>]
wifidirect_cfg_intent [IntentValue]
wifidirect_cfg_capability [<DeviceCapability> <GroupCapability>]
wifidirect_cfg_noa <enable|disable> <index> [<counttype> <duration> <interval>]
wifidirect_cfg_opp_ps <enable|disable> [<CTWindow>]
wifidirect_cfg_invitation_list [mac_addr]
wifidirect_cfg_listen_channel [ListenChannel]
wifidirect_cfg_op_channel [OperatingChannel]
wifidirect_cfg_persistent_group_record [index] [role]
           [<groupbss> <deviceId> <ssid> <psk>] [peermac1] [peermac2]
wifidirect_cfg_persistent_group_invoke [index] | <cancel>
wifidirect_cfg_presence_req_params [<type> <duration> <interval>]
wifidirect_cfg_ext_listen_time [<duration> <interval>]
wifidirect_cfg_provisioning_params [<action> <configMethods> <devicePassword>]
wifidirect_cfg_wps_params [<action>]

wifidirect_mode [mode]
----------
    "./wifidirectutl <iface> wifidirect_mode [mode]"

    This command is used to setup various modes for wifidirect device.
    The mode 2 can be used only when wifidirect is started using mode 1.
    The mode 3 should not be used for uAP.

    The supported options are:
        mode :     0 - stop wifidirect mode
                   1 - start wifidirect mode
                   2 - start wifidirect group owner mode
                   3 - start wifidirect client mode
                   4 - start wifidirect find phase
                   5 - stop wifidirect find phase
        empty - Get current wifidirect mode

    Example:
        ./wifidirectutl <iface> wifidirect_mode 0
                Stop wifidirect mode.

        ./wifidirectutl <iface> wifidirect_mode 1
                Start wifidirect mode.

        ./wifidirectutl <iface> wifidirect_mode
                Get current WIFIDIRECT start/stop mode.

wifidirect_config
----------
    "./wifidirectutl <iface> wifidirect_config [*.conf]"

    This command is used to set/get the wifidirect configuration.

        Example:
        ./wifidirectutl <iface> wifidirect_config wifidirect.conf
            Read configuration from wifidirect.conf and apply it.
        ./wifidirectutl <iface> wifidirect_config
            Read existing wifidirect configuration and display it.

wifidirect_params_config
----------
    "./wifidirectutl <iface> wifidirect_params_config [*.conf]"

    This command is used to set/get the wifidirect parameters configuration.

        Example:
        ./wifidirectutl <iface> wifidirect_params_config wifidirect.conf
            Read parameter configuration from wifidirect.conf and apply it.
        ./wifidirectutl <iface> wifidirect_params_config
            Read existing wifidirect parameters's configuration and display it.

wifidirect_action_frame
----------
    "./wifidirectutl <iface> wifidirect_action_frame <*.conf> | <PeerAddr> <Category> <OUISubtype> <DialogToken>"

    This command is used to send action frames as specified in config file or on command line.

        Example:
        ./wifidirectutl <iface> wifidirect_action_frame wifidirect.conf
            Read action_frame from wifidirect.conf and send to peer.
        ./wifidirectutl <iface> wifidirect_action_frame <PeerAddr> <Category> <OUISubtype> <DialogToken>
            Read action frame parameters from command line and send to peer.

wifidirect_discovery_request
----------
    "./wifidirectutl <iface> wifidirect_discovery_request <*.conf>"

    This command is used to send wifidirect discovery request packet.

        Example:
        ./wifidirectutl <iface> wifidirect_discovery_request wifidirect.conf
            Read discovery packet from wifidirect.conf and send to peer.

wifidirect_discovery_response
----------
    "./wifidirectutl <iface> wifidirect_discovery_response <*.conf>"

    This command is used to send wifidirect discovery response packet.

        Example:
        ./wifidirectutl <iface> wifidirect_discovery_response wifidirect.conf
            Read discovery packet from wifidirect.conf and send to peer.

wifidirect_cfg_discovery_period
----------
	"./wifidirectutl <iface> wifidirect_cfg_discovery_period [<MinDiscPeriod> <MaxDiscPeriod>]"

	This command is used to set or get minimum and maximum discovery period.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_discovery_period 10 20
		Set minimum discovery interval to 10 and maximum discovery
		interval to	20.

		./wifidirectutl <iface> wifidirect_cfg_discovery_period
		Get minimum and maximum discovery interval.

wifidirect_cfg_intent
----------
	"./wifidirectutl <iface> wifidirect_cfg_intent [IntentValue]"

	This command is used to set or get intent value.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_intent 12
		Set intent value to 12.

		./wifidirectutl <iface> wifidirect_cfg_intent
		Get Group Owner Intent.

wifidirect_cfg_capability
----------
	"./wifidirectutl <iface> wifidirect_cfg_capability [<DeviceCapability> <GroupCapability>]"

	This command is used to set or get device capability and group capability.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_capability 10 20
		Set Device capability to 10 and group capability to 20

		./wifidirectutl <iface> wifidirect_cfg_capability
		Get Device capability and group capability.

wifidirect_cfg_noa
----------
	"./wifidirectutl <iface> wifidirect_cfg_noa <enable|disable> <index> [<counttype> <duration> <interval>]"

	This command is used to set or get NoA parameters like count_type, duration and
	interval in ms when NoA is enabled. Valid value of index is [0, 1].

		Example:
		./wifidirectutl <iface> wifidirect_cfg_noa enable 0 10 50 100
		Enable NoA and set count to 10, duration to 50ms and interval to 100 ms
            for index 0.

		./wifidirectutl <iface> wifidirect_cfg_noa disable 1
		Disable NoA at index 1.

		./wifidirectutl <iface> wifidirect_cfg_noa
		Get NoA settings.

wifidirect_cfg_opp_ps
----------
	"./wifidirectutl <iface> wifidirect_cfg_opp_ps <enable|disable> [<CTWindow>]"

	This command is used to set or get Opportunistic power save and CT window.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_opp_ps enable 50
		Set OppPS and CTwindow value to 50.

		./wifidirectutl <iface> wifidirect_cfg_opp_ps disable
		Disable OppPS.

		./wifidirectutl <iface> wifidirect_cfg_opp_ps
		Get OppPS and CT window.

wifidirect_cfg_invitation_list
----------
	"./wifidirectutl <iface> wifidirect_cfg_invitation_list [mac_addr]"

	This command is used to set or get invitation list of peers.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_invitation_list 00:50:43:20:23:34
		Set 00:50:43:20:23:34 in invitation list of peers.

		./wifidirectutl <iface> wifidirect_cfg_invitation_list
		Get Invitation list of peers.

wifidirect_cfg_listen_channel
----------
	"./wifidirectutl <iface> wifidirect_cfg_listen_channel [ListenChannel]"

	This command is used to set or get Listen channel.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_listen_channel 11
		Set Listen channel to 11.

		./wifidirectutl <iface> wifidirect_cfg_listen_channel
		Get Listen channel.

wifidirect_cfg_op_channel
----------
		"./wifidirectutl <iface> wifidirect_cfg_op_channel [OperatingChannel]"

		This command is used to set or get Operating channel.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_op_channel 11
		Set Operating channel to 11.

		./wifidirectutl <iface> wifidirect_cfg_op_channel
		Get Operating channel.

wifidirect_cfg_persistent_group_record
----------
		"./wifidirectutl <iface> [index] [role]
                 [<groupbss> <deviceId> <ssid> <psk>] [peermac1] [peermac2]"

		This command is used to set or get the persistent group record
        maintained in the device. Valid index is from 0 to 3. The role should be
        0 for client, 1 for group-owner.

		Example:
		./wifidirectutl <iface> wifidirect_cfg_persistent_group_record 0 1
        00:50:43:12:24:36 00:50:43:13:26:39 "DIRECT-" "1234567890"
        00:50:43:20:c2:d0
		Set persistent group record with index 0, role as group owner, bssId and
        device Id, ssid="DIRECT-", passphrase="1234567890", and peer mac address.
        The passphrase get converted to PSK.

		./wifidirectutl <iface> wifidirect_cfg_persistent_group_record 1 1
        00:50:43:12:24:36 00:50:43:13:26:39 "DIRECT-" "1234567890"
        0x1234567890123456789012345678901234567890123456789012345678901234
		Set persistent group record with index 1, role as group owner, bssId and
        device Id, ssid="DIRECT-", passphrase="1234567890", and peer mac address.
        The passphrase get converted to PSK.
        PSK is specified with "0x" prefix and 32 bytes (64 characters).

		./wifidirectutl <iface> wifidirect_cfg_persistent_group_record 1
		Get persistent group record with index 1.

		./wifidirectutl <iface> wifidirect_cfg_persistent_group_record
		Get persistent group record for all indices.

wifidirect_cfg_persistent_group_invoke
----------
		"./wifidirectutl <iface> wifidirect_cfg_persistent_group_invoke [index] | <cancel>"

		This command is used to invoke a particular persistent group record
        from the list. Valid index is from 0 to 3.

		./wifidirectutl <iface> wifidirect_cfg_persistent_group_invoke 2
		Invoke persistent group record with index 1.

		./wifidirectutl <iface> wifidirect_cfg_persistent_group_invoke cancel
		Cancel invokation of persistent groups.

wifidirect_cfg_presence_req_params
----------
		"./wifidirectutl <iface> wifidirect_cfg_presence_req_params [<type> <duration> <interval>]"

		This command is used to set/get presence request parameters. Type should
        be 1 for preferred values and 2 for acceptable values.

		./wifidirectutl <iface> wifidirect_cfg_presence_req_params 1 50 100
		Set duration to 50ms and interval to 100ms.

		./wifidirectutl <iface> wifidirect_cfg_presence_req_params
		Get presence request parameters.

wifidirect_cfg_ext_listen_time
----------
		"./wifidirectutl <iface> wifidirect_cfg_ext_listen_time [<duration> <interval>]"

		This command is used to set/get extended listen timing parameters.

		./wifidirectutl <iface> wifidirect_cfg_ext_listen_time 1200 1300
		Set availability period to 1200ms and availability interval to 1300 ms.

		./wifidirectutl <iface> wifidirect_cfg_ext_listen_time
		Get extended listen timing parameters.

wifidirect_cfg_provisioning_params
----------
		"./wifidirectutl <iface> wifidirect_cfg_provisioning_params [<action> <configMethod> <devicePassword>]"

		This command is used to set/get provisioning protocol parameters. Action should
        be 1 for request parameters and 2 for response parameters.

		./wifidirectutl <iface> wifidirect_cfg_provisioning_params 1 0x80 0x04
		Set config method to 0x86 and device password to 0x04.

		./wifidirectutl <iface> wifidirect_cfg_provisioning_params
		Get Provision protocol parameters.

wifidirect_cfg_wps_params
----------
		"./wifidirectutl <iface> wifidirect_cfg_wps_params [<action>]"

		This command is used to set WPS action. action can be "pin" (pin entered),
        "pbc"(button pressed) or "none".

		Example:
		./wifidirectutl <iface> wifidirect_cfg_wps_params pin
		Indicates pin operation

		./wifidirectutl <iface> wifidirect_cfg_wps_params none
		Indicates no operation

===============================================================================
        U S E R  M A N U A L  F O R  WIFIDISPLAY

wifidisplay_mode
-----------
            "./wifidirectutl <iface> wifidisplay_mode [<action>]"
            This command is used to enable or disable wifi-display. The possible values are either 1 or 0.
		Example:
		./wifidirectutl <iface> wifidisplay_mode 1
		Indicates enable wifi_display

		./wifidirectutl <iface> wifidisplay_mode 0
		Indicates disable wifi_display

wifidisplay_config
-----------
            "./wifidirectutl <iface> wifidisplay_config [*.conf]"

            This command is used to set/get the wifidisplay configuration.

             Example:
             ./wifidirectutl <iface> wifidisplay_config wifidisplay.conf
             Read configuration from wifidisplay.conf and apply it.
             ./wifidirectutl <iface> wifidisplay_config
             Read existing wifidisplay configuration and display it.

wifidisplay_update_devinfo
----------
            "./wifidirectutl <iface> wifidisplay_update_devinfo [value]"

            This command is used to set the device information of wifidisplay device information subelement.
            This command will overwrite the new device information with user defined value.

             Example:
             ./wifidirectutl <iface> wifidisplay_update_devinfo 10
             Update device information programmed with new value 10 by overwritting existing value.

wifidisplay_discovery_request
----------
            "./wifidirectutl <iface> wifidisplay_discovery_request [*.config]"

            This command is used to send wifi display service discovery request.

            Example:
            ./wifidirectutl <iface> wifidisplay_discovery_request wifidisplay.conf
            Read discovery packet from wifidisplay.conf and send to peer.

wifidisplay_discovery_response
----------
           "./wifidirectutl <iface> wifidisplay_discovery_response <*.conf>"

           This command is used to send wifidisplay discovery response packet.

           Example:
           ./wifidirectutl <iface> wifidisplay_discovery_response wifidisplay.conf
           Read discovery packet from wifidisplay.conf and send to peer.

===============================================================================
        U S E R  M A N U A L  F O R  MLANEVENT

NAME
mlanevent.exe

This tool can be used to listen for and obtain events from the driver
through the netlink layer. This is only used for display/debugging purpose.

----------------
Supported events
----------------
WIFIDIRECT_GENERIC_EVENT
WIFIDIRECT_SERVICE_DISCOVERY

-----------------
Details of events
-----------------

WIFIDIRECT_GENERIC_EVENT
-----------------
    For this event, the following information is shown:
        + Event length.
        + Event Type indicating Negociation, Invitation, Discoverability,
		Provision discovery related Request or Response.
        + Event SubType indicating Client or Group owner role.
        + Peer MAC address.
        + Associated WIFIDIRECT IE elements.

WIFIDIRECT_SERVICE_DISCOVERY
---------------------
    For this event, the following information is shown:
        + Peer MAC address.
        + Service discovery packet details.