Skip to main content

XATL — Temperature Sensor List

Manages the association between temperature sensor IDs and user-defined tags (A–J) for easy reference and event configuration.

Formats

Query a Tag

>QXATL{TAG}<

Response:

  • >RXATL{TAG}{ID}< — ID associated with this tag
  • >RXATL{TAG}U< — No ID associated with this tag
FieldFormatDescription
TAGSingle letter (A–J)Sensor tag
ID14-hex charsSensor ID (DS18B20)

Associate a Sensor ID with a Tag

>SXATL{TAG}{ID}<

Response: Command accepted (association saved)

FieldFormatDescription
TAGSingle letter (A–J)User-defined tag
ID14-hex charsDS18B20 sensor ID

Remove Tag Association

>SXATL{TAG}U<

Response: Command accepted (association removed)

Examples

Query tag A:

>QXATLA<
>RXATLA28000013406C1001< ← Tag A associated with this sensor

Query empty tag:

>QXATLF<
>RXATLFU< ← Tag F has no association

Associate sensor with tag B:

>SXATLB28000013406C1002<
>SXATLB28000013406C1002< ← Confirmed

Remove tag D association:

>SXATLD U<

Sensor ID Format

DS18B20 temperature sensor IDs are 14 hexadecimal characters:

28000013406C1001
├─ Family Code (2 hex): 28 (always for DS18B20)
└─ Serial Number (12 hex): 000013406C1001

Tags Available

TagUse Case
A–J10 user-defined temperature sensors

Each tag can be associated with one sensor. Tags are used in:

  • XATI — Query list of sensors
  • XATO — Configure threshold alarms

Workflow

  1. Identify sensors — Connect DS18B20 sensors to OneWire bus
  2. Query available sensors — Use >QXATI< to see connected devices
  3. Tag sensors — Use >SXATL{TAG}{ID}< to assign meaningful names
  4. Configure thresholds — Use >SXATO{IDX}1{TAG}{SIGN}{VALUE}< to set alarm conditions
  5. Monitor values — Use >QXATI< to read current temperatures

Example Setup

Assign tags to three temperature sensors:

>SXATLA28000013406C1001< ← Engine temperature
>SXATLB28000013406C1002< ← Cabin temperature
>SXATLC28000013406C1003< ← Cargo temperature

Query the list:

>QXATI<
>RXATI28000013406C1001,A,+0850;28000013406C1002,B,+0200;28000013406C1003,C,+0150<

Configure threshold alarm for engine temperature (tag A > 100°C):

>SXATO01A+0100<

Notes

  • Tags persist across device resets
  • A sensor can only have one tag, but you can reassign tags
  • Removing a tag does not affect the physical sensor connection
  • Thresholds configured on a tag-based condition will use the last assigned sensor