# ewoutbergsma/mobile_thread_device_robot architecture

> Architecture diagram of the GitHub repository ewoutbergsma/mobile_thread_device_robot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ewoutbergsma/mobile_thread_device_robot
- Repository: https://github.com/ewoutbergsma/mobile_thread_device_robot

## Overview

This repository combines robot experiment runners and UART logging with an ESP32 OpenThread CLI firmware and offline log analysis. The documented experiment workflow is to launch a movement script alongside the UART logger; logs can then be parsed and visualized. The firmware initializes OpenThread and registers custom CLI extensions. The tree also contains substantial socket, Wi-Fi, iperf, and LED-strip capabilities. Relationships among unsampled firmware modules are omitted; the graph only draws links supported by excerpts, the source index, or README statements.

Main entry points: [`esp32_ot_cli_551/main/esp_ot_cli.c`](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/main/esp_ot_cli.c) (OpenThread CLI Runtime), [`esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_api.c`](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_api.c) (LED Strip API), [`openthread_log_parser.py`](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/openthread_log_parser.py) (Log Parser), [`wander.py`](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/wander.py) (Wander Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiment["Robot Experiments"]
  node_wander["Wander Runner<br/>[wander.py]"]
  node_wall_follow["Wall Follow Runner"]
  node_uart_logger["UART Logger"]
end

subgraph group_analysis["Log Analysis"]
  node_parser["Log Parser"]
  node_visualizer["Log Visualizer"]
  node_homography["Homography Mapping<br/>[homography.py]"]
end

subgraph group_firmware["OpenThread Firmware"]
  node_ot_runtime["OpenThread CLI Runtime<br/>[esp_ot_cli.c]"]
  node_ot_config["OpenThread Configuration<br/>[esp_ot_config.h]"]
  node_cli_extension["CLI Extension Registry"]
  node_tcp_socket["TCP Socket Commands"]
  node_udp_socket["UDP Socket Commands"]
  node_wifi_commands["Wi-Fi Commands<br/>[esp_ot_wifi_cmd.c]"]
  node_curl["Curl Commands<br/>[esp_ot_curl.c]"]
  node_dns64["DNS64 Commands<br/>[esp_ot_dns64.c]"]
  node_nvs_diag["NVS Diagnostics<br/>[esp_ot_nvs_diag.c]"]
  node_ota_commands["OTA Commands"]
end

subgraph group_device_tools["Device Tools"]
  node_iperf["Iperf Traffic<br/>[iperf.c]"]
  node_led_api["LED Strip API<br/>[led_strip_api.c]"]
  node_led_rmt["LED RMT Driver"]
  node_led_spi["LED SPI Driver"]
end

node_operator(("Experiment Operator"))

node_operator -->|"launches"| node_wander
node_operator -->|"launches"| node_wall_follow
node_operator -->|"launches"| node_uart_logger
node_parser -->|"provides metrics"| node_visualizer
node_ot_runtime -->|"uses defaults"| node_ot_config
node_ot_runtime -->|"initializes"| node_cli_extension
node_led_api -->|"dispatches"| node_led_rmt
node_led_api -->|"dispatches"| node_led_spi

click node_wander "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/wander.py"
click node_wall_follow "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/wall_follow_and_log.py"
click node_uart_logger "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_uart_logger.py"
click node_parser "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/openthread_log_parser.py"
click node_visualizer "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/openthread_log_visualizer.py"
click node_homography "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/homography_map/homography.py"
click node_ot_runtime "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/main/esp_ot_cli.c"
click node_ot_config "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/main/esp_ot_config.h"
click node_cli_extension "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_cli_extension.c"
click node_tcp_socket "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_tcp_socket.c"
click node_udp_socket "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_udp_socket.c"
click node_wifi_commands "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_wifi_cmd.c"
click node_iperf "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__iperf/iperf.c"
click node_led_api "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_api.c"
click node_led_rmt "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_rmt_dev.c"
click node_led_spi "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_spi_dev.c"
click node_curl "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_curl.c"
click node_dns64 "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_dns64.c"
click node_nvs_diag "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_nvs_diag.c"
click node_ota_commands "https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_ota_commands.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_wander,node_wall_follow,node_uart_logger toneBlue
class node_parser,node_visualizer,node_homography toneAmber
class node_ot_runtime,node_ot_config,node_cli_extension,node_tcp_socket,node_udp_socket,node_wifi_commands,node_curl,node_dns64,node_nvs_diag,node_ota_commands toneMint
class node_iperf,node_led_api,node_led_rmt,node_led_spi toneRose
class node_operator toneIndigo
```

## Components

### Robot Experiments

- [Wander Runner](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/wander.py): `wander.py`
- [Wall Follow Runner](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/wall_follow_and_log.py): `wall_follow_and_log.py`
- [UART Logger](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_uart_logger.py): `esp32_uart_logger.py`

### Log Analysis

- [Log Parser](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/openthread_log_parser.py): `openthread_log_parser.py`
- [Log Visualizer](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/openthread_log_visualizer.py): `openthread_log_visualizer.py`
- [Homography Mapping](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/homography_map/homography.py): `homography_map/homography.py`

### OpenThread Firmware

- [OpenThread CLI Runtime](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/main/esp_ot_cli.c): `esp32_ot_cli_551/main/esp_ot_cli.c`
- [OpenThread Configuration](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/main/esp_ot_config.h): `esp32_ot_cli_551/main/esp_ot_config.h`
- [CLI Extension Registry](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_cli_extension.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_cli_extension.c`
- [TCP Socket Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_tcp_socket.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_tcp_socket.c`
- [UDP Socket Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_udp_socket.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_udp_socket.c`
- [Wi-Fi Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_wifi_cmd.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_wifi_cmd.c`
- [Curl Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_curl.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_curl.c`
- [DNS64 Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_dns64.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_dns64.c`
- [NVS Diagnostics](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_nvs_diag.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_nvs_diag.c`
- [OTA Commands](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_ota_commands.c): `esp32_ot_cli_551/managed_components/espressif__esp_ot_cli_extension/src/esp_ot_ota_commands.c`

### Device Tools

- [Iperf Traffic](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__iperf/iperf.c): `esp32_ot_cli_551/managed_components/espressif__iperf/iperf.c`
- [LED Strip API](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_api.c): `esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_api.c`
- [LED RMT Driver](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_rmt_dev.c): `esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_rmt_dev.c`
- [LED SPI Driver](https://github.com/ewoutbergsma/mobile_thread_device_robot/blob/main/esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_spi_dev.c): `esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_spi_dev.c`

### Other components

- **Experiment Operator**

## Connections

- Experiment Operator → Wander Runner: launches
- Experiment Operator → Wall Follow Runner: launches
- Experiment Operator → UART Logger: launches
- Log Parser → Log Visualizer: provides metrics (evidence: `openthread_log_visualizer.py`)
- OpenThread CLI Runtime → OpenThread Configuration: uses defaults (evidence: `esp32_ot_cli_551/main/esp_ot_cli.c`)
- OpenThread CLI Runtime → CLI Extension Registry: initializes (evidence: `esp32_ot_cli_551/main/esp_ot_cli.c`)
- LED Strip API → LED RMT Driver: dispatches (evidence: `esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_rmt_dev.c`)
- LED Strip API → LED SPI Driver: dispatches (evidence: `esp32_ot_cli_551/managed_components/espressif__led_strip/src/led_strip_spi_dev.c`)
