History

Dhaval Gujar a9c014d915 Add ESP-IDF 6.0 compatibility fixes		2026-04-16 17:32:55 +05:30
..
common	examples: Add shared support and ESP32 node example	2026-04-14 18:32:58 +05:30
esp32-node	Add ESP-IDF 6.0 compatibility fixes	2026-04-16 17:32:55 +05:30
esp-box-3-display	examples: Add ESP-BOX-3 display example	2026-04-14 18:32:58 +05:30
README.md	examples: Add ESP-BOX-3 display example	2026-04-14 18:32:58 +05:30

README.md

Examples

This directory contains the example applications in this repository and the shared source they build on.

Available Examples

ESP32 Wi-Fi Node Example A general-purpose ESP32 node with device.*, wifi.status, gpio.*, and adc.read.
ESP-BOX-3 Display Example An ESP-BOX-3 node with the shared device and Wi-Fi commands plus display.show and display.status.

Directory Structure

common/ Shared source used by more than one example. This is not a standalone example.
esp32-node/ The generic ESP32 example.
esp-box-3-display/ The ESP-BOX-3 example.

Naming Convention

*_node_cmd.c OpenClaw Node command handlers and the function that registers those commands with the node.
*_repl_cmd.c REPL command handlers and the function that registers those commands with the console.
Other .c files Helper code, board setup, runtime services, or the main application entry point.

The public esp_openclaw_node API passes command parameters as raw JSON text. The examples parse that text with cJSON explicitly inside the example sources.

Common Directory

The shared files under common/ are split the same way:

Shared device and Wi-Fi node commands: esp_openclaw_node_common_device_node_cmd.c
Shared JSON parsing and payload helpers: esp_openclaw_node_example_json.c
Shared REPL startup: esp_openclaw_node_example_repl.c
Shared REPL commands such as status, wifi, gateway, and reboot: esp_openclaw_node_example_repl_cmd.c
Shared saved-session reconnect helper: esp_openclaw_node_example_saved_session_reconnect.c
Shared Wi-Fi helpers: esp_openclaw_node_wifi.c