logto send data to the cloud, or a
discoverto only display information. There must be a config file when running
discover. The config file defines which variables need to be collected, what names they appear on the the Ardexa cloud, units and scaling, what table(s) they variables will be sent to, and the source name(s). Example config file as follows. Always verify data accuracy by running a
discoverfirst, before committing the plugin to collect data.
#is a comment line, and will be ignored
Memory Locationis the Ormon memory location/address.
Scalewill only be used for
integertypes. An error will be reported if you try and divide an integer, or multiply by anything other than a whole number. The scale can also be a value such as
0.75-9, where the
-9is a BIAS value (addition or subtraction). In which case it will FIRST subtract the 9, THEN multiply by 0.75. If using a bias value, then it can ONLY be used with a
Invalidate. This column will only do the following task": If an entry starts with
>, it will invalidate ALL entries in a configuration file, if the value for this entry is greater than the specified amount. For example; if the
Invalidatecolumn entry is
>10000, then a value of 12,000 will ensure ALL readings in the configuration file are invalidated. Use this item with caution. Also, it will ONLY work on
decvalues. This invalidation feature is intended for those machines that have poor quality control, and sometimes transmit wildly wrong values.
Lookup Table; Sometimes you want to convert an INT to a keyword, through a lookup table. Or you may want to get a register bit and convert it to a keyword. See examples below.
Typecolumn values are as follows:
dec... Converts the Omron memory location to a decimal. Can be scaled (including division).
int... Converts the Omron memory location to an integer. Can only be scaled upwards (not divided). So a
scalevalue that is not a whole number will be rejected.
bool... Omron memory location is converted to an INT. This value is then check as follows: Anything other than
0will output a
True. Else, output will be
int_bool... Omron memory location is converted to an INT. This value is then check as follows: Anything other than
0will output a
1. Else, output will be
bin... Converts the Omron memory location to an integer, then to a binary representation.
bit... Used with a lookup table (in the
Lookup Tablecolumn) to define a bit being turned or off. See example contents of file below.
bitb... If a bit in the Omron memory location is turned on/off, it will reflect a boolean ("True"/"False") output.
bitb_int... If a bit in the Omron memory location is turned on/off, it will reflect a boolean ("1"/"0") output.
str... Treated as an ASCII character. If it can't be converted, it will output an empty field
str_rep... Same as
str, but it will clear
\0values in the resultant string.
ip_addressThis is the IP Address of the Omron PLC. Make sure that Port 9600 is open.
config_path. This is the config file location
--attemptsIs the number of attempts to make to get data from the PLC. The default=2
1. Include a
0value to display something (or blank) if no bits are turned on