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
| Field | Format | Description |
|---|---|---|
TAG | Single letter (A–J) | Sensor tag |
ID | 14-hex chars | Sensor ID (DS18B20) |
Associate a Sensor ID with a Tag
>SXATL{TAG}{ID}<
Response: Command accepted (association saved)
| Field | Format | Description |
|---|---|---|
TAG | Single letter (A–J) | User-defined tag |
ID | 14-hex chars | DS18B20 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
| Tag | Use Case |
|---|---|
| A–J | 10 user-defined temperature sensors |
Each tag can be associated with one sensor. Tags are used in:
Workflow
- Identify sensors — Connect DS18B20 sensors to OneWire bus
- Query available sensors — Use
>QXATI<to see connected devices - Tag sensors — Use
>SXATL{TAG}{ID}<to assign meaningful names - Configure thresholds — Use
>SXATO{IDX}1{TAG}{SIGN}{VALUE}<to set alarm conditions - 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<
Related Commands
- XATI — Temperature Sensors Info (query sensor list and values)
- XATO — Temperature Thresholds (configure alarm conditions)
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