1.2.3.nnn - User Interface Settings - A

The device uses this property to set which custom image it displays when idle. If the selected image does not exist, the device falls back to showing text. This property does not take effect instantly; it takes effect the next time the device transitions to idle (for example, after a transaction or after resetting).

· 0x00 = Show text “Welcome”

· 0x01 = Show custom image 1

· 0x02 = Show custom image 2

· 0x03 = Show custom image 3

· 0x04 = Show custom image 4

To use this feature, the host must first load an image into the selected slot using Command 0xD812 - Start Send File to Device (Unsecured). Images must be BMP format, 160KB or smaller with no compression, maximum 320px by 240px, with color depth 16 color, 256 color, 16-bit color, 24-bit color. Images smaller than the maximum size are centered on the display. Note images at full screen size must be 16-bit color or lower to meet the size requirement.

None

1

1

Binary

Any number

0x00

1.2.3.1.1.2 / 0x010203010102

Custom Idle Page Image Device Locked

The device uses this property to set which custom image it displays when idle and locked. If the selected image does not exist, the device falls back to showing text. This property does not take effect instantly; it takes effect the next time the device transitions to idle (for example, after a transaction or after resetting). See Device Lock Feature for more information.

· 0x00 = Show text “Welcome” “Device is Locked”

· 0x01 = Show custom image 1

· 0x02 = Show custom image 2

· 0x03 = Show custom image 3

· 0x04 = Show custom image 4

To use this feature, the host must first load an image into the selected slot using Command 0xD812 - Start Send File to Device (Unsecured). Images must be BMP format, 160KB or smaller with no compression, maximum 320px by 240px, with color depth 16 color, 256 color, 16-bit color, 24-bit color. Images smaller than the maximum size are centered on the display. Note images at full screen size must be 16-bit color or lower to meet the size requirement.

1.2.3.1.2.1 / 0x010203010201

Display Orientation

The device uses this property to set the orientation of the display. There are four modes: Landscape with magnetic stripe reader (MSR) on the top, Landscape with MSR on the bottom, Portrait with MSR on the right, and Portrait with MSR on the left. This property does not take effect immediately, it takes effect the next time the device transitions to idle (for example, after a transaction or after power cycle / reset).

Property Description

Property OID

1.2.3.1.2.3 / 0x010203010203

Name

Send UI notifications along with showing message on the display

Description

This property is used to enable/disable the device to send UI notifications to the Host (similars to non-display device) in addition to showing UI message on the display device.

1.2.3.1.3.1 / 0x010203010301

Enable Card Logos Page at Startup

Enables a page at startup that displays supported payment type brand logos.

1.2.3.1.3.2 / 0x010203010302

Display Card Logo While Authorizing

Enable display of logo for card brand used in transaction

1.2.3.1.2.2 / 0x010203010202

Display Backlight Intensity

The device uses this property to set the intensity of the display’s backlight, expressed as a percentage range from 1% to 100%.

The backlight setting takes effect immediately after the host changes it.

1.2.3.2.1.1 / 0x010203020101

System Volume Control

This property sets the output volume for all sounds the device produces after startup, expressed as a percentage range from 0% (no sound) to 100%. The volume setting takes effect immediately after the host changes it.

Note that devices with limited volume control hardware allocate ranges of numbers to represent the same physical volume level (for example, 1..49 = Low, 50..100 = High).

Touch Keypress Beep Enable

1.2.3.2.2.1 / 0x010203020201

Globally enables/disables the beep tone triggered by touchscreen taps.

1.2.3.3.1.1 / 0x010203030101

Phone Number Format

This property is used to change the displayed format of the phone number entered in the touch screen. It fully supports the International E.164 format that defines the fields allowed for global phone numbers. This property is an array of 7 bytes divided into fields. All values are HEX. Byte 0-1 – Country code (0x0000): 1 – 999 (value range 0x01 – 0x3E7) see NOTE 1 Byte 2 – Number of Area code digits: 0 – 3 (value range 0x00 – 0x03) Byte 3 – Add Area code leading zero: (T/F) 0 – 1 (value range 0x00 – 0x01) NOTE 3

Byte 4 – Number of local number digits: l – 12 (value range 0x01 – 0x0C)

Byte 5 – Local number dash position: 0 – ‘Byte 4’s value minus 1’

Byte 6 – Hide digits with ‘*’: (T/F) 0 – 1 (value range 0x00 – 0x01) NOTE 1: If country code is set to zero, then the local number format is automatically enabled.

NOTE 2: The maximum number of digits specified by the E.164 format is 15. The country code digits + area code digits + local number digits cannot exceed 15 total digits.

NOTE 3: Setting Byte 3 to true only takes effect if country code is set to zero. If Byte 3 is set to true, then Byte 2 must be set to 2 or 3. Reason: Adding a leading zero automatically makes the number of area code digits greater than 1.

1.2.3.3.2.1 / 0x010203030201

Social Security Number Format

This property is used to change the displayed format of the social security number entered

in the touch screen. The default obfuscated character is ‘*’.

Byte 0 – Number of digits

Valid values are 4 or 9 (0x04 or 0x09) 4 = Last 4 social security number digits 9 = All 9 social security number digits

Byte 1 – Hide digits with ‘*’ (T/F) 0 – 1 (0x00 – 0x01)

1.2.3.3.3.1 / 0x010203030301

Zip Code Format

This property is used to format the zip code. Byte 2 is used to control the input type, For example, a numeric zip code 23452 (United states) or an alphanumeric zip code M5V 2T6 (Canada).

Byte 0 – Number of digits: 1 – 9 (value range 0x01 – 0x09)

Byte 1 – Dash position: 0 – ‘Byte 0’s value minus 1’

When set to 0, no dash will appear

Byte 2 – Zip code type: Numeric or Alphanumeric 0 - 1 (value 0x00 – 0x01)

Byte 3 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01)

1.2.3.3.4.1 / 0x010203030401

Birth Date Format

This property is used to determine if the birth date should be displayed on the screen or hidden. The default hidden character is ‘*’.

Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01) Byte 1 – Birth date format

0x00 = MM-DD-YYYY

0x01 = DD-MM-YYYY

Property Description

Property OID

1.2.3.3.6.1 / 0x010203030601

Name

Email Format

Description

This property is used to determine if the Email should be displayed on the screen or hidden. The default hidden character is ‘*’. The maximum number of characters for Email is 29

Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01)

Example (Hex)

AA00 81040155D101 840F D101 850101 870402030306 8902 C100

Example (Hex)

AA0081048255D10182040000000084820010D1018501018704020303068903C10100

Example (Hex)

AA0081048255D11182040000000084820010D1118501018704020303068903C10101

Property Description

111111111111111111111111111111111111111111111111111111111111111

Property OID

1.2.3.3.7.1 / 0x010203030701

Name

General Information Format

Description

This property is used to determine if the General Information should be displayed on the screen or hidden. The default hidden character is ‘*’. The maximum number of characters for General Information is 18.

Byte 0 – Hide digits with ‘*’ (T/F) 0 – 1 (value range 0x00 – 0x01)

Example (Hex)

AA00 81040155D101 840F D101 850101 870402030307 8902 C100

Example (Hex)

AA0081048255D10182040000000084820010D1018501018704020303078903C10100

Example (Hex)

AA00 81040155D111 8410 D111 850101 870402030307 8903 C101 01

Example (Hex)

AA0081048255D11182040000000084820010D1118501018704020303078903C10101