All pages
Powered by GitBook
1 of 1

Loading...

2.3.1.2.1.n - System Status Device State Information

Device Operational Status - Property 2.3.1.2.1.1

Property Description

Property OID

2.3.1.2.1.1 / 0x020301020101

Name

Device Operational Status

Securing Key

None

Min. Len (b)

1

Max. Len (b)

16 (reserved for future expansion)

Data Type

Binary

Valid Values

Byte 0

· Bit 0 = Tamper problem present

· Bit 1 = Master Key problem present

· Bit 2 = Keys and Certificates problem present

· Bit 3 = Real Time Clock problem present

· Bit 4 = Random Number Generator problem present

· Bit 5 = Cryptography Engine problem present

· Bit 6 = Magnetic Stripe Reader Hardware problem present

Default

None

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 = No external power supplied 0x01 = Power supplied by USB port

Default

None

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00..0x64

Default

None

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x00 = Precharge

0x01 = Fast charge – constant current

0x02 = Fast charge – constant voltage

0x03 = End of charge

0x04 = Charge complete

0x08 = No external power supplied

Default

None

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Signed Binary

Valid Values

0x80 .. 0x7F (-128 .. 127)

Default

None

Securing Key

None

Min. Len (b)

3

Max. Len (b)

3

Data Type

Unsigned Binary

Valid Values

HH (0x00 – 0x17) MM (0x00 – 0x3B) SS(0x00 – 3B)

Default

None

Description

The device uses this property to report its operational status.

Online is the status the manufacturer populates in this property before shipping, and is the result of the device going through processes that configure its security subsystems and features. In this state, the device is fully functional and can perform transactions.

Offline means the device is no longer fully functional and can no longer perform transactions. The device automatically transitions to this state if it detects a problem with security or any of the subsystems it checks. For example, trying to open the device triggers a tamper response, which causes the device to change its operational status to Offline. To retrieve more information about the cause of an Offline status, the host can retrieve Property 2.3.1.2.1.2 Offline Status Detail.

Securing Key

None

Min. Len (b)

1

Max. Len (b)

1

Data Type

Binary

Valid Values

0x01 = Offline 0x02 = Online

Default

None

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C100

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C101 02

Property Description

Property OID

2.3.1.2.1.2 / 0x020301020102

Name

Offline Status Detail

Description

The device uses this property to report the status of every subsystem that can cause the device’s operation status to be set to Offline in Property 2.3.1.2.1.1 Device Operational Status.

The property consists of a sequence of bytes where each bit in each byte represents the status of a subsystem. If a bit is set to one, then there is a problem with the subsystem, otherwise no problem was detected.

Some subsystems provide other properties or commands that can be used to get more information about the subsystem’s status. For example, Property 2.3.1.1.2.2 Tamper Sensors Activated and Property 2.3.1.1.2.3 Tamper Sensor Tampered.

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C200

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C201 00

Property Description

Property OID

2.3.1.2.1.3 / 0x020301020103

Name

External Power Supplied

Description

The device uses this property to report the status of external power.

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C300

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C301 01

Property Description

Property OID

2.3.1.2.1.4 / 0x020301020104

Name

Battery State of Charge

Description

The device uses this property to report the charge status of the internal battery. The charge status is reported as a percentage of full charge.

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C400

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C401 64

Property Description

Property OID

2.3.1.2.1.5 / 0x020301020105

Name

Battery Charger Status

Description

The device uses this property to report the status of the battery charger.

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C500

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C501 04

Property Description

Property OID

2.3.1.2.1.6 / 0x020301020106

Name

Device Temperature

Description

The device uses this property to report the temperature in Celsius

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C600

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C601 26

Property Description

Property OID

2.3.1.2.1.7 / 0x020301020107

Name

Device Time

Description

The device uses this property to report the device RTC time. It returns the time in 24 hour clock format HH:MM:SS.

Example (Hex)

AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C700

Example (Hex)

AA0081048255D10182040000000084820012D1018501028704030102018905C703040909

Device Operational Status - Get Request Example

Device Operational Status - Get Response Example

Offline Status Detail - Property 2.3.1.2.1.2

Offline Status Detail - Get Request Example

Offline Status Detail - Get Response Example

Property External Power Supplied - 2.3.1.2.1.3

External Power Supplied - Get Request Example

External Power Supplied - Get Response Example

Battery State of Charge - Property 2.3.1.2.1.4

Battery State of Charge - Get Request Example

Battery State of Charge - Get Response Example

Battery Charger Status - Property 2.3.1.2.1.5

Battery Charger Status - Get Request Example

Battery Charger Status - Get Response Example

Device Temperature - Property 2.3.1.2.1.6

Device Temperature - Get Request Example

Device Temperature - Get Response Example

Device Time - Property 2.3.1.2.1.7

Device Time - Get Request Example

Device Time - Get Response Example

· Bit 7 = Reserved