Difference between revisions of "Custom Scenarios"

From Wiki Knowledge Base | Teltonika GPS
(Undo revision 101241 by Airidas.S (talk))
Tag: Undo
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Introduction to Custom Scenarios functionality==
 
==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.
+
Given that different clients have unique needs and are always expanding their options and solutions, we continually look for ways to meet various expectations in a timely manner.To achieve this, we developed a solution that allows users to customize a set of parameters as conditions in order generate an event or control the device's digital outputs. When connected to different types of peripherals such as alarms, buzzers or relays, this feature can inform the driver or complete specific functions.  
  
−
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.
+
Since the device operates independently under different conditions, it eliminates the need to monitor device status on the platform and implement complex backend functions. Using the custom scenarios functionality any type of data readable by the specific device model can impact how and when the digital output is controlled.  
  
  
 
==Custom Scenarios functionality logic==
 
==Custom Scenarios functionality logic==
−
[[File:Custom Scenarios Topology.png|right|thumb|800px|Figure 1. “Custom Scenarios” functionality logic]]
+
[[File:Custom Scenarios Topology.png|right|thumb|600px|Figure 1. “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.
+
“Smart Ignition Detection”– detects ignition “on” and “off” automatically by monitoring last “Smart Ignition Duration” seconds of external voltage and comparing it to current external voltage value. If current external voltage value is higher by “Smart Ignition Delta” than external voltage “Smart Ignition Duration” seconds ago, Ignition “on” event is detected. If current external voltage value is lower by “Smart Ignition Delta” than “Smart Ignition Duration” seconds ago Ignition “off” event is detected.
  
−
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==
 
  
−
Below is a detailed explanation of configurable parameters for each scenario.
 
  
−
{| class="wikitable" style="text-align:left; width:100%;"
+
 
−
! Parameter ID !! Parameter Name !! Min Value !! Max Value !! Default Value !! Description
+
 
−
|-
+
 
−
| 19100, 19130, 19160 || Output Control || 0 || 3 || 0 || Specifies the DOUT controlled by the scenario:
+
 
−
* 0 – None
+
 
−
* 1 – DOUT1
+
==Smart Ignition Detection configuration==
−
* 2 – DOUT2
+
 
−
* 3 – DOUT3
+
New configurable parameters were added under “Ignition Settings” (Figure 2):
−
|-
+
 
−
| 19101, 19131, 19161 || Priority || 0 || 3 || 0 || Sets the scenario priority:
+
• Smart Ignition Enable/Disable – To enable functionality. Parameter is able to be configured if “Ignition Source” has “Power Voltage” configured.
−
* 0 – None
+
 
−
* 1 – Low
+
• Smart Ignition Delta (mV) – How much external voltage must change to detect ignition ON or OFF event.
−
* 2 – High
+
 
−
* 3 – Panic
+
• Smart Ignition Duration (s) – Time interval used for comparing current external voltage against historical external voltage configured seconds ago.
−
|-
+
[[File:Smart ignition.png|thumb|left|alt=|Figure 2. “Smart Ignition” configurable parameters]]
−
| 19124, 19154, 19184 || Permanent Output Control || 0 || 1 || 0 || Enables continuous DOUT control as long as conditions are met.
+
 
−
|-
+
 
−
| 19102, 19132, 19162 || DOUT ON Duration || 100 ms || 65,000,000 ms || 200 ms || Duration for which DOUT remains ON when the scenario is active.
+
 
−
|-
+
 
−
| 19103, 19133, 19163 || DOUT OFF Duration || 0 || 65,000,000 ms || 200 ms || Duration for which DOUT remains OFF. A value of 0 means the DOUT stays ON continuously.
+
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
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.
 +
[[File:Ignitionaccel.PNG|left|thumb|600px|Figure 3. “Smart Ignition” recommended configuration for vehicles with smart alternators]]
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
'''<big>Parameter list</big>'''
 +
{| class="wikitable"
 +
|+
 +
! rowspan="2" style="width: 150px; background: #003475; color: white;" |'''Parameter ID'''
 +
! rowspan="2" style="width: 150px; background: #003475; color: white;" |'''Name'''
 +
! colspan="3" style="width: 150px; background: #003475; color: white;" |'''Value range'''
 +
! rowspan="2" style="width: 250px; background: #003475; color: white;" |'''Description'''
 
|-
 
|-
−
| 19105, 19135, 19165 || Source #1 || Device-specific || Device-specific || IO element ID || The primary I/O source for the trigger. Cannot be ignored.
+
! style="width: 75px; background: #003475; color: white;" |Min
 +
! style="width: 75px; background: #003475; color: white;" |Max
 +
! style="width: 75px; background: #003475; color: white;" |Default
 
|-
 
|-
−
| 19110, 19140, 19170 || Source #2 || Device-specific || Device-specific || Ignored || The secondary I/O source. Can be ignored.
+
!style="text-align: center; vertical-align: center;" |66201
 +
|style="text-align: center; vertical-align: center;" |Smart Ignition
 +
|style="text-align: center; vertical-align: center;" |0
 +
|style="text-align: center; vertical-align: center;" |1
 +
|style="text-align: center; vertical-align: center;" |1
 +
|style="text-align: center;" |0 - Disabled; <br> 1 - Enabled
 
|-
 
|-
−
| 19116, 19146, 19176 || Source #3 || Device-specific || Device-specific || Ignored || The tertiary I/O source. Can be ignored.
+
!style="text-align: center; vertical-align: center;" |66202
 +
|style="text-align: center; vertical-align: center;" |Smart Ignition Delta, mV
 +
|style="text-align: center; vertical-align: center;" |100
 +
|style="text-align: center; vertical-align: center;" |2000
 +
|style="text-align: center; vertical-align: center;" |600
 +
|style="text-align: center;" |How much external voltage must change, in miliVolts to detect ignition ON or OFF event.
 
|-
 
|-
−
| 19106, 19136, 19166 || Operand || 0 || 6 || 0 || Defines the condition logic for the trigger:
+
!style="text-align: center; vertical-align: center;" |66203
−
* 0 – On Exit
+
|style="text-align: center; vertical-align: center;" |Smart Ignition Duration, s
−
* 1 – On Entrance
+
|style="text-align: center; vertical-align: center;" |2
−
* 2 – On Both
+
|style="text-align: center; vertical-align: center;" |20
−
* 3 – On Hysteresis
+
|style="text-align: center; vertical-align: center;" |3
−
* 4 – On Change
+
|style="text-align: center;" |Time interval, in seconds, used for comparing current external voltage against historical external voltage configured seconds ago.
−
* 5 – On Delta Change
 
−
* 6 – Is
 
 
|-
 
|-
−
| 19107, 19137, 19167 || Low Level || Dynamic || Dynamic || 0 || Sets the lower threshold value for the source trigger.
 
−
|-
 
−
| 19108, 19138, 19168 || High Level || Dynamic || Dynamic || 0 || Sets the upper threshold value for the source trigger.
 
−
|-
 
−
| 19109, 19139, 19169 || Activation Delay Timer || 0 s || 65,535 s || 0 || Time (in seconds) the condition must remain true for activation.
 
−
|-
 
−
| 19115, 19145, 19175 || Logic || 0 || 1 || 1 || Determines trigger evaluation logic:
 
−
* 0 – OR (any trigger activates the scenario)
 
−
* 1 – AND (all triggers must be true to activate the scenario)
 
 
|}
 
|}
  
−
=== Configuration Process ===
 
−
 
−
1. **Define Output Control**:
 
−
  - Assign the DOUT (DOUT1, DOUT2, or DOUT3) to be controlled by the scenario.
 
−
 
−
2. **Configure Triggers**:
 
−
  - Select up to three I/O sources (e.g., ignition, fuel level, temperature).
 
−
  - Define operands to specify logic (e.g., "On Entrance," "Is").
 
−
  - Set Low and High threshold values for each source.
 
−
  - Adjust the Activation Delay Timer for precise control.
 
−
 
−
3. **Set Priority**:
 
−
  - Choose the priority level for the scenario. Higher-priority scenarios override lower-priority ones for the same DOUT.
 
−
 
−
4. **Adjust DOUT Control Settings**:
 
−
  - Configure DOUT ON/OFF durations or enable Permanent Output Control for continuous activation.
 
−
 
−
5. **Save Configuration**:
 
−
  - Verify all parameters and save the configuration. The device evaluates scenario conditions every second.
 
  
−
=== Example Use Cases ===
 
  
−
- **Scenario 1**: Control a relay when fuel level drops below 10%.
+
==Firmware and hardware compatibility==
−
- **Scenario 2**: Trigger a buzzer if RPM exceeds 3000 while ignition is ON.
+
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. [[File:Download_zip.png|x30px|link=Special:Redirect/file/FMB.Ver.03.29.00.rev.980 and configurator.zip]]
−
- **Scenario 3**: Activate an alarm when GSM signal strength drops below 20%.
 

Revision as of 15:45, 18 November 2024

Introduction to Custom Scenarios functionality

Given that different clients have unique needs and are always expanding their options and solutions, we continually look for ways to meet various expectations in a timely manner.To achieve this, we developed a solution that allows users to customize a set of parameters as conditions in order generate an event or control the device's digital outputs. When connected to different types of peripherals such as alarms, buzzers or relays, this feature can inform the driver or complete specific functions.

Since the device operates independently under different conditions, it eliminates the need to monitor device status on the platform and implement complex backend functions. Using the custom scenarios functionality any type of data readable by the specific device model can impact how and when the digital output is controlled.


Custom Scenarios functionality logic

Figure 1. “Custom Scenarios” functionality logic

“Smart Ignition Detection”– detects ignition “on” and “off” automatically by monitoring last “Smart Ignition Duration” seconds of external voltage and comparing it to current external voltage value. If current external voltage value is higher by “Smart Ignition Delta” than external voltage “Smart Ignition Duration” seconds ago, Ignition “on” event is detected. If current external voltage value is lower by “Smart Ignition Delta” than “Smart Ignition Duration” seconds ago Ignition “off” event is detected.







Smart Ignition Detection configuration

New configurable parameters were added under “Ignition Settings” (Figure 2):

• Smart Ignition Enable/Disable – To enable functionality. Parameter is able to be configured if “Ignition Source” has “Power Voltage” configured.

• Smart Ignition Delta (mV) – How much external voltage must change to detect ignition ON or OFF event.

• Smart Ignition Duration (s) – Time interval used for comparing current external voltage against historical external voltage configured seconds ago.

Figure 2. “Smart Ignition” configurable parameters












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.

Figure 3. “Smart Ignition” recommended configuration for vehicles with smart alternators















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. Download zip.png

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Custom_Scenarios&oldid=101230"