How peterantypas/maiana works
MAIANA is an embedded AIS transponder with separate transponder and NMEA 2000 adapter firmware, plus host-side firmware-update tooling. The primary workflow is GNSS timing and position plus configured station data feeding AIS reception/transmission, then NMEA output through the chosen boat-system interface. A bootloader supports firmware updates; OpenPlotter can manage and update the device. The README documents product-level capabilities; source excerpts are limited, so several subsystem links are documented rather than verified from implementation calls.
Main entry points: RadioManager.cpp AIS radio control · Src/main.cpp NMEA0183 consumer · main.c Firmware bootloader · Src/main.cpp Transponder firmware
Components 18
Transponder firmware
- AIS radio control
latest/Firmware/Transponder/Src/RadioManager.cpp - Channel manager
latest/Firmware/Transponder/Src/ChannelManager.cpp - Station provisioning
latest/Firmware/Transponder/Inc/bsp/bsp.hpp - Transponder firmware
latest/Firmware/Transponder/Src/main.cpp
Boat interfaces
- UART NMEA0183
latest/Firmware/Transponder/Inc - NMEA0183 consumer
latest/Firmware/NMEA2000Adapter/Core/Src/main.cpp - Sentence handling
latest/Firmware/NMEA2000Adapter/Core/Src/NMEASentence.cpp - NMEA 2000 stack
latest/Firmware/NMEA2000Adapter/nmea2000/NMEA2000.cpp - CAN adapter
latest/Firmware/NMEA2000Adapter/n2k_mcp/NMEA2000_mcp.cpp - Adapter event queue
latest/Firmware/NMEA2000Adapter/Core/Src/EventQueue.cpp
Firmware updates
- Update application
latest/Apps/maiana-update/mainframe.py - Device update client
latest/Apps/maiana-update/maianaclient.py - Firmware bootloader
latest/Firmware/Bootloader/Src/main.c - Firmware flash
Hardware services
- STM32 hardware layer
latest/Firmware/Bootloader/Drivers/STM32L4xx_HAL_Driver/Src/stm32l4xx_hal.c
Other components
- Boat operator
- GNSS receiver
- Boat systems
Connections 16
- GNSS receiver → AIS radio control: provides timing
- Station provisioning → Transponder firmware: configures station
- Transponder firmware → AIS radio control: controls radio
- Channel manager → AIS radio control: selects channels
- AIS radio control → UART NMEA0183: outputs AIS data
latest/Firmware/Transponder/Src/RadioManager.cpp - UART NMEA0183 → NMEA0183 consumer: sends serial data
- NMEA0183 consumer → Sentence handling: processes sentences
latest/Firmware/NMEA2000Adapter/Core/Src/main.cpp - NMEA0183 consumer → Adapter event queue: dispatches events
latest/Firmware/NMEA2000Adapter/Core/Src/main.cpp - Sentence handling → NMEA 2000 stack: encodes NMEA data
- NMEA 2000 stack → CAN adapter: uses CAN adapter
- CAN adapter → Boat systems: outputs NMEA 2000
- Boat operator → Update application: requests update
- Update application → Device update client: starts update
latest/Apps/maiana-update/mainframe.py - Device update client → Firmware bootloader: transfers firmware
- Firmware bootloader → Firmware flash: validates and installs
latest/Firmware/Bootloader/Src/main.c - Firmware bootloader → STM32 hardware layer: controls hardware
latest/Firmware/Bootloader/Src/main.c