Skip to Content

IT Command — Digital Input Debounce

The IT command configures debounce (anti-bounce) times for digital inputs and ignition, preventing false alarms.


What is it for?

🚪 Door sensors — Filters mechanical bouncing when opening/closing
🔑 Stable ignition — Prevents false changes when starting engine
🆘 Panic button — Quick response with bounce filtering
📳 Vibration sensors — Ignores normal vehicle vibrations

Allows defining independent delays for positive (ON) and negative (OFF) edges.


Syntax

OperationCommandDescription
ConfigureSITindex delay_on delay_offDefine debounce times
QueryQITindexRead current configuration

Parameters

FieldDescriptionRange
indexDigital input slot00-06 (IN00-IN06), 07 (generic slot)
delay_onTenths of second + edge0001-9999
delay_offTenths of second - edge0001-9999

Default Values

InputDebounce ONDebounce OFF
IN00-IN06100 ms100 ms
Slot 07100 ms100 ms

Index 07 does not configure ignition. SIT and QIT always read and write the same array of digital inputs, and slot 07 is just one more entry in that array: it has no relation to the ignition sensor.

The real IGN debounce lives in variables of its own inside the ignition module, with 10 seconds by default on both edges, and is configured with SCXIGN. Sending SIT07... has no effect whatsoever on engine startup.


Examples

Door sensor with anti-bounce

>SIT0200100003< // IN02: ON=1.0s, OFF=0.3s

Behavior:

  • 🚪 Door must be open for 1s to generate IN02+
  • 🚪 Door must be closed for 0.3s to generate IN02-
>QIT02< >RIT0200100003;ID=1234;*3A< // Configuration confirmation

Vibration sensor

>SIT0100500050< // IN01: both edges 5.0 seconds // Prevents alarms from momentary vibrations

Panic button (quick response)

>SIT0300020001< // IN03: ON=0.2s (fast), OFF=0.1s // Immediate activation with mechanical bounce filtering

Ignition debounce

To change the ignition debounce SIT is not used, instead SCXIGN, which accepts the mode and, optionally, the on and off times:

// See the CXIGN page for the full time syntax >QCXIGN<

By Sensor Type

Sensor TypeON (ms)OFF (ms)Reason
Door100-50050-200Avoid mechanical bounce
Vibration500-2000500-2000Filter normal vibrations
Button20-10010-50Quick response
Pressure1000-50001000-5000Stabilize readings
Temperature2000-100002000-10000Avoid transient changes
Ignition1000-100001000-10000Filter startups
Impact10-10010-100Immediate detection

Considerations

Very long debounce times (>30s) may cause loss of legitimate events. Adjust according to specific application.

For critical applications (panic button, impacts), use minimum debounce (10-50ms) and validate events on platform.


Relation with Events

Debounce affects when triggers are generated:

// Without adequate debounce (default 100ms) Door opens/closes quickly → multiple IN02+/IN02- events // With appropriate debounce (1000ms) >SIT02 1000 0300< Door opens/closes quickly → no events (doesn't reach time) Door opens and stays open → IN02+ event after 1s

Compatibility

💾Firmware v1.03.00
SPLegacy
ULLegacy
Spider:IN00-IN06, IGN
Ultralite:IN00-IN03, IGN
💾Firmware v1.00.00
SP-IOT
SM-IOT
ZE-IOT
Spider IoT:IN00-IN06, IGN
Smart IoT:IN00-IN03, IGN
Zero IoT:IN00-IN02, IGN

See Also

Last updated