mirror of https://github.com/espressif/openthread.git synced 2026-06-05 21:14:49 +00:00

Files

T

Abtin Keshavarzian fb216d335c [cmake] update CMake configurations for Apple platforms (#12729 )

This commit updates various CMake configuration files to simplify
the check for Apple platforms. It replaces the `CMAKE_CXX_COMPILER_ID`
check for `AppleClang` with the built-in `APPLE` variable across
multiple targets (such as `ftd`, `mtd`, `cli`, and others). This
ensures that Apple-specific linker and compiler flags (like `-Wl,-map`
and `-Wimplicit-int-conversion`) are correctly applied when building
on macOS, regardless of the specific compiler used.

Additionally, this commit updates `CMakeLists.txt` to explicitly set
the `CMAKE_AR` and `CMAKE_RANLIB` paths to the default system
locations (`/usr/bin/ar` and `/usr/bin/ranlib`) when the `APPLE`
variable is set.

2026-03-20 13:19:29 -05:00

BUILD.gn

[gn] add cli_uart (#12345 )

2026-02-02 17:30:38 -08:00

cli_uart.cpp

[gn] add cli_uart (#12345 )

2026-02-02 17:30:38 -08:00

CMakeLists.txt

[cli] add cli-radio build (#6769 )

2021-09-18 09:51:35 -07:00

ftd.cmake

[cmake] update CMake configurations for Apple platforms (#12729 )

2026-03-20 13:19:29 -05:00

main.c

[cli] provide default 'APP' log output implementation in CLI module (#12309 )

2026-01-21 12:30:29 -08:00

mtd.cmake

[cmake] update CMake configurations for Apple platforms (#12729 )

2026-03-20 13:19:29 -05:00

radio.cmake

[cmake] update CMake configurations for Apple platforms (#12729 )

2026-03-20 13:19:29 -05:00

README.md

[build] remove autotools (#9027 )

2023-06-28 08:54:23 -07:00

README.md

OpenThread CLI Example

This example application exposes OpenThread configuration and management APIs via a simple command-line interface. The steps below take you through the minimal steps required to ping one emulated Thread device from another emulated Thread device.

1. Build

$ cd <path-to-openthread>
$ ./script/cmake-build simulation

2. Start node 1

Spawn the process:

$ cd <path-to-openthread>/build/simulation/examples/apps/cli
$ ./ot-cli-ftd 1

Generate, view, and commit a new Active Operational Dataset:

> dataset init new
Done
> dataset
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrc
Done
> dataset commit active
Done

Bring up the IPv6 interface:

> ifconfig up
Done

Start Thread protocol operation:

> thread start
Done

Wait a few seconds and verify that the device has become a Thread Leader:

> state
leader
Done

View IPv6 addresses assigned to Node 1's Thread interface:

> ipaddr
fd3d:b50b:f96d:722d:0:ff:fe00:fc00
fd3d:b50b:f96d:722d:0:ff:fe00:c00
fd3d:b50b:f96d:722d:7a73:bff6:9093:9117
fe80:0:0:0:6c41:9001:f3d6:4148
Done

2. Start node 2

Spawn the process:

$ cd <path-to-openthread>/build/simulation/examples/apps/cli
$ ./ot-cli-ftd 2

Configure Thread Network Key from Node 1's Active Operational Dataset:

> dataset networkkey dfd34f0f05cad978ec4e32b0413038ff
Done
> dataset commit active
Done

Bring up the IPv6 interface:

> ifconfig up
Done

Start Thread protocol operation:

> thread start
Done

Wait a few seconds and verify that the device has become a Thread Child or Router:

> state
child
Done

3. Ping Node 1 from Node 2

> ping fd3d:b50b:f96d:722d:7a73:bff6:9093:9117
16 bytes from fd3d:b50b:f96d:722d:558:f56b:d688:799: icmp_seq=1 hlim=64 time=24ms

4. Explore More

See the OpenThread CLI Reference README.md to explore more.