What is the XDR sentence?
The XDR (Transducer Measurement) sentence is a generic NMEA0183 sentence used to transmit measurements from various types of sensors (transducers). It allows multiple measurements to be grouped into a single sentence.
What is the general format of the XDR sentence?
$xxXDR,a,x.x,u,n,a,x.x,u,n,...*hhWhere for each transducer group:
- a: Transducer type (one letter)
- x.x: Measured value
- u: Unit of measurement (one letter)
- n: Transducer name (character string)
The checksum (*hh) is mandatory.
Which transducers are supported by NavimetriX?
1. Heel (PTCH)
| Field | Value |
|---|---|
| Type | A (Angular) |
| Unit | D (Degrees) |
| Name | PTCH |
Example:
$IIXDR,A,5.2,D,PTCH*XXNavimetriX reads the angle named PTCH as the boat's heel, the one shown by the Clinometer: this example indicates a heel of 5.2°.
2. Roll
| Field | Value |
|---|---|
| Type | A (Angular) |
| Unit | D (Degrees) |
| Name | ROLL |
Example:
$IIXDR,A,-1.1,D,ROLL*XXThis indicates a roll angle of -1.1°. The Clinometer shows the roll when no PTCH heel is received.
Combined example (roll + heel):
$IIXDR,A,-1.1,D,ROLL,A,5.0,D,PTCH*743. Water temperature
| Field | Value |
|---|---|
| Type | C (Temperature) |
| Unit | C (Celsius), F (Fahrenheit), or K (Kelvin) |
| Name | Must contain water (e.g. WATERTEMP, WaterTemp, water) |
Examples:
$IIXDR,C,18.5,C,WATERTEMP*XX
$IIXDR,C,65.3,F,WaterTemp*XX
$IIXDR,C,291.65,K,water*XX4. Air temperature
| Field | Value |
|---|---|
| Type | C (Temperature) |
| Unit | C (Celsius), F (Fahrenheit), or K (Kelvin) |
| Name | Must contain air (e.g. AIRTEMP, AirTemp, air) |
Examples:
$IIXDR,C,22.0,C,AIRTEMP*XX
$IIXDR,C,71.6,F,AirTemp*XXCombined example (water + air):
$IIXDR,C,18.1,C,WATERTEMP,C,22.0,C,AIRTEMP*495. Barometric pressure
| Field | Value |
|---|---|
| Type | P (Pressure) |
| Unit | B (Bars) |
| Name | Free (no name required) |
Note: The value must be expressed in bars (1 bar = 1000 hPa). NavimetriX automatically converts it to hPa. Only an atmospheric value, between 0.8 and 1.1 bar, is used: any other pressure in bars (engine oil, hydraulics) is ignored.
Example:
$IIXDR,P,1.013,B,BARO*XXThis indicates a pressure of 1013 hPa.
6. Rudder angle
| Field | Value |
|---|---|
| Type | A (Angular) |
| Unit | D (Degrees) |
| Name | Must contain RUDDER (e.g. RUDDER, Rudder) |
Example:
$IIXDR,A,-4.5,D,RUDDER*XXThe rudder angle is also read from the RSA sentence.
7. Batteries
| Measurement | Type | Unit |
|---|---|---|
| Voltage | U | V (volts) |
| Current (negative when discharging) | I | A (amperes) |
| State of charge | any except P | P (percent), or a name containing SOC |
Examples:
$IIXDR,U,13.82,V,BAT0*XX
$IIXDR,I,-5.2,A,BAT0*XX
$IIXDR,G,85,P,BAT0_SOC*XXThe transducer name identifies the bank: BAT0 and BAT0_SOC are grouped under the same bank (the SOC, VOLT, AMP… suffixes are ignored for grouping). A state of charge sent as a ratio between 0 and 1 (without the P unit) is converted to a percentage. Banks are shown in the Energy (battery) instrument.
How do I combine multiple measurements in a single sentence?
Transducer groups can be chained in the same XDR sentence (up to 10 transducers per sentence):
$IIXDR,A,-2.5,D,ROLL,A,3.1,D,PTCH,C,18.5,C,WATERTEMP,C,21.0,C,AIRTEMP,P,1.015,B,BARO*XXIs the transducer name case-sensitive?
No. Transducer name recognition is not case-sensitive for temperatures, rudder angle and batteries:
WATERTEMP,WaterTemp,watertemp→ all recognizedAIRTEMP,AirTemp,airtemp→ all recognizedRUDDER,Rudder,rudder→ all recognized
Exception: for roll and heel, the names must be exactly ROLL and PTCH. Pressure requires no name at all.
Which talker prefix should I use?
NavimetriX accepts all standard talker prefixes (II, GP, HC, etc.). The examples above use $II (Integrated Instrumentation), but $GP, $HC, or others are equally valid.
Summary of accepted formats
| Measurement | Type | Unit | Transducer name |
|---|---|---|---|
| Heel | A | D | PTCH |
| Roll | A | D | ROLL |
| Water temperature | C | C, F, or K | contains water |
| Air temperature | C | C, F, or K | contains air |
| Barometric pressure | P | B (0.8 to 1.1) | free |
| Rudder angle | A | D | contains RUDDER |
| Battery voltage | U | V | bank name |
| Battery current | I | A | bank name |
| State of charge | not P | P | bank name (or contains SOC) |