Skip to main content

Extended Tags

Extended Tags append additional data fields to standard TAIP event report messages. They are organized into 3 groups (A, B, C), each configurable independently.

Managing Extended Tags — XAEF (groups A/B/C)

Set tags for group A:

>SXAEFA;<TAG1>;<TAG2>;...<

Query current tags for group A:

>QXAEFA<

Delete all tags for group A:

>SXAEFAU<

Replace A with B or C for the other groups (SXAEFB, SXAEFC, etc.).

XAEF Result Examples

Set tags for group A:

>SXAEFA;SV;DOP;BL<
>RXAEFA;SV;DOP;BL<

Query tags for group A:

>QXAEFA<
>RXAEFA;SV;DOP;BL<

Delete tags for group A:

>SXAEFAU<
>RXAEFAU<

Group B and C behave the same way, replacing A with B or C.

Tags Reference

TagFull NameDescriptionFormat Example
ADMain Power ADCMain power ADC reading in millivolts (True Ignition source)AD=13200
ALAltitudeAltitude in meters above sea levelAL=1250.5
APAccelerometer ProfileMotion state + acceleration payloadAP=1,200,0,0,0,0,0,0
BBSBluetooth Beacon StatusWhitelist beacon advertisement dataBBS=cbec81c98eea$2A6E4509$2A0868421234
BLBattery LevelBattery value from UC infoBL=3850
CEIgnition CounterIgnition counter valueCE=3600
CLIdle CounterIdle counter valueCL=120
CSOver-Speed CounterOver-speed counter valueCS=45
CVxxCounter ValueValue of counter C00–C99 (xx = index)CV00=1500
DOPDilution of PrecisionPDOP, HDOP, VDOP valuesDOP=12,9,8
EATemperature SensorsOneWire temperature values by sensor tagEA=A21.50B22.10
FFFuel Sensor SnapshotTechnoton state, frequency, temperature, and levelFF=1,2571,24,500
IPIP AddressCarrier-assigned IP address of the LTE/GPRS data sessionIP=10.24.183.57
ISiButton StatusConnection state and last known iButton IDIS=101AABBCCDDEEFF
IXI/O StatusPacked digital I/O status payloadIX=10203040
SCSignal CoverageCellular generation and serving-cell dataSC=4G,732,123,04D2,0000DDD5,20
SVSatellites in ViewNumber of GNSS satellites in useSV=9
VHVirtual HourmeterEngine hours (H:MM format)VH=125:30
VOVirtual OdometerAccumulated distance (km)VO=15234

Tag Details

BBS — Bluetooth Beacon Status

>SXAEFA;BBS<

Reports the latest BLE advertisement service data from all whitelisted beacons that have received at least one advertisement. Requires the whitelist to be configured via BBL.

Format: BBS=addr1$UUID1value1$...$2A08timestamp[,addr2$...]

FieldDescription
address12-character lowercase hex BLE address from the whitelist.
$UUID4-character uppercase hex 16-bit UUID of the service data entry.
valueUppercase hex bytes of the service data payload.
$2A08Timestamp UUID (Date Time characteristic).
timestamp8-character uppercase hex Unix epoch when the advertisement was received.

Special conditions:

  • If no whitelist beacons have reported data, the result is BBS=U (unknown).
  • Up to 8 service data entries per beacon are stored; only AD type 0x16 entries are included.

Example results:

  • BBS=cbec81c98eea$2A6E4509$2A0868421234
  • BBS=cbec81c98eea$2A6E4509$2A0868421234,703bf221d4d5$2A6E3809$2A6F250D$2A0868421240
  • BBS=U (no beacon data available)

See also: BBS command, BBL — Bluetooth Beacon White List

AL — Altitude

>SXAEFA;AL<

Reports altitude in meters from the GNSS fix. Requires a valid GNSS fix (F01 active).

Example results:

  • AL=1250.5
  • AL=-9999.0 (invalid fix quality)

AD — Main Power ADC

>SXAEFA;AD<

Reports the current main power ADC voltage in millivolts from UC_MAIN_POWER_ADC_CHANNEL.

This is the same signal used by the True Ignition (TI) command when voltage-based ignition detection is enabled.

Example results:

  • AD=13200
  • AD=0 (no measured voltage)

AP — Accelerometer Profile

>SXAEFA;AP<

Format: AP=<motion_state>,<acceleration>,0,0,0,0,0,0

  • motion_state: 1 = motion detected, 0 = stationary
  • acceleration: current acceleration value

Examples:

  • AP=0,0,0,0,0,0,0,0
  • AP=1,0,0,0,0,0,0,0
  • AP=1,200,0,0,0,0,0,0

BL — Battery Level

>SXAEFA;BL<

Reports the internal battery voltage in millivolts (e.g., BL=3850 = 3.850 V).

Example result: BL=3850

CE / CL / CS — Special Counters

>SXAEFA;CE;CL;CS<
  • CE: Ignition counter — total ignition ON time since last reset
  • CL: Idle counter — time engine is on but vehicle is not moving
  • CS: Over-speed counter — time spent above the configured speed limit

Example results:

  • CE=3600
  • CL=120
  • CS=45

CVxx — Counter Values

>SXAEFA;CV00;CV01<

Reports the current value of user counters C00–C99. Replace xx with the counter index (00–99).

Example results:

  • CV00=1500
  • CV01=230

DOP — Dilution of Precision

>SXAEFA;DOP<

Format: DOP=<PDOP>,<HDOP>,<VDOP> — integer values scaled by 10 (e.g., 12,9,8 means 1.2,0.9,0.8).

Example result: DOP=12,9,8

EA — Temperature (OneWire DS18B20)

>SXAEFA;EA<

Format: EA=<tag><value><tag><value>...

Special conditions:

  • Values are emitted with sensor tag prefix (A..J) and two decimals (e.g., A23.50).
  • If a sensor has no valid reading yet, it is reported as <tag>*.
  • If no sensor has ever reported a valid value, the result is EA=A*.
  • The payload includes tags from A up to the last tag with valid data.

Example results:

  • EA=A23.50
  • EA=A10.00B-5.50
  • EA=A*

FF — Fuel Sensor Snapshot

>SXAEFA;FF<

Format: FF=<state>,<frequency>,<temperature>,<level>

  • state: 0 disconnected, 1 connected
  • frequency: Technoton oscillator frequency in Hz
  • temperature: sensor temperature in degrees Celsius
  • level: fuel level in sensor units

Example result: FF=1,2571,24,500

IP — IP Address

>SXAEFA;IP<

Reports the carrier-assigned IP address of the active LTE/GPRS data session (ppp0 interface).

  • When the data session is active, reports the assigned IP in dotted-decimal notation.
  • When the session is down, reports 0.0.0.0.

The same value is available via the XAIP command.

Example results:

  • IP=10.24.183.57
  • IP=0.0.0.0 (session down)

IS — iButton Status

>SXAEFA;IS<

Format: IS=<connected><ID> — no separator between connection flag and ID.

  • connected: 1 if connected now, 0 otherwise
  • ID: last known 14-character iButton ID (can remain present even when disconnected)

Example results:

  • IS=0
  • IS=101AABBCCDDEEFF
  • IS=001AABBCCDDEEFF

IX — I/O Status

>SXAEFA;IX<

Format: IX=102<extpwr_ignon>3<input1>4<output1_output2>

Where:

  • <extpwr_ignon> is a 2-bit value: extpwr | (ignon << 1)
  • <input1> is 0 or 1
  • <output1_output2> is a 2-bit value: output1 | (output2 << 1)

Example results:

  • IX=10203040
  • IX=10233040

SC — Signal Coverage

>SXAEFA;SC<

Format: SC=<GEN>,<MCC>,<MNC>,<LAC_HEX4>,<CELL_ID_HEX8>,<RSSI>

GEN is derived from RAT (4G, 3G, 2G, or UNKNOWN).

Example results:

  • SC=4G,732,123,04D2,0000DDD5,20
  • SC=2G,310,410,0064,000000C8,15

SV — Satellites in View

>SXAEFA;SV<

Number of GNSS satellites actively used in the current fix.

Example result: SV=9

VH — Virtual Hourmeter

>SXAEFA;VH<

Format: VH=HHH:MM — accumulated engine hours and minutes. Configure control signal with >SXAVH<.

Example result: VH=125:30

VO — Virtual Odometer

>SXAEFA;VO<

Format: VO=DDDDD — accumulated distance in km. Configure control signal with >SXAVO<.

Example result: VO=15234

Full Report Example

Configuration:

>SXAEFA;AL;BL;SV;DOP<
>SXAEFB;VO;VH<

Resulting report:

>REV001447147509+2578250-0802813901519512;AL=150;BL=3850;SV=9;DOP=12,9,8;VO=15234;VH=125:30;ID=356612020083541<

Tag Result Examples

TagExample Result
ADAD=13200
ALAL=1250.5
APAP=1,200,0,0,0,0,0,0
BBSBBS=cbec81c98eea$2A6E4509$2A0868421234
BLBL=3850
CECE=3600
CLCL=120
CSCS=45
CV00CV00=1500
DOPDOP=12,9,8
EAEA=A23.50
FFFF=1,2571,24,500
IPIP=10.24.183.57
ISIS=101AABBCCDDEEFF
IXIX=10203040
SCSC=4G,732,123,04D2,0000DDD5,20
SVSV=9
VHVH=125:30
VOVO=15234