Class: de.wireware.plc.DatapointMapperModule

From FactorityWiki

Jump to: navigation, search

Contents

Summary

Classification: Module for FACTORITY Connectivity Server

This module is able to map datapoints from remote machines to the local machine. It provides a simple way to connect machine objects.

Specification

Parameters

Name Purpose
remote-name the WireWare name of the remote machine object
remote-driver the name of the driver, when connecting to a remote machine by a specific driver
remote-parameters the connection parameters, when connecting to a remote machine by a specific driver
remote-address the address of the remote machine, when connecting to a remote machine by a specific driver
remote-lineid the WireWare line identification of the remote machine object (when not specifying a WireWare name)
remote-machinenr the WireWare machine number of the remote machine object (when not specifying a WireWare name)

Data section

Formal specification

 
<!ELEMENT data (datapoint)*>
<!ATTLIST datapoint
   name CDATA #REQUIRED
   type CDATA #REQUIRED
   writable (true,yes,false,no) "false"
   remote CDATA #REQUIRED
   remote-bit #IMPLIED
   read-back (true,yes,false,no) "false"
>

datapoint: Defining a datapoint

This defines a datapoint with a specific name and type, which is mapped to a datapoint of a remote machine object. The datapoint is created in the namespace of the module. The following types are allowed:

integer or int a 32bit integer value
boolean or bool a boolean value
bin:nn a binary value, with a length of nn bytes, where nn may be between 1 and 1024

If writeable is set to true, the datapoint can be modified by client applications.

The parameter remote specifies the name of the datapoint of the remote machine. If remote-bit is specified a single bit of a remote integer datapoint is mapped to a local boolean datapoint. If read-back is set to true, any writes to the remote datapoint are read back by the module. Otherwise the module stores the last written value.

Datapoints

The following datapoints are created by the module.

Name Type Writeable Purpose
Online boolean no Signals if the peer device is online

Beside of this the datapoints which are specified in the data section are created.

Example

<module>
  <class>de.wireware.plc.DatapointMapperModule</class>
  <name>namespace</name>
  <data>
    <remote-lineid>5021</remote-lineid>
    <remote-machinenr>1</remote-machinenr>
        
    <datapoint name="busy" type="boolean" remote="remoteBusy" read-back="true"/>
    <datapoint name="basePos" type="boolean" remote="remoteBasePos" read-back="true"/>
        
  </data>
</module>