cifTelegramBin

cifTelegramBin — sends a telegram and waits for a response.

Synopsis

(cifTelegramBin card_id rcv_task snd_task cmd ext ascii_hex_string)
  

Parameters

card_id

The target card ID (0..3).

rcv_task

The ID of the target CIF firmware task that is to process the message. This value is protocol-dependent. Different message functions are available through the various target tasks.

snd_task

The sending task id, normally 16 (the HOST user), but may be dependent on the protocol and specific function.

cmd

The message command specifier, as defined for the particular protocol and function.

ext

The message command specifier extension, if required by the command.

ascii_hex_string

The content of the message as a string of ASCII-encoded hex digits.

[Note]

This specifies the content of the message itself (header + data); the message interface header (the first 8 bytes) is automatically created from the other supplied parameters.

Returns

(cifTelegramBin card_id return_value)

where return_value depends on the message response, or one of the following errors:

(error "cifTelegramBin DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "cifTelegramBin -1 (time) messageError message_error_code")
(error "cifTelegramBin -1 (time) replyMailboxError device_error_code")
(error "cifTelegramBin -1 (time) sendMailboxError device_error_code")
[Note]

The text string corresponding to the message_error_code and device_error_code can be obtained by issuing an errorDescription command, like this:

(errorDescription error_code)

Description

This command provides access to the CIF message data interface. The message content must be specified as ASCII encoded hex digits, and the resulting binary message is likewise encoded as ASCII hex. See the cifTelegram command for more information about messages.

Example

See protocol-specific configuration files.