QRET Avionics Libraries

Shared firmware libraries for QRET's avionics stack — the communication, logging, and storage infrastructure the STM32 and ESP32 nodes build on.

What's Inside

• aim_network: CAN bus communication, time synchronization, and network health monitoring.
• aim_logger: Lightweight logger that stamps each message with a timestamp and severity (DEBUG–ERROR).
• aim_flash_storage: Telemetry storage to internal or SPI NOR flash via littlefs, with RDES compression.

Build

PlatformIO manages libraries and board configs (install guide):

• Compile: pio run
• Upload: pio run --target upload
• Serial monitor: pio device monitor

Quick Start

Open an example as a PlatformIO project (e.g. aim_network/examples/stm32_canbus) — these are the recommended starting point for new firmware. Use standard Arduino calls for hardware, and the logger instead of Serial.print():

int pressureValue = analogRead(A0);
LOG_INFO("Pressure value is: %d", pressureValue);

Design Notes

• The CAN network is intentionally narrow and predictable: mailbox-driven TX, content-based addressing (consumers filter by message class/subject — there is no destination field), bounded RX polling, and fixed-size static queues.
• STM32 uses an internal HAL-based bxCAN backend; ESP32 uses TWAI. No external CAN libraries.