CXIGN Command - Ignition Mode
Configures the IGN variable operation, maintaining its function according to the physical input sensing, or virtualizing its logical state. Also allows adjusting the stabilization (debounce) times for validating ignition turn-on and turn-off.
What is it for?
| Use case | Description |
|---|---|
| 🔌 Simplified installation | Detect ignition by voltage |
| 🛠️ No physical connection | Virtualize IGN in portable applications |
| 📊 Force state | Manually set IGN for testing |
| ⚡ By power supply | Use battery voltage as indicator |
| ⏱️ Filter noise | Tune turn-on / turn-off stabilization times |
Description
This command allows:
- Maintain normal operation according to the physical ignition input
- Manually set its value to a predetermined state
- Adapt its operation to the device’s external power supply voltage
- Release the IN07 input in manual mode, so it can be used for another purpose
- Configure stabilization times (
tonandtoff) to avoid false positives from intermittent signals
The voltage mode allows dispensing with the electrical connection for ignition sensing.
Commands
Configure
SCXIGNa[,ton[,toff]]Query
QCXIGNResponse
RCXIGNa,ton,toffParameters
Mode (a)
| Value | Description |
|---|---|
| 0 | Normal (default). According to physical ignition input |
| 1 | Manual, allowing state setting through SS command |
| 2 | By voltage (according to main power supply) |
| 3 | Manual releasing IN07 (allows using IN07 for another purpose) |
Stabilization times (ton, toff)
| Parameter | Function | Range | Default |
|---|---|---|---|
| ton | Time the signal must remain active to confirm IGN ON | 1 to 9999 | 100 (10 s) |
| toff | Time the signal must remain inactive to confirm IGN OFF | 1 to 9999 | 100 (10 s) |
ton and toff are expressed in units of 100 ms (e.g. ton=50 equals 5 s).
Both are optional: if omitted, previously configured values are kept.
Voltage thresholds (mode 2)
In mode 2 the device decides IGN by comparing the supply voltage against two thresholds with hysteresis. By default it picks them automatically according to the detected electrical family:
| Family (automatic) | IGN ON above | IGN OFF below |
|---|---|---|
| 12 V car (voltage ≤ 17 V) | 13.3 V | 12.9 V |
| 24 V truck (voltage > 17 V) | 25.4 V | 24.7 V |
Since v1.09.26 the thresholds can be set manually with the V suffix, for vehicles whose charging ranges don’t match the automatic ones (smart alternators, AGM/LiFePO4 batteries, machinery).
Configure manual thresholds
>SCXIGNV1,138,131< // enable: IGN ON above 13.8 V, OFF below 13.1 V
>SCXIGNV0< // disable: back to automatic thresholds| Parameter | Description | Range |
|---|---|---|
on | Turn-on threshold, in tenths of a volt (138 = 13.8 V) | 80–320 |
off | Turn-off threshold, in tenths of a volt (131 = 13.1 V) | 80–320 |
Validation: on must be greater than off — the difference between them is the hysteresis that prevents oscillations. With manual thresholds active, the automatic 12/24 V family selection is bypassed. The configuration persists across restarts.
Query thresholds and current voltage
>QCXIGNV<
>RCXIGNV1,138,131,128<| Field | Description |
|---|---|
| 1st | 1 = manual thresholds, 0 = automatic |
| 2nd / 3rd | Effective ON / OFF thresholds (in automatic mode, shows the ones in use) |
| 4th | Voltage measured at that moment, in tenths of a volt |
The first three fields of the response mirror the set command: the query response can be sent back as-is as a set.
Recommended procedure
- With the engine off:
>QCXIGNV<and note the voltage in the last field (e.g.126) - With the engine running:
>QCXIGNV<and note it (e.g.143) - Choose two cut points inside that band, with margin at both ends:
>SCXIGNV1,138,131<
The last-field voltage is the same —and in the same unit— as the V field of the reports: the procedure can also be done remotely by looking at the platform history.
Examples
Manual mode with fixed IGN
>SCXIGN1<
>SSSIGN11<Manual operation mode is set, then the IGN value is fixed = 1 (regardless of the case).
Configure custom times
>SCXIGN0,50,150<Normal mode (physical input), with ton = 5 s and toff = 15 s. Useful when a slower turn-off is desired to capture post-ignition events.
Change only the turn-on time
>SCXIGN0,200<Normal mode, ton = 20 s; toff keeps its previously configured value.
Query current configuration
>QCXIGN<
>RCXIGN0,100,100<Tune thresholds on a vehicle with shifted ranges
>SCXIGN2< // ignition by voltage
>QCXIGNV< // engine off -> RCXIGNV0,133,129,126
>QCXIGNV< // engine running -> RCXIGNV0,133,129,143
>SCXIGNV1,138,131< // cut points inside the measured band
>RCXIGNV1,138,131,143<Compatibility
Version availability:
- Mode 3 (Manual releasing IN07): available from firmware v1.09.15.
- Timing parameters
tonandtoff: available from firmware v1.09.17. - Configurable voltage thresholds (
SCXIGNV/QCXIGNV): available from firmware v1.09.26 (IoT line).
On earlier versions, only SCXIGN<a> with a between 0 and 2 is accepted.
See Also
- SS Command - Signal configuration
- Virtual Ignition by Voltage - Application note