How horizon-fyz/esp32-s3-above works
This firmware is an ESP32-S3 surface-robot controller. The main workflow is a host sending TCP control frames: the application parses them, mixes propulsion commands, and drives the ESCs and drum motor; it also accepts console commands and reports navigation/status data. Other documented capabilities include gimbal positioning, optional MPU-based stabilization, and W5500 networking. The README establishes several subsystem links; sampled source confirms the network manager’s SPI and chip initialization. Unsampled runtime details are not expanded beyond documented behavior.
Main entry points: main.c Application Runtime · wiznet_manager.c Network Manager · gimbal.c Gimbal Planner · nav.c Navigation Driver
Components 15
Application
- Application Runtime
main/main.c - Serial Console
main/main.c
W5500 Networking
- Network Manager
components/wiznet/src/wiznet_manager.c - SPI Bridge
components/wiznet/src/wiznet_spi.c - Socket Wrappers
components/wiznet/src/wiznet_socket.c - TCP Socket Stack
components/wiznet/Ethernet/socket.c - W5500 Driver
components/wiznet/Ethernet/W5500/w5500.c
Control and Motion
- Frame Protocol
components/control/control.c - Motor Control
components/motor/motor.c - Gimbal Planner
components/gimbal/gimbal.c - Servo Driver
components/servo/servo.c
Sensors and Telemetry
- Gimbal IMU
components/imu/imu.c - Navigation Driver
components/nav/nav.c
Other components
- Control Host
- Navigation Module
Connections 19
- Control Host → Application Runtime: sends frames
README.md - Application Runtime → Network Manager: starts networking
main/main.c - Application Runtime → Socket Wrappers: serves TCP
main/main.c - Socket Wrappers → TCP Socket Stack: wraps calls
- Network Manager → SPI Bridge: initializes
components/wiznet/src/wiznet_manager.c - Network Manager → W5500 Driver: configures
components/wiznet/src/wiznet_manager.c - Application Runtime → Frame Protocol: parses commands
README.md - Frame Protocol → Application Runtime: calls callback
- Application Runtime → Motor Control: applies drive
README.md - Application Runtime → Serial Console: handles commands
README.md - Application Runtime → Gimbal Planner: sets position
README.md - Gimbal Planner → Servo Driver: writes trajectories
- Application Runtime → Servo Driver: initializes
main/main.c - Application Runtime → Navigation Driver: starts navigation
README.md - Navigation Module → Navigation Driver: streams UART data
README.md - Navigation Driver → Application Runtime: provides snapshots
- Application Runtime → Control Host: sends telemetry
README.md - Application Runtime → Gimbal IMU: initializes optionally
main/main.c - Gimbal IMU → Gimbal Planner: feeds attitude