Mandatory Set Up Within Setting Template
There are three fields, which are most necessary to be able to receive data on the platform:
- Name;
- Connectivity > Telemetry server > MQTT broker address;
- Connectivity > GSM/GPRS > APN list;
- Data recording > Simple.
a) Name.
Set an understandable name and add notes.
b) Set address where to send data.
All data will be sent to broker, so set address and port where data should be sent:
Device settings\Connectivity\Telemetry server #1\MQTT broker address\MQTT broker address settings:
For https://online.omnicomm.ltd/ (For other domain please contact Omnnicomm technical support):
- Domain name/IP : 185.9.185.254 or convert.omnicomm.ru
- Port : 15390
- Protocol : TCP
c) Set APN of SIM inserted to device.
Device settings\Connectivity\GSM/GPRS\ APN list\ APN:
To configure you would need to know MCC, MNC and APN of SIM.
Note. MCC, MNC are five first digits of IMSI code (123 - MCC, 45 - MNC).
If you use few different operators, can insert all of them, but mandatory is the one of SIM, inserted to device.
Set:
- Mobile country code
- Mobile network code
- APN name
- User
- Password
d) Set which data should be sent to send to the platform.
“Data recording” is responsible for structure of data, that being sent to MQTT broker.
It supports two methods of data structure - Simple and Extended.
In “Simple” - you can create packets, in “Extended” you can create separate sensors and set conditions and triggers to them. Meanwhile in “Simple” triggers can be set only to all packet, not separate sensors.
“Simple” - is recommended way to send data.
”Extended” - can be used in specific projects, when you need to track values of particular sensor, for example: temperatures, RPM, over-voltages or similar.
Note. Simple and Extended options can not be used simultaneously. If you set both - device would not send any data.
Device settings\ Data recording\Simple\ APN list\ APN:
In ‘Data recording’ click on “Simple” and then “+ Add” button to create a packet, which will be sent to server.
Also, you can use button of “Import preset” and choose preset based on type of device, for example:
Simple data sending method.
You can create 4 different packets based on different conditions. To create a new packet, click on “+ Add” button. Also can check presets, created by XG team by clicking on “Import preset” button.
Signal conditions describes when this type of packet should be sent:
Speed, course, distance and time thresholds defines track quality settings.
Note. “GNSS register period” is responsible to how often device will send this kind of packet to server.
In “data register trigger” you can add additional triggers to send a message to server without waiting for “GNSS register period” to pass:
Into sensor list, you should add all sensors, which packet should include:
Recommended sensors:
- SENSOR_GNSS_COORDINATES (53248)
- SENSOR_ISOBUS_IMPLEMENT_1 (61432)
- SENSOR_GNSS_SPEED (8192)
- SENSOR_GNSS_COURSE (12299)
- SENSOR_AXES_X (28672)
- SENSOR_AXES_Y (28673)
- SENSOR_AXES_Z (28674)
- SENSOR_ALTITUDE (28675)
- SENSOR_GNSS_SATELLITES (8193)
- SENSOR_GNSS_LONGITUDE (45056)
- SENSOR_GNSS_LATITUDE (45057)
- SENSOR_IMEI (49159)
- SENSOR_FIRMWARE_VERSION (49170)
- SENSOR_VCC (12288)
- SENSOR_IGNITION (109)
- SENSOR_IN_2 (16)
- SENSOR_IN_3 (17)
- SENSOR_IN_4 (18)
- SENSOR_IN_5 (19)
- SENSOR_U32_USER_DEFINED_0 (16389)
- SENSOR_U32_USER_DEFINED_1 (16390)
- SENSOR_U32_USER_DEFINED_2 (16391)
- SENSOR_U32_USER_DEFINED_3 (16392)
- SENSOR_U32_USER_DEFINED_4 (16393)
- SENSOR_U32_USER_DEFINED_5 (16394)
You can adjust the list of sensors for your case.
Note. Parameters must be supported from Omnicomm Online side, do not put uncollected data in the list.
You can duplicate a list of parameters for various conditions and exclude/include parameters (parking, movement, etc.)
Script settings
Scripts will allow user to implement various scenarios and control device peripherals.
Script is a program (programming code), written in C like language.
We recommend using script templates to avoid errors in functionality.
Device settings\ Script\Script
Click Add script and choose the necessary template (example Script LLS-FUEL-Sensor-1-7).
Go to the script settings: Device settings\ Script\ Your script (Script1@BCE_MEAS_LLS-FUEL-Sensor-SCR-1)\Main settings\ Settings.
Choose a Port for the sensors' connection (RS-232 or RS-485).
Go to Device settings\ Script\ Your script (Script1@BCE_MEAS_LLS-FUEL-Sensor-SCR-1)\Main settings\Parameters settings\.
Add the necessary quantity of parameters(for each sensor) and edit it:
Change parameter name, address and choose data and position in the message(same in data collection section)
For fuel sensors level supported parameters are: Sensor_U16UserDefined2-15.
Save the configuration and go to the devices section. Click on your device and choose configuration from the list.
You have to wait until it is uploaded to the device through the remote server.
The second option to download the configuration with USB.
Step 1: Click Configurations icon in the main menu bar. The devices page appears.
List of all configurations created will appear in your screen.
Step 2: In the Actions menu click on the download icon to get the binary configuration file.
II. Firmware Download.
Step 3: Click Firmwares icon in the main menu bar. All available and assigned firmwares will appear.
Step 4: Click on download icon to get the firmware .aes file.
III. Uploading files to device.
Step 5: Connect device to a PC.
Note. Device must be disconnected from any power source (internal battery as well). Using USB – mini USB cable connect device to a computer.
Step 6: New flash drive will appear. In some cases you might need to format the flash, before uploading the file.
Step 7: Copy/paste the configuration file or the firmware file to the flash drive.
Note: Insert only one file at once. If you need to update both -FW & settings, do it separately. After uploading one file, connect device to the power, then disconnect and upload another file.
Step 8: Disconnect the USB cable and power up the device. It should take a couple of seconds for the device to boot up and flash the new settings or FW.
To add a device to the platform, you can follow https://doc.omnicomm.ltd/en/omnicomm_online-administration/vehicle/add
Fuel sensors settings parameter settings tab:
To receive fuel data, you need to configure user settings in the profile settings section.
https://doc.omnicomm.ltd/en/omnicomm_online-administration/vehicle/add/setparametrs/table
Open Parameter settings tab:
We recommend the following values for obtaining fuel user parameters:
- User parameter number: 0, 2, 4, 6 -fuel level; 1, 3, 5, 7 -temperature;
- Type of value before conversion: unsigned integer (4 byte)
- Byte and word order: Direct byte and word order
- Type of value after conversion: integer
- Minimum value: 0
- Maximum value: 4046
- Coefficient: 1
- Offset: 0
- For CHECK FUEL LEVEL SENSOR choose the source of data for each LLS:
For Fuel level sensor 1:
- Calculation method: User parameter 1, 3, 5, 7 etc
- Determining method for the fuel level sensor condition: Calculate
- Level is 0: Mode = Ready
- Level above 4095: Mode = Error
- Fuel temperature Calculation method: Always 20°C
