Skip to main content

XAIL — Authorized iButtons ID List (00–99)

Manages up to 100 authorized iButton entries (indices 00–99). Each authorized entry in this range triggers an individual signal: Q00, Q01, ... Q99.

Formats​

Query an Entry​

>QXAIL{INDEX}<

Response:

  • >RXAIL{INDEX}{ID}< — ID stored at index
  • >RXAIL{INDEX}U< — Slot is empty
FieldFormatDescription
INDEX2 digits (00–99)Slot index
ID16-hex charsCRC (2) + Serial (12) + Family (2)

Add or Update an Entry​

16-character ID format (with CRC):

>SXAIL{INDEX}{ID}<

Response: >SXAIL{INDEX}{ID}< (command accepted)

FieldFormatDescription
INDEX2 digitsSlot index (00–99)
ID16-hex charsCRC (2) + Serial (12) + Family (2)

Delete an Entry​

>SXAIL{INDEX}U<

Response: Command accepted (entry removed)

Examples​

Query slot 05:

>QXAIL05<
>RXAIL0518000013406C1001<   ← ID found

Query empty slot:

>QXAIL10<
>RXAIL10U<   ← Slot empty

Add iButton by 16-char ID:

>SXAIL03A5987654321ABCDEF018<
16-Character ID Format (Printed on the device)​
{CRC}{SERIAL_NUMBER}{FAMILY_CODE}
A5000013406C100101
├─ CRC Bytes (2 hex): A5 (computed)
├─ Serial Number (12 hex): 000013406C1001
└─ Family Code (2 hex): 01

Add iButton by 14-char ID:

>SXAIL03987654321ABCDEF0<
14-Character Format (Alternative)​
{FAMILY_CODE}{SERIAL_NUMBER}
18000013406C1001
├─ Family Code (2 hex): 01 (DS1990A) or 81 (USB)
└─ Serial Number (12 hex): 000013406C1001

Delete entry:

>SXAIL05U<

Signals​

Each authorized entry in this list triggers:

  • Signal Q{INDEX} — Active when the corresponding iButton is connected
  • Signal F19 — Active when any authorized iButton is detected
  • Signal F18 — Active when any iButton is connected

Examples​

  • Authorized at index 00 → triggers signal Q00
  • Authorized at index 05 → triggers signal Q05
  • Authorized at index 99 → triggers signal Q99

Storage​

  • Capacity: 100 slots (indices 00–99)
  • Storage type: Persistent (survives power cycles)

Device Events​

Create events based on iButton detection:

Report on Q05 rising edge (iButton at index 05 connected):

>SED00NA0;Q05+<

Report on any authorized iButton (F19):

>SED00NA0;F19+<