How solitary-dev-50/tongdou works
The repository contains several firmware variants; this map focuses on the documented developer-oriented demo firmware, not the separate hardware-test firmware. Its principal workflow is a device event or command entering the application, which coordinates scenario selection and execution through robot hardware; the firmware also exposes voice, configuration, reminders, and diagnostics. The sampled App header establishes component wiring, while deeper behavior is only shown for selected modules, so unsampled subsystem internals are represented at their existing directories and uncertain links are omitted.
Main entry points: App.cpp Application · RealtimeVoiceService.cpp Realtime voice service · HardwareManager.cpp Hardware manager · WebConfigServer.cpp Web configuration
Components 20
Application runtime
- Application
demo_firmware/firmware/src/app/App.cpp - App commands
demo_firmware/firmware/src/app - Reminders
demo_firmware/firmware/src/reminder - Time service
demo_firmware/firmware/src/system/TimeService.cpp
Scenes and behavior
- Scenario selection
demo_firmware/firmware/src/scenario/ScenarioEngine.cpp - Scenario library
demo_firmware/firmware/src/scenario - Scenario execution
demo_firmware/firmware/src/scenario - Demo scene player
demo_firmware/firmware/src/demo
Voice interaction
- Realtime voice service
demo_firmware/firmware/src/realtime/RealtimeVoiceService.cpp - Realtime audio sender
demo_firmware/firmware/src/realtime/RealtimeAudioSender.cpp - TongDou voice client
demo_firmware/firmware/src/tongdou_voice/TongDouVoiceClient.cpp
Robot hardware
- Hardware manager
demo_firmware/firmware/src/hardware/HardwareManager.cpp - Sensors and actuators
demo_firmware/firmware/src/hardware - Gyro wiggle control
demo_firmware/firmware/src/motion/GyroReturnWiggleController.cpp - Hardware self-test
demo_firmware/firmware/src/diagnostic/HardwareSelfTestService.cpp
Device interfaces
- Web configuration
demo_firmware/firmware/src/web/WebConfigServer.cpp - MCP tools
demo_firmware/firmware/src/mcp/McpServer.cpp - Wi-Fi settings
demo_firmware/firmware/src/system/WifiConfigStore.cpp - Scenario configuration
demo_firmware/firmware/src/web/ScenarioConfigApi.cpp
Other components
- Device user
Connections 21
- Device user → Application: uses device
README.md - Application → Hardware manager: owns
- Application → Scenario selection: owns
- Application → Scenario execution: owns
- Application → Realtime voice service: owns
- Application → Reminders: owns
- Application → Web configuration: owns
- Application → MCP tools: owns
- Application → Demo scene player: owns
- Scenario selection → Scenario library: selects from
demo_firmware/firmware/src/scenario/ScenarioEngine.h - Gyro wiggle control → Sensors and actuators: reads IMU, drives motors
- Hardware manager → Hardware self-test: provides
- Hardware manager → Sensors and actuators: manages
demo_firmware/firmware/src/hardware/HardwareManager.h - Scenario execution → Sensors and actuators: uses
- Reminders → Time service: uses
demo_firmware/firmware/src/reminder/ReminderManager.h - Realtime voice service → Realtime audio sender: coordinates
- Realtime voice service → TongDou voice client: uses
- Web configuration → Scenario configuration: routes configuration
- Web configuration → Wi-Fi settings: uses settings
- App commands → Scenario selection: invokes
- App commands → Scenario execution: invokes
demo_firmware/firmware/src/app/App.h