Skip to Content
CommandsStatesTriggersUV

UV Command — User Triggers

Creates custom triggers that monitor any internal device variable and generate events when specific conditions are met.

What is it for?

Use caseDescription
🎯 Variable monitoringSupervises any internal device parameter
⚡ Change detectionTriggers events when values enter/exit ranges
📈 Delta modeDetects abrupt changes in speed, fuel, etc.
🔗 Rules integrationUV00-UV47 signals available for event engine
🔧 Response parsingExtracts specific fields with delimiters

Supports 32 triggers (indices 00-31), expandable up to 47 in some firmwares.

Syntax

ActionCommandDescription
QueryQUVnnQueries trigger nn configuration
ConfigureSUVnnabb.bb,cc,dd,ee,ffConfigures complete trigger
Delete oneSUVnn*Deletes trigger nn
Delete allSUV*55AADeletes all triggers
Reset signalSUVnnRSets UVnn signal to 0

Parameters

ParamDescriptionValues
nnTrigger index00 to 31 (or 47)
aConversion typeSee table below
bb.bbInternal command to monitorEx: QIO, QVR
ccFirst character indexPosition in response
ddCharacter countData length
ee..eeMinimum value (≥) or delta timeDepends on type
ff..ffMaximum value (<) or deltaDepends on type

Conversion Types

TypeDescriptionRange
/ SSigned decimal-2147483648 to +2147483647
UUnsigned decimal0 to 4294967295
FFloating pointDecimals
HHexadecimal Big Endian0x00 to 0xFFFFFFFF
hHexadecimal Little Endian0x00 to 0xFFFFFFFF
AASCII stringText
XDelta (abrupt change)From v1.08.07

Delta Mode (X) - Detail

Delta mode accumulates changes in the monitored value over a time window and triggers if the accumulated variation exceeds the configured threshold.

Parameters in X mode:

ParamFunction
eeTime window in seconds
ffDelta threshold (see modes below)

Comparison modes:

ff formatBehaviorTriggers when
ff positive (e.g.: 20)Increments onlyIf accumulated delta ≥ ff
ff negative (e.g.: -20)Decrements onlyIf accumulated delta ≤ ff
*ff (e.g.: *20)Absolute valueIf |accumulated delta| ≥ |ff|

Internal operation:

  1. At the start of each window, saves the current value and resets the accumulator
  2. On each evaluation, adds the difference: delta += current_value - previous_value
  3. When time ee is reached, compares the accumulated delta with threshold ff
  4. If the condition is met, triggers the corresponding UV signal
  5. Restarts the time window and accumulator

The ff value (delta) cannot be zero. If delta = 0 is configured, the trigger will not be processed.

Split Field (Optional)

Format: \XXnn where:

  • XX = Delimiter character in hexadecimal (ex: 3B = ;)
  • nn = Field number to extract
// Example: \3B1 separates by ";" and takes field 1

Associated Signals

PropertyValue
SignalUV
Index00 - 47
Conditional use✅ Yes
Edges+ positive, - negative, * any

Practical Examples

Example 1: Ignition Monitoring

Captures IGN state from QIO command:

>SUV00UQIO,7,1,1,2<       // Unsigned, position 7, 1 character, range 1-2

Create rules to detect ignition changes:

>SRL00E;TRG=UV00+;ACC={STX UV00+ ;@TRM}<  // Positive trigger (IGN ON)
>SRL01E;TRG=UV00-;ACC={STX UV00- ;@TRM}<  // Negative trigger (IGN OFF)

Example 2: GPS Antenna Status

Detect if GPS antenna is connected, open, or short-circuited:

// Configure query buffer
>SCXXB04G0000000,STATUS=,\2A,A<
 
// Create triggers for each state
>SUV00AQXB04,5,2,OK,<       // GPS Antenna OK
>SUV01AQXB04,5,4,OPEN,<     // GPS Antenna open
>SUV02AQXB04,5,5,SHORT,<    // GPS Antenna short
 
// Rules to report status
>SRL90E;TRG=UV00+;ACC={STX GPS ANTENNA CONNECTED;@TRM}<
>SRL91E;TRG=UV01+;ACC={STX GPS ANTENNA OPEN;@TRM}<
>SRL92E;TRG=UV02+;ACC={STX GPS ANTENNA SHORT;@TRM}<

Expected result:

>RTX GPS ANTENNA CONNECTED;ID=039129;*5B<
>RTX GPS ANTENNA OPEN;ID=039129;*47<
>RTX GPS ANTENNA SHORT;ID=039129;*61<

See CXXB command

Example 3: Using Delimiter (Split)

Extract IGN from response delimited by ;:

>SUV04FQIO,\3B1,3,1,1,2<    // Delimiter ; (0x3B), field 1

QIO Response:

RIO;IGN1;IN1111111;XP000;V000;VBU464
    ↑
    Field 1, position 3, 1 character = "1"

Query UV trigger value with: >QSSUV04<

Compatibility

💾Firmware v1.03.00
SPLegacy
ULLegacy
MTLegacy
💾Firmware v1.00.00
SP-IOT
SM-IOT
ZE-IOT

See Also

Last updated
IntroductionIntroduction