cardIoStatus
cardIoStatus — provides process I/O data exchange status for
cards.
Synopsis
(cardIoStatus)
(cardIoStatus card_id)
Parameters
- card_id
- The
target card ID (0..3). If no card ID is
specified, the query is repeated for all initialized cards.
Returns
In response to a query or successful setting of a card:
(cardIoStatus card_id mode mode ReadyBit ready_flag RunBit run_flag
ComBit com_flag count exchanges flags flags)where
- mode
- The mode of exchange between the fieldbus and process
I/O data buffers on the card (see Hilscher Fieldbus CIF Card in
the Cogent Driver Specifications sections of the Cogent C API manual).
- ready_flag
- 1 if the card is running
and initialization (of the card firmware) is
complete.
- run_flag
- 1 if the card is
configured and communicating.
- com_flag
- 1 if data exchange
between the card and the fieldbus has been
established.
- exchanges
- An internal driver count of the number of
buffer data accesses completed.
- flags
- The current value of the 2-byte device flag
register (in hex).
Otherwise, one of the following error messages:
(error "cardIoStatus DR_ERR_CARD_INVALID (time) invalid card: card_id")
Description
This command provides status
information about the process I/O data exchange between a card and
its fieldbus. Normally it is used only for interactive performance
testing.
Example
In the following example,
(cardIoStatus 0)
returns
(cardIoStatus 1 mode 2 ReadyBit 1 RunBit 1 ComBit 0 count 0 flags 0000)
