Versions Compared

Old Version 18

changes.mady.by.user Former user

Saved on

compared with

New Version 19

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleElecsys Product and Support Information

Include Page
RediGate Title Page Boilerplate
RediGate Title Page Boilerplate

Anchor
TOC
TOC
Table of Contents

Table of Contents
exclude(Table of Contents).*

 

...

Introduction

The RediGate Configuration Manual describes the configuration of many of the RediGate's standard features using the ACE program. This document gives additional instructions for configuring the RediGate to use the following protocols:

...

Include Page
Introduction-Protocol
Introduction-Protocol

 

Allen Bradley DF1 & CSP Protocol Description

This document is not intended to provide a detailed description of the protocol(s) involved, nor to disclose proprietary information that may belong to other parties. Depending on the protocol, it may be necessary to refer to other vendor protocol documentation or device configuration details to understand how the RediGate should be configured to interface with it. This section provides a brief discussion of the protocol for the purpose of understanding the RediGate's configuration objects.

...

The Description and Enabled properties are included in ACE as part of each object but are not mentioned here. The "UFF External" property is only mentioned for the objects where it is typically used, but should normally be left unchecked.

DF1/CSP Master Channel

The structure of ACE objects for a Master Channel used for DF1 or CSP protocol is shown below:

...

  • When using DF1 serial master, the Response Timeout is unused, because the AsyncCircuit object defines various timeouts for the DF1 protocol.
  • In the Scan Table, only include the first Poll Record of a "Continuation Poll," not any subsequent poll records that are part of the same poll definition.

DF1 RS-232 Async Circuit

 

The DF1 RS-232 Async Circuit is a special serial communications path to one or more Allen Bradley DF1 field units from a common Master Channel. Use this circuit instead of the generic AsyncCircuit when configuring a DF1 serial field unit under a Master Channel. You should not use the standard AsyncCircuit when polling DF1 PLCs.

...

PropertiesValues
DH Link Type

Select the Allen Bradley link type (DH or DH+).

Configure this to "DH." The RediGate does not currently support the Data Highway Plus (DH+) protocol, which requires special hardware. 

Station DHP  Address

Enter the DF1 (master) station address taken by the RediGate on the Data Highway network.

Note that the master station address is different from the device address being polled, which is configured under the FieldUnit definition. 

Link Protocol

Select the link protocol to use ('Full Duplex' or 'Half Duplex').

This should be set to match the full-duplex (peer to peer) or half-duplex setting of the PLC.  

Serial Port

Select the Async serial port to use for this circuit.

The selected port must be defined as an AsyncPort object under Networks, where its serial properties (baud rate, etc.) are defined.

Message Timeout

Enter the message timeout in milliseconds. This is the amount of time to wait for a message response.

In the DF1 protocol, there may be multiple messages to a single poll, such as acknowledgments.

Message TimeoutsEnter the number of message timeouts before declaring a message to have failed. 
Poll Timeout

Enter the poll timeout in milliseconds. This is the amount of time to wait for the initial byte of a response to a poll.

For DF1 used on an Async Circuit, the Master Channel's Response Timeout parameter is unused. 

Poll TimeoutsEnter the number of poll timeouts before aborting a poll request. 
Demark Timeout

Enter the byte timeout in milliseconds to wait for the last byte of a packet.

The Demark Timeout is used to help identify the end of a packet after the RediGate has started receiving bytes on the serial port. 

Error CheckSelect the error check type (BCC, or CRC-16).

Network Circuit


A Network Circuit is an IP network communications path to one or more field units from a common Master Channel. The Network Circuit is used when the field unit is connected to the RediGate over a TCP/IP network.

...

 See the RediGate Configuration Manual for information on configuring the NetCircuit object.

AsyncPort

 

If using a Df1Rs232circuit for serial DF1 devices, make sure to include a COM port (System>Networks>AsyncPort) object in the configuration with the instance number matching the physical COM port, and the baud rate corresponding to the field device’s setting.

See the RediGate Configuration Manual for information on configuring the AsyncPort.

DF1/CSP FieldUnit

  
A DF1 or CSP Field Unit object contains unique information for each Field Unit using the Allen Bradley PLC communication protocols, and defines parameters for how data is read and written for the device.

...

Poll Table Properties
PropertiesValues
DF1 Address

Enter the starting source register in the DF1 (or CSP) device to begin polling data. This will be found in the documentation for the device, based on the information that you want to obtain. This field should be set the same in each row of a "continuation poll." The DF1 Address should be entered in one of the following formats, based on the PLC Addressing Type (below):

  • PLC-2 Logical – Enter the number (in octal) of the logical register address in the PLC. For example, for register 17 in the PLC, enter the octal address as "21".
  • PLC-2 Physical – Enter the number (in decimal) of the physical register address in the PLC.
  • PLC-5 Logical Binary – Enter the starting register address in the PLC as a 4-level dotted notation, such as "0.7.30.0". Always set the 1st number to 0. The 2nd number indicates the "file" in the PLC, and the 3rd number is the point/register within the file. The 4th level of the dotted notation refers to the bit within an integer register and should always be set to "0", because the RediGate always reads whole integer values.
  • PLC-5 Logical ASCII – Enter the starting register address in the PLC as an ASCII string in the format "$Xf:pp", where:
    • "X" can be "N" for integer, "B" for Boolean, or "F" for floating point
      (any ASCII character can be used and is ignored in the RediGate)
    • "f" is the numeric value of the file in the PLC containing data
    • "pp" is the point number within the file
    • For instance, "$N7:30" indicates integer data in file 7, starting at point 30; this corresponds to a PLC-5 Logical Binary address of "0.7.30.0".
PLC Addressing TypeSelect the PLC addressing type of the DF1 Address entered in the previous column (above). This field should be set the same in each row of a "continuation poll."
PLC-2 Logical
PLC-2 Physical
PLC-5 Logical Binary
PLC-5 Logical ASCII 
Data Type

Select the data type of the data being read in this row of the Poll Table. If the Read Count of points contains data of different types, use multiple rows to define the number of points to read for each Data Type and the Destination Register in which to store each set of data. Select the data type from:

  • Integer-16bits, Unmasked 16-Bit Writes (0x67) – 16-bit integer data, using Allen Bradley function code 0x67. Destination RTDB should be 16-bit.
  • Float (Read-Write) / Int32 (Read-only) – Read 32-bit data (Floating point data may be written, but writing to 32-bit integers is not currently supported). Destination RTDB should be 32-bit.
  • Bit: Auto-detect Read-Modify-Write (0x26), else Typed Write (0x67) – Use this data type to parse individual bits out of an integer register. Destination RTDB should be Boolean. For output data, RediGate will attempt to automatically detect whether the device supports Read-Modify-Write command (0x26) to selectively modify only the bits that are being written. If this cannot be determined, then RediGate will use Typed Write (0x67) to write entire block of bits to the PLC.
  • Int 16-Pairs, Little-Endian Words – Read pairs of 16-bit values (up to Read Count of 50 pairs) from PLC and store into 32-bit Destination RTDB (first register is Least Significant Word).
  • Int 16-Pairs, Big-Endian Words – Read pairs of 16-bit values (up to Read Count of 50 pairs) from PLC and store into 32-bit Destination RTDB (first register is Most Significant Word).
  • Bit: Read-Modify-Write Forced (0x26) – Read individual bits from integer register. Destination RTDB should be Boolean. Binary outputs will always use Read-Modify-Write (0x26) command.
  • 0xAB CompLOGX Mask Write, Bit Read – Read individual bits from integer register from a CompactLogix PLC. Destination RTDB should be Boolean. Binary outputs will be written using function 0xAB Mask Write.
  • CMD-LOG-TO-STRING32 –

    Include Page
    CMD-LOG-TO-STRING32
    CMD-LOG-TO-STRING32

Read Count Enter the count of points to read from the device. 
If polling for a block of data from a single "file" with different Data Type and/or Destination Register range, use multiple rows in the Poll Table.
The Read Count on the first row of a continuation poll should include the total number of registers to include in the DF1 protocol request, with the Write Count defining how many points of a specific data type to save into the RTDB.
Set the Read Count to zero (0) on subsequent consecutive rows of the same poll definition, to indicate a "continuation poll." 
Write CountEnter the count of points to store into the RTDB Destination Register. 
If polling for a block of "file" data with different Data Type and/or Destination Register range, the Read Count is set to zero (0) on all rows after the initial row of the "continuation poll."
In all cases, the Write Count should include only the count of points to parse from the message using the Data Type specified on this row. The data will be stored into the RTDB, beginning at the RTDB Destination Register. Include as many rows as needed to parse data from the poll message, with Read Count=0 and Write Count set to parse the data type.
If parsing data using the "Bit" type, the count must be the number of binary bits. If parsing the data using the "Integer" type, but storing into Boolean registers, the Write Count must be the number of integer registers to be parsed—but be aware that 16 bits per integer register will be stored into the RTDB. 
RTDB Destination AddressEnter the starting destination register within the field unit's RTDB into which the Write Count of data points will be stored. These registers must be configured in the RTDB object.
The Destination Register type should be chosen based on the Data Type of the data points defined on this row of the Poll Table.
Bit data should be stored into Boolean RTDB registers.
Integers should be stored into 16-bit RTDB registers. It is also permissible to use the Integer data type but store into an RTDB Destination Address that is defined as a Boolean. In this case, each of the 16 bits of the integer will be stored sequentially into the RTDB, beginning at the least-significant bit.
Floating point data should be stored into REAL32 RTDB registers.


Example of Continuation Poll

As an example of a continuation poll, assume that the DF1 PLC has statuses, accumulators, controls, and setpoints all packed into different boards located at $N9:60 through $N9:119 registers (using PLC-5 Logical ASCII format). Below is an example poll table with this information.

...

Rows 6 and 7 may be included as entries in the Master Channel's Scan Table, but only if the RediGate needs to read the binary control bits and analog setpoint values from the PLC continuously. If it is only necessary for a host system to write to these control registers (not read the feedback)—for instance, if the control feedback is obtained from reading other DF1 registers—the Poll Table definitions are still required in order to map Modbus RTDB registers to DF1 device point numbers, but there is no need to include Scan Table entries for these polls (see Master Channel on page ).

Modbus RTDB

See the RediGate Configuration Manual for information on configuring the RTDB.

...