tech_doc_e.doc / V1.1

Realtime Runtime System for Windows NT/2000/XP

5 System Diagnosis

5.1Bus diagnosis of the IO drivers

All IO drivers are cyclically requested to fill the following diagnosis structure GetBusState, as soon as an IEC task has written its process data to the drivers:

TYPE GETBUSSTATE: STRUCT

BOLDENABLE : BOOL; ENABLE: BOOL;

DRIVERNAME:POINTER TO STRING; DEVICENUMBER:INT; READY:BYTE;

STATE:INT; EXTENDEDINFO:ARRAY[0..129] OF BYTE;

END_STRUCT

END_TYPE

This structure is defined in library BusDiag.lib.

The IO drivers write this structure to the diagnosis address which is defined in the configuration for each bus master. This functionality will only be available for bus masters which are configured in CoDeSys.

For each potential participant in the bus a byte will be reserved in EXTENDEDINFO, where the bits 0

– 2 will be used as follows:

Bit 0: The participant is available in the configuration. Bit 1: The participant is available on the bus.

Bit 2: The participant returns an error.

As soon as a participant which is available on the bus returns an error, the corresponding diagnosis information can be read with the help of the function block DiagGetState (also defined in BusDiag.lib).

DiagGetState will be called for a certain participant of the bus.

FUNCTION_BLOCK DiagGetState

VAR_INPUT

ENABLE:BOOL ;

DRIVERNAME:POINTER TO STRING ;

DEVICENUMBER:INT ;

BUSMEMBERID:DWORD ;

END_VAR

VAR_OUTPUT

READY: BOOL ;

STATE:INT ;

EXTENDEDINFO:ARRAY[0..99] OF BYTE ;

END_VAR

The function block will be executed as soon as a rising edge is detected at the ENABLE input.

DRIVERNAME is the name of the driver (address of the name) to which the diagnosis request should be sent. If "0" is inserted here, the diagnosis request will be sent to all available drivers.

DEVICENUMBER identifies the bus which is managed by the driver. (The Hilscher card driver e.g. can handle up to 5 cards (busses).) The index is based on 0.

BUSMEMBERID identifies the participant of the bus. For a CANopen card BUSMEMBERID e.g. will consist of the NodeID, for a PB-DP card it will render the station address of the participant etc. (in general: the BUSMEMBERID allows a clear identification of the participant). How a bus participant is identified is bus and driver specific.

READY is an output parameter which will be set as soon the diagnosis request has been completely processed. In STATE you will then find one of the values of