Common Script With Logic Template

Sensor - data to publish to broker.

Settings - user configurable settings.

Table of Contents

Operating principle.

Outputs, Static signals, Timers can be controlled by various sensors or settings. Settings as SMS control, identification, speed settings, harsh driving while active raises virtual flag, which is checked in output settings.

In Output settings is used AND logic, that means if multiple checkboxes are marked, script will check if all conditions matches.

By creating replicas in single output can change logic from AND to OR.

1. Assign script to Setting template.

Open

Note. Scripts have hierarchy, so if this is the only script assigned - assign it to ‘Script1’ field.

2. Configure script settings.

After assigning a script, the Settings field will appear. Expand it to configure.

Open

A. Enabling interfaces to work with script.

Such interfaces like Outputs, 1-wire, Static signals is a part of device hardware, so if you want them to be controlled by script - need to configure it in ‘Hardware’ settings:

Below is example of configuring Output for script access:

Open

The same can be done with other interfaces, like 1-wire or Wiegand26.

B. Configuring SMS settings.

Open

It will generate “SMS Control” signal, based on which you can control Outputs, Timers, or other functions.

Open

C. Harsh driving settings.

Firstly need to set thresholds, which will generate violation signals:

Open

It will generate “Harsh Cornering”, “Harsh Accelerating”, “Harsh Braking” signals, based on which you can control Outputs, Timers, or other functions.

Open

D. Speed settings.

If not using ‘Geofencing’, in configuration can be used just single speed threshold. “Use Geozones” mark should be unticked.

Multiple speeds can be used together with different ‘Geozone groups’. Every address can have it’s own speed threshold.

To use Speed settings with Geozones, at first need to include Geozone group in Geofencing:

Open

To use Speed settings with Geozones, at first need to include Geozone group in Geofencing:

Open

Geozone ID in both ‘Geofencing’ and in Speed settings have to match.

If speed limit in Speed settings is 0 output will turn on when car will be in specified geozone.

Thresholds will generate “Speed Settings” signal, based on which you can control Outputs, Timers, or other functions.

Open

If marked - it will activate signal if speed threshold of any ‘Geozone group’ is reached.

E. Identification settings configuration.

Identification can be used with, or without ‘ID lists’. If case if no ‘ID list’ is assigned, device will work with any iButton or RFID card.

ID lists can be assigned in “Identification' menu:

Open

Below you can find an example of Identification settings configuration.

Open

• Disable Ibutton reading while authorized - Device will not read and parse RFID Tags while driver is authorized. (Recommended to use with Ibutton string and IDlist)

• Authorized Only When Tag is Presented - Driver will be authorized only while RFID Tag is touching Ibutton reader.

• Reset Authorization After Ignition is Off - device resets driver ID and authorization status after Ignition off and Authorization expiration timeout.

• Index Of ID list - number of ID list set in ‘Identification’ settings.

Note. If ID list is enabled, Index of ID list must match with ID list index in list configuration.

• Use ID list for Authorization - script will check if Tag ID is included in ID list.

• Timeout for Authorization - Time given for driver to authorize, if driver is still not authorized “Authorization Warning” = True, after authorization “Authorization Warning” = False.

• Authorization expiration timeout - time until authorization expiration after ignition turned off.

• Ignition pin - which pin of device will be used as ignition for identification.

• Ibutton Sensor - Assign additional Ibutton sensor (Recommended to use with Disable Ibutton reading while authorized).

• Ibutton string format - format how chosen Ibutton sensor will be parsed. (Hex_raw, Hex, Decimal)

• Read Tag ID option - Read Half ID: reads only lower bits of RFID tag ID. Read Full ID: reads both low and high bits of RFID tag ID.

When ‘Identification settings’ are configured, based on them can configure Outputs, Timers, or other functions. Can use following signals:

Open

Driver Authorized - generates signal after tag assigned to reader when Ignition is On.

Authorization Warning - generates signal when authorization time in ‘Identification’ settings has exceeded.

Wiegand Present - generates signal after Wiegand26 tag assigned to reader.

F. Timer control settings configuration.

When configuring Timers it is necessary to set starting (Increment) and resetting (Reset to 0) conditions.

Open

It will generate “Timer 1”, “Timer 2” or “Timer 3” signal, based on which you can control Outputs.

Open

G. Static signal configuration.

‘Static signal’ is a long lasting virtual signal that can be generated by certain conditions, signal or SMS commands. Then stopped by other conditions. In most cases Static signals are being used for remote immobilization, or some unique scenarios.

Configuration will generate “Static signal 1” and “Static signal 2”, based on which you can control Outputs.

Open

H. OUT control configuration.

After enabling ‘Script access; in Out configuration under 'Hardware’, you can create conditions when Outputs should get On and when Off.

Note, that Outputs can not have just one conditions - if you create condition when it should get ON, also need to create a condition when it should get OFF.

Conditions can be added by clicking “Add+” button:

Open

Below is example of immobilization:

Open

Open

Open

Note: After every script update, making “Reserialize” is recommended to ensure, that new settings will be rewritten to the device.