Back to USDT Commands
CMD_USDT_SET_EXTENDED
Command:             CMD_USDT_SET_EXTENDED
Destination:         SD_USDT
Destination Channel: Vehicle Network Protocol Channel ID

Description

Clients use this command to send of list of IDs/headers of messages using Extended Addressing to the USDT server for a given client and channel number. The client must be registered with the USDT server before using this command.

By default, only the ID/Header of 0101 (hexadecimal) is recognized as using Extended Addressing. USDT treats the data portion of a data message differently when using Extended Addressing than when not. If other and/or different IDs/Headers are to use Extended Addresses, they must be listed with either this command or the CMD_USDT_REGISTER command. The default ID/Header for Extended Addressing of 0101 is used only when the list of IDs/Headers using Extended Addressing is not present. If one or more IDs/Headers are present, only those in the list are recognized as using Extended Addressing.


Command Data Format

Number of IDs/Headers to follow reserved ID/Header using Extended Address ...
1 byte 3 bytes 4 bytes ...

Number of IDs/Headers using Extended Addressing

This is the number IDs/Headers that follow.  If this command is used to specify one or more IDs/Headers using extended addressing, the default ID/Header of 0101 (hexadecimal) is replaced with the supplied list of IDs/Headers.
IDs/Headers (n) - n ranges from 1 to 255
Each ID/Header to be used with extended addressing should be a 4 byte value.  The values should be right justified.  For instance, to specify that the ID/Header of 0102 use extended addressing, the four bytes should be set to 00 00 01 02 (hexadecimal).  If more that one ID/Header is specified, the most common one or ones should appear first to insure maximum efficiency when handling the messages.


Response Data Format

none


Response Return Codes

 
RESP_OK Execution of the command was successful. 
RESP_INVAL_CHAN The specified channel is invalid. 
RESP_MEM_ALLOC_ERR Could not allocate enough memory for data buffers. 
RESP_UNSUPPORTED This command is not supported on the specified channel. 
RESP_INVAL_LEN The number of bytes present for the IDs/Headers is incorrect according to the number of IDs/Headers in the third byte of data. 
RESP_INVAL_PARAM The client is not registered with the USDT server. 
RESP_UNREG The specified source channel is not registered with the server. 
RESP_UNKNOWN_ERR An unknown error occurred. 
|Top|