ARV Embedded Firmware

Project	Board	Description
estop_tx	ESP32	LoRa e-stop transmitter (handheld button)
estop_rx	ESP32	LoRa e-stop receiver (on robot)
led_status	Arduino Mega	RGB LED strip status controller
recovery_ultrasonic	Arduino Mega	Three HC-SR04 sensors, streams minimum distance over serial

Setup

First run the host bootstrap if you haven't. Then:

just setup

VSCode: Install recommended extensions in this repo (it should automatically prompt you).

Windows: Everything works natively from PowerShell (no WSL2 needed). If your board isn't detected, you may need the CP210x (most ESP32 boards) or CH340 (most Arduino clones) USB-serial driver.

Commands

# See available commands
just

Build & Upload

# Build one project
just build estop_tx

# Build all projects
just build

# Upload to connected board
just upload estop_tx

# Open serial monitor
just monitor estop_rx

# List available serial ports
just ports

Formatting & Linting

# Check formatting
just lint

# Auto-fix formatting
just format

Adding a New Project

just create-project my_project

Copies template_project to my_project/. The template defaults to our ESP32 board config with a commented-out Arduino Mega alternative. Edit platformio.ini if your board differs, and add the project to the table above. For other boards see the PlatformIO board explorer.

IntelliSense

Clangd reads each project's compile_commands.json, generated by just setup. Run just intellisense to regenerate after a platformio.ini changes (yours or a pulled one), or whenever clangd shows stale errors.