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.

A completed Gnimu device in a white case, with the GNSS antenna exposed on top and a power switch on the side
A completed battery-powered build on the XIAO nRF52840.

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

Support for the RaceChrono DIY protocol is planned for a future version.