pfbStationStatus

pfbStationStatus — queries the status of Profibus nodes present on the network.

Synopsis

(pfbStationStatus card_id)
  

Parameters

card_id
The target card ID (0..3).

Returns

If succesful:

   (pfbStationStatus card_id statusi...)

where statusi is the status of node i, generated for all nodes present on the network, as follows:

   (i status [changed] id_str1...)

where:

iThe station ID of the node.
statusACTIVE or PASSIVE
changedCHANGED indicates the status of the station has changed (gone online or offline) since the last query. The character '*' indicates no change has occurred
id_str1The first of up to 4 strings containing the identification data of the station, or if the ID cannot be read, then the string "Error: 0xNN", where NN is a station-specific error value.

Otherwise, one of the following error messages:

(error "pfbStationStatus DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "pfbStationStatus PFB_ERR_NO_CARD (time) Card not available")
(error "pfbStationStatus PFB_ERR_CARD_NOT_ONLINE (time) Card is not ONLINE")
(error "pfbStationStatus PFB_ERR_STN_STATUS_FDL_TIMEOUT (time)
        Error attempting to find passive stations (timeout)")
(error "pfbStationStatus PFB_ERR_STN_STATUS_ID_REQ_TIMEOUT (time)
        Error issuing station status request (timeout)")
(error "pfbStationStatus PFB_ERR_STN_STATUS_CLEAR_TIMEOUT (time)
        Error clearing the station status changed flag (timeout)")

Description

This command provides the status of all nodes present on the Profibus network.

Example

The command:

(pfbStationStatus 0)

returns something like this:

(pfbStationStatus 0 (0 ACTIVE * "") (2 PASSIVE * "TMG i-tec GmbH" "80166" "1.3" "1.0")