Property Subgroup 1.2.7.nnn System Settings - 1.2.7.1.1.1 - 1.2.7.1.4.3

Table - Property 1.2.7.1.1.1 Device Reset Occurred Notification Control

Property Description

Property OID

1.2.7.1.1.1 / 0x010207010101

Name

Device Reset Occurred Notification Control

Description

The device uses this property to control behavior of the Device Reset Occurred

notification in Notification 0x1001 - Device Information Update.

Changes to this property do not take effect until the device is power cycled or reset.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 = Never send this notification.

0x01..0xFE = The frequency in seconds the device should repeat sending the notification until the host requests that it stop with Property 1.2.7.1.1.2 Device Reset Occurred Notification Acknowledged.

0xFF = Only send this notification once.

Default

0x00

Table - Property 1.2.7.1.1.1 - Get Request Example

Example (Hex)

AA 00 81 04 01 55 D1 01 84 0F D1 01 85 01 01 87 04 02 07 01 01 89 02 C1 00

Table - Property 1.2.7.1.1.1 - Get Response Example

Example (Hex)

AA 00 81 04 82 55 D1 01 82 04 00 00 00 00 84 82 00 10 D1 01 85 01 01 87 04 02 07 01 01 89 03 C1

01 00

Table - Property 1.2.7.1.1.1 - Set Request Example

Example (Hex)

AA 00 81 04 01 55 D1 11 84 10 D1 11 85 01 01 87 04 02 07 01 01 89 03 C1 01 05

Table - Property 1.2.7.1.1.1 - Set Response Example

Example (Hex)

AA 00 81 04 82 55 D1 11 82 04 00 00 00 00 84 82 00 10 D1 11 85 01 01 87 04 02 07 01 01 89 03 C1

01 05

Table - Property 1.2.7.1.1.2 Device Reset Occurred Notification Acknowledged

Property Description

Property OID

1.2.7.1.1.2 / 0x010207010102

Name

Device Reset Occurred Notification Acknowledged

Description

The host can use this property to acknowledge it has received the Device Reset Occurred notification in Notification 0x1001 - Device Information Update and to request that the device stop sending it.

Alternatively, because the device automatically sets the value of this property to 0x00 on boot, the host can use this property to detect power cycles or resets using a polling method. To implement this, the host should read the value on a set schedule (for example, every 2 seconds). If the host finds a value of 0x00, a power cycle or reset has occurred, and the host should set the value back to 0x01. From that point until the next power cycle or reset, the value will remain 0x01.

Changes made to this property will not persist after a power cycle or reset. After a power cycle or reset, this property has a value of 0x00 until the host changes it to 0x01.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 = Not acknowledged. Only the device can set to this value. 0x01 = Acknowledged. Do not continue to send the notification.

Default

0x00

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070101 8902 C200

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070101 8903 C201 00

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 8501 01 8704 02070101 8903 C20101

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820010 D111 8501 01 8704 02070101 8903 C201 01

Table - Property 1.2.7.1.1.3 Device Reset Will Occur Soon Notification Control

Property Description

Property OID

1.2.7.1.1.3 / 0x010207010103

Name

Device Reset Will Occur Soon Notification Control

Description

The host can use this property to control behavior of the Device Reset Will Occur Soon

notification in Notification 0x1001 - Device Information Update.

See 24 Hour Automatic Reset PCI Requirement for more information.

Changes to this property do not take effect until the device is power cycled or reset.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 = Never send this notification.

0x01..0xFF = Number of minutes before a reset to send the notification message.

Default

0x03

Table - Get Request Example

Example (Hex)

AA 00 81 04 01 55 D1 01 84 0F D1 01 85 01 01 87 04 02 07 01 01 89 02 C3 00

Table - Get Response Example

Example (Hex)

AA 00 81 04 82 55 D1 01 82 04 00 00 00 00 84 82 00 10 D1 01 85 01 01 87 04 02 07 01 01 89 03 C3

01 05

Table - Set Request Example

Example (Hex)

AA 00 81 04 01 55 D1 11 84 10 D1 11 85 01 01 87 04 02 07 01 01 89 03 C1 01 05

Table - Set Response Example

Example (Hex)

AA 00 81 04 82 55 D1 11 82 04 00 00 00 00 84 82 00 10 D1 11 85 01 01 87 04 02 07 01 01 89 03 C1

01 05

Table - Property 1.2.7.1.1.4 Auto Reset Configuration

Property Description

Property OID

1.2.7.1.1.4 / 0x010207010104

Name

Auto Reset Configuration

Description

This property controls the device’s auto reset feature. The auto reset feature can be configured such that the device automatically resets 23 hours after booting up or at a specific time of day. The auto-reset feature cannot be disabled.

See 24 Hour Automatic Reset PCI Requirement for more information.

Changes to this property do not take effect until the device is power cycled or reset.

Securing Key

None

Min. Len (b)

2

Max. Len (b)

2

Data Type

Binary

Valid Values

First byte 0 - 23 hours and second byte 0 - 59 minutes = Reset at the time of day specified. The time of day specified should be 24-hour Universal Time Coordinated (UTC). For example, values of 0 0 would be 12:00am UTC and values of 23 59 (0x17 0x3B) would be 11:59pm UTC.

First byte 0xFF and second byte 0xFF = Auto reset 23 hours after booting up.

Default

0xFF 0xFF

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070101 8902 C400

Table - Get Response Example

Example (Hex)

AA0081048255D10182040000000084820011D1018501018704020701018904C402FFFF

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8411 D111 8501 01 8704 02070101 8904 C402 FFFF

Table - Set Response Example

Example (Hex)

AA0081048255D11182040000000084820011D1118501018704020701018904C402FFFF

Table - Property 1.2.7.1.2.1 User Event Notification Controls Enable

Bit Property Description

Property OID

1.2.7.1.2.1 / 0x010207010201

Name

User Event Notifications Enable

Description

The host can use this property to enable notification reasons defined in Notification 0x1001 - Device Information Update in the User Events Category. Each bit enables a specific Reason by setting that bit to 1. Byte 0 is the first byte, bit 0 is the LSB of each byte.

The device only detects these user events and sends these notifications when it is idle. While processing a command (not idle), such as when processing a transaction with Command 0x1001 - Start Transaction, the device only sends notifications related to the command it is currently processing.

Notification reasons may consume power when idle. For example, enabling Contactless reasons requires the device to continuously consume some radio frequency power to detect the presence of a contactless card when idle. To conserve power, only enable the notification reasons that are required by the solution design, if any. The readers and their associated notifications will be disabled if the battery charge is 5 percent or lower.

Changes to this property do not take effect until the device is power cycled or reset.

Securing Key

None

Min. Len (b)

4

Max. Len (b)

4

Data Type

Binary

Valid Values

Byte 0

· bit 0 = Reason: Contactless Card Presented

· bit 1 = Reason: Contactless Card Removed

· bit 2 = Reason: Card Seated in Slot

· bit 3 = Reason: Card Unseated from Slot

· bit 4 = Reason: Card Swiped

· bit 5 = Reason: Touch Sensor Press Detected

· bit 6 = Reason: Touch Sensor Release Detected

· bit 7 = Reason: Barcode Read Detected

Byte 1

· bit 0 = Reason: Encrypt Barcode Reader Event Data

· bit 1 = Reserved (set to 0x00)

· etc.

Byte 2

· bit 0 = Reserved (set to 0x00)

· etc.

Byte 3

· bit 0 = Reserved (set to 0x00)

· etc.

Any byte / bit not listed here is reserved for future use. The host should set those values to 0, so if a future revision of firmware starts using those bits, the related notifications will be disabled and will not affect the existing host software.

Default

0x00, 0x00, 0x00, 0x00 (all User Event notifications disabled)

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070102 8902 C100

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820013 D101 8501 01 8704 02070102 8906 C1 04 00 00 00

00

Table - Set Request Example

Example (Hex)

AA00 8104 0155D111 8413 D111 8501 01 8704 02070102 8906 C1 04 03 00 00 00

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820013 D111 8501 01 8704 02070102 8906 C1 04 03 00 00

00

Table - Property 1.2.7.1.2.2 User Event Notification MSR Data Timeout (MSR Only)

Bit Property Description

Property OID

1.2.7.1.2.2 / 0x010207010202

Name

User Event Notification MSR Data Timeout

Description

This parameter defines the number of seconds the device waits for the host to take action (by sending Command 0x1001 - Start Transaction) after the device sends Notification 0x1001 - Device Information Update to report a User Event / Card Swiped event.

After this period of time passes, the device erases the buffered card data from memory.

Changes to this property do not take effect until the device is power cycled or reset.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

· 0x00 = Invalid value. (will be converted to 0x02 in the firmware)

· 0x01 to 0xFF = 1 to 255 seconds

Default

0x02 (2 seconds)

Table - Get Request Example

Example (Hex)

AA00 8104 010CD101 841A D101 8107 2B06010401F609 8501 01 890A E208E706E104E202C200

Table - Get Response Example

Example (Hex)

AA00 8104 820CD101 8204 00000000 8482001B D101 8107 2B06010401F609 8501 01 890B

E209E707E105E203C2 0102

Table - Set Request Example

Example (Hex)

AA00 8104 010DD111 841B D111 8107 2B06010401F609 8501 01 890B E209E707E105E203C2

0102

Table - Set Response Example

Example (Hex)

AA00 8104 820DD111 8204 00000000 8482001B D111 8107 2B06010401F609 8501 01 890B

E209E707E105E203C2 0102

Table - Property 1.2.7.1.3.1 Maximum Battery Charge Level (Deprecated)

Property Description

Property OID

1.2.7.1.3.1 / 0x010207010301

Name

Maximum Battery Charge Level

Description

This OID has been deprecated. The OID can be written or read but it will have no effect of the device’s behavior.

The host can use this property to control the maximum charge level for the battery. All charge percentages reported or displayed will use this percentage as 100% charged.

Setting this value to lower than 0x64 (100%) will increase the life of the battery but reduce the run time when running from the battery.

The Maximum Battery Charge Level takes effect immediately after the host changes it.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x0A..0x64

Default

0x64 (100%) if WLAN device 0x50 (80%) for all other devices

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070103 8902 C100

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070103 8903 C101 50

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 8501 01 8704 02070103 8903 C101 50

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820010 D111 8501 01 8704 02070103 8903 C101 50

Table - Property 1.2.7.1.4.1 Device Low Temperature Notification Level

Property Description

Property OID

1.2.7.1.4.1 / 0x010207010401

Name

Device Low Temperature Notification Level

Description

The device will send a low temperature notification when the device’s temperature falls below this temperature. The temperature is in degrees Celsius.

The Device Low Temperature Notification Level takes effect immediately after the host changes it.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Signed Binary

Valid Values

Temperature in Celsius:

DynaProx: 0xE2 .. 0x55 (-30 .. 85) DynaProx BCR: 0xEC .. 0x37 (-20 .. 55)

DynaFlex: 0x00 .. 0x2D (0 .. 45)

This value must be less than that set in 1.2.7.1.4.2.

Default

Temperature in Celsius: DynaProx: 0xE2 (-30 DynaProx BCR: 0xEC (-20) DynaFlex: 0x00 (0)

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070104 8902 C100

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070104 8903 C101 00

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 8501 01 8704 02070104 8903 C101 05

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820010 D111 8501 01 870402070104 8903 C101 05

Table - Property 1.2.7.1.4.2 Device High Temperature Notification Level

Property Description

Property OID

1.2.7.1.4.2 / 0x010207010402

Name

Device High Temperature Notification Level

Description

The device will send a high temperature notification when the device’s temperature rises above this temperature. The temperature is in degrees Celsius.

The Device High Temperature Notification Level takes effect immediately after the host changes it.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Signed Binary

Valid Values

Temperature in Celsius:

DynaProx: 0xE2 .. 0x55 (-30 .. 85) DynaProx BCR: 0xEC .. 0x37 (-20 .. 55)

DynaFlex: 0x00 .. 0x2D (0 .. 45)

This value must be greater than that set in 1.2.7.1.4.1.

Default

Temperature in Celsius: DynaProx: 0x55 (85) DynaProx BCR: 0x37 (55) DynaFlex: 0x2D (45)

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070104 8902 C200

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070104 8903 C201 2D

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 8501 01 8704 02070104 8903 C201 2D

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820010 D111 8501 01 870402070104 8903 C201 2D

Table - Property 1.2.7.1.4.3 Device Temperature Notification Repeat Interval

Property Description

Property OID

1.2.7.1.4.3 / 0x010207010403

Name

Device Temperature Notification Repeat Interval

Description

While the device’s temperature is outside of the range defined by Device Low Temperature Notification Level (1.2.7.1.4.1) and Device High Temperature Notification Level (1.2.7.1.4.2), notifications will be sent to the host. This property sets the period between notifications.

The Device Temperature Notification Repeat Interval takes effect immediately after the host changes it.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 Send once. Do not repeat.

0x0F .. 0xFF Repeat period in seconds. Must be multiple of 0x0F (15).

Default

0x1E (30 seconds)

Table - Get Request Example

Example (Hex)

AA00 8104 0155D101 840F D101 8501 01 8704 02070104 8902 C300

Table - Get Response Example

Example (Hex)

AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070104 8903 C301 1E

Table - Set Request Example

Example (Hex)

AA00 81040155D111 8410 D111 8501 01 8704 02070104 8903 C301 1E

Table - Set Response Example

Example (Hex)

AA00 8104 8255D111 8204 00000000 84820010 D111 8501 01 870402070104 8903 C301 1E

Last updated