Knowledge · Guide
Get engine, tanks, and batteries into your logbook over NMEA 2000
The Logbook app reads engine RPM, engine hours, tank levels, battery values, barometric pressure, heel, and trim straight from your onboard network. It recognizes the right NMEA 2000 PGNs, XDR sentences, and Signal K paths on its own. You don't have to configure anything by hand anymore.
Updated: November 2026
In short
- What gets logged
- RPM and engine hours, tank levels, battery voltage or state of charge, barometric pressure, air temperature, heel, and trim.
- Where it comes from
- Straight from NMEA 2000 (e.g., PGN 127488, 127489, 127505, 127508), from XDR sentences in NMEA 0183, or from Signal K.
- Limits
- Up to 3 engines, 3 batteries, 4 fuel tanks, 3 fresh water tanks, and 2 gray water tanks.
- Key settings
- Put the NMEA source first in the data source order, map your tanks to their NMEA 2000 instances, pick volts or percent for batteries.
- No longer needed
- regular expressions, data type, and multiplier.
Which values the app logs
| Value | Count | NMEA 2000 | NMEA 0183 | Signal K |
|---|---|---|---|---|
| Engine RPM | up to 3 engines | PGN 127488 | RPM, XDR | propulsion.<id>.revolutions |
| Engine hours | up to 3 engines | PGN 127489 | XDR | propulsion.<id>.runTime |
| Fuel tank | up to 4 | PGN 127505 | XDR | tanks.fuel.<id> |
| Fresh water tank | up to 3 | PGN 127505 | XDR | tanks.freshWater.<id> |
| Gray and black water | up to 2 | PGN 127505 | XDR | tanks.wasteWater.<id> |
| Battery voltage | up to 3 | PGN 127508 | XDR | electrical.batteries.<id>.voltage |
| Battery state of charge | up to 3 | PGN 127506 | — | electrical.batteries.<id>.capacity.stateOfCharge |
| Barometric pressure | 1 | PGN 130314, 130311, 130310 | MDA, MMB, XDR | environment.outside.pressure |
| Air temperature | 1 | PGN 130312, 130316, 130311, 130310 | MDA, MTA, XDR | environment.outside.temperature |
| Heel (roll), trim (pitch) | 1 | PGN 127257 | XDR | navigation.attitude |
Step 1: Connect
Connect the app to your gateway as described in Connect NMEA over Wi-Fi. After that, under Settings › Data sources › NMEA connection settings, the Received Data list shows the sections Engine hours, Engine RPM, Fuel Tanks, Freshwater Tanks, Gray water, Batteries, and Trim & List with their live values.
If a value doesn't show up there, your onboard network isn't delivering it or the gateway is filtering out the PGN.
Step 2: Put the data source first
Out of the box, the app carries over the value from the last entry for tanks and batteries and calculates engine hours itself. To get the sensor reading into the entry instead:
- Open Settings › Data sources › Define data sources.
- Pick the value, for example “Fuel level” or “Engine 1 hours.”
- Drag the NMEA source to the top, for example “NMEA 2000 127505.”
In the NMEA settings, “1.” then marks the source that goes into new entries.
Step 3: Map tanks to instances
Every tank sender on the NMEA 2000 network has an instance number from 0 to 15. The instance is set in the sensor or on the chartplotter and is often numbered consecutively across all tanks. Your second diesel tank might then have instance 3 rather than 1.
In the NMEA settings, the Fuel Tanks, Freshwater Tanks, and Gray water sections each have an item called NMEA 2000 Instances. That's where you set which instance goes into which tank in the app.
For gray water, you map gray water (fluid type 2) and black water (type 5) separately. Both end up in the app's gray water tanks.
Tank size: If the sensor reports a different tank size than the one you've entered in the app, the app shows a note with the path to the right setting. Make the sizes match, or the volume figures won't be right.
Step 4: Batteries, voltage or state of charge
Under Batteries › Import you choose for each battery whether the Voltage (V) or the State of Charge (%) goes into your logbook. The app shows sources with the other unit grayed out.
NMEA 2000 instances 0, 1, and 2 become battery 1, 2, and 3.
Step 5: Engine, switching between sail and motor automatically
The Engine RPM section has the switch Automatically switch between sail and motor. When it's on, the app creates an entry on its own as soon as engine 1's RPM rises above 50 rpm or drops below it, and changes the boat status between Sailing and Motoring.
Requirements:
- Recording is on (blue frame visible).
- Advanced engine selection is off in the logbook settings.
- Valid RPM data is coming in.
NMEA 2000 instances 0, 1, and 2 become engine 1, 2, and 3.
All supported NMEA 2000 PGNs
| PGN | Name | Delivers |
|---|---|---|
| 129025 | Position, Rapid Update | Position |
| 129029 | GNSS Position Data | Position, GPS accuracy |
| 129539 | GNSS DOPs | GPS accuracy |
| 129026 | COG & SOG, Rapid Update | Course and Speed Over Ground |
| 127250 | Vessel Heading | True heading |
| 127258 | Magnetic Variation | Magnetic variation for PGN 127250 |
| 128259 | Speed, Water Referenced | Calculating the current |
| 130577 | Direction Data | Course, speed, current |
| 130306 | Wind Data | True and apparent wind |
| 128267 | Water Depth | Water depth |
| 128275 | Distance Log | Trip log (total and trip) |
| 130312, 130316 | Temperature | Water and air temperature |
| 130310, 130311 | Environmental Parameters | Temperatures, barometric pressure |
| 130314 | Actual Pressure | Barometric pressure |
| 127488 | Engine Parameters, Rapid Update | Engine RPM |
| 127489 | Engine Parameters, Dynamic | Engine hours |
| 127505 | Fluid Level | Tank levels |
| 127508 | Battery Status | Battery voltage |
| 127506 | DC Detailed Status | State of charge |
| 127257 | Attitude | Heel, trim |
Which formats your gateway can send
NMEA 2000 is a binary protocol on the cable. Over Wi-Fi, every gateway packages the data differently. The app recognizes these formats on its own:
| Format | Typical devices |
|---|---|
$PCDIN (SeaSmart) | Digital Yacht, Quark-elec |
$MXPGN | Shipmodul MiniPlex |
| Actisense N2K ASCII and binary (BST) | Actisense W2K-1, NGT-1 |
| Yacht Devices RAW | Yacht Devices YDWG-02 |
| canboat / Actisense CSV | Signal K and canboat installations |
The byte layout of the PGNs follows the open documentation of the canboat project, which most other software also uses as its NMEA 2000 reference. The standard itself is only available from the NMEA for a fee.
Shipmodul: The MiniPlex sends
$MXPGN with reversed byte order. If you pick the “Shipmodul” gateway in the app, the $MXPGN Bytes in reverse option is already on. With custom settings, only turn it on if the values make no sense otherwise.An example of a tank level as
$MXPGN:$MXPGN,01F211,5810,02841C8A020000FF*1E01F211 is hexadecimal for PGN 127505 (Fluid Level). You used to have to cut out the bytes 841C with a regular expression and convert them yourself. Today the app reads tank, fluid type, level, and tank size straight from it.Engine, tank, and battery over NMEA 0183 (XDR)
If your gateway converts NMEA 2000 to NMEA 0183, these values usually arrive as an XDR sentence. The app recognizes them by the name of the measurement:
| Value | Names recognized in the XDR sentence |
|---|---|
| Engine RPM | ENGINE, RPM |
| Engine hours | ENGINEHOURS |
| Battery voltage | BATTERY, BATT |
| Fuel | FUEL |
| Fresh water | FRESHWATER, WATER |
| Gray water | WASTEWATER, GREYWATER, GRAYWATER |
| Barometric pressure | BARO, BAROMETER, PRESSURE, AIRPRESSURE |
| Air temperature | AIRTEMP, OUTSIDE…, TEMPAIR, ENV_OUTAIR_T |
| Water temperature | SEATEMP, WATERTEMP, WTEMP, TEMPWATER, ENV_WATER_T |
| Trim | TRIM, PITCH, PTCH |
| Heel | HEEL, ROLL |
The number of the engine, tank, or battery comes after a
#, for example FUEL#0 for the first tank.If your device uses different names, send me an export of your data records. I can add new names with the next update.
What doesn't work
- Custom rules with regular expressions. Automatic detection has replaced them.
- More than 3 engines, 3 batteries, 4 fuel tanks, 3 fresh water tanks, and 2 gray water tanks.
- Other engine values such as oil pressure, coolant temperature, or fuel consumption.
- Battery current in amps.
Missing any of that, or a PGN your onboard network sends? Get in touch with me. I'll do my best to find a solution.
Frequently asked questions
Which PGN contains the tank level?
PGN 127505 (Fluid Level). It contains the instance, the fluid type (fuel, fresh water, gray water, black water), the level in percent, and the tank size.
Do I still need to set up regular expressions for NMEA 2000?
No. Starting with version 2.92 (iOS) and 1.36 (Android), the app recognizes engine, tanks, batteries, barometric pressure, heel, and trim on its own. The old custom rules are gone.
Why doesn't the app show my second tank?
The instance is probably wrong. In the NMEA settings, open the tank's section, tap “NMEA 2000 Instances,” and assign the instance your sensor sends.
Can the app read engine hours from NMEA 2000 automatically?
Yes, from PGN 127489, for up to three engines. To do that, under “Engine 1 hours,” drag the “NMEA 2000 127489” source to first place in the data sources.
Does this also work with a Shipmodul MiniPlex?
Yes. Pick the “Shipmodul” gateway in the app. The option for the reversed byte order of
$MXPGN is then already turned on.