How theowenyoung/ai-passport works
FoloToy AI Passport is an open wearable-device firmware baseline; the README describes main as a runnable hardware-test demo, not a finished application. The user-facing flow is button input → menu navigation → a selected hardware demo → device feedback or a radio/sleep result. The graph preserves the documented display, button, audio, battery, Wi-Fi, BLE, and low-power demos plus the BSP and shared UI layer. Several demo and BSP relationships come from the SOURCE INDEX; links not established by shown calls are omitted or marked unverified.
Main entry points: main.c Firmware lifecycle · demo_low_power.c Low-power demo · ui_pixel.c Pixel UI helpers · bsp_display.c Display driver
Components 19
Demo application
- Firmware lifecycle
main/main.c - Menu navigation
main/demo_navigation.c - Display demo
main/demo_display.c - Button demo
main/demo_button.c - Audio demo
main/demo_audio.c - Battery demo
main/demo_battery.c - Low-power demo
main/demo_low_power.c
Board support
- Button input
components/bsp/src/bsp_button.c - Display driver
components/bsp/src/bsp_display.c - Audio driver
components/bsp/src/bsp_audio.c - Battery sensing
components/bsp/src/bsp_battery.c - Shared I2C
components/bsp/src/bsp_i2c.c - Board pin map
components/bsp/include/bsp_pins.h - LVGL display port
components/bsp/src/bsp_display_lvgl.c
Shared UI
- Pixel UI helpers
main/ui_pixel.c
Radio services
- Wi-Fi scan
main/demo_wifi.c - BLE advertising
main/demo_ble.c - Radio setup
main/demo_radio.c
Other components
- Device user
Connections 34
- Device user → Button input: presses
- Button input → Firmware lifecycle: sends events
- Firmware lifecycle → Menu navigation: routes input
main/main.c - Firmware lifecycle → Display demo: dispatches demo
- Firmware lifecycle → Button demo: dispatches demo
- Firmware lifecycle → Audio demo: dispatches demo
- Firmware lifecycle → Battery demo: dispatches demo
- Firmware lifecycle → Wi-Fi scan: dispatches demo
- Firmware lifecycle → BLE advertising: dispatches demo
- Firmware lifecycle → Low-power demo: dispatches demo
- Display demo → Pixel UI helpers: uses helpers
main/demo_display.c - Button demo → Pixel UI helpers: uses helpers
main/demo_button.c - Audio demo → Audio driver: plays and records
main/demo_audio.c - Audio demo → Display driver: locks UI
main/demo_audio.c - Audio demo → Pixel UI helpers: uses helpers
main/demo_audio.c - Battery demo → Battery sensing: reads level
main/demo_battery.c - Battery demo → Pixel UI helpers: uses helpers
main/demo_battery.c - Wi-Fi scan → Radio setup: prepares radio
main/demo_wifi.c - BLE advertising → Radio setup: uses setup
main/demo_ble.c - Wi-Fi scan → Pixel UI helpers: shows results
main/demo_wifi.c - BLE advertising → Pixel UI helpers: uses helpers
main/demo_ble.c - Low-power demo → Audio driver: suspends audio
main/demo_low_power.c - Low-power demo → Battery sensing: suspends gauge
main/demo_low_power.c - Low-power demo → Display driver: suspends display
main/demo_low_power.c - Low-power demo → Shared I2C: releases bus
main/demo_low_power.c - Low-power demo → Pixel UI helpers: updates status
main/demo_low_power.c - Button input → Board pin map: uses configuration
components/bsp/src/bsp_button.c - Display driver → Board pin map: uses configuration
components/bsp/src/bsp_display.c - Audio driver → Board pin map: uses configuration
components/bsp/src/bsp_audio.c - Audio driver → Shared I2C: uses bus
components/bsp/src/bsp_audio.c - Battery sensing → Board pin map: uses configuration
components/bsp/src/bsp_battery.c - Battery sensing → Shared I2C: uses bus
components/bsp/src/bsp_battery.c - LVGL display port → Display driver: adapts driver
components/bsp/src/bsp_display_lvgl.c - Display driver → LVGL display port: initializes port