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

ValueCountNMEA 2000NMEA 0183Signal K
Engine RPMup to 3 enginesPGN 127488RPM, XDRpropulsion.<id>.revolutions
Engine hoursup to 3 enginesPGN 127489XDRpropulsion.<id>.runTime
Fuel tankup to 4PGN 127505XDRtanks.fuel.<id>
Fresh water tankup to 3PGN 127505XDRtanks.freshWater.<id>
Gray and black waterup to 2PGN 127505XDRtanks.wasteWater.<id>
Battery voltageup to 3PGN 127508XDRelectrical.batteries.<id>.voltage
Battery state of chargeup to 3PGN 127506—electrical.batteries.<id>.capacity.stateOfCharge
Barometric pressure1PGN 130314, 130311, 130310MDA, MMB, XDRenvironment.outside.pressure
Air temperature1PGN 130312, 130316, 130311, 130310MDA, MTA, XDRenvironment.outside.temperature
Heel (roll), trim (pitch)1PGN 127257XDRnavigation.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:
  1. Open Settings › Data sources › Define data sources.
  2. Pick the value, for example “Fuel level” or “Engine 1 hours.”
  3. 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

PGNNameDelivers
129025Position, Rapid UpdatePosition
129029GNSS Position DataPosition, GPS accuracy
129539GNSS DOPsGPS accuracy
129026COG & SOG, Rapid UpdateCourse and Speed Over Ground
127250Vessel HeadingTrue heading
127258Magnetic VariationMagnetic variation for PGN 127250
128259Speed, Water ReferencedCalculating the current
130577Direction DataCourse, speed, current
130306Wind DataTrue and apparent wind
128267Water DepthWater depth
128275Distance LogTrip log (total and trip)
130312, 130316TemperatureWater and air temperature
130310, 130311Environmental ParametersTemperatures, barometric pressure
130314Actual PressureBarometric pressure
127488Engine Parameters, Rapid UpdateEngine RPM
127489Engine Parameters, DynamicEngine hours
127505Fluid LevelTank levels
127508Battery StatusBattery voltage
127506DC Detailed StatusState of charge
127257AttitudeHeel, 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:
FormatTypical devices
$PCDIN (SeaSmart)Digital Yacht, Quark-elec
$MXPGNShipmodul MiniPlex
Actisense N2K ASCII and binary (BST)Actisense W2K-1, NGT-1
Yacht Devices RAWYacht Devices YDWG-02
canboat / Actisense CSVSignal 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*1E
01F211 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:
ValueNames recognized in the XDR sentence
Engine RPMENGINE, RPM
Engine hoursENGINEHOURS
Battery voltageBATTERY, BATT
FuelFUEL
Fresh waterFRESHWATER, WATER
Gray waterWASTEWATER, GREYWATER, GRAYWATER
Barometric pressureBARO, BAROMETER, PRESSURE, AIRPRESSURE
Air temperatureAIRTEMP, OUTSIDE…, TEMPAIR, ENV_OUTAIR_T
Water temperatureSEATEMP, WATERTEMP, WTEMP, TEMPWATER, ENV_WATER_T
TrimTRIM, PITCH, PTCH
HeelHEEL, 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.