doc: wifi: Add Wi-Fi direct document

Add Wi-Fi direct (p2p mode) document.

Signed-off-by: Kapil Bhatt <[email protected]>

Author: kapbh

doc/nrf/protocols/wifi/index.rst

@@ -33,6 +33,7 @@ If you want to go through an online training course to familiarize yourself with
    station_mode/index
    scan_mode/index
    sap_mode/index
+   wifi_direct
    advanced_modes/index
    provisioning/index
    regulatory_support

doc/nrf/protocols/wifi/wifi_direct.rst

@@ -0,0 +1,182 @@
+.. _ug_wifi_direct:
+
+Wi-Fi Direct (P2P mode)
+#######################
+
+.. contents::
+   :local:
+   :depth: 2
+
+Wi-Fi Direct® (also known as Wi-Fi P2P or peer-to-peer mode) enables direct device-to-device connections without requiring a traditional access point.
+The nRF70 Series devices support Wi-Fi Direct, allowing you to establish peer-to-peer connections with other Wi-Fi Direct-capable devices.
+
+Building with Wi-Fi Direct support
+**********************************
+
+To build an application with Wi-Fi Direct support, use the :ref:`wifi_shell_sample` sample with the ``wifi-p2p`` snippet and external flash for firmware patches.
+
+Build command
+=============
+
+To build the Wi-Fi shell sample with Wi-Fi Direct (P2P) support, run the following command:
+
+.. code-block:: console
+
+   west build --pristine --board nrf7002dk/nrf5340/cpuapp -S wifi-p2p -S nrf70-fw-patch-ext-flash
+   west flash
+
+Wi-Fi Direct commands
+*********************
+
+The following commands are available for Wi-Fi Direct operations.
+Both Wi-Fi shell commands and ``wpa_cli`` commands are  provided for each operation.
+
+Finding peers
+=============
+
+To start discovering Wi-Fi Direct peers, use the following commands:
+
+.. tabs::
+
+   .. group-tab:: Wi-Fi shell command
+
+      .. code-block:: console
+
+         wifi p2p find
+
+   .. group-tab:: wpa_cli command
+
+      .. code-block:: console
+
+         wpa_cli p2p_find
+
+This command initiates the P2P discovery process.
+The device scans for other Wi-Fi Direct-capable devices in range.
+
+Listing discovered peers
+========================
+
+To view the list of discovered peers, use the following commands:
+
+.. tabs::
+
+   .. group-tab:: Wi-Fi shell command
+
+      .. code-block:: console
+
+         wifi p2p peers
+
+   .. group-tab:: wpa_cli command
+
+      .. code-block:: console
+
+         wpa_cli p2p_peers
+
+This command displays a table of discovered peers with the following information:
+
+.. code-block:: console
+
+   Num  | Device Name                      | MAC Address       | RSSI | Device Type          | Config Methods
+   1    | Galaxy S22                       | D2:39:FA:43:23:C1 | -58  | 10-0050F204-5        | 0x188
+
+The columns in the table represent the following attributes:
+
+* ``Num`` - Sequential number of the peer in the list
+* ``Device Name`` - Friendly name of the peer device
+* ``MAC Address`` - MAC address of the peer device
+* ``RSSI`` - Signal strength in dBm
+* ``Device Type`` - WPS device type identifier
+* ``Config Methods`` - Supported WPS configuration methods
+
+Getting peer details
+====================
+
+To get detailed information about a specific peer, use the following commands:
+
+.. tabs::
+
+   .. group-tab:: Wi-Fi shell command
+
+      .. code-block:: console
+
+         wifi p2p peer <mac_address>
+
+   .. group-tab:: wpa_cli command
+
+      .. code-block:: console
+
+         wpa_cli p2p_peer <mac_address>
+
+For example:
+
+.. code-block:: console
+
+   wpa_cli p2p_peer D2:39:FA:43:23:C1
+
+This command displays detailed information about the specified peer device.
+
+Connecting to a peer
+====================
+
+To establish a Wi-Fi Direct connection with a discovered peer:
+
+.. tabs::
+
+   .. group-tab:: Wi-Fi shell command
+
+      .. code-block:: console
+
+         wifi p2p connect <mac_address> <pin|pbc> -g <go_intent>
+
+   .. group-tab:: wpa_cli command
+
+      .. code-block:: console
+
+         wpa_cli p2p_connect <mac_address> <pin|pbc> go_intent=<go_intent>
+
+Parameters:
+
+* `<mac_address>` - MAC address of the peer device to connect to
+* ``<pbc|pin>`` - WPS provisioning method:
+
+  * ``pin`` - Use PIN-based WPS authentication.
+    The command will return a PIN (for example, ``88282282``) that must be entered on the peer device.
+  * ``pbc`` - Use Push Button Configuration (PBC) for WPS authentication.
+
+* ``go_intent`` - Group Owner (GO) intent value ``0-15``:
+
+  * Higher values indicate a stronger desire to become the Group Owner.
+  * Value of ``15`` forces the device to become the GO.
+  * Value of ``0`` indicates the device prefers to be a client.
+
+Example connection with PIN method:
+
+**Wi-Fi shell command:**
+
+.. code-block:: console
+
+   wifi p2p connect D2:39:FA:43:23:C1 pin -g 0
+
+**wpa_cli command:**
+
+.. code-block:: console
+
+   wpa_cli p2p_connect D2:39:FA:43:23:C1 pin go_intent=0
+
+The command will output a PIN (for example, ``88282282``) that should be entered on the peer device to complete the connection.
+
+To disconnect from a Wi-Fi Direct connection:
+
+.. tabs::
+
+   .. group-tab:: Wi-Fi shell command
+
+      .. code-block:: console
+
+         wifi disconnect
+
+   .. group-tab:: wpa_cli command
+
+      .. code-block:: console
+
+         wpa_cli disconnect