Skip to Content

IC Command

The IC command (Identification Code) enables driver session management through identification codes, tracking who operates the vehicle, for how long, and what distance they cover.

What is it for?

  • 👤 Identify drivers via iButton, RF433 or Bluetooth
  • ⏱️ Control work shifts with work/rest time tracking
  • 📊 Usage statistics (duration, distance, idle time)
  • 🔐 Vehicle access control with authorized codes
  • 📱 Operation modes for different work types

Syntax

OperationCommandDescription
Start sessionSICcode,modeOpens session with code and mode
Change modeSIC,modeChanges active session mode
Close sessionSIC*Ends current session
QueryQICGets active session data

QIC Response

RIC code,mode,datetime,duration,idle,movement,distance,slot
FieldFormatDescription
code16 charsDriver identifier
mode1 charIdentification source (N=iButton/OneWire, R=RF433)
datetimeDDMMYYHHMMSSConcatenated session start date and time (12 digits)
duration8 digitsTotal session time in seconds
idle8 digitsTime with IGN OFF in seconds
movement8 digitsTime with IGN ON in seconds
distance10 digitsDistance traveled in meters
slot4 digitsICL slot (0000-0099) that opened the session

IC Signals (Triggers)

SignalEventDescription
IC00+Session startedNew session opened
IC01+Mode changeSession mode modified
IC02+Valid userCode found in ICL list
IC03+Invalid userCode NOT authorized

IC signals do not support negative edges or conditional use in TRG.


Basic Examples

Start session with iButton

>SICAA01234567890123,0< // Response: RIC AA01234567890123,N,291224143022,00000000,00000000,00000000,0000000000,0003

Query active session

>QIC< // Response: RIC AA01234567890123,N,291224143022,00003600,00001200,00002400,0000045000,0003

Interpretation:

FieldValueMeaning
CodeAA01234567890123Driver ID
ModeNSource: iButton / OneWire
Start29122414302229/12/2024 14:30:22 (concatenated datetime)
Duration000036003600 s = 1 hour total
Idle000012001200 s = 20 min engine off
Movement000024002400 s = 40 min running
Distance000004500045000 m = 45 km traveled
Slot0003ICL slot that opened the session

Close session

>SIC*< // Ends session and saves statistics

Change mode during session

>SIC,1< // Changes to mode 1 while maintaining session

Authorized Code Management (ICL)

To manage the authorized code list, use the ICL Command:

>SICL00 AA01234567890123< // Load code at position 00 >QICL00< // Query code >SICL00*< // Delete code

ICL slot in the response (v1.09.23)

From firmware v1.09.23, the RIC response appends at the end the ICL list slot that opened the session, formatted as 4 digits (0000-0099). The field is additive: it appears after the distance.

>QIC< >RIC AA01234567890123,N,291224143022,00003600,00001200,00002400,0000045000,0003< // ...,distance=0000045000, ICL slot=0003

Applies to QIC, SIC and SIC* responses.

With no active session, RIC comes back bare (no fields, no slot):

>QIC< >RIC<

Limitations

ParameterValue
Simultaneous sessions1
Storable codes (ICL)100 (00-99)
Code length16 characters
Persistence⚠️ Volatile (lost on restart)

Sessions are lost on device restart. To maintain records, send periodic reports with QIC or when closing sessions.

Compatibility

💾Firmware v1.03.00
SPLegacy
iButton, Manual
💾Firmware v1.00.00
SP-IOT
SM-IOT
ZE-IOT
Spider IoT:iButton, RF433, BTH, Manual. ICL slot in RIC from v1.09.23
Smart IoT:iButton, BTH, Manual. ICL slot in RIC from v1.09.23
Zero IoT:Manual. ICL slot in RIC from v1.09.23

See Also

Last updated