User Manual

48 Command Summary
14.10 XModem
Filesystem
Download
Dec
Hex
ASCII
254 222 133 6 48
FE DE 85 6 30
■ ▐ à ACK 0
v8.3
Downloads the complete filesystem using the XModem Transfer Protocol. A veritable heap of data, transmitted at
a decent pace.
Response
Integer
Size of the filesystem to download.
Byte(s)
Filesystem data to download, an even multiple of 256 bytes.
14.11 XModem
File Upload
Dec
Hex
ASCII
254 220 133 6 48
FE DC 85 6 30
■ ▄ à ACK 0
File ID Type Size Data
File ID Type Size Data
File ID Type Size Data
v8.3
Uploads a single file to the display using the XModem Transfer Protocol. Unlike the standard protocol, there is one
XModem upload command for all file types, see File Types for a complete list.
File ID
Short
Unique identification number for the file to upload, value between 0 and 1023.
Type
Byte
Type of file to upload, see File Types .
Size
Integer
Size of the file to upload.
Data
Byte(s)
File data to upload, must be padded to an even multiple of 128 bytes.
14.12 XModem
File Download
Dec
Hex
ASCII
254 221 133 6 48
FE DD 85 6 30
■ ▌ à ACK 0
File ID Type
File ID Type
File ID Type
v8.3
Downloads a single file from the display to the host using the XModem Transfer Protocol.
File ID
Short
Unique identification number for the file to download, value between 0 and 1023.
Type
Byte
Type of file to download, see File Types .
Response
Integer
Size of the filesystem to download.
Byte(s)
Filesystem data to download, an even multiple of 128 bytes, may be padded with 255s.
File Transfer Protocol
Once a bitmap or font file has been created and paired to its command it must be sent using a file
protocol developed specifically for Matrix Orbital displays. Once a file upload command has been sent
requesting a unique reference number and specifying the file size required, the display will respond
indicating whether it has enough room to save the file or not. As is the case throughout the upload
protocol, a response of 1 will indicate confirmation while an 8 corresponds to rejection and will
terminate the session.
Table 39: Upload Protocol Responses
Value
Action
Description
1
Acknowledged
Transfer successful, upload continues
8
Not Acknowledged
Transfer failed, abort upload