Software overview
Veetr brings together firmware inside Veetr Vane, native apps for iPhone and Android, a Progressive Web App (PWA), and race management on the website. Use the phone app to record sailing with phone GPS, add Veetr Vane for instrument data, or join a race organized on the website.
The software parts
| Software | Runs on | Main responsibility |
|---|---|---|
| Firmware | The ESP32 inside Veetr | Reads the wind, GPS, and motion sensors; calculates derived values; stores device settings; and publishes sailing data over BLE. |
| Progressive Web App | A compatible web browser | Connects to Veetr, turns its data into sailing instruments, stores recent readings locally, shows the track map, and manages the device. |
| Native apps | iPhone and Android | Display instruments, record trips, show race courses, and provide start-line and anchor tools. Phone GPS recording works without Veetr Vane. |
| Race management | The Veetr website | Organizes series, invitations, courses, heats, tracking, and results for referees, sailors, and spectators. |
From sensor to screen
- The firmware reads the ultrasonic wind sensor over RS485, the GPS receiver over UART, and the IMU over I²C.
- It validates the readings and calculates values such as true wind speed and angle.
- About once per second, it sends a compact JSON message through a BLE notification.
- The native app or PWA translates that message into speed, wind, heading, heel, GPS, and starting-line displays.
- Commands travel in the other direction when you calibrate the unit, rename it, configure a starting line, or start an update.
Wind + GPS + IMU → ESP32 firmware → Bluetooth LE → Native app or PWA → instruments and local history ← device commands and firmware updatesDirect instrument connection
The live instrument connection is between your display device and Veetr Vane over Bluetooth; it does not need a cloud service. The PWA stores sailing history in that browser’s IndexedDB database, while the ESP32 stores its device settings in non-volatile memory. Neither is uploaded to a Veetr account.
Internet access is useful for loading or updating the PWA, checking GitHub for a new firmware release, and downloading map tiles. The cached app interface and an already established BLE connection can continue without internet access.
Native apps also store recordings on the phone. Race invitations, live position sharing, and account features use online services. See the native-app reference and recording and sharing guide for those workflows.
Choose what you need
- Using the phone app: read the native-app reference, or view screenshots and request beta access.
- Using Veetr: start with the user setup guide, then use the firmware update guide when needed.
- Understanding the device: read the firmware and PWA reference pages.
- Contributing code: use the development guide and PlatformIO configuration.