Overview
The RTU Configuration feature provides a
...
method for reading and writing the configuration data used by an RTU or flow computer.
...
If the RTU stores its configuration
...
in items/registers and can accept configuration changes through writes to those items
...
/registers, it can be configured in ACM. This is simply a means of backup for the device configuration.
This feature is designed to work with any device which reads its configuration from
...
items/registers. As such, the layout of data in those items/registers must be defined by the user. This is accomplished by manually creating an XML file for that layout. After that file is initially created, it will be used as a template when ACM reads the configuration from the device. The initial XML configuration file may be created using any text editor. An editor with XML syntax highlighting is recommended.
Sample Configuration
...
Storage Location
These configuration files are stored in the Windows ProgramData folder. The following is the default location:
C:\ProgramData\AutoSol\Communication Manager\7\DataFiles
Any manually created files should be placed in this directory.
File Naming Convention
Three versions of a configuration file can be kept for a given device: Development, Production, and Last Read.
The files are named in the following format:
Code Block | |||
---|---|---|---|
|
...
<Tables>
<Table Number="0" Description="Allocation Table" Selected="False" LastRead="2001/01/01 00:00:00">
<Display Key="IPN" F1="AllocatedRows" ID1="" ID2="" Lnk=""/>
<Types Default="VT_I2"/>
<Data>
<row Key="0:1" F1="581" ID1="" ID2="0" Lnk=""/>
<row Key="0:2" F1="140" ID1="" ID2="0" Lnk=""/>
<row Key="0:3" F1="24" ID1="" ID2="0" Lnk=""/>
</Data>
</Table>
<Table Number="1" Description="Analog Input" Selected="True" LastRead="2014/04/15 02:04:20">
<Display Key="IPN" F1="CCMIPN{CCM}" F2="Desc 1{62}" F3="Desc 2{62}" F4="Value" F5="Units{62}" F6="" F7="Lockout" F8="Zero" F9="Span" F10="Manual Override" F11="Max Overrange" F12="RBE Deadband" F13="Exception Occurred{bool}" F14="RBE Enabled{bool}" ID1="" ID2="" Lnk=""/>
<Types Default="VT_I2" F1="VT_I2" F2="VT_I2" F3="VT_I2" F4="VT_R4" F5="VT_I2" F6="VT_R4" F7="VT_R4" F8="VT_R4" F9="VT_R4" F10="VT_R4" F11="VT_R4" F12="VT_R4" F13="VT_I1" F14="VT_I1"/>
<Data>
<row Key="1:1" F1="1" F2="16" F3="17" F4="0" F5="18" F6="0" F7="0" F8="0" F9="900000" F10="-999999" F11="945000" F12="0.5" F13="0"
F14="1" ID1="E700870NE" ID2="4" Lnk="70087.E.0.NE"/>
<row Key="1:2" F1="65" F2="16" F3="19" F4="0" F5="20" F6="0" F7="0" F8="0" F9="900000" F10="-999999" F11="945000" F12="0.5" F13="0"
F14="1" ID1="E700870NF" ID2="4" Lnk="70087.E.0.NF"/>
</Data>
</Table>
</Tables>
On this page
...
| |
<ObjectID>_RtuConfig_<Version>.xml |
ObjectID is the object ID in ACM and the suffix can be _Prod, _Dev, or _Read for Production, Development, or Last Read respectively
For example:
1234_RtuConfig_Prod.xml – The configuration file for the device with object ID 1234 when running in a production environment.
5555_RtuConfig_Dev.xml – The configuration file for the device with object ID 5555 when running in a development environment.
9876_RtuConfig_Read.xml – The configuration file for the device with object ID 9876 created by the last run of the Read RTU Configuration command.
Assigning XML Config Files To A Device
Before first use, the initial Last Read file must be created manually as described by device sample files above. This informs the driver of which items/registers to read and store. After the file is created, the file can be controlled & assigned to devices through the ACM Configuration Client by opening the device, selecting the RTU Configuration tab, and selecting the desired type from the drop down list. From there, changes can then be made from the RTU Configuration tab rather than editing the file manually.
The Development and Production files can also be created so the driver can write configuration data to the RTU. Either or both of these files can be created. The Development file is designed as a way to test the configuration data. Once satisfied that the configuration is correct, the Development file can be ‘promoted’ to a Production file. During this process the driver copies the Development file to the Production file. The Production file can be written to the RTU via the ACM command API.
Configuration Interface
The RTU Configuration Tab is used to view and edit the contents of a particular configuration file for the device object. The user can also upload and download values to/from the RTU.
Sample RTU Configuration File Loaded
Commands
The following commands are available for devices with RTU Configuration capabilities. They can be accessed from the commands listing of the device.
Command Name | Description | Parameters |
---|---|---|
Read RTU Configuration | The Read RTU Configuration command references the existing _Read XML file to obtain the necessary addresses, reads those addresses from the device, and creates a new _Read.xml file containing the data received from the device. This command can be executed on a schedule if desired. | None |
Write Last Read RTU Configuration | Takes the configuration found in the _Read.xml configuration file and writes it to the appropriate registers in the device. | None |
Write Development RTU Configuration | Takes the configuration found in the _Dev.xml configuration file and writes it to the appropriate registers in the device. | None |
Write Production RTU Configuration | Takes the configuration found in the _Prod.xml configuration file and writes it to the appropriate registers in the device. | None |