beautypg.com

File transfer protocol – Matrix Orbital GLK19264A-7T-1U User Manual

Page 51

background image

46

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 38: Upload Protocol Responses

Value

Action

Description

1

Acknowledged

Transfer successful, upload continues

8

Not Acknowledged

Transfer failed, abort upload



Once a file is confirmed to fit within the display, the upload will begin. A protocol is used here to ensure
each byte is uploaded successfully. After each byte is sent, the module will echo it back to the host. It