pfbMasterStatus

pfbMasterStatus — queries the overall status of a card acting as a DP Master.

Synopsis

(pfbMasterStatus card_id)
  

Parameters

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

Returns

If succesful:

(pfbMasterStatus card_id mode status stn_statusi...)

where

mode
is RUN if scanning of i/o is active, otherwise STOP.
status
is OK if all i/o for which the master is configured to scan are functioning correctly, otherwise ERROR.
stn_statusi
is the status of station i, generated for all nodes present on the network, as follows:
  • (i OK) if the station is functioning correctly, otherwise
  • (i error ext_error error_str )
    where:
    iThe station ID of the node.
    errorThe error code associated with station i.
    ext_errorThe extended error code.
    error_strThe descriptive string associated with the error.

Otherwise, one of the following error messages:

(error "pfbMasterStatus DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "pfbMasterStatus PFB_ERR_NO_CARD (time) card not available")
(error "pfbMasterStatus PFB_ERR__MASTER_NOT_CFG (time) DP Master not configured")

Description

This command provides the status of the card as a DP Master scanning the network.

Example

The command:

(pfbMasterStatus 0)

returns something like this:

(pfbMasterStatus 0 RUN OK (2 OK))

or

(pfbMasterStatus 0 RUN ERROR (2 0x03 3 "frame delivery problems while updating slave data"))