The host uses this command to direct the device to immediately show a QR code on the display, provided the device is not in a mode that has exclusive use of the display (such as during a transaction).
1
Prepare and send the request
Ensure the device is not currently running another command (for example, not running a transaction such as Start Transaction - Command 0x1001.
Select the data for the QR code to display.
Compose a command request in the format described below and send it to the device.
2
The device generates and displays the QR code.
If the Display Time parameter is set to Indefinite:
Tag
Len
Value / Description
Typ
Req
Default
Tag
Len
Value / Description
Typ
Req
Default
If the request started successfully, the Request Status in the message wrapper is All Good, Requested Operation Was Successful.
The device returns a command response message with Response Status, Operation Status Summary byte set to 0x00 (OK, Done). After this response the host is free to send further commands.
If the Display Time parameter is set to a number of seconds:
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 unlocks to allow other commands and sends User Interface Operation Complete - Notification 0x1805 to report Display / Display Message / Timed Out / Reserved.
1822 = Show QR Code (Display Only) - Command 0x1822
81
01
Display Time
- 0x00 = Indefinite
- 0x01 to 0xFF = 1 to 255 seconds
B
O
0x00
82
var
Data to Encode — See ISO/IEC 18004:2015
B
R
83
01
Error Correction
- 0x00 = Low
- 0x01 = Medium
- 0x02 = Quartile
- 0x03 = High
See ISO/IEC 18004:2015
Minimum Version — Must be less than or equal to Maximum Version
- 0x01 to 0x28 = Version 1 to Version 40 — See ISO/IEC 18004:2015
B
O
0x01
86
01
Maximum Version — Must be greater than or equal to Minimum Version
- 0x01 to 0x28 = Version 1 to Version 40
See ISO/IEC 18004:2015
B
O
0x28
87
03
Block Color — Use RRGGBB format.
B
O
0x000000 (Black)
88
03
Background Color — Use RRGGBB format.
B
O
0xFFFFFF (White)
89
var
Prompt
Text for the device to display below the QR code. Because the device shows the Prompt using a proportional font, the maximum length that fits the display depends on the text and the device’s orientation set by Property 1.2.3.1.1.2 Custom Idle Page Image Device Locked (Display Only). In Landscape orientation, the upper limit is approximately 30 characters. In Portrait orientation, the limit is approximately 22 characters.
B
)
No prompt
End of any wrappers, at minimum including Request Message
1822 = Show QR Code (Display Only) - Command 0x1822
No parameters
End of any wrappers, at minimum including Request Message
Beginning of any wrappers, at minimum including Request Message.
Beginning of any wrappers, at minimum including Request Message.
Device generates and displays the QR code
Show QR Code (Display Only) - Request Data for Command 0x1822
Show QR Code (Display Only) - Response Data for Command 0x1822