Yokogawa MX Ethernet
8 min
review the following information for setting up and configuring the yokogawa mx ethernet driver the driver reads channel data from a yokogawa mx data acquisition unit over ethernet, polling on the interval you set for each tag alongside the process value, it exposes the channel's alarm status, alarm setpoints, tag name, unit, scale limits, precision, and scan interval, so you can bring the instrument's own configuration into litmus edge (le) rather than duplicating it by hand note this driver is experimental some features may not work as expected it is also read only writing to the instrument is not supported compatibility compatibility parameter compatible items driver type ethernet validated devices/series yokogawa mx100 how to configure the plc to set up and configure this device in litmus edge, you will need to do the following step 1 set up and configure the device step 2 set up the device in litmus edge devicehub step 3 configure the list of registers step 1 set up and configure the device configure the mx unit for ethernet access and record its ip address confirm the port the unit listens on the default is 34316 note which channels are in use and what each one measures you enter a channel number as the address on every tag note the driver does not support device discovery enter the network address manually step 2 set up the device in litmus edge devicehub configure the following parameters when you connect a device with this driver update default values to the specific setup of your device parameter value type yokogawa driver yokogawa mx ethernet network address ip address of the unit default 192 168 0 1 network port port the unit listens on, from 0 to 65535 default 34316 read timeout (optional) read timeout in milliseconds, from 10 to 10000 default 3000 step 3 configure the list of registers when you add a tag docid\ tuy hh0gi8djvot70wroh to the connected device, refer to the following register table and tag parameters you can also browse and add tags from a device docid\ w7yrwng retsuxewuzwqt for this device refer to the following additional resources organize device and tag data by using metadata docid\ mu 6j6zhi0cvchdad0w8n tag formula variables docid\ io7xgyrdvv vmpnfxoaci register table select the register name in the name list, then enter the channel number in address every register takes the same address, so pv at address 3 and unit at address 3 refer to the same channel all registers are read only name value types access types description pv float32, float64 r/o process value alarm int8, int16, int32 r/o alarm summary alarm1 bool r/o alarm level 1 status alarm2 bool r/o alarm level 2 status asp1 float32, float64 r/o alarm level 1 setpoint asp2 float32, float64 r/o alarm level 2 setpoint tag string r/o tag name of the channel tagcomment string r/o tag comment of the channel unit string r/o unit of the channel scalelo float32, float64 r/o lower scale value of the channel scalehi float32, float64 r/o upper scale value of the channel precision float32, float64 r/o precision of the channel interval int8, int16, int32 r/o scan interval of the channel tag parameters parameter value name register name from the drop down list available options depend on the names in the register table value type data type available options depend on the register name selected address channel number, from 1 to 60 count number of channels to read, from 1 to 65535 default 1 a count higher than 1 generates an array of values from the channel configured and the channels that follow it polling interval value in seconds this determines how often the tag should poll the register for data enter 0 to disable polling default 1000 tag formula formula to process tag data see tag formula below only publish on change of value select the checkbox to publish nats messages only when the value parameter changes to a new value change of value only applies to boolean, numeric (such as int or float), and simple string data types it does not apply to complex types, such as json or array poll once topics are not affected by change of value settings these topics will still only see a single message meta data metadata summarizes basic information about data this feature allows you to define key value pair data for the device output payload later on it can then be used to find, use, and reuse particular instances of data note if you use special characters in meta data key names, the special characters are replaced with underscore characters in the payload this can cause two key names to be combined into one for example, configuring the key names a b and a&\&b will cause only one key name to be created (a b) tag formula enter a formula for the tag to process the generated data two variables are permitted value (current tag value) and timestamp (current tag unix time in milliseconds) the following math functions are available function description sin sine cos cosine sqrt square root tan tangent power(x) performs the operation 10^x log(x) natural logarithm (base e) exp(x) performs the operation e^x