updateStatus

updateStatus — forces the card flags to be read and processed.

Synopsis

(updateStatus [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

(updateStatus card_id status)

where status is the status byte for the card (see statusPointDefine), or one of the following errors:

(error "bufferUpdate -1 (time) Command invalid: Card card_id using interrupt mode")

(error "bufferUpdate DR_ERR_CARD_INVALID (time) invalid card: card_id")

(error "bufferUpdate DR_ERR_CARD_IO_FAILURE (time) I/O failure (error_code) on device card_id")
[Note]

The text string corresponding to the error message code for I/O failure can be obtained by issuing a errorDescription command, like this:

(errorDescription error_code)

Description

This command causes the card status flags to be read, and processed if a change is detected, returning the resulting status of the card. Typically, you would use this command as an alternative to the normal mechanisms for updating the card, namely, polling or interrupts, when you want to synchronize the processing of card events externally.

See Also

bufferUpdate