ezeio2:configuration:devices

The “Device” page is where most links to hardware and data sources are created. This is done through the addition of drivers. Drivers are application programs that (in most cases) establish a communication link to hardware and provide an eze.io interface. This is similar to drivers, programs and apps that you would load on your phone, tablet or personal computer. For some such as “GPS receiver GN-803G” or the Expansion CAN port activation“ adding and saving changes is all that is required. Other driver's settings will range in complexity based on the requirements of the device or the level of customization provided by the driver.

To add a device, please follow these steps:

  1. (From the Configure screen) select the “Devices” tab
  2. At the bottom of the left panel click the Add Device button (This will bring up a list of available device drivers)
  3. Select the appropriate driver and click Add Driver

Most drivers have some settings that needs to be properly set before the driver can be functional. For example, all Modbus RTU devices require a device address to be set.

Make your selections for the new driver and click Save Changes.

Finally, enable your new driver by checking the Active box, and then save your changes again.

The driver will now start working, and you should see values populate in the “Available register” list.

Select the register values that you want to show as fields by checking the corresponding checkboxes, and click Add selected to Fields. This will create new Fields, complete with “Data expression” and some default settings.

This driver (located in the Core drivers folder) is designed for use with the ezeio MkII controller and the ezeio MkII I/O Expander. It is ideal for resistance (Ohms), Thermistors and sensors with DC current (0-30 mA) or voltage (0-10 VDC) signals. A specialized driver is offered for pulse signals. The settings on this driver map the source, configured circuitry on the ezeio, and produce signal readings, scaled values, a logic value and statuses. An instance of this driver can be added for each available input terminal on the controller or expanders. This method of individually configuring inputs allows the driver's name to reflect the sensor/device and provides space in the settings for more features. Below are descriptions of the various settings.

Name - The name is up to the user. Our suggestion is to choose a naming convention that makes the viewing the device list intuitive. Such as referring to the sensor and/or application.

Notes - This space can be used to store information specific to the device, such as: location, wiring, scaling, etc.

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.

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.

REGISTER 1 & 2 SETTINGS - Each discrete input is duplicated, providing the opportunity to process the data it two different ways, such as max & average or or pulse rate & pulse count. The ezeio's controllers 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.

Register 1 & 2 modes - Choose one of the setting below for registers 1 & 2.

Mode Description Effect
Snapshot Sample value is single reading
Minimum Lowest of the 100 readings over sample interval
Maximum Highest of the 100 readings over sample interval
Average Average of the 100 readings over sample interval
Pulse rate Rate is shown as frequency (Hz x 1000)
Pulse count Counting total number of pulse
Pulse interval milliseconds elapsed since last pulse
Differential pulse count

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.

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.

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

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].

SCALING OF REGISTER 2 - This register's scaling utilizes a multiplying factor and an offset. Using the previous example of a 4-20mA output pressure transducer with a range of 0-250 psi, the offset would be 4 and the factor would be 15.625. The result of this scaling of register 2 is shown as register 4

Offset - Set a starting point or floor for the scaling such as 4 in the case of 4-20mA signals.

Factor - Multiply the raw value to create a linear conversion that matches your sensors scale. To find the factor, divide the sensor full scale range by the number of raw unit steps.

LOGIC STATE - This feature converts any ranging analog value into a digital value (or boolean) by defining a threshold beyond which it is consider true (represented by the # 1).

Threshold (Scaled) -

Filter time - Filter out transient value changes by entering a number of seconds (and tenths) in this field. The value must then exceed the threshold for the proscribed time before it is considered true.

Thermistor Name Source or Generic Part # Application Range
10k type II Generic
10k type III Generic
10k type B=3380 eze System BA0010
2k2 eze System BA0022
100k Generic
TX1001 Pro ThermoWorks TX-1001X-OP
ET7273 ET7273
  • ezeio2/configuration/devices.txt
  • Last modified: 2021-03-19 00:15
  • by johpar