Back to Program Loader Commands
CMD_PGM_DESC

Command:          CMD_PGM_DESC
Destination:          SD_PGM
Destination Channel:  0

Description

Clients use this command to specify the size, name and description of a program to be uploaded to the . The returned handle is needed to upload the file using the CMD_PGM_UPLOAD command.


Command Data Format

Size Name Description
4 bytes 32 bytes 80 bytes
Size
This is the total size of the program to be uploaded.
Name
This is the name of the program to be uploaded to the . If the name is less than 32 bytes long, it should be null padded.
Description
This is a description of the program to be uploaded. If the description is less than 80 bytes long, it should be null padded.


Response Data Format

Exists Flag Handle Padding
1 byte 1 byte 2 bytes

Exists Flag

This is set to 1 if the filename exists.


Handle

This is the handle to be used with the Upload Program command to send the file to the .


Response Return Codes

RESP_OK Execution of the command was successful.
RESP_NO_ROOM Not enough room for program or program is too large
RESP_INVAL_PARAM Invalid filename. The filename contains an invalid character.
RESP_UNSUPPORTED This command is not supported on the specified channel.
RESP_UNREG The specified source channel is not registered with the server.
RESP_UNKNOWN_ERR An unknown error occurred.

|Top|