Class Pb_Hilscher
Redaktör Ferdinand Hauck
Version 1.0
Modified 09-DEC-2008 13:19:56.59
Configuresa Hilscher CIF 50-PB (Profibus DP master board).
Available on GNU/Linux.  The object should be named Px, where x is
the number of the device, e.g. P1.  It should in theory be possible
to run up to four Hilscher Profibus DP master boards in parallel per
system.
This class is based on the Softing Profiboard class by Claes Jurstrand.

RtBody attributes pwr_sClass_Pb_Hilscher
String80 Description   Text description of the object (comment).
IoProcessMask Process   Defines the ProviewR process that will handle I/O for the bus.
1 for the PLC process (default).
Objid ThreadObject   Defines which of the PLC threads that will handle I/O for the bus (if Process = 1).
Status Status   Indicates the current state of the bus in runtime. Updated by the I/O-handler.
PB__NOTINIT : Bus is not initialized.
PB__INITFAIL : Bus failed to be initialized.
PB__DISABLED : Bus is disabled, no I/O-handling will be performed.
PB__STOPPED : Bus is in stopped mode.
PB__CLEARED : Bus is in cleared mode.
PB__NORMAL : Bus is in operating mode (this should be the normal state when running).
UInt8 DisableBus   Flag that disables the initialization of the bus, if initialized turns off I/O-handling.
UInt16 NumberSlaves   Number of configured slaves in the bus. Updated by the I/O-handler.
UInt16 BusNumber   Number of the bus. This value is independent for different agent
classes, so if you mix boards from different vendors, the agent
objects for the cards will share BusNumber in some cases.
It should be possible to attach up to four Hilscher Profibus DP
master boards to each system.
UInt16 BaudRate   Baud rate for the bus in Kbit/s. Possible values are 500, 1500, 3000, 6000, 12000.
Note that the values for some of the following attributes are depending on the
baud rate.
UInt16 StallTime   Watchdog timer for write supervision in the master card. This watchdog is
activated at the first write operation after initialization. If the timer later
elapses without a write operation, the master card will reset itself, and the bus
will stop, leaving all slaves to stall when their own stall time elapses.
A value of 0 will disable the board's watchdog functionality altogether.
Range 0..65535 ms
UInt16 Tsl   Slot time, the maximum time a master station must wait for a transaction response.
Range 37..16383 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 200
1500 kbit/s - 300
3000 kbit/s - 400
6000 kbit/s - 600
12000 kbit/s - 1000
UInt16 MinTsdr   Minimum station delay time for responder, the period of time which may elapse before
the responder can send the response frame. Range 11..1023 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 11
1500 kbit/s - 11
3000 kbit/s - 11
6000 kbit/s - 11
12000 kbit/s - 11
UInt16 MaxTsdr   Maximum station delay time for responder, the responder has to send the response frame
before this time is elapsed. Range 37..2^16-1 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 100
1500 kbit/s - 150
3000 kbit/s - 250
6000 kbit/s - 450
12000 kbit/s - 800
UInt8 Tqui   Quiet time, the period of time which a transmitting station must wait after the end of a frame
before enabling its receiver. It is significant when using repeaters. Range 0..493 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 0
1500 kbit/s - 0
3000 kbit/s - 3
6000 kbit/s - 6
12000 kbit/s - 9
UInt8 Tset   Setup time, the time between the occurrence of an interrupt request and the necessary request
action is performed. Range 1..494-Tqui BitTimes.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 1
3000 kbit/s - 4
6000 kbit/s - 8
12000 kbit/s - 16
UInt32 Ttr   Target rotation time, the anticipated time for one token rotation on the bus, including
allowances for high and low priority transactions and GAP maintenance.
Range 256..2^24-1 Bit Times.
The value is irrelevant in Profibus DP operations.
UInt8 G   Gap update factor, defines the number of token rotations between GAP maintenance cycles.
Range 1..100.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 10
3000 kbit/s - 10
6000 kbit/s - 10
12000 kbit/s - 10
UInt8 Hsa   Highest station address. Range 1..126.
UInt8 MaxRetryLimit   Maximum retry limit, indicates how often FDL has to repeat the request frame when no response
or acknowledge frame is receive from the recognized station within the slot time. Range 0..7.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 1
3000 kbit/s - 2
6000 kbit/s - 3
12000 kbit/s - 4
UInt8 BpFlag   Bus parameter flag. Should not be changed from the default value.
UInt16 MinSlaveInterval   Data exchange cycle time in 100 us. Should not be changed from the default value.
UInt16 PollTimeout   Watchdog timer for Master to Master communication.
UInt16 DataControlTime   Control interval for global control status reports of the DP master.
Array of UInt8 Diag   Area for receiving diagnostic data from the master. Not implemented yet.


Template Object
Process 1
BusNumber 1
BaudRate 12000
StallTime 3000
Tsl 1000
MinTsdr 11
MaxTsdr 800
Tqui 9
Tset 16
Ttr 300000
G 10
Hsa 126
MaxRetryLimit 4
MinSlaveInterval 1
PollTimeout 1000
DataControlTime 100


Attributes detail


Description Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody
Text description of the object (comment).

Process Attribute
Klass Attribute
Typ IoProcessMask
Flags
Kropp RtBody
Defines the ProviewR process that will handle I/O for the bus.
1 for the PLC process (default).

ThreadObject Attribute
Klass Attribute
Typ Objid
Flags
Kropp RtBody
Defines which of the PLC threads that will handle I/O for the bus (if Process = 1).

Status Attribute
Klass Attribute
Typ Status
Flags Noedit|Invisible
Kropp RtBody
Indicates the current state of the bus in runtime. Updated by the I/O-handler.
PB__NOTINIT : Bus is not initialized.
PB__INITFAIL : Bus failed to be initialized.
PB__DISABLED : Bus is disabled, no I/O-handling will be performed.
PB__STOPPED : Bus is in stopped mode.
PB__CLEARED : Bus is in cleared mode.
PB__NORMAL : Bus is in operating mode (this should be the normal state when running).

DisableBus Attribute
Klass Attribute
Typ UInt8
Flags Noedit|Invisible
Kropp RtBody
Flag that disables the initialization of the bus, if initialized turns off I/O-handling.

NumberSlaves Attribute
Klass Attribute
Typ UInt16
Flags Noedit|Invisible
Kropp RtBody
Number of configured slaves in the bus. Updated by the I/O-handler.

BusNumber Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Number of the bus.  This value is independent for different agent
classes, so if you mix boards from different vendors, the agent
objects for the cards will share BusNumber in some cases.
It should be possible to attach up to four Hilscher Profibus DP
master boards to each system.

BaudRate Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Baud rate for the bus in Kbit/s. Possible values are 500, 1500, 3000, 6000, 12000.
Note that the values for some of the following attributes are depending on the
baud rate.

StallTime Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Watchdog timer for write supervision in the master card. This watchdog is
activated at the first write operation after initialization. If the timer later
elapses without a write operation, the master card will reset itself, and the bus
will stop, leaving all slaves to stall when their own stall time elapses.
A value of 0 will disable the board's watchdog functionality altogether.
Range 0..65535 ms

Tsl Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Slot time, the maximum time a master station must wait for a transaction response.
Range 37..16383 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 200
1500 kbit/s - 300
3000 kbit/s - 400
6000 kbit/s - 600
12000 kbit/s - 1000

MinTsdr Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Minimum station delay time for responder, the period of time which may elapse before
the responder can send the response frame. Range 11..1023 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 11
1500 kbit/s - 11
3000 kbit/s - 11
6000 kbit/s - 11
12000 kbit/s - 11

MaxTsdr Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Maximum station delay time for responder, the responder has to send the response frame
before this time is elapsed. Range 37..2^16-1 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 100
1500 kbit/s - 150
3000 kbit/s - 250
6000 kbit/s - 450
12000 kbit/s - 800

Tqui Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Quiet time, the period of time which a transmitting station must wait after the end of a frame
before enabling its receiver. It is significant when using repeaters. Range 0..493 Bit Times.
Recommended values for each baud rate:
500 kbit/s - 0
1500 kbit/s - 0
3000 kbit/s - 3
6000 kbit/s - 6
12000 kbit/s - 9

Tset Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Setup time, the time between the occurrence of an interrupt request and the necessary request
action is performed. Range 1..494-Tqui BitTimes.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 1
3000 kbit/s - 4
6000 kbit/s - 8
12000 kbit/s - 16

Ttr Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody
Target rotation time, the anticipated time for one token rotation on the bus, including
allowances for high and low priority transactions and GAP maintenance.
Range 256..2^24-1 Bit Times.
The value is irrelevant in Profibus DP operations.

G Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Gap update factor, defines the number of token rotations between GAP maintenance cycles.
Range 1..100.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 10
3000 kbit/s - 10
6000 kbit/s - 10
12000 kbit/s - 10

Hsa Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Highest station address. Range 1..126.

MaxRetryLimit Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Maximum retry limit, indicates how often FDL has to repeat the request frame when no response
or acknowledge frame is receive from the recognized station within the slot time. Range 0..7.
Recommended values for each baud rate:
500 kbit/s - 1
1500 kbit/s - 1
3000 kbit/s - 2
6000 kbit/s - 3
12000 kbit/s - 4

BpFlag Attribute
Klass Attribute
Typ UInt8
Flags
Kropp RtBody
Bus parameter flag. Should not be changed from the default value.

MinSlaveInterval Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Data exchange cycle time in 100 us. Should not be changed from the default value.

PollTimeout Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Watchdog timer for Master to Master communication.

DataControlTime Attribute
Klass Attribute
Typ UInt16
Flags
Kropp RtBody
Control interval for global control status reports of the DP master.

Diag Attribute
Klass Attribute
Typ Array of UInt8
Flags Array|Noedit|Invisible
Elements 256
Kropp RtBody
Area for receiving diagnostic data from the master. Not implemented yet.