Class Epl_MN
Redaktör je
Creator Jack E, Sixten I
Version 1.0
Modified 04-JUL-2013 08:13:16.20
 Ethernet Powerlink Managing node.

 A Powerlink network consists of two device types, an MN (Managing Node)
 and one or several CN (Controlled Node). The Epl_MN object is used when
 ProviewR acts as an MN in a Powerlink network.

 The Powerlink circuit is configured in the node hierarchy with Epl_MN, Epl_CN
 and Epl_Module objects. But a corresponding configuration also has to be done
 in the openCONFIGURATOR. The openCONFIGURATOR imports xdd and xdc files provided
 by the CN vendors, and will generate a cdc-file that is used by the Powerlink
 stack to initiate the communication.

Configuration


 Before the use of a Powerlink agent object a configuration
 file must be created (cdc-file).

 The preferred software for building the cdc-file is openCONFIGURATOR.
 When using openCONFIGURATOR you have to provide the device description
 files (.xdd) for all the slaves that will be used in the  Powerlink network.
 See section "Case study Powerlink tool openCONFIGURATOR" below for more
 information.

 The mapping of the input and output areas will be made by the
 openCONFIGURATOR. All communication parameters such as cycle time
 will be configured using openCONFIGURATOR.

 When the configuration is complete you build the cdc-file and transfer
 it to your project. Preferred location of the cdc-file is $pwrp_exe in the
 current project. Then all you have to do is to specify the path in the
 CDCfile attribute.

 When building the cdc-file you will also get a file named xap.h. This
 file contains two structs that represents the input  and output areas.
 You can use this as a map when you configure the  channel objects for
 the module. The channel types and representation has to match the area
 descriptions in the xap.h file.

 The NodeId is always 240 for a Powerlink MN. The address range
 1-239 is used for CN. The address of a CN is specified in the
 openCONFIGURATOR.

 Epl_MN object also requires configuration of an EplHandler object, see
 figure below.

Example Epl_MN settings


Example 1

 A basic configuration with the ProviewR managing node configured with an
 Epl_MN object. Below this two controlled node with one module each,
 configured with Epl_CN and Epl_Module objects. Below the module objects
 channel object are configured with input channels first and output
 channels last.

 Epl_MN
  Epl_CN
   Epl_Module
    ChanAi
    ChanAi
    ChanAi
    ChanIo
    ChanAo
  Epl_CN
   Epl_Module
    ChanAi
    ChanAo

Example 2

 This is an example with an ABB ACS880 frequency converter.
 Note that the channels are contained in the Io attribute
 of the module object M1.

The result will be like this three class object



Case study Powerlink tool openCONFIGURATOR


 openCONFIGURATOR is an open source tool contributed by www.Kalycito.com.
 openCONFIGURATION is used for easy setup, configuration and maintenance
 of any POWERLINK network. openCONFIGURATOR ideally complements openPOWERLINK,
 the open source POWERLINK protocol stack for master and slave.

 Every node in a Powerlink network must be configure through this tool.
 In a ProviewR project all Powerlink CN nodes is a reflection of this memory
 mapping.


The Case
 The case study is found in class help for object ABB_ACS880_Epl, see this
 class for more information.

See also



RtBody attributes pwr_sClass_Epl_MN
String80 Description   Used to add a short description of the master
String80 Specification  
String256 CDCfile   This attribute should contain a path to a cdc-file.
Example: /home/pwrp/mnobd.cdc
String80 Device   The network device used by the Powerlinkstack
Example: eth0
String80 IpAddress  
String80 IpNetmask  
UInt16 NodeId   The NodeId of the master, should always be 240.
IoProcessMask Process   The ProviewR process the agent object is associated with
Objid ThreadObject  
StallActionEnum StallAction  
UInt32 Priority  
UInt16 StartupTimeout  
UInt16 Timeout  
EplNmtState NmtState  
Status Status  
UInt16 ErrorCount  
UInt16 ErrorSoftLimit  
UInt16 ErrorHardLimit  
UInt32 InputAreaSize  
UInt32 OutputAreaSize  
UInt16 NumberOfSlaves  


Template Object
CDCfile $pwrp_exe/mnobd.cdc
Device eth0
NodeId 240
Process 128
Priority 20
StartupTimeout 30
Timeout 2
ErrorSoftLimit 25
ErrorHardLimit 50


Attributes detail


Description Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody
Used to add a short description of the master

Specification Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody

CDCfile Attribute
Klass Attribute
Typ String256
Flags
Kropp RtBody
This attribute should contain a path to a cdc-file.
Example: /home/pwrp/mnobd.cdc

Device Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody
The network device used by the Powerlinkstack
Example: eth0

IpAddress Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody

IpNetmask Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody

NodeId Attribute
Klass Attribute
Typ UInt16
Flags Noedit
Kropp RtBody
The NodeId of the master, should always be 240.

Process Attribute
Klass Attribute
Typ IoProcessMask
Flags
Kropp RtBody
The ProviewR process the agent object is associated with

ThreadObject Attribute
Klass Attribute
Typ Objid
Flags
Kropp RtBody

StallAction Attribute
Klass Attribute
Typ StallActionEnum
Flags
Kropp RtBody

Priority Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody

StartupTimeout Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody

Timeout Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody

NmtState Attribute
Klass Attribute
Typ EplNmtState
Flags State|Noedit
Kropp RtBody

Status Attribute
Klass Attribute
Typ Status
Flags State|Noedit
Kropp RtBody

ErrorCount Attribute
Klass Attribute
Typ UInt16
Flags State|Noedit
Kropp RtBody

ErrorSoftLimit Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody

ErrorHardLimit Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody

InputAreaSize Attribute
Klass Attribute
Typ UInt32
Flags State|Noedit
Kropp RtBody

OutputAreaSize Attribute
Klass Attribute
Typ UInt32
Flags State|Noedit
Kropp RtBody

NumberOfSlaves Attribute
Klass Attribute
Typ UInt16
Flags State|Noedit
Kropp RtBody