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
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
Device Operational Status - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C100
Device Operational Status - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C101 02
Offline Status Detail - Property 2.3.1.2.1.2
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.
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
· Bit 7 = Reserved
Default
None
Offline Status Detail - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C200
Offline Status Detail - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C201 00
Property External Power Supplied - 2.3.1.2.1.3
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.
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
External Power Supplied - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C300
External Power Supplied - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C301 01
Battery State of Charge - Property 2.3.1.2.1.4
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.
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Binary
Valid Values
0x00..0x64
Default
None
Battery State of Charge - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C400
Battery State of Charge - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C401 64
Battery Charger Status - Property 2.3.1.2.1.5
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.
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
Battery Charger Status - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C500
Battery Charger Status - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C501 04
Device Temperature - Property 2.3.1.2.1.6
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
Securing Key
None
Min. Len (b)
1
Max. Len (b)
1
Data Type
Signed Binary
Valid Values
0x80 .. 0x7F (-128 .. 127)
Default
None
Device Temperature - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C600
Device Temperature - Get Response Example
Example (Hex)
AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C601 26
Device Time - Property 2.3.1.2.1.7
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.
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
Device Time - Get Request Example
Example (Hex)
AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C700
Device Time - Get Response Example
Example (Hex)
AA0081048255D10182040000000084820012D1018501028704030102018905C703040909
Last updated