> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/system-status-information-property-group-2.3.1.nnn/system-status-device-state-information-property-subgroup-2.3.1.2.1.n.md).

# System Status Device State Information - Property Subgroup 2.3.1.2.1.n

## Table SSDS-1 - Device Operational Status - Property 2.3.1.2.1.1&#x20;

<table data-header-hidden><thead><tr><th width="232" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.1 / 0x020301020101</td></tr><tr><td valign="top">Name</td><td>Device Operational Status</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>The device uses this property to report its operational status.</p><p> </p><p>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.</p><p>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.</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x01 = Offline 0x02 = Online</td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-2 - Device Operational Status - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C100</td></tr></tbody></table>

## Table SSDS-3 - Device Operational Status - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C101 02</td></tr></tbody></table>

## Table SSDS-4 - Offline Status Detail - Property 2.3.1.2.1.2&#x20;

<table data-header-hidden><thead><tr><th width="214.6666259765625" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.2 / 0x020301020102</td></tr><tr><td valign="top">Name</td><td>Offline Status Detail</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p> </p><p>Description</p></td><td><p>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.</p><p> </p><p>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.</p><p>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.</p></td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>16 (reserved for future expansion)</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top"><p> </p><p> </p><p> </p><p> </p><p>Valid Values</p></td><td><p>Byte 0</p><p>·         Bit 0 = Tamper problem present</p><p>·         Bit 1 = Master Key problem present</p><p>·         Bit 2 = Keys and Certificates problem present</p><p>·         Bit 3 = Real Time Clock problem present</p><p>·         Bit 4 = Random Number Generator problem present</p><p>·         Bit 5 = Cryptography Engine problem present</p><p>·         Bit 6 = Magnetic Stripe Reader Hardware problem present</p><p>·         Bit 7 = Reserved</p></td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-5 - Offline Status Detail - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C200</td></tr></tbody></table>

## Table SSDS-6 - Offline Status Detail - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C201 00</td></tr></tbody></table>

## Table SSDS-7 - Property External Power Supplied - 2.3.1.2.1.3&#x20;

<table data-header-hidden><thead><tr><th width="222" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.3 / 0x020301020103</td></tr><tr><td valign="top">Name</td><td>External Power Supplied</td></tr><tr><td valign="top">Description</td><td>The device uses this property to report the status of external power.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x00 = No external power supplied 0x01 = Power supplied by USB port</td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-8 - External Power Supplied - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C300</td></tr></tbody></table>

## Table SSDS-9 - External Power Supplied - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C301 01</td></tr></tbody></table>

## Table SSDS-10 - Battery State of Charge - Property 2.3.1.2.1.4&#x20;

<table data-header-hidden><thead><tr><th width="236" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.4 / 0x020301020104</td></tr><tr><td valign="top">Name</td><td>Battery State of Charge</td></tr><tr><td valign="top">Description</td><td>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.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x00..0x64</td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-11 - Battery State of Charge - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C400</td></tr></tbody></table>

## Table SSDS-12 - Battery State of Charge - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C401 64</td></tr></tbody></table>

## Table SSDS-13 - Battery Charger Status - Property 2.3.1.2.1.5&#x20;

<table data-header-hidden><thead><tr><th valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.5 / 0x020301020105</td></tr><tr><td valign="top">Name</td><td>Battery Charger Status</td></tr><tr><td valign="top">Description</td><td>The device uses this property to report the status of the battery charger.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Binary</td></tr><tr><td valign="top"><p> </p><p> </p><p>Valid Values</p></td><td><p>0x00 = Precharge</p><p>0x01 = Fast charge – constant current </p><p>0x02 = Fast charge – constant voltage </p><p>0x03 = End of charge</p><p>0x04 = Charge complete</p><p>0x08 = No external power supplied</p></td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-14 - Battery Charger Status - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C500</td></tr></tbody></table>

## Table SSDS-15 - Battery Charger Status - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C501 04</td></tr></tbody></table>

## Table SSDS-16 - Device Temperature - Property 2.3.1.2.1.6&#x20;

<table data-header-hidden><thead><tr><th width="233.3333740234375" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.6 / 0x020301020106</td></tr><tr><td valign="top">Name</td><td>Device Temperature</td></tr><tr><td valign="top">Description</td><td>The device uses this property to report the temperature in Celsius</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>1</td></tr><tr><td valign="top">Max. Len (b)</td><td>1</td></tr><tr><td valign="top">Data Type</td><td>Signed Binary</td></tr><tr><td valign="top">Valid Values</td><td>0x80 .. 0x7F (-128 .. 127)</td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-17 - Device Temperature - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C600</td></tr></tbody></table>

## Table SSDS-18 - Device Temperature - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 81048255D101 820400000000 84820010 D101 850102 870403010201 8903 C601 26</td></tr></tbody></table>

## Table SSDS-19 - Device Time - Property 2.3.1.2.1.7&#x20;

<table data-header-hidden><thead><tr><th width="198.54547119140625" valign="top"></th><th></th></tr></thead><tbody><tr><td valign="top">Property Description</td><td></td></tr><tr><td valign="top">Property OID</td><td>2.3.1.2.1.7 / 0x020301020107</td></tr><tr><td valign="top">Name</td><td>Device Time</td></tr><tr><td valign="top">Description</td><td>The device uses this property to report the device RTC time. It returns the time in 24 hour clock format HH:MM:SS.</td></tr><tr><td valign="top">Securing Key</td><td>None</td></tr><tr><td valign="top">Min. Len (b)</td><td>3</td></tr><tr><td valign="top">Max. Len (b)</td><td>3</td></tr><tr><td valign="top">Data Type</td><td>Unsigned Binary</td></tr><tr><td valign="top">Valid Values</td><td>HH (0x00 – 0x17) MM (0x00 – 0x3B) SS(0x00 – 3B)</td></tr><tr><td valign="top">Default</td><td>None</td></tr></tbody></table>

## Table SSDS-20 - Device Time - Get Request Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA00 8104 0155D101 840F D101 8501 02 8704 03010201 8902 C700</td></tr></tbody></table>

## Table SSDS-21 - Device Time - Get Response Example

<table data-header-hidden><thead><tr><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Example (Hex)</td></tr><tr><td valign="top">AA0081048255D10182040000000084820012D1018501028704030102018905C703040909</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/system-status-information-property-group-2.3.1.nnn/system-status-device-state-information-property-subgroup-2.3.1.2.1.n.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
