README.rst
1.. zephyr:code-sample:: wifi-shell
2 :name: Wi-Fi shell
3 :relevant-api: net_stats
4
5 Test Wi-Fi functionality using the Wi-Fi shell module.
6
7Overview
8********
9
10This sample allows testing Wi-Fi drivers for various boards by
11enabling the Wi-Fi shell module that provides a set of commands:
12scan, connect, and disconnect. It also enables the net_shell module
13to verify net_if settings.
14
15Building and Running
16********************
17
18Verify the board and chip you are targeting provide Wi-Fi support.
19
20For instance you can use Nordic's nrf7002dk by selecting the nrf7002dk/nrf5340/cpuapp board.
21
22.. zephyr-app-commands::
23 :zephyr-app: samples/net/wifi/shell
24 :board: nrf7002dk/nrf5340/cpuapp
25 :goals: build
26 :compact:
27
28Sample console interaction
29==========================
30
31.. code-block:: console
32
33 shell> wifi scan
34 Scan requested
35 shell>
36 Num | SSID (len) | Chan | RSSI | Sec
37 1 | kapoueh! 8 | 1 | -93 | WPA/WPA2
38 2 | mooooooh 8 | 6 | -89 | WPA/WPA2
39 3 | Ap-foo blob.. 13 | 11 | -73 | WPA/WPA2
40 4 | gksu 4 | 1 | -26 | WPA/WPA2
41 ----------
42 Scan request done
43
44 shell> wifi connect "gksu" 4 SecretStuff
45 Connection requested
46 shell>
47 Connected
48 shell>
49
