How coconut-e/music_nano works
music_nano is an ESP32 microSD music player: the user browses scanned media, selects a track, and sends decoded audio over Bluetooth A2DP to headphones. The firmware also offers lyrics, novel reading, device settings and power management, plus Wi-Fi OTA updates. The graph follows the documented startup and playback workflow and preserves these major feature branches. Some subsystems are represented by tree-supported implementation paths but were not sampled; their links are included only where the README documents them.
Main entry points: main.c Firmware Startup · audio_task.cpp Audio Decode · ui_player.c Music Player UI · ui_settings_wifi.c Wi-Fi Settings
Components 22
Media and Audio
- Media Scan
main/storage/media_scan.c - Media Index
main/storage/sys_monitor.c - Audio Decode
main/audio/audio_task.cpp - Format Decoders
main/audio/decoder_mp3.cpp - PCM Conversion
main/audio/pcm_pipeline.cpp - Cover Decode
main/audio/cover.cpp
User Interface
- Media Browser
main/ui/menu/menu_browser.c - Music Player UI
main/ui/ui_player.c - Lyrics View
main/ui/ui_lyrics.c - Novel Reader
main/ui/ui_novel.c - Settings UI
main/ui/ui_settings.c - Wi-Fi Settings
main/ui/ui_settings_wifi.c
Connectivity and Updates
- Bluetooth Audio
main/bt/bt_a2dp.c - Wi-Fi Manager
main/app/wifi_mgr.c - OTA Updates
main/app/ota.c
Device Services
- Firmware Startup
main/main.c - Power Management
main/power/power_mgr.c - Battery Monitor
main/power/power_batt.c - Display Driver
main/drivers/drv_display.c - Touch Input
main/drivers/touch.c
Other components
- User
- Headphones
Connections 24
- User → Media Browser: browses media
README.md - Firmware Startup → Media Scan: starts services
main/main.c - Media Scan → Media Index: builds index
README.md - Media Index → Media Browser: provides listings
README.md - Media Browser → Music Player UI: selects track
main/ui/menu/menu_browser.c - Music Player UI → Audio Decode: sends commands
README.md - Audio Decode → Format Decoders: decodes formats
README.md - Audio Decode → PCM Conversion: converts PCM
- Audio Decode → Bluetooth Audio: streams PCM
README.md - Bluetooth Audio → Headphones: plays audio
README.md - Audio Decode → Cover Decode: extracts artwork
README.md - Cover Decode → Music Player UI: supplies cover
main/ui/ui_player.c - Music Player UI → Lyrics View: opens lyrics
README.md - User → Novel Reader: reads novels
README.md - User → Settings UI: configures device
README.md - Settings UI → Wi-Fi Settings: opens Wi-Fi
main/ui/ui_settings_wifi.c - Wi-Fi Settings → Wi-Fi Manager: manages Wi-Fi
main/ui/ui_settings_wifi.c - Wi-Fi Settings → OTA Updates: starts updates
README.md - Firmware Startup → OTA Updates: initializes OTA
main/main.c - Firmware Startup → Bluetooth Audio: initializes Bluetooth
main/main.c - Firmware Startup → Power Management: initializes power
main/main.c - Firmware Startup → Battery Monitor: checks battery
main/main.c - Firmware Startup → Display Driver: initializes display
main/main.c - Firmware Startup → Touch Input: starts input