OVERVIEW & PURPOSE
Detail explanation on how to build managed configurations for Syrus Intelligent tracking devices reporting to Pegasus Gateway IoT Application Enablement Platform for Fleet Automation and Mobile Asset Management.
All links refer to our Licensed Support Library available for USD $240/annually and can be purchase here.
INTRODUCTION
- A managed configuration is a .py (Python Software Foundation) extension file which divides in 4 main parts:
- Header: Contains the main information required to start as well as:
- Name: Name of the current config; Two configurations cannot have the same name
- Restricted_firmware: Minimum and maximum firmware version which supports the current configuration. This is very important since some firmwares cannot support newer commands, generating errors in Pegasus. Useful to apply to specific business models
- Params: Several parameters to establish initial values and accessories commands, as well as Speed limit, Tracking resolution commands, Safe immobilization commands, counters, among others.
- Tracking_resolutions: Several options for tracking resolution to be configurable via Pegasus
- Sms_alias_actions: Since there are up to 4 configurable telephone destination points, we can execute some basic commands from them using SMS, as well as Secure Engine Cut off, request for location etc.
- Allowed commands: Sometimes we need to send some special configuration commands via Pegasus Console. This is the field to specify the authorized ones.
- Script: This is a field marked as “cmds” and it contains all the commands to configure Syrus
- Labels: This field is for the label which use Pegasus and its web-services and restful-API to identify different Syrus’ events. Very important to respect labels for report generation data.
- For a list of labels please refer to the api/labels
- Footer: Contains descriptions for the end user of each event configured in Syrus.
- Html_description: HTML with events description to be shown in administration section of Pegasus
- There are some considerations to take into account when Syrus is used to track stationary Assets, motors, etc. Please refer to final chapter if so for special instructions.
For a complete Script configuration sample, download S227.py template
HEADER
Name
#!/usr/bin/python
# -*- coding: utf-8 -*-
name = {'en' : u'Base Standard Configuration',
'es' : u'Configuración Base Estándar'
Change the text for the desired name in spanish (es) and english (en).
Don’t forget to change the name in HTML Description section:
<tr>
<td valign="top" align="center" width="500px">
<span style="font-weight:bold; font-size:14px">Base Standard Configuration is used on vehicles on which Syrus device is permanently powered, has the ignition detection wired.</td>
</tr>
<tr>
<td valign="top" align="center" width="500px">
<span style="font-weight:bold; font-size:14px">Configuración Base Estándar es usada en vehículos en los cuales el dispositivo Syrus esta alimentado permanentemente, tiene conectada la detección de ignición.
.</td>
</tr>
Restricted Firmware
Put the minimum and maximum firmware for this configuration here
restricted_fw = {
'min_number':2003023,
'max_number':9999999,
'allow_only_flavor_string' : None
}
For this example version 2.3.23 is separated by zeros as follows: 2 003 023.
Parameters
‘cmds_speedlimit‘: These commands are inside the script, but Pegasus will modify them according to your preferences selected in “Organization”
- ‘initialvalues_speedlimit_mph’ – initial speed limit in mph
- ‘initialvalues_speedlimit_secs’ – initial speed limit persistence in seconds
‘cmds_tracking‘: Same as speed limit, these commands are modified by pegasus when you change your preferences in “Organization”
‘safeimmo‘: If True, Pegasus is going to use Output 1 in a safe immobilization mode. False will allow to use output1 as an ordinary output. For more information on these mode see Appendix A.
‘using_ccounters’ : True,: This tell Pegasus to use special Syrus’ counters that will be described later on this document. This line cannot be removed
params = {
'cmds_speedlimit' : '>SXACST{{mph}}0<>SED93SV0;G27+;XCT=SGC03TC{{secs}}<',
'initialvalues_speedlimit_mph' : 50,
'initialvalues_speedlimit_secs' : 10,
'cmds_tracking' : '>SXAGH00{{head}}<>SED97SV0;F00+;XCT=SGC01TR{{secs}};XCT=SGC19TC00010<>SED95SV0;J00F00&+;XCT=SGC01TR{{secs}}<',
'initialvalues_tracking_resolution' : 5,
'safeimmo' : True,
'using_ccounters' : True,
}
Tracking Resolutions
Put here all the desired combinations desired for tracking resolutions. First number is for “Turn angle sensitivity” and Second number is for periodic time reporting without turning.
Example: (35,20) stands for 35° or 20 seconds, whatever occurs first
tracking_resolutions = {
10: (30,20),
9 : (35,20),
8 : (35,30),
7 : (40,60),
6 : (40,120),
5 : (45,300),
4 : (70,420),
3 : (90,600),
2 : (None,720),
1 : (None,1800),
}
SMS Alias Actions
In Pegasus you can select special Keywords so send via SMS through authorized mobile numbers to activate/deactivate Outputs (Either cancel or execute).
In this section you can customize the text explanation that it is going to appear in Pegasus.
Pegasus Section View
sms_alias_actions = {
'safeimmo_set' : {
'cmd' : '>SXASES1<',
'name' :{'en': 'Execute a Safe Immobilization' ,
'es':'Ejecute la Immobilización Segura'},
'description' :{'en': 'Execute a Safe Immobilization' ,
'es':'Ejecute la Inmobilización Segura'}
},
'safeimmo_reset' : {
'cmd' : '>SXASES0<',
'name' :{'en': 'Cancel a Safe Immobilization' ,
'es':'Cancelar la Immobilización Segura'},
'description' :{'en': 'Cancel a Safe Immobilization' , 'es':'Cancelar la Immobilización Segura'}
},
}
Allowed Commands
These are the commands that can be sent from Pegasus Console. Be careful not to allow commands which could disable the unit communication
allowed_cmds = [
'>SRT;SFBUFF',
'>SRT;ECU<',
'>SXAQQ',
'>SXAEM',
'>SXAV',
'>SXAWA',
'>SXAIL',
'>SXATT',
]
Note: Note SXAV in yellow is allowing to send all the commands beginning with XAV: XAVH, XAVI, XAVO, XAVC and so on. Please take a look to the technical manual for further information
SCRIPT
Script comes under the name “cmds” and bounded in triple quotes. It contains all the necessary commands to configure syrus, except Destination point, which is given by configurator software.
- It cannot have comments as you could see in the original .py file, but we are going to put some comments to explain the function of each block.
- Also, all the commands have a direct link to Technical Manual so you can study the exact function of each command deeper.
- Signals are marked in red and orange so you can check them on the Signal List
cmds = """
>SRT;CONFIG<
>SXATT01<
>SXASEM0<
>SSSXP10<
>SXAPSE<
>SXADP01U<
>SXADP02U<
>SXADP03U<
>SXADP05U<
>SXADP04U<
>SXADP10U<
>SXADP11U<
>SXADP12U<
>SXADP13U<
>SXADP14U<
>SXAKA0141<
>SXAEC::gps 9 1<
>SXAVOC;IGN<
>SDA0;P00<
>SXAEFA;AC;AL;AV;BL;CF;DOP;IX;JO;SV;VO;CL;CE;CS<
>SGC00TR07200<
>SXASP00F00002002<
>SXASP01IP2002002<
>SXASP03OJ0010010<
>SXAQQ1;10,180,0600;IOS,G08<
>SXAGH001045<
>SED00MA0;C00+<
>SED96SV0;F00-;XCT=SGC00TR07200;XCT=SGC01U;XCT=SGC06U;XCT=SGC07U<
>SED97SV0;F00+;XCT=SGC01TR00300;XCT=SGC19TC00010<
>SED95SV0;J00F00&+;XCT=SGC01TR00300<
>SED01MA0;C01J00|C19&+;XCT=SGC19TC00010<
>SED98SV0;F00+;XCT=SXAPSE;XCT=SGC00U;XCT=SGC06DR00500<
>SED99SV0;F00-;XCT=SGC04U<
>SED02MA0;F00+;XCT=SGC17U<
>SED03MA0;F00-;XCT=SGC17TC0216000060<
>SXACST0500<
>SED93SV0;G27+;XCT=SGC03TC00010<
>SED94SV0;G27-;XCT=SGC03U<
>SED04MA0;G27C03&+<
>SED91SV0;G05+;XCT=SGC04TR00600;XCT=SSSU021<
>SED92SV0;G05-;XCT=SGC04U;XCT=SSSU020<
>SED07MA0;C04U02&+;XCT=SSSU020<
>SED05MA0;F00C04&+;XCT=SSSU041<
>SED06MA0;G05!U04&+;XCT=SSSU040<
>SED90SV0;C06+;XCT=SGC07TC00300<
>SED08MA0;C07F01&+<
>SED10MA0;IP1+<
>SED11MA0;IP2+<
>SED12MA0;IP2-<
>SED13MA0;IP3+<
>SED14MA0;IP3-<
>SED15MA0;XP1+<
>SED16MA0;XP1-<
>SED17MA0;XP2+<
>SED18MA0;XP2-<
>SXATA021;SSSXP21;OUT2ON<
>SXATA031;SSSXP20;OUT2OFF<
>SED19MA0;G07+<
>SED20MA0;G07-<
>SED21MA0;F15+<
>SED22MA0;F13-<
>SED23MA0;F13+<
>SED24MA0;F04+<
>SED25MA0;F04-<
>SED26MA0;F08-<
>SED27MA0;F08+<
>SED88SV0;F01-;XCT=SGC08TC00300;XCT=SGC07U<
>SEDD89SV0;F01+;XCT=SGC08U<
>SED30MA0;C08+;XCT=SGC08U<
>SXASEM1<
>SED31MA0;G00+<
>SED32MA0;G00-<
>SED33MA0;G01+<
>SED34MA0;G01-<
>SED35MA0;G02+<
>SXATA001;SXASES1;SECON<
>SXATA011;SXASES0;SECOFF<
>SED37MA0;F11F00!&+;XCT=SXAPSA11100050120<
>SED86SV0;C17+;XCT=SXAPSA11100050120<
>SED87SV0;G15+;XCT=SGC18TC0000200060<
>SED36MA0;C18+;XCT=SGC18U<
>SED38MA0;G16+;XCT=SGC18U<
>SXAGN001+13<
>SXAGN011-13<
>SED39MA0;N00+<
>SED40MA0;N01+<
>SED41MA0;V00+<
>SED42MA0;U06+;XCT=SSSU060<
"""
LABELS
ev_labels = {
0 : 'prdtst',
1 : 'trckpnt',
2 : 'ignon',
3 : 'ignoff', ...
}
Labels are alphabetic representations of the events, created to replace the codes. Codes are numeric, and in some cases the same event has different event codes between different scripts. The creation of labels allows to have the same name for different events no caring about its event number. For example:
3 : 'ignoff',
Means Ignition Off event is using code 3 under this script (Syrus is going to report EV03) and because this evlabel “ignoff” Pegasus will understand it as Ignition Off event.
A different script can have code 80 as an ignition off event, all it would need is an ev_label
80 : 'ignoff',
FOOTER
HTML DESCRIPTION
This is a Descriptive Html which is going to appear in Organization -> Devices:
Pegasus Section View
html_description = {
'en' : """
<html>
<body class="reportbody">
<table class="reporttable">
<br>
<div class="listbold"> Report definitions: </div>
<div class="reportdef">
<span>c00</span><b>Periodic test </b>- Reports every 2 hours<br>
<span>c02</span><b>Vehicle ON </b><br>
<span>c03</span><b>Vehicle OFF </b><br>
<span>c04</span><b>Speeding </b>- The vehicle has exceeded the speed limit<br>
<span>c05</span><b>Idle </b>- The vehicle has remained with the ignition ON<br>
<span>c06</span><b>Out of idle state </b><br>
<span>c08</span><b>Input 1 deactivated </b><br>
<span>c10</span><b>Input 1 activated<br>
<span>c11</span><b>Input 2 activated </b>- Input 2 has been activated.<br>
<span>c12</span><b>Input 2 deactivated </b>- Input 2 has been deactivated.<br>
<span>c13</span><b>Input 3 activated </b>- Input 3 has been activated.<br>
<span>c14</span><b>Input 3 deactivated </b>- Input 3 has been deactivated.<br>
<span>c15</span><b>Output 1 activated </b>- Output 1 has been activated.<br>
Once you are finished updating the managed configuration you can send support@digitalcomtech.com the file, and the name of the gateway that you would like to upload it to.
PROFESSIONAL SERVICES TO BUILD CUSTOM CONFIGURATIONS.
You can also contact our Support Team and we can build the configuration for you. DCT charge USD $150 for each Personalized Managed Configuration.
Appendix A
Parameter: safeimmo
This parameter can be used to activate output 1 of the device ‘safely’. It is intended for disabling the vehicle’s ignition or starter wire remotely by activating output 1 (this output would therefore have to be connected to a relay that controls the vehicle’s ignition or starter wire).
How it works?
When safeimmo is True
- If GPS is available: the speed of the device, indicated by the device’s GPS must remain under 10 mph for at least 20 seconds
- If GPS is not available: the device’s built-in motion sensor must remain in no-motion state for at least 5 minutes
One of those two conditions must be met for the Output 1 to activate, otherwise Output 1 will not be activated.
In tracking you will see the following button when safeimmo is True
The command to activate the output is
When safeimmo is False
- The output 1 will activate or deactivate immediately
And you will see the following button in tracking.
Note that if you set safeimmo to False, you must remove the command >SXASEM1< from the script cmds.
Appendix B
Special Considerations for stationary devices
If Syrus is going to remain stationary (E.g. Motorspumps) it is very important that the script has the three following things:
- Trips Algorithm, Declaration
- An event to cut the trip at the end of the day (or at any time along the day) using GT command
- In the last line of the script it is necessary to start the first trip with >SXATTI< command
