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 Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 013) |
| LLL | 3 | Length of the following data |
| FS | 1 | Field separator (Hex 1C) |
| FileName | Var. | Name of download file (at least 5 characters) |
| FS | 1 | Field separator (Hex 1C) |
| FileSize | Var. | Size of download file in bytes (no more than 100 KB) |
| Must be all UPPERCASE and end with .PNG or .JPG. |
Response
API 5001 is only present in response if Completion Code in API 0011 is non-zero (indicating an error).
| Subfield Name | Length | Description |
|---|---|---|
| TTT | 3 | Tag (always = 013) |
| LLL | 3 | Length of the following data |
| Text | Var. | Error message (may not be present) |
Sample Message
Request
| API Field #, | Value Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,xxx.. | User Data. See API 0011 (User Data). |
| 5001, 013017FSCLOSED.PNGFS18316 | Non-Financial Data
|
Response
| API Field #, | Value Description |
|---|---|
| 0001,36 | Transaction Type |
| 0011,xxx.. | User Data. See API 0011 (User Data). |
| 5001,013009Timed out | Non-Financial Data
|
| 5002,12189383 | Device serial number (if present) |