T5 Registry for runtime parameters

The "T5 Registry" enables you to design and monitor remotely a hierarchical registry of parameters. Parameters can be set apart from the Workbench, and can also be read or written from the IEC program. Refer to the following topics:

- Designing the registry of parameters
- Monitoring parameters
- Use parameters in IEC applications

Designing the registry of parameters

The Registry Design tool enables you to design the set of runtime parameters and how they will be edited during monitoring. The definition of parameters is stored in an XML file. The design tool works mainly on this file. Additionally, the design tool is used to send the new registry to the runtime in binary form. Optionally the XML file can also be stored in the runtime.

To run the design tool from the Workbench, use the menu command "Tools / Runtime Parameters / Design".

Parameters are freely organized with folders. The left part of the editor shows you the complete hierarchy of folders and parameters. The right hand area is used for entering the detailed description of the folder or parameter currently selected in the tree. Use the commands of the "Edit" menu to add new folders and parameters.

For each folder you must specify the following pieces of information:

Name

Name of the folder - cannot contain "/" characters

Access

Access mode (read-write or read only)

Protection

Protection mode for write (using password):
No = no protection
Yes = password protected
Inherit = use the same protection as the parent folder

Password

Password for write

Description

Free description text

For each parameter you must specify the following pieces of information:

Name

Name of the folder - cannot contain "/" characters

Type

Data type

Max. length

Maxumum length for STRING. Maximum lengthy cannot exceed 200 characters

Access

Access mode (read-write or read only)

Protection

Protection mode for write (using password):
No = no protection
Yes = password protected
Inherit = use the same protection as the parent folder

Password

Password for write

Default

Default value when registry is loaded for the first time

Description

Free description text

Editing mode Editing method when monitoring
Extra data Description of choices for a list or combo box editing mode
Minimum Minimum allowed value for numbers
Maximum Maximum allowed value for numbers

The commands of the "Project" menu are used for updating the runtime:

    - Check Registry

This command checks the whole contents of the designed registry and reports possible consistency errors.

    - Send Registry

This command sends the registry in binary format to the runtime system. You normally need to select the communication parameters of a remote runtime, but you can also save the binary registry in a local file if you want to use another transfer method. For remote sending, you can optionally send the XML definition file together with the binary registry.

Depending on the runtime system, it may happen that the new registry is not taken into account immediately, if it is currently in use by the system. Some runtimes will need a Stop/Restart of the IEC application. Some other runtimes may require a full reboot. Refer to the OEM instructions.

Monitoring parameters

The "Register Host" tool is used for monitoring runtime parameters On Line. Parameters can be displayed, and possibly modified according to their protection as defined in the Design tool. To run the host tool from the Workbench, use the menu command "Tools / Runtime Parameters / Monitor". Then use the "File / Open" command to connect to the runtime and monitor its parameters.

The left side tree shows the folders of the Registry. The right-side area shows the parameters of the selected folder. Double click on a parameter to change its value.

Use the "View / Refresh" command to refresh the value of the parameters.

The "File / Save" menu command asks the runtime system to save the contents of the registry to backup support (flash or disk).