Cogent CIF Driver for Hilscher Fieldbus CIF Cards : Version 6.4
	Command Reference

`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)


cardInit		cardPoll