Skip to main content

DS18B20 Temperature Sensors

Antares 4G supports 1-Wire digital temperature sensors based on the DS18B20 chip.

DS18B20 sensors can operate in normal power mode or parasite mode.

⚠️ Purchase note: many low-cost probes are labeled as DS18B20 but do not include a genuine compatible chip. Prefer sensors explicitly indicating parasite-mode support. Example known-working model: https://www.adafruit.com/product/381

Up to 10 temperature sensors can be connected simultaneously, mapped to signals TO0–TO9.

Signals​

SignalDescription
TO0–TO9Temperature threshold signals (one per sensor slot)

Typical Setup Flow​

  1. Connect one or more DS18B20 sensors to the 1-Wire bus.
  2. Query discovered sensors with QXATI.
  3. Assign each physical sensor ID to a logical tag (A–J) with SXATL.
  4. Configure threshold slots (0–9) with SXATO.
  5. Optionally include temperature values in reports using extended tag EA.

Temperature Thresholds​

Each threshold slot (0–9) is associated with one tagged sensor and one threshold value.

Behavior:

  • Positive threshold: use sign 1 (or +) in command encoding.
  • Negative threshold: use sign 0 (or -) in command encoding.
  • Value is fixed-point with one decimal, encoded as 4 digits.
    • Example: 0255 = +25.5°C
    • Example: 0050 with negative sign = -5.0°C
  • A threshold slot cannot be shared by two different sensor tags at the same time.

Commands​

Sensor Information — XATI​

Query all detected sensors and their current values. See XATI — Temperature Sensors Info for complete documentation.

Quick example:

>QXATI<
>RXATI28AABBCCDDEEFF,A,+0215;28112233445566,B,+0180<

Tag Assignment — XATL​

Assign sensor IDs to logical tags (A–J) for easier reference in events and reports. See XATL — Temperature Sensor List for complete documentation.

Quick example — assign tag A:

>SXATLA28AABBCCDDEEFF<

Quick example — query tag A:

>QXATLA<
>RXATLA28AABBCCDDEEFF<

Threshold Configuration — XATO​

Configure alarm thresholds for each sensor. When a sensor exceeds its threshold, signal F21 is triggered. See XATO — Temperature Thresholds for complete documentation.

Quick example — set threshold for tag A > 25.5°C:

>SXATO01A+0255<

Quick example — query threshold at slot 0:

>QXATO0<
>RXATO0A+0255<

Extended Tag: EA​

Add the EA tag to include temperature sensor readings in reports:

>SXAEFA;EA<

Report example:

>REV001234567890+2578250-0802813901234512;EA=A21.50B22.10;ID=IMEI<

Special conditions for EA:

  • Output is tag-prefixed (A..J), not comma-only values.
  • If a sensor has no valid reading yet, it appears as [tag]*.
  • If no sensor has valid readings, the field is EA=A*.

Installation and commissioning tips​

  • Connect and identify sensors one at a time during installation to avoid ID confusion.
  • Record each sensor physical location with its assigned tag (A–J).
  • Validate live values with QXATI before creating threshold events.