1.. zephyr:code-sample:: openthread-shell
2   :name: OpenThread shell
3   :relevant-api: net_stats
4
5   Test Thread and IEEE 802.15.4 using the OpenThread shell.
6
7Overview
8********
9
10This sample allows testing the Thread protocol and the underlying IEEE 802.15.4 drivers for various
11boards using the OpenThread shell.
12
13Building and Running
14********************
15
16Verify that the board and chip you are targeting provide IEEE 802.15.4 support.
17
18There are configuration files for different boards and setups in the shell directory:
19
20- :file:`prj.conf`
21  Generic config file.
22
23- :file:`overlay-ot-rcp-host-nxp.conf`
24  This overlay config enables support of OpenThread RCP host running on NXP chips over IMU interface.
25
26Build shell application like this:
27
28.. zephyr-app-commands::
29   :zephyr-app: samples/net/openthread/shell
30   :board: <board to use>
31   :conf: <config file to use>
32   :goals: build
33   :compact:
34
35Example building for Nordic's nRF52840 DK.
36
37.. zephyr-app-commands::
38   :zephyr-app: samples/net/openthread/shell
39   :board: nrf52840dk/nrf52840
40   :conf: "prj.conf"
41   :goals: build
42   :compact:
43
44Example building for NXP's RW612 FRDM (RCP host).
45
46.. zephyr-app-commands::
47   :zephyr-app: samples/net/openthread/shell
48   :board: frdm_rw612
49   :conf: "prj.conf overlay-ot-rcp-host-nxp.conf"
50   :goals: build
51   :compact:
52
53Sample console interaction
54==========================
55
56.. code-block:: console
57
58   uart:~$ ot scan
59   | PAN  | MAC Address      | Ch | dBm | LQI |
60   +------+------------------+----+-----+-----+
61   | fe09 | abcdef1234567890 | 15 | -78 |  60 |
62   Done
63