Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Export as PDF

0x1803 - Display Message (Display Only)

The host uses this command to request that the device display a message for the cardholder.

The sequence of events is as follows:

1

The host ensures the device is not currently running another command, for example, that it is not running a transaction using Command 0x1001 - Start Transaction.

2

The host selects the message it wants to display from the list of available pre-determined strings.

3

The host composes a command request in the format below, and sends it to the device.

4

The device displays the requested message.

  • If the Timeout parameter is set to Infinite, the device returns a command response message with Response Status, Operation Status Summary byte set to 0x00 (OK, Done) after which the host is free to send further commands.

  • If the Timeout parameter is not set to Infinite:

    • The device returns a command response message with its Response Status, Operation Status Summary byte set to 0x01 (OK, Started / Running).

    • While the host is waiting for the timeout to expire, it should not send any commands to the device, because the device is busy processing the current command.

    • After the timeout period expires, the device blanks the display and sends Notification 0x1805 - User Interface Operation Complete to inform the host.

Request Data for Command 0x1803 - Display Message (Display Only)

Tag
Len
Value / Description
Typ
Req
Default

Beginning of any wrappers, at minimum including Request Message

1803 = Display Message (Display Only) - Command 0x1803

81

01

Timeout - 0x00 = Infinite. Device leaves the requested message on the display until the host initiates a change.

B

O

0x00

- All other values = Timeout in seconds for the device to display the message.

82

01

Message ID. Specify a Display String ID from Display Strings.

B

O

0x14

End of any wrappers, at minimum including Request Message

Response Data for Display Message (Display Only) - Command 0x1803

Tag
Len
Value / Description
Typ
Req
Default

Beginning of any wrappers, at minimum including Response Message

1803 = Display Message (Display Only) - Command 0x1803

No parameters.

End of any wrappers, at minimum including Response Message

Request Example

Example (Hex):

Response Example

Last updated