How gpapazachariou/esp32_diploma works
This is the ESP32 lower-controller firmware for Waveshare UGV robots. The principal workflow is an upper computer or web client sending JSON commands, which the controller handles to drive motion and optional camera gimbal or RoArm modules; it also processes sensor data and provides status through the OLED and web interface. The graph preserves documented capabilities, including ESP-NOW and LED control. Source excerpts are limited, so several firmware dispatch links are documented or marked unverified rather than inferred from module names.
Main entry points: General_Driver.ino ESP32 firmware · json_cmd.h JSON command handling · IMU.cpp IMU processing · SCS.cpp Servo protocol
Components 26
Interfaces
- ESP32 firmware
General_Driver/General_Driver.ino - UART commands
General_Driver/uart_ctrl.h - HTTP server
General_Driver/http_server.h - Web interface
General_Driver/web_page.h - JSON command handling
General_Driver/json_cmd.h - Wi-Fi control
General_Driver/wifi_ctrl.h - ESP-NOW
General_Driver/esp_now_ctrl.h
Robot control
- Motion control
General_Driver/movtion_module.h - Drive configuration
General_Driver/ugv_config.h - UGV control
General_Driver/ugv_advance.h - Camera gimbal
General_Driver/gimbal_module.h - RoArm-M2
General_Driver/RoArm-M2_module.h - LED switches
General_Driver/ugv_led_ctrl.h
Sensors and status
- IMU integration
General_Driver/IMU_ctrl.h - IMU processing
General_Driver/IMU.cpp - QMI8658 driver
General_Driver/QMI8658.cpp - AK09918 driver
General_Driver/AK09918.cpp - OLED display
General_Driver/oled_ctrl.h - Battery status
General_Driver/battery_ctrl.h - Device files
General_Driver/files_ctrl.h
Servo support
- Servo command API
SCServo/SCSCL.cpp - Servo protocol
SCServo/SCS.cpp - Servo serial transport
SCServo/SCSerial.cpp - SMS/STS servo API
SCServo/SMS_STS.cpp
Other components
- Upper computer
- Web client
Connections 25
- Upper computer → UART commands: sends JSON
README.md - UART commands → ESP32 firmware: feeds commands
- Web client → Web interface: uses interface
README.md - Web interface → HTTP server: sends requests
General_Driver/web_page.h - HTTP server → ESP32 firmware: routes requests
- ESP32 firmware → JSON command handling: dispatches commands
- ESP32 firmware → Wi-Fi control: configures connectivity
- ESP32 firmware → ESP-NOW: supports messaging
README.md - JSON command handling → Motion control: controls motion
- Motion control → Drive configuration: uses drive settings
- ESP32 firmware → UGV control: controls UGV
- JSON command handling → Camera gimbal: controls gimbal
README.md - JSON command handling → RoArm-M2: controls arm
README.md - JSON command handling → LED switches: sets LED switches
README.md - ESP32 firmware → IMU integration: initializes IMU
- IMU integration → IMU processing: delegates processing
General_Driver/IMU_ctrl.h - IMU processing → QMI8658 driver: uses sensor
- IMU processing → AK09918 driver: uses magnetometer
- ESP32 firmware → OLED display: updates display
README.md - ESP32 firmware → Battery status: reads battery
- ESP32 firmware → Device files: uses device files
- RoArm-M2 → Servo command API: uses servo API
- Servo command API → Servo protocol: issues servo commands
SCServo/SCSCL.cpp - SMS/STS servo API → Servo protocol: issues servo commands
SCServo/SMS_STS.cpp - Servo protocol → Servo serial transport: uses transport