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 trigger 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 read becomes a potential input for controlling digital outputs, providing flexibility and efficiency.
Custom Scenarios functionality logic
The Custom Scenarios functionality enables configuration of up to three independent scenarios, each with up to three unique triggers. Triggers are defined using data from various I/O elements, such as: Fuel Level, Engine RPM, Seatbelt Status, DTC Faults, Movement Status, Ignition State, GSM Signal Level, 1-Wire/Bluetooth sensor temperature and etc. Each trigger is configured with specific logic operands (e.g., "On Entrance," "On Exit"), threshold values (Low and High levels), 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 evaluate as true, the scenario becomes active. This can generate a record (if configured) and control the digital output (DOUT) 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 functionality configuration
The **Custom Scenarios** functionality allows users to configure up to three independent scenarios, each comprising up to three triggers. These triggers utilize data from I/O elements, enabling flexible and autonomous control over the device’s digital outputs (DOUT).
Configurable Parameters
Each scenario can be configured using the following parameters:
- **Output Control**:
- Specifies which DOUT (DOUT1, DOUT2, or DOUT3) the scenario controls. - Options: * 0 – None * 1 – DOUT1 * 2 – DOUT2 * 3 – DOUT3
- **Priority**:
- Determines the scenario's priority when multiple scenarios control the same DOUT. - Options: * 0 – None * 1 – Low * 2 – High * 3 – Panic
- **Trigger Sources (#1, #2, #3)**:
- Define the I/O sources to be monitored. Examples include ignition status, fuel level, RPM, or temperature readings. - Source #1 is mandatory and cannot be disabled, while #2 and #3 can be ignored if unnecessary.
- **Operand**:
- Defines the logic for evaluating source values. - Options: * 0 – On Exit * 1 – On Entrance * 2 – On Both * 3 – On Hysteresis * 4 – On Change * 5 – On Delta Change * 6 – Is (value within range)
- **Threshold Levels**:
- **Low Level**: Minimum value for trigger activation. - **High Level**: Maximum value for trigger activation.
- **Activation Delay Timer**:
- Specifies the time (in seconds) that a condition must remain true for the trigger to activate. - Range: 0 to 65,535 seconds.
- **Logic**:
- Defines whether all or any triggers must be true for the scenario to activate. - Options: * 0 – OR (any trigger activates the scenario) * 1 – AND (all triggers must be true to activate the scenario)
Scenario Activation Logic
1. All configured triggers are evaluated every second. 2. If all conditions for a scenario are met:
- The scenario activates. - A record is generated (if enabled). - The configured DOUT toggles ON or OFF based on the scenario's state.
3. Scenarios operate in deep-sleep mode if compatible I/O sources are used.
DOUT Control Options
- **Permanent Output Control**:
- When enabled, DOUT remains ON as long as conditions are met.
- **ON/OFF Durations**:
- If OFF duration > 0, DOUT blinks while the scenario is active. - If OFF duration = 0, DOUT stays ON continuously until the scenario deactivates.
Priority Management
Custom Scenarios follow a priority hierarchy:
- Scenario 1 has the highest priority.
- Scenario 3 has the lowest priority.
- If multiple scenarios control the same DOUT, the higher-priority scenario takes precedence.
For detailed examples and configuration steps, refer to the Configurator Page.
---
This Wiki section ensures clear formatting, structured details, and alignment with the document content:contentReference[oaicite:0]{index=0}.
In case the vehicle has a variable voltage alternator, also known as a smart alternator, an alternative configuration is advised -- taking into account movement detection by accelerometer, in order to monitor the ignition status of the vehicle.
Parameter list
| Parameter ID | Name | Value range | Description | ||
|---|---|---|---|---|---|
| Min | Max | Default | |||
| 66201 | Smart Ignition | 0 | 1 | 1 | 0 - Disabled; 1 - Enabled |
| 66202 | Smart Ignition Delta, mV | 100 | 2000 | 600 | How much external voltage must change, in miliVolts to detect ignition ON or OFF event. |
| 66203 | Smart Ignition Duration, s | 2 | 20 | 3 | Time interval, in seconds, used for comparing current external voltage against historical external voltage configured seconds ago. |
Firmware and hardware compatibility
Smart ignition detection functionality is available for FMT100/FMX880 devices on the firmware 03.29.00.rev.980. You can download the firmware and configurator here. 
