Property Group 2.3.1.nnn System Status Information - 2.3.1.1.1.1 -

Table - Property 2.3.1.1.1.1 Device Key Status

Property Description

Property OID

2.3.1.1.1.1 / 0x020301010101

Name

Device Key Status

Description

This OID contains a 32-bit bitmap. Each bit indicates the status of a device key. A bit value of 1 indicates the corresponding key has been injected.

Securing Key

None

Min. Len (b)

Max. Len (b)

Data Type

Binary

Valid Values

Bit 0: TMPTK_1000

Bit 1: MTK_1001

Bit 2: DEVTK_1002

Bit 3: FINTK_1003

Bit 4: PRODTK_1021

Bit 5: MFGTK_1022

Bit 6: MFIFTK_1081

Bit 7: AKIFTK_1091

Bit 8: FREQMK_1101

Bit 9: MREQMK_1102

Bit 10: MFRQMK_1111

Bit 11: ARQ1MK_1121

Bit 12: ARQ2MK_1122

Bit 13 – 31: Reserved

Default

None

Table - Get Request Example

Example (Hex)

AA00 8104010ED101 841AD101 81072B06010401F609 850102 890AE308E106E104E102C100

Table - Get Response Example

Example (Hex)

AA00 8104820ED101 820400000000 8482001E D101 81072B06010401F609 850102 890EE30CE10AE108E106C1040000077E

Table - Property 2.3.1.1.1.2 Transaction Key Status

Property Description

Property OID

2.3.1.1.1.2 / 0x020301010102

Name

Transaction Key Status

Description

This OID contains a 32-bit bitmap. Each bit indicates the status of a transaction key. A bit value of 1 indicates the corresponding key has been injected.

Securing Key

None

Min. Len (b)

Max. Len (b)

Data Type

Binary

Valid Values

Bit 0: DKPTM0_2000 Bit 16: DKPTM10_2010

Bit 1: DKPTM1_2001 Bit 17: DKPTM11_2011

Bit 2: DKPTM2_2002 Bit 18: DKPTM12_2012

Bit 3: DKPTM3_2003 Bit 19: DKPTM13_2013

Bit 4: DKPTM4_2004 Bit 20: DKPTM14_2014

Bit 5: DKPTM5_2005 Bit 21: DKPTM15_2015

Bit 6: DKPTM6_2006 Bit 22: DKPTM16_2016

Bit 7: DKPTM7_2007 Bit 23: DKPTM17_2017

Bit 8: DKPTM8_2008 Bit 24: DKPTM18_2018

Bit 9: DKPTM9_2009 Bit 25: DKPTM19_2019

Bit 10: DKPTMA_200A Bit 26: DKPTM1A_201A

Bit 11: DKPTMB_200B Bit 27: DKPTM1B_201B

Bit 12: DKPTMC_200C Bit 28: DKPTM1C_201C

Bit 13: DKPTMD_200D Bit 29: DKPTM1D_201D

Bit 14: DKPTME_200E Bit 30: DKPTM1E_201E

Bit 15: DKPTMF_200F Bit 31: DKPTM1F_201F

Default

None

Table - Get Request Example

Example (Hex)

AA00 8104010FD101 841AD101 81072B06010401F609 850102 890AE308E106E104E102C200

Table - Get Response Example

Example (Hex)

AA00 8104820FD101 820400000000 8482001ED101 81072B06010401F609 850102 890EE30CE10AE108E106C20400000081

Table - Property 2.3.1.1.2.1 Real Time Clock Enabled

Property Description

Property OID

2.3.1.1.2.1 / 0x020301010201

Name

Real Time Clock Enabled

Description

The device maps this property to its internal register that enables its internal real-time clock. Because the device ensures that register is enabled every time it powers up, this property should always report Real Time Clock Enabled.

Securing Key

None

Min. Len (b)

Max. Len (b)

Data Type

Binary

Valid Values

0x00 = Real Time Clock Not Enabled 0x01 = Real Time Clock Enabled

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010102 8903 C101 01

Table - Property 2.3.1.1.2.2 Tamper Sensors Activated

Property Description

Property OID

2.3.1.1.2.2 / 0x020301010202

Name

Tamper Sensors Activated

Description

The device uses this property to report whether its tamper sensors have been activated using Command 0xF016 - Activate Device Security (MAGTEK INTERNAL ONLY). A device that is operating normally should always have its tamper sensors activated.

Securing Key

None

Min. Len (b)

Max. Len (b)

Data Type

Binary

Valid Values

0x00 = Tamper Sensors Not Activated

0x01 = Tamper Sensors Activated

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010102 8903 C101 01

Table - Property 2.3.1.1.2.3 Tamper Sensor Tampered

Property Description

Property OID

2.3.1.1.2.3 / 0x020301010203

Name

Tamper Sensor Tampered

Description

The device uses this property to report whether a tamper sensor has tampered. A device that is operating normally should not reported that it has been tampered with. To examine the device’s tamper history to determine the cause, use Command 0xF014 - Read Log (MAGTEK INTERNAL ONLY) or Command 0xF015 - Read Log & Clear Tamper (MAGTEK INTERNAL ONLY).

Securing Key

None

Min. Len (b)

Max. Len (b)

Data Type

Binary

Valid Values

0x00 = Not Tampered 0x01 = Tampered

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010102 8903 C301 00

Table - Property 2.3.1.2.1.1 Device Operational Status

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)

Max. Len (b)

Data Type

Binary

Valid Values

0x01 = Offline 0x02 = Online

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C101 02

Table - Property 2.3.1.2.1.2 Offline Status Detail

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)

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

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C201 00

Table - Property 2.3.1.2.1.3 External Power Supplied

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)

Max. Len (b)

Data Type

Binary

Valid Values

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

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C301 01

Table - Property 2.3.1.2.1.4 Battery State of Charge

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)

Max. Len (b)

Data Type

Binary

Valid Values

0x00..0x64

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C401 64

Table - Property 2.3.1.2.1.5 Battery Charger Status

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)

Max. Len (b)

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

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C501 04

Table - Property 2.3.1.2.1.6 Device Temperature

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)

Max. Len (b)

Data Type

Signed Binary

Valid Values

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

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C601 26

Table - Property 2.3.1.2.1.7 Device Time

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)

Max. Len (b)

Data Type

Unsigned Binary

Valid Values

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

Default

None

Table - Get Request Example

Example (Hex)

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

Table - Get Response Example

Example (Hex)

AA0081048255D10182040000000084820012D1018501028704030102018905C703040909

Last updated 21 days ago