beautypg.com

File transfer protocol – Matrix Orbital GLK24064-25 User Manual

Page 54

background image

Command Summary

49

15.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 Upload 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.


15.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

This command will upload a single file to the display. Unlike the standard protocol, there is one XModem upload
command for all file types, see File Types for a complete list.

File ID

Word

Unique identification number for the file to upload.

Type

Byte

Type of file to upload, see File Types .

Size

Double

Size of the file to upload.

Data

Byte(s)

File data to upload, must be padded to an even multiple of 128 bytes.

15.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 XModem protocol.

File ID

Word

Unique identification number for the file to download.

Type

Byte

Type of file to download, see File Types .

Response

Double

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

Value

Action

Description

1

Acknowledged

Transfer successful, upload continues

8

Not Acknowledged

Transfer failed, abort upload



This manual is related to the following products: