Back to Card Commands
CMD_CARD_TX

Command:              CMD_CARD_TX
Destination:          SD_CARD
Destination Channel:  Channel ID

Description

Clients use this command to transmit a message over the specified channel.

Command data format

The message to be transmitted is arranged as follows:

Message Frame Format
GC frame header
Frame Type = FT_CMD
Message Frame
(n bytes)
data header Network data + padding

data header


Header Length 1 byte
unsigned char
Number used to represent the
message header.
Header Bits 1 byte
unsigned char
Number of bits that make up the
header. (These are the least
significant bits of the header bytes.)
Data Length 2 bytes
unsigned short
The number of extra data bytes associated
with this message.
Extra Length 1 byte
unsigned char
Additional information (e.g. TX, RX,
etc.) about the message; see
Appendix B.
Mode 1 byte Message mode (tx, rx, etc)
Priority 1 byte
Unsigned char
Not currently used.
Error Status 1 byte
unsigned char
Reports of error conditions
Time Stamp 4 bytes
unsigned long
Message timestamp, in 10uS units
Context 1 byte User-specified unique value that is
guaranteed to remain unchanged
during the life of the message.
Reserved Char 1 byte Reserved.
Reserved Short 2 bytes Reserved.

Response data format

(None)

Response return codes

RESP_OK Execution of the command was successful
RESP_INVAL_CHAN The specified channel is invalid.
RESP_UNSUPPORTED This command is not supported on the specified
channel.
RESP_INVAL_MSG The specified message is not a legal message for
this protocol.
RESP_INVAL_LEN The specified data size is not legal.
RESP_TX_FAIL A transmit attempt failed.
RESP_UNREG The specified source channel is not registered with
the server.
RESP_UNKNOWN_ERR An unknown error has occurred.
RESP_BUF_FULL The transmit buffer is full.

|Top|