How nationalroboticsleague-nrl/nrl-nationalroboticsleague works
NRL is a dual-ESP32-S3 robotics platform: teams write robot behavior as OpModes, while the libraries provide the control loop, hardware interfaces, telemetry, display, and wireless link to a handheld controller. The repository also documents a project generator and a blocks editor as student-facing authoring capabilities. Several firmware modules are prebuilt or unsampled, so the graph omits unverified internal call paths; documented capabilities and visible header relationships are retained.
Main entry points: opmodes Student OpModes · NRLComms.h Robot communications · HexaDCMotor.h DC motors · BoardPins.h Board pin map
Components 18
Robot Runtime
- Student OpModes
RobotFirmware/opmodes - OpMode runtime
RobotFirmware/lib/HexaNRL/src/NRLOpMode.h - Action system
RobotFirmware/lib/HexaNRL/src/NRLAction.h - Drive actions
RobotFirmware/lib/HexaNRL/src/DriveActions.h - Tank drive
RobotFirmware/lib/HexaNRL/src/TankDrive.h - Telemetry API
RobotFirmware/lib/HexaNRL/src/NRLTelemetry.h - Robot ESP32
RobotFirmware/src/RobotMain.ino
Robot Hardware
- DC motors
lib/HexaServos/src/HexaDCMotor.h - Servo motors
lib/HexaServos/src/HexaServo.h - Power sensing
lib/HexaPower/src/HexaPower.h - IMU sensing
lib/HexaIMU/src/HexaIMU.h - Robot OLED
lib/HexaOLED/src/HexaOLED.h - Board pin map
RobotFirmware/lib/HexaNRL/src/BoardPins.h
Controller Link
- Robot communications
RobotFirmware/lib/HexaNRL/src/NRLComms.h - Handheld controller
Student Authoring
- Blocks editor AST
tools/blocks-editor/nrl-ast.mjs - Project generator
tools/nrl_new_project.py
Other components
- Robot team
Connections 19
- Robot team → Student OpModes: writes behavior
README.md - Student OpModes → OpMode runtime: implements hooks
RobotFirmware/lib/HexaNRL/src/NRLOpMode.h - OpMode runtime → Action system: runs actions
RobotFirmware/lib/HexaNRL/src/NRLOpMode.h - Student OpModes → Drive actions: uses drive routines
- Drive actions → Tank drive: controls drive
RobotFirmware/lib/HexaNRL/src/DriveActions.h - Tank drive → DC motors: uses motors
RobotFirmware/lib/HexaNRL/src/TankDrive.h - Student OpModes → Robot communications: reports telemetry
- Telemetry API → Robot communications: sends telemetry
RobotFirmware/lib/HexaNRL/src/NRLTelemetry.h - Robot ESP32 → Robot communications: runs wireless link
- Handheld controller → Robot communications: pairs via ESP-NOW
README.md - Student OpModes → DC motors: commands
- Student OpModes → Servo motors: commands
- Student OpModes → Power sensing: reads rails
README.md - Student OpModes → IMU sensing: reads orientation
- Student OpModes → Robot OLED: updates display
- Board pin map → DC motors: defines pins
RobotFirmware/lib/HexaNRL/src/BoardPins.h - Board pin map → Power sensing: defines channels
RobotFirmware/lib/HexaNRL/src/BoardPins.h - Robot team → Blocks editor AST: authors blocks
tools/blocks-editor/nrl-ast.mjs - Robot team → Project generator: creates project
README.md