Table of Contents

ezeio System Info driver

Description

The ezeio MkII System Info driver provides system performance data as well as configuration settings for two of the ezeio's serial buses. In addition to the data and settings, registers 17 and 20 provide a means of locking in a location and measuring the units distance from that point, if it moves (requires a GPS receiver). This driver is loaded by default on units with serial numbers BBA and higher.

Configuration settings (center panel)

Modbus data rate (BAUD rate) - The speed of the bus can be set or changed to align with the devices connected to the Modbus RTU port. The drop-down menu list all seven speeds defined by the Modbus.org specifications (1200 to 115200 bps).

Modbus Parity - Parity can be set or changed by selecting one of three option in the drop-down menu.

CAN Port mode - The can port can be utilized for eze System MkII I/O Expanders (eze-CAN) or J1939 communication. Use the drop-down menu to make your selection.

Status & Registers (right panel)

Device Status

Driver info - Typically this is the name from the program file

Driver updated/version - Date loaded or updated and the version of the driver

Battery & Signal - Signal indicates the progress through the script. If driver fails to operate, signal number indicates progress

Driver status - Color and text of status bubbles give a quick visual reference of Communication, Operation, and Application

Communication - Com count indicates number of successful and unsuccessful data packets received

Available registers

Twenty registers offer a mix of performance date, statuses, GPS data, and a feature that locks in a GPS reference location. A description of each register is given below.

1. Uptime - Number of seconds the ezeio has been running. Power cycling or rebooting the ezeio will reset “Uptime” to zero.

2. Input voltage - Voltage reading at the barrel jack (“DC in” top right).

3. Battery voltage - Voltage reading at green screw terminals (“Batt” lower right).

4. Logic voltage - Voltage supplied for board components, inputs and “+5” supply on green screw terminal.

5. Ethernet Link Status - “1” indicates a connection to an Ethernet LAN.

6. Ethernet Connection Status - “1” indicates the ezeio is utilizing an Ethernet LAN to connect to the eze.io servers.

7. Cellular Connection Status - “1” indicated the ezeio is utilizing a Cellular network to connect to the eze.io servers.

8. Cellular Signal - Value shown is the (RSSI) received signal strength indicator.

9. Cellular inhibit - It is possible to temporarily turn off the cellular modem. This is achieved through script commands. If inhibited, the number of seconds remaining are shown in this register. If not connected via Ethernet, this information will not be transmitted as a live value. If you wish to track this data the register must be added to a “Field”.

10. GPS lock - “1” indicates the receiver has a lock on multiple satellites

11. GPS signal - The receivers signal strength is reported as DOP (Dilution Of Precision). Typically the value should be between 1 and 20. A lower number indicates higher precision (see the table at the bottom of the page for a complete breakdown). If the receiver does not have a GPS lock the value is reported as 255.

12. GPS Latitude - Last known Latitude

13. GPS Longitude - Last known Longitude

14 GPS Elevation - Last known Elevation

15 System Local Date - Current year, month, day, based on the time zone set under the “System” tab.

16 System Local Time - Current hour, minute, second, based on the time zone set under the “System” tab.

GPS Location Lock registers

Registers 17 through 20 are part of the GPS Location Lock feature. This feature works as a simple version of geo fencing for application such as rental equipment. When the lock is switched on, current GPS coordinates are saved as references (registers 17 & 18. If the ezeio (and GPS receiver) move from the reference coordinates the distance is calculated and shown in register 19, as meters. This value can be used in an alarm condition expression. Example: r(1,19) > 300

17 Ref Latitude - Latitude captured by “Ref Location lock” (register 20). This value will float, matching register 12, if “Ref Location Lock” is off.

18 Ref Longitude - Longitude captured by “Ref Location lock” (register 20). This value will float, matching register 13, if “Ref Location Lock” is off.

19 Ref-GPS distance - Distance (in meters) between current GPS coordinates and reference location.

20 Ref Location lock - An On/Off switch is provided when this register is added to “Fields”. Switching it on captures the current GPS coordinates and holds them in registers 17, 18. The difference between the current GPS coordinates (registers 12 & 13) and the locked reference Location (registers 17 & 18) is calculated in meters and shown in register 19.

Group area matching

Register 21 is convenient to use for irregular shaped geographical boundaries. The value is set to the number of the group with the smallest area overlapping the controller location. An example of how to use this in an alarm expression is r(1,21) < 1. This will trigger the alarm when no area matches the controller location.

21 Group by location - The location of the controller (as determined by GPS, by cell tower or manually set) is compared every 10 minutes with the group areas in all subgroups to the group where the controller is. This register will be set to the group number of the smallest area that overlaps the controller location. If no area overlaps with the controller location, the value will be 0 (zero). [New since April-24]

—-

GPS signal (DOP value)

DOP Value Rating[5] Description
<1 Ideal Highest possible confidence level to be used for applications demanding the highest possible precision at all times.
1-2 Excellent At this confidence level, positional measurements are considered accurate enough to meet all but the most sensitive applications.
2-5 Good Represents a level that marks the minimum appropriate for making accurate decisions. Positional measurements could be used to make reliable in-route navigation suggestions to the user.
5-10 Moderate Positional measurements could be used for calculations, but the fix quality could still be improved. A more open view of the sky is recommended.
10-20 Fair Represents a low confidence level. Positional measurements should be discarded or used only to indicate a very rough estimate of the current location.
>20 Poor At this level, measurements are inaccurate by as much as 300 meters with a 6-meter accurate device (50 DOP × 6 meters) and should be discarded.