Gnimu GNSS+IMU firmware
Gnimu turns a microcontroller, a GNSS module and an IMU into a motorsports telemetry source that streams live position, speed and motion data over Bluetooth Low Energy (BLE) at up to 25Hz.
Gnimu streams the Gnimu protocol, the open telemetry format shared by every Gnimu device. One fixed-layout frame carries position, speed, motion and power data, so an app set up for one Gnimu device works with all of them, including Gnimu-CAN.
For broader compatibility, Gnimu can instead be built to stream the publicly documented RaceBox BLE data protocol, so that apps and tools that already read RaceBox data can use it too. Only the streaming data is implemented, not RaceBox’s own commands. The protocol is chosen when the firmware is built.
A device advertises as Gnimu (Gnimu-protocol builds) or Gnimu-RB (RaceBox builds), followed by a device-unique ID. Some apps only look for devices with the name they expect; the configuration guide explains how to change it.
Supported boards
One firmware builds for both boards.
| ESP32 | XIAO nRF52840 | |
|---|---|---|
| Microcontroller | ESP32-WROOM-32 dev board | Seeed XIAO nRF52840 Sense |
| Power | USB | 3.7V LiPo battery or USB |
| GNSS | HGLRC M100-5883 | HGLRC M100-5883 |
| IMU | External MPU-6050 | Onboard LSM6DS3TR-C |
| Construction | Hand-wired | Hand-wired, or on the Gnimu carrier PCB |
| Best for | A simple, always-plugged-in build | A portable, battery-powered build |
Self-calibrating
The firmware measures its own mounting tilt and gyroscope zero point the first time the car is parked with a GNSS fix. There is no calibration step to remember before each session.
Device commands
A Gnimu can be told to re-trim its IMU, restart, or switch off, from its serial console or, on RaceBox builds, over BLE from Gnimu Monitor. A connected app can also read how the device was configured.
Where to go next
- Build guide: ESP32
- Build guide: XIAO nRF52840
- Building and flashing
- Releases
- Report a problem or ask a question
Support for the RaceChrono DIY protocol is planned for a future version.