Source Code and Directory Structure

aiden-firmware/
├── CMakeLists.txt                 # Main C/C++ build configuration
├── Makefile                       # Local build/test shortcut entry point
├── build.sh                       # Public binaries, image, and image-exec CLI
├── cmake/                         # Toolchain files
├── docs/                          # Structured documentation
├── edid/                          # HDMI EDID hex files
├── overlay/                       # Firmware injection files: etc/oem/userdata
├── pico-sdk/                      # Luckfox SDK submodule
├── scripts/                       # Build, release, and device helper scripts
│   └── build/
│       ├── run_container.sh       # Host-side Docker lifecycle and profiles
│       ├── host/
│       │   └── go_toolchain.sh    # Pinned Go provisioning and verification
│       └── container/
│           ├── binaries.sh        # Application binary cross-build task
│           ├── image.sh           # Firmware image build orchestrator
│           └── lib/
│               ├── ext4_images.sh # ext4 image sizing and mutation helpers
│               └── generated_binaries.sh # Generated-binary verification
├── src/                           # C/C++ SDK, services, tools
├── src/agent/                     # Go Agent
├── tests/                         # host-native unit tests
├── third_party/                   # doctest, stb, opencv-mobile, etc.
└── upgrade_tool/                  # Flashing tool

Key files in src/

File / Module	Description
aiden_sdk.*	C++ SDK entry point, providing Wakeup, AudioCapture, AudioPlayer, CameraCapture
frame_*	Frame Service, frame buffer, camera source, frame protocol and client
audio_*	Audio Service, recording/playback session, protocol and client
uds_*	Generic Unix domain socket transport layer
service_status.*	Common service status enums
image_process.*	Image cropping, black border removal, scaling, rotation
hid_server.*, example_usb_hid.cpp	USB HID gadget and HTTP example server
agent/internal/configweb/	Go Config Web HTTP service, maintaining Agent TOML and Wi-Fi configuration
agent_toml.*	C++ side Agent TOML parsing/writing

Key directories in src/agent/

Path	Description
cmd/daemon	Long-running Agent daemon providing the HTTP/Web UI in all input modes and the legacy stt or provider-backed realtime voice loop
cmd/abctl	A/B partition control utility for OTA system
cmd/ota	OTA update client
cmd/benchmark-http	Standalone LLM endpoint latency probe
cmd/test-warmup	Connection warmup measurement harness
internal/agent/runtime.go	Agent runtime, model invocation and tool loop
internal/agent/realtimevoice	Provider-neutral realtime voice session seam and native Qwen, OpenAI, xAI, Gemini, and Speko adapters
internal/agent/server.go	HTTP server / Web UI / tool API
internal/agent/tools*.go	Built-in tools such as HID, screenshot, audio, shell
internal/agent/stt.go / internal/agent/tts/ / vad.go	STT, pluggable TTS providers, RKNN/CPU VAD orchestration
internal/agent/skills*.go	Skill loading, activation and tool restrictions
config/agent.toml	Agent configuration example

overlay/ structure

overlay/
├── etc/
│   ├── aiden_audio_service.conf
│   ├── aiden_frame_service.conf
│   ├── dnsmasq.d/usb0.conf
│   └── init.d/S*
├── oem/usr/bin/
├── oem/usr/model/
└── userdata/
    ├── agent/agent.toml
    └── wpa_supplicant.conf

The build system has three explicit layers. build.sh is the only public CLI, scripts/build/run_container.sh owns host-side Docker lifecycle and the binaries and image profiles, and scripts/build/container/ contains tasks that run only inside the selected container profile. The image task copies the application binaries to overlay/oem/usr/bin/, injects the VAD model into the OEM partition along with overlay/oem/usr/model/, and syncs/injects the overlay into the pico-sdk output image.