The target card ID (0..3). If no card ID is specified, the query is repeated for all initialized cards.
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
The mode of exchange between the fieldbus and process I/O data buffers on the card (see Driver Control API in the Cogent API manual).
1 if the card is running and initialization (of the card firmware) is complete.
1 if the card is configured and communicating.
1 if data exchange between the card and the fieldbus has been established.
An internal driver count of the number of buffer data accesses completed.
The current value of the 2-byte device flag register (in hex).
Otherwise, one of the following error messages:
(error "cardIoStatus DR_ERR_DEV_INVALID (time) invalid device: card_id")
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.
In the following example,
(cardIoStatus 0)
returns
(cardIoStatus 1 mode 2 ReadyBit 1 RunBit 1 ComBit 0 count 0 flags 0000)