How theorigaux/projet-robot-lora works
The repository’s runtime product is a LoRa-controlled robot with a web joystick and a Raspberry Pi serial bridge. The main path is browser input → PHP/SQLite state → Python bridge → transmitter → robot receiver, with distance reported back to the web UI. The README also documents autonomous obstacle avoidance and an OLED/physical-joystick transmitter interface. Project-management automation is represented as a separate capability; its external wiring is not established by the sampled source.
Main entry points: TX.cpp LoRa transmitter · dir.db Command and distance state · index.html Web interface · RX.cpp Robot receiver
Components 17
Web control
- Web interface
web/public/index.html - Joystick endpoint
web/public/update.php - Mode endpoint
web/public/update_mode.php - Distance endpoint
web/public/get_distance.php - Command and distance state
web/public/dir.db
Command bridge
- Serial bridge loop
web/public/test-communication.py
LoRa robot
- LoRa transmitter
arduino/emetteur/TX.cpp - Robot receiver
arduino/recepteur/RX.cpp - Ultrasonic ranging
arduino/recepteur/RX.cpp - Motor control
arduino/recepteur/RX.cpp
Project automation
- Issue and board automation
scripts/project_manager.py
Other components
- Robot operator
- USB serial
- Physical joystick
- Status OLED
- LoRa link
- Robot motors
Connections 21
- Robot operator → Web interface: controls
README.md - Web interface → Joystick endpoint: sends joystick
web/public/update.php - Web interface → Mode endpoint: sets mode
web/public/update_mode.php - Web interface → Distance endpoint: polls distance
web/public/get_distance.php - Joystick endpoint → Command and distance state: writes coordinates
web/public/update.php - Mode endpoint → Command and distance state: writes mode
web/public/update_mode.php - Serial bridge loop → Command and distance state: reads commands
web/public/test-communication.py - Serial bridge loop → Command and distance state: writes distance
web/public/test-communication.py - Distance endpoint → Command and distance state: reads distance
web/public/get_distance.php - Serial bridge loop → USB serial: sends commands
web/public/test-communication.py - USB serial → Serial bridge loop: returns readings
web/public/test-communication.py - USB serial → LoRa transmitter: serial commands
arduino/emetteur/TX.cpp - Physical joystick → LoRa transmitter: provides axes
arduino/emetteur/TX.cpp - LoRa transmitter → LoRa link: transmits controls
arduino/emetteur/TX.cpp - LoRa link → Robot receiver: delivers controls
arduino/recepteur/RX.cpp - Robot receiver → LoRa link: returns distance
arduino/recepteur/RX.cpp - LoRa link → LoRa transmitter: delivers distance
arduino/emetteur/TX.cpp - LoRa transmitter → Status OLED: displays status
arduino/emetteur/TX.cpp - Robot receiver → Ultrasonic ranging: measures distance
arduino/recepteur/RX.cpp - Robot receiver → Motor control: selects movement
arduino/recepteur/RX.cpp - Motor control → Robot motors: drives motors
arduino/recepteur/RX.cpp