How taeraemon/tag_v3 works
Project type and purpose
• This is an embedded IoT firmware project (PlatformIO/C++) for a microcontroller (e.g. ESP32) that manages device settings over BLE and WiFi, monitors battery, synchronizes time via an RTC, persists settings in EEPROM, and can transmit data over LTE or WiFi.
• The README describes a command-driven device that exposes a simple protocol (commands 1–6) for scan control, SSID configuration, advertise settings, battery queries, time sync, and factory reset.
File structure
• Top-level:
• platformio.ini → build/deployment configuration
• / & lib/ → shared headers and libraries
• src/ → application code
• test/ → Python scripts simulating HTTP/TCP servers and clients
• src/:
• main.cpp + .main.cpp → entry point
• BLE_manager.*, WiFi_manager.* → radio interfaces
• Battery_monitor.* → ADC measurement and percentage calculation
• RTC_manager.* → real-time clock interface
• EEPROM_manager.* → persistent storage
• Command_handler.* → parses incoming commands and delegates actions
• Transmission_manager.* & LTE_manager.* → over-the-air data transmission
• Presence of clear “Manager” classes indicates a modular service-oriented design.
README for additional insights
• The README lists each manager’s responsibility and the command protocol.
Elements
• Clear labels for each block (e.g., “BLE_manager”, “EEPROM_manager”, “Battery_monitor”)
• Firmware modules (Manager classes + Command_handler): another
• External entities (BLE client, cloud server): a third