Differences

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

--- ezeio2:userinterface:configuration:devices:driverlist:discretein [2022-06-21 23:17] – johpar
+++ ezeio2:userinterface:configuration:devices:driverlist:discretein [2023-10-13 18:03] (current) – [Status & Registers (right panel)] johpar
@@ Line 1: / Line 1: @@
 ==== Discrete Input driver ====
+==== Configuration settings (center panel) ====
 === Description ===
@@ Line 7: / Line 9: @@
  ----
-{{ :ezeio2:userinterface:configuration:devices:driverlist:input_mapping.png?400 |}}
+{{:ezeio2:userinterface:configuration:devices:driverlist:discrete_example_1.png?400|}}
 === Settings ===
@@ Line 17: / Line 19: @@
 **Active** Check box - Check this box and "Save changes" to run the driver. The driver program can be suspended by unchecking the box and clicking on "Save changes".
-**Device** - Select the ezeio controller or the address number of a connected ezeio I/O Expander.
+{{:ezeio2:userinterface:configuration:devices:driverlist:input_mapping.png?400|}}
-{{:ezeio2:userinterface:configuration:devices:driverlist:input_mapping.png?400 |}}
+**Device** - Select the ezeio controller or the device number of a connected ezeio I/O Expander.
 **Input number** - Select the input number (1-8) of the selected device.
-**Input hardware type** - Select the type of sensor or signal type (0-10V, 0-30mA (4-20mA), Ohms, thermistor). Some of the thermistor choices are tailored to specific sensors and others are generic (see the table below for details). Options from pulse are shown, but we recommend using the "Pulse input" driver. The Self test is diagnostic setting to test the circuitry of the input when nothing is connected. The selection will determine the raw to unit conversion for registers 1 & 2 (shown on the "Available registers" table on the right hand panel). These are the pre-scaled values.
+{{:ezeio2:userinterface:configuration:devices:driverlist:hardware_type.png?400|}}
-**REGISTER 1 & 2 SETTINGS** - Each discrete input is duplicated, providing the opportunity to process the data it two different ways, such as max & average. The ezeio controller's microprocessor reads the onboard inputs (and those of any docked ezeio I/O Expanders) at a rate of 1000 times per second. These readings are processed and output as samples a the rate of 10 times per second. The table below describes the effects of each mode.
+**Input hardware type** - Select the type of sensor or signal type (0-10V, 0-30mA (4-20mA), Ohms, thermistor). Some of the thermistor choices are tailored to specific sensors and others are generic (see the table below for details). Options from pulse are shown, but we recommend using the "Pulse input" driver. //The Self test is diagnostic setting to test the circuitry of the input when nothing is connected//.
-**Register 1 & 2 modes** - Choose one of the setting below for registers 1 & 2.
+**REGISTER 1 & 2 modes** - Each discrete input is duplicated, providing the opportunity apply two modes of initial processing and two methods of scaling. The ezeio controller's microprocessor reads the onboard inputs at a rate of 1000 times per second and exports the results every 1/10 of a second (//connected I/O Expander inputs are sampled slower as they are transmitted via CANbus//). Additional processing is applied to logged registers (see [[ezeio2:userinterface:configuration:fields|"Fields"]])
+**Register 1 & 2 modes** - These modes control how the analog to digital converter calculates the live values. //Separate settings on the individual "Field" settings control how each channel is logged//.  Choose one of the setting below for registers 1 & 2.
 | **Mode** | **Description** | **Effect** |
@@ Line 40: / Line 46: @@
-**SCALING OF REGISTER 1** - Register 1 can be scaled to a unit value such as PSI or LPM. The relationship between the Min/Max raw & scaled settings creates a 2 point linear conversion. The result of this conversion is shown in register 3. In addition, a Low/High error range (in the scaled unit) can be entered, representing a normal or safe operating range for the application.
+**SCALING OF REGISTER 1** - Register 1 can be scaled to a unit value such as PSI or LPM with a 2 point linear conversion method. A rough conversion can be obtained by entering corresponding values from a table supplied by the sensor manufacture. For a calibrated conversion, use a trusted gauge or probe to provide readings at two points within the sensors range. Enter the value for one point and use the driver's copy function to capture the corresponding live raw reading. The result of this conversion is shown in register 3. In addition, a Low/High error range (in the scaled unit) can be entered, representing a normal or safe operating range for the application.
-**Min raw - Max raw** - By default, the range shown here is set based on the "Input hardware type" selected, such as 0-10V (0.0 - 10.0) or 0-30mA (4.0 - 20.0). This would correlate to the full scale of a typical sensor. These  fields can be changed if required to match the output of your sensor or the scale range you wish to use in the next step.
+{{:ezeio2:userinterface:configuration:devices:driverlist:copy_button.png?600|}}
-**Min scale - Max scale** - Enter values here that correlate to the Min/Max raw values. For example: 4.0mA = 0 psi and 20.0mA = 250 psi
+**Raw value point A & B** - By default, the range shown here is set based on the "Input hardware type" selected, such as 0-10V (0.0 - 10.0) or 0-30mA (4.0 - 20.0). This would correlate to the full scale of a typical sensor. These  fields can be changed if required to match the output of your sensor or the scale range you wish to use in the next step.
+**Scaled value at point A & B** - Enter values here that correlate to the Min/Max raw values. For example: 4.0mA = 0 psi and 20.0mA = 250 psi
 **Low error - High error** - Enter values here that represent the normal range for the application. This could also represent the operating range of the sensor, so a negative value could indicate an open circuit. When the value is out of this range, the "Driver status" will indicate an "App error". This error can be see on the Driver status, incorporated in expressions by use of ds(DVCSTAT_APPSTAT) and included in messages with the "Message Template Tag" [DVCSTAT#APPSTAT].
@@ Line 62: / Line 70: @@
 **Logic** - Set the true (or ON) state to be above or below the threshold value, with a value of 1 or 100. Choosing 100, make it easy to use the value to drive a digital output via "Fields".
- ==== Thermistor options ====
+ ==== Thermistor options (use Thermistor driver for more options and features) ====
 <WRAP center round tip 60%>
@@ Line 77: / Line 85: @@
 | TX1001 Pro | ThermoWorks | TX-1001X-OP |  |
 | ET7273 |  | ET7273 |  |
+----
+==== 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 ===
+| 1 | Raw electrical value | Unit type is set by "Input hardware type", V, mA, Ohm |
+| 2 | Raw electrical value | Unit type is set by "Input hardware type", V, mA, Ohm |
+| 3 | Scaled value, Register 1 | Scaled by 2 point calibration |
+| 4 | Scaled value, Register 2 | Scaled by offset and factor |
+| 5 | Logical state | Analog value converted to digital (on/off) based on threshold setting |
+| 6 | Logical cycles | Number of times "Logical state" changes from off to on |
+| 7 | Logical active time | Number of seconds logical state is "on" (runtime) |