;-------------------------------------------------------------------
; AnxPbsDrvCfg.txt is the top-level configuration file and must always
; exist in the zip file.
; Options, Profibus Baud & Slave and mappings.
; Template links to:
; - EthDev Ethernet/IP device parameters (may be included in EthDef)
; - EthDef Ethernet/IP mapping tags, may include device parameters
; - PbsDef Profibus Slave mappings to Ethernet/IP tags
; *** Note: Although Template files have a csv extension, they MUST be
;           edited with a text editor and commas are not required!
; Existing Profibus IO sizes and DeviceIDs can be captured using the
; "Profibus DP Auto Config" function in the AN-X3-PBS-HMI firmware.
;-------------------------------------------------------------------

; Anything after a semicolon is considered a comment and is ignored

; Template files are simple "Include" files.
; Configuration commands can all be in the top level AnxPbsDrvCfg.txt
; file, but repetitive and device specific commands and mappings may
; be moved to Template files and included several times in the top level

; Configuration Commands are not case sensitive.
; The following Configuration Commands are supported:

; --- Specify the Baud Rate of the connected Profibus Network.
BaudRate <baud>
    <baud> is 12m, 6m, 3m, 1m5, 500k, 187k5, 93k75, 19k2 or 9k6
    Example:
    BaudRate 12m

; --- Fault Profibus Slave Node if Ethernet/IP Target is not active
FaultPbSlave

; --- Include Template File (optional)
Template <TplFile>
    <TplFile>       Template file to be included in-line - '.csv' is added
    Example:
    Template EthDef_PowerFlex_40   ; include file that defines drive Ethernet tags

; --- Begin Profibus Slave Configuration
PbSlave <ProfiNode> <InpByteLen> <OutByteLen> <SlaveDeviceID>
    <ProfiNode>     0-125
    <InpByteLen>    0-244 bytes
    <OutByteLen>    0-244 bytes
    <SlaveDeviceID> Usually hex (0x). Must match Slave Device ID configured in
                    Profibus Master. Set to Device ID of replaced Profibus drive.
                    For testing, QTS Device ID may be used (0x08a5).
    Example:
    PbSlave 11    8    8 0x08a5

; --- PKW Header integer Length - Siemens parameter mechanism
PKWLen  <IntLen>
    <IntLen>        0-120 integers, usually 0 or 4
                    Pbs Mappings (PZD Data) are offset by this number

; --- Scheduled Connection Name
Name "<Name>"
    <name>          User defined name shown on 'Monitor Ethernet/IP' web page
    Example:
    Name "ACS880_198"

; --- Ethernet/IP Target Device IP Address
IpAddr <IPAdress>
    Example:
    IpAddr 10.10.0.198

; --- Requested Packet Interval for Ethernet/IP Scheduled Connection
RPI <Time>
    <Time>          1 to 750ms
    Example:
    RPI 10

; --- Minimum Requested Packet Interval supported by Ethernet/IP Target Device
MinRPI <Time>
    <Time>          1 to 750ms Usually defined in EthDev file to limit RPI value in
                               top level configuration file. Device manufacturer my
                               specify this. Default is 1.
    Example:
    MinRPI 1

; --- Ethernet/IP Target Device Product Key Definition
Key <VendID> <ProdType> <ProdCode> <MajorRev> <MinorRev>
    <VendID>        Vendor ID - 0x0001 for Rockwell
    <ProdType>      Product Type
    <ProdCode>      Product Code
    <MajorRev>      Major Rev - prefix with 'c' for compatible mode
    <MinorRev>      Minor Rev
    ; Product Key information may be provided by the Device manufacturer.
    ; It can also be obtained from RSLinx or a *.eds file.
    ; If not defined, no Product Key is sent and Target Device may or
    ; may not accept the connection.
    Example:
    Key 0x0001 0x007B 0x490 c3 2

; --- Ethernet/IP Assembly Instance
AssemIns <Instance>
    <Instance>      1 to 65535 - Usually 4 or 6, defined by Device manufacturer
    Example:
    AssemIns 6

; --- Ethernet/IP Output or Originator to Target Connection Point
OutConnPt  <ConnPnt>
O_T_ConnPt <ConnPnt>
    <ConnPnt>       1 to 65535 - defined by Device manufacturer
    Example:
    OutConnPt 2

; --- Ethernet/IP Input or Target to Originator Connection Point
InpConnPt  <ConnPnt>
T_O_ConnPt <ConnPnt>
    <ConnPnt>       1 to 65535 - defined by Device manufacturer
    Example:
    InpConnPt 1

; --- CIP Path to Ethernet/IP Device
CipPath <CipPath>
    <CipPath>       Path to Ethernet/IP Target - Usually not needed since device is
                    on the local Ethernet network.
    Example:
    CipPath  0x01  0    ; Port 1 (Backplane), Slot 0

; Configuration Integer value(s) sent with Forward Open
CfgInt  <CfgVal>
CfgDint <CfgVal> ...
    <CfgVal>        Int/Dint Val, 0x for hex
    Examples:
    CfgInt  0x0023 0x0054 0x0000 1 2 -3 -4 0x1234
    CfgDint 0x0x12345678 -1000 1000 0x00000000

; --- Begin Inputs Configuration - Optional Ethernet/IP Input/T_O Length
Inputs [EIP_InpLen]
    [EIP_InpLen]    2 to 502 - Ethernet/IP Input Length in bytes
    ; Inputs/EndInputs can occur many times per device
    ; [EIP_InpLen] Specified once per device
    ; Len includes 2 byte CIP Sequence Number
    Example:
    Inputs 10   ; ByteLen: 'Seq'2 + 'StsHdr'4 + 'Payload'4 (2 int)

; --- End Inputs Configuration
EndInputs

; --- Begin Outputs Configuration - Optional Ethernet/IP Output/O_T Length
Outputs [EIP_OutLen]
    [EIP_OutLen]    6 to 502 - Ethernet/IP Output Length in bytes
    ; Outputs/EndOutputs can occur many times per device
    ; [EIP_OutLen] Specified once per device
    ; Len includes 2 byte CIP Sequence Number + 4 byte Run/Idle Header
    Example:
    Outputs 10  ; ByteLen: 'Seq'2 + 'Run/IdlHdr'4 + 'Payload'4 (2 int)

; --- End Outputs Configuration
EndOutputs

; --- End Profibus Slave and Ethernet/IP Device configuration
EndPbSlave

; Mappings
----------

; --- Define Ethernet/IP I/O Tag - Optional
EthTag <TagName> <EthAddr>
    <TagName>   Unique for Device, separate for Inputs and Outputs
                Up to 63 chars long
                Alpha Numeric plus '_'
                Not case sensitive
                Max 256 tags for Inputs and 256 tags for Outputs per Device
    <EthAddr>   Int[Ofs]    Map 16-bit integer
                Dint[Ofs]   Map 32-bit integer
                Real[Ofs]   Map 32-bit real value (IEEE 754)
        [Ofs]   Int (16-bit) offset within Ethernet Frame, after 2 byte Sequence and 4 byte Header
                Int must be 16-bit aligned
                Dint/Real must be 32-bit aligned (even words)
                Modifiers:
                Header Start before Status Header (Inputs) or Run/Idle header (Outputs)
                Byte   Offset is in bytes
                Int    Offset is in Ints  (16-bit) Default
                Dint   Offset is in Dints (32-bit)
                Real   Offset is in Reals (32-bit)
        .<bit>  Bit number 0 to 15 for Int, 0 to 31 for Dint

    Ethernet/IP Output data always includes a 32-bit Run/Idle header, so Output data cannot be mapped there.
    Ethernet/IP Input data may include a 32-bit Status header, many devices don't map data there.
    The 'Header' modifier allows mapping to the header areas.

    Examples:
    EthTag Drive_Ready  int[Header 0].0     ; Byte ofs 0 + (0*'Int'2)
    EthTag Drive_Over   int[Header 1].0     ; Byte ofs 2 + (1*'Int'2)
    EthTag Drive_Under  int[Header 2].0     ; Byte ofs 4 + (2*'Int'2) same as int[0] below
    EthTag Drive_Active int[       0].0     ; Byte ofs 4 'Header'4 + (0*'Int'2) Same as int[Header 2] above

    EthTag Drive_Speed  real[Real  2].0     ; Byte ofs 12 'Header'4 + (2*'Real'4)
    EthTag Drive_Accel  int[Byte   8].0     ; Byte ofs 12 'Header'4 + (8*'Byte'1)
    EthTag Drive_Decel  Dint[Int   4].0     ; Byte ofs 12 'Header'4 + (4*'Int'2)
    EthTag Drive_Under  int[Dint   2].0     ; Byte ofs 12 'Header'4 + (2*'Dint'4)

    [Header x]: 0 1 2 3 4...
           [x]:     0 1 2...

; --- Map Profibus Input Data
 PbsInt[PbsOfs] <AsignOper> <EthTag> or <EipAddr> [Mult] [Div]
PbsDint[PbsOfs] <AsignOper> <EthTag> or <EipAddr> [Mult] [Div]
PbsReal[PbsOfs] <AsignOper> <EthTag> or <EipAddr> [Mult] [Div]
    [PbsOfs]    Profibus Input Int (16-bit) offset
                Dint/Real must be even (32-bit aligned)
    <AsignOper> <- Direct Data
                {- Swap   Data - Int 01 to 10 Dint 0123 to 3210
                <~ or {~  Invert (Bits only)
    <EthTag>    As defined above
    <EthAddr>   As defined above
    [Mult]      Int/Dint - 32-bit integer, Real
    [Div]       Int/Dint only, 1 to 65535

    Supports:
    Int  from Int  with dint Mlt & Div
    Int  from Dint with dint Mlt & Div
    Dint from Dint with dint Mlt & Div
    Dint from Int  with dint Mlt & Div
    Int  from Real with real Mlt
    Dint from Real with real Mlt
    Real from Int  with real Mlt
    Real from Dint with real Mlt
    Real from Real with real Mlt
    All Int to Dint are sign extended.
    *** No Out Of Bounds checking

    Examples:
    PbsDint[0].03   <- Drive_Ready   ; Ethernet Tag
    PbsDint[0].04   <~ dint[0].28    ; Ethernet Address, Invert
    PbsInt[1]       {- OutputFreq   *32767/600  ; Int from Int with swap and int Mult Div
    PbsReal[8]      <- dint[8]  *1000           ; Real from Dint with swap real mult
    PbsDint[10]     {- dint[10] *100/4          ; Dint from Dint with swap and int Mult Div

; --- Map Profibus Output Data
 PbsInt[PbsOfs] [Mult] [Div] <AsignOper> <EthTag> or <EipAddr>
PbsDint[PbsOfs] [Mult] [Div] <AsignOper> <EthTag> or <EipAddr>
PbsReal[PbsOfs] [Mult] [Div] <AsignOper> <EthTag> or <EipAddr>
    [PbsOfs]    Profibus Output Int (16-bit) offset
                Dint/Real must be even (32-bit aligned)
    <AsignOper> -> Direct Data
                -> Swap   Data - Int 01 to 10 Dint 0123 to 3210
                ~> or ~}  Invert (Bits only)
    <EthTag>    As defined above
    <EthAddr>   As defined above
    [Mult]      Int/Dint - 32-bit integer, Real
    [Div]       Int/Dint only, 1 to 65535

    Supports:
    Int  to Int     with dint Mlt & Div
    Int  to Dint    with dint Mlt & Div
    Dint to Dint    with dint Mlt & Div
    Dint to Int     with dint Mlt & Div
    Int  to Real    with real Mlt
    Dint to Real    with real Mlt
    Real to Int     with real Mlt
    Real to Dint    with real Mlt
    Real to Real    with real Mlt
    All Int to Dint sign extended
    *** No Out Of Bounds checking

    Examples:
    PbsDint[0].03   -> Drive_Ready   ; Ethernet Tag
    PbsDint[0].04   ~} dint[0].28    ; Ethernet Address, Swap & Invert
    PbsInt[1]   *32767/600 -} OutputFreq  ; Int to Int with swap & int Mult Div
    PbsReal[8]  *1000      -} dint[8]     ; Real to Dint with swap real Mult
    PbsDint[10] *100/4     -} dint[10]    ; Dint to Dint with swap and int Mult Div