Tag 013 - Fast Graphics Download

This tag supports a fast Graphics download process. This process can be used to replace an existing graphics file (with the exact same filename, e.g. CLOSED.PNG) on the Simplify device.

The process begins with a Fast Graphics Download (Informational Prompt Tag 013) message. The binary graphics data must be sent immediately after this message is sent (or ACK’d, if enabled).

A download should take about a second. If successful, the existing file is overwritten with the new graphics data. Simplify sends a response after the download is complete (or an error is detected). A subfield in API 0011 returns 000 (for success) or an error code; for errors, there may also be a text message (API 5001).

Consult your Elavon representative for specific filenames and resolution by device.

Control characters and messages

Note concerning communications used during the Fast Graphics Download process:

  • For RS232/USB the Fast Graphics Download message is sent with a STX … EOT ETX LRC wrapper. If ACK is disabled for this message, the graphics data must be sent immediately after the wrapper. If ACK is enabled, Simplify must start receiving the graphics data within 1 second after sending the ACK; otherwise it will return a timeout.
  • For TCP/IP: There is no wrapper for this message, only an EOT. ACK/NAK is not supported, and the graphics data must be sent immediately after the EOT. Simplify must start receiving the graphics data within 1 second after receiving the EOT; otherwise it will return a timeout.
  • The binary graphics data must be sent raw (no wrapper or EOT).

API 5001 Format

Request

API 5001 in the request must specify the name and size of the graphics file.

Subfield NameLengthDescription
TTT3Tag (always = 013)
LLL3Length of the following data
FS1Field separator (Hex 1C)
FileNameVar.Name of download file (at least 5 characters)
Must be all UPPERCASE and end with .PNG or .JPG.
FS1Field separator (Hex 1C)
FileSizeVar.Size of download file in bytes (no more than 100 KB)

Response

API 5001 is only present in response if Completion Code in API 0011 is non-zero (indicating an error).

Subfield NameLengthDescription
TTT3Tag (always = 013)
LLL3Length of the following data
TextVar.Error message (may not be present)

Sample Message

Request

API Field #,Value Description
0001,36Transaction Type
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
5001, 013017FSCLOSED.PNGFS18316Non-Financial Data
  • 013=Tag
  • 017=Length of data
  • CLOSED.PNG=download filename
  • 18316=download filesize (in bytes)

Response

API Field #,Value Description
0001,36Transaction Type
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
5001,013009Timed outNon-Financial Data
  • 013=Tag
  • 009=Length of data
  • Timed out=Error message
5002,12189383Device serial number (if present)