Custom Scenarios
Introduction to Custom Scenarios functionality
To meet the diverse and evolving needs of our clients, we have developed the Custom Scenarios feature. This solution allows users to define specific conditions using customizable parameters to generate events or control a device’s digital outputs. By connecting the device to peripherals like alarms, buzzers, or relays, this functionality can notify drivers or perform targeted actions seamlessly.
The feature enables the device to operate autonomously based on predefined conditions, eliminating the need for constant monitoring of device status or complex backend integrations. With Custom Scenarios, any data the device can send becomes a potential input for controlling digital outputs, providing flexibility and efficiency.
Custom Scenarios description
The Custom Scenarios functionality enables configuration of up to three independent scenarios, each with up to three unique triggers. Triggers are defined using data as source from various I/O elements, such as: Fuel Level, Engine RPM, Seatbelt Status, DTC Faults, Movement Status, Ignition State, GSM Signal Level, 1-Wire or Bluetooth sensor temperature and etc. Each source is configured with specific logic operands, threshold values, and an activation delay timer, which specifies how long a value must remain within the defined range before the trigger is activated.
When all triggers of a scenario are 'true', the scenario becomes active. This can generate a record and/or control the Digital Output by toggling it on or off based on the active conditions. Additionally, if configured for continuous operation, the DOUT remains active as long as the conditions are met.
Key features include:
- Support for dynamic trigger logic based on selected operands and conditions.
- Autonomous device operation, even in low-power or deep-sleep modes, provided compatible I/O sources are used.
- Adjustable ON/OFF durations or permanent output control, enabling versatile device behaviors such as blinking or continuous activation.
- Custom Scenarios operate independently from the I/O menu, with priority management ensuring that higher-priority scenarios take precedence in controlling the DOUT when multiple scenarios are configured.
Custom Scenarios configuration and parameters
Configuration UI
Configuration parameters
| Parameter Name | Parameter ID | Value Range | Default Value | Value | Value Definition | Description | Version Introduced | |||
|---|---|---|---|---|---|---|---|---|---|---|
| Custom Scenario 1 ID | Custom Scenario 2 ID | Custom Scenario 3 ID | Min | Max | ||||||
| Priority | 19101 | 19131 | 19161 | 0 | 3 | 0 | 0 | None | No priority is set for the scenario, eventual records will not be generated. | 03.28.06.Rev.260 |
| 1 | Low | Low priority is set for the scenario. | ||||||||
| 2 | High | High priority is set for the scenario. | ||||||||
| 3 | Panic | Panic priority is set for the scenario. | ||||||||
| Output Control | 19100 | 19130 | 19160 | 0 | 3 | 0 | 0 | None | Specifies that no DOUT is controlled by the scenario. | 03.28.06.Rev.260 |
| 1 | DOUT1 | Specifies that DOUT1 is controlled by the scenario. | ||||||||
| 2 | DOUT2 | Specifies that DOUT2 is controlled by the scenario. | ||||||||
| 3 | DOUT3 | Specifies that DOUT3 is controlled by the scenario. | ||||||||
| Permanent Output Control | 19124 | 19154 | 19184 | 0 | 1 | 0 | 0 | Disabled | DOUT will be controlled continuously on and off according to DOUT ON Duration and DOUT OFF Duration parameters. | 03.30.01.Rev.60 |
| 1 | Enabled | DOUT will be constantly ON while scenario is active. | ||||||||
| DOUT ON Duration | 19102 | 19132 | 19162 | 100 | 65000000 | 200 | - | milliseconds | Duration for which DOUT remains turned ON | 03.28.06.Rev.260 |
| DOUT OFF Duration | 19103 | 19133 | 19163 | 0 | 65000000 | 200 | - | milliseconds | Duration for which DOUT remains OFF. If Permanent Output Control and DOUT OFF Duration values are set to 0, DOUT will be turned on for the period configured in DOUT ON Duration parameter. | 03.28.06.Rev.260 |
| Source #1 | 19105 | 19135 | 19165 | - | - | Device-specific | - | Calculated ID | Data source for primary trigger for the scenario. This trigger cannot be ignored. | 03.28.06.Rev.260 |
| Source #2 | 19110 | 19140 | 19170 | - | - | Device-specific | - | Calculated ID | Data source for secondary trigger for the scenario. This trigger can be ignored. | 03.28.06.Rev.260 |
| Source #3 | 19116 | 19146 | 19176 | - | - | Device-specific | - | Calculated ID | Data source for tertiary trigger for the scenario. This trigger can be ignored. | 03.28.06.Rev.260 |
| Operand | 19106 | 19136 | 19166 | 0 | 6 | 0 | 0 | On Exit | Trigger activates on exit of the defined condition. | 03.28.06.Rev.260 |
| 1 | On Entrance | Trigger activates on entrance of the defined condition. | ||||||||
| 2 | On Both | Trigger activates on both entrance and exit of the condition. | ||||||||
| 3 | On Hysteresis | Trigger activates on hysteresis of the condition. | ||||||||
| 4 | On Change | Trigger activates on any change in the condition. | ||||||||
| 5 | On Delta Change | Trigger activates on a specified delta change. | ||||||||
| 6 | Is | Trigger activates as long as source value is in range between Low and High. | 03.29.00.Rev.294 | |||||||
| Low Level | 19107 | 19137 | 19167 | Dynamic | Dynamic | 0 | - | - | Sets the lower threshold value for the trigger. | 03.28.06.Rev.260 |
| High Level | 19108 | 19138 | 19168 | Dynamic | Dynamic | 0 | - | - | Sets the upper threshold value for the trigger. | 03.28.06.Rev.260 |
| Activation Delay Timer | 19109 | 19139 | 19169 | 0 | 65535 | 0 | - | seconds | Time the trigger must remain true for activation of the scenario. | 03.28.06.Rev.263 |
| Ignore | 19114 | 19144 | 19174 | 0 | 1 | 1 | 0 | No | The trigger will not be ignored and is actively checked. | 03.28.06.Rev.260 |
| 1 | Yes | The trigger will be ignored and will not affect scenario activation. | ||||||||
| Logic | 19115 | 19145 | 19175 | 0 | 1 | 1 | 0 | OR | Trigger evaluation logic: any enabled trigger activates the scenario. | 03.28.06.Rev.263 |
| 1 | AND | Trigger evaluation logic: all enabled triggers must be true to activate the scenario. | ||||||||
Output control and eventual record logic
Records are generated when all enabled trigger conditions are met, and the scenario activates, also controlling the configured DOUT state. If the priority is set to "None", no record will be created; however, the scenario will still control the DOUTx if it is configured your configuration. For more details on priority, refer to this page
Eventual record AVL ID list
| Custom Scenario | AVL ID | DOUTx State | Record Value |
|---|---|---|---|
| Custom Scenario 1 | 1163 | OFF -> ON | 1 |
| ON -> OFF | 0 | ||
| Custom Scenario 2 | 1164 | OFF -> ON | 1 |
| ON -> OFF | 0 | ||
| Custom Scenario 3 | 1165 | OFF -> ON | 1 |
| ON -> OFF | 0 |
Output control priority management
Custom scenarios can be configured to use the same or different digital outputs. When multiple scenarios are assigned to the same digital output, the scenario with the highest priority takes control when active. Custom Scenario 1 has the highest priority, while Custom Scenario 3 has the lowest. The priorities of all device scenarios:
| Priority | Scenario |
|---|---|
| #1 | SECO |
| #2 | Towing |
| #3 | Immobilizer |
| #4 | Private Mode |
| #5 | DOUT Control Via Ignition |
| #6 | Call |
| #7 | Authorized Read Notification |
| #8 | Green Driving |
| #9 | Jamming |
| #10 | Overspeeding |
| #11 | Idling |
| #12 | DOUT Control via SMS |
| #13 | Custom Scenario 1 |
| #14 | Custom Scenario 2 |
| #15 | Custom Scenario 3 |
| #16 | GNSS Jamming |
| #17 | Diagnostic Tool Maintenance |
Source value calculation
Source value is the calculated parameter value ID of the selected source. The possible sources depend on the hardware. The sources are based on the I/Os, their parameter value IDs (which are needed when setting sources via commands) can be calculated:
Parameter value ID = (I/O Element AVL ID - I/O Group First Element AVL ID) * 10 + I/O Group AVL ID
| I/O Group Name | I/O Group AVL ID | I/O Group First Element AVL ID |
|---|---|---|
| Base | 50000 | 0 |
| LVCAN | 45100 | 478 |
| OBD | 40100 | 398 |
For example: IButton I/O AVL ID is 39, so parameter value ID will be (39 - 0) * 10 + 50000 = 50390. It can be set using setparam command to remotely change configuration of Custom Scenarios source to be IButton remotely. To check element AVL ID list refer to this page.
Examples of use cases
- **Scenario 1**: Control a relay when fuel level drops below 10%. - **Scenario 2**: Trigger a buzzer if RPM exceeds 3000 while ignition is ON. - **Scenario 3**: Activate an alarm when GSM signal strength drops below 20%.