ezeio2:userinterface:configuration:devices:driverlist:ezesysinfo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revisionBoth sides next revision
ezeio2:userinterface:configuration:devices:driverlist:ezesysinfo [2021-12-15 16:10] – [Registers] johparezeio2:userinterface:configuration:devices:driverlist:ezesysinfo [2024-04-03 21:42] andreh
Line 4: Line 4:
  
 ==== Description ==== ==== 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 19 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.+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 ====+==== 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 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).  
Line 16: Line 16:
 {{ezeio2:userinterface:configuration:devices:ezesysinfo:configuring.png?direct&400|}} {{ezeio2:userinterface:configuration:devices:ezesysinfo:configuring.png?direct&400|}}
  
-==== Registers ====+---- 
 + 
 +==== 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. 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.
  
-{{ezeio2:userinterface:configuration:devices:ezesysinfo:registers.png?direct&400|}}+{{:ezeio2:userinterface:configuration:devices:ezesysinfo:2404-registers.png?400|}}
  
 **1. Uptime** - Number of seconds the ezeio has been running. Power cycling or rebooting the ezeio will reset "Uptime" to zero. **1. Uptime** - Number of seconds the ezeio has been running. Power cycling or rebooting the ezeio will reset "Uptime" to zero.
Line 54: Line 73:
 **16 System Local Time** - Current hour, minute, second, 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.
  
 +<WRAP center round box 80%>
 === GPS Location Lock registers === === 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  +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'' 
 +</WRAP>
  
 **17 Ref Latitude** - Latitude captured by "Ref Location lock" (register 20). This value will float, matching register 12, if "Ref Location Lock" is off. **17 Ref Latitude** - Latitude captured by "Ref Location lock" (register 20). This value will float, matching register 12, if "Ref Location Lock" is off.
Line 64: Line 86:
  
 **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. **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.
 +
 +<WRAP center round box 80%>
 +=== 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.
 +</WRAP>
 +
 +**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)**+=== GPS signal (DOP value) ===
 | DOP Value | Rating[5] | Description | | 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 | Ideal | Highest possible confidence level to be used for applications demanding the highest possible precision at all times. |
Line 74: Line 103:
 | 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. | | 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. |  | 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. |+| >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. |
 |  |  | |  |  |