> 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/dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.2.1.n-system-status-device-state-information.md).

# 2.3.1.2.1.n - System Status Device State Information

## 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 <a href="https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.2.1.n-system-status-device-state-information#property-2.3.1.2.1.2-offline-status-detail"><mark style="color:red;"><strong>Property 2.3.1.2.1.2 Offline Status Detail.</strong></mark></a></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>

#### 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>

#### 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>

## Property 2.3.1.2.1.2 - Offline Status Detail

<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 <a href="https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.2.1.n-system-status-device-state-information#device-operational-status-property-2.3.1.2.1.1"><mark style="color:red;"><strong>Property 2.3.1.2.1.1 Device Operational Status</strong></mark></a>.</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, <a href="https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.1.2.n-system-status-security-protection-information#property-2.3.1.1.2.2-tamper-sensors-activated"><mark style="color:red;"><strong>Property 2.3.1.1.2.2 Tamper Sensors Activated</strong></mark></a> and <a href="https://developer.magtek.com/api-and-command-reference/dynafamily-programmers-manual/properties/2.3.1.nnn-system-status-information/2.3.1.1.2.n-system-status-security-protection-information#property-2.3.1.1.2.3-tamper-sensor-tampered"><mark style="color:red;"><strong>Property 2.3.1.1.2.3 Tamper Sensor Tampered</strong></mark></a>.</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>

#### 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>

#### 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>

## Property 2.3.1.2.1.3 - External Power Supplied

<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>

#### 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>

#### 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>

## Property 2.3.1.2.1.4 - Battery State of Charge

<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>

#### 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>

#### 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>

## Property 2.3.1.2.1.5  - Battery Charger Status

<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>

#### 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>

#### 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>

## Property 2.3.1.2.1.6 - Device Temperature

<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>

## 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>

## 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>

## Property 2.3.1.2.1.7 - Device Time

<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>

#### 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>

#### 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
