> For the complete documentation index, see [llms.txt](https://docs.dnt.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dnt.de/dnt-lw-wsci/kommunikationsprotokoll/2.-geratestatus.md).
# 2. Gerätestatus
## 2.1 Status Intervall
{% tabs %}
{% tab title="GET STATUS INTERVAL" %}
Fragt das Sendeintervall ab, in dem die zyklische Statusmeldung (`Get Status (0x04)`)
gesendet wird.
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x00` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x00 (Command ID) |
| 1 | 7:0 | ID_STATUS_REPORT_INTERVAL |
{% endtab %}
{% tab title="SET STATUS INTERVAL" %}
Konfiguriert des Intervall, in dem die zyklische Statusmeldung `Get Status (0x04)`
gesendet wird.
**Beispiel**
```
0x01 09 = 5 Min. Statusintervall
```
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x01 (Command ID) |
| 1 | 7:0 | ID_STATUS_REPORT_INTERVAL |
{% endtab %}
{% endtabs %}
ID_STATUS_REPORT_INTERVAL
| Eigenschaft | Wert |
| :------------: | :-----------------------------------------------------------------------------------------: |
| Beschreibung | Definiert den Zeitraum in Sekunden, in dem das Produkt eine zyklische Statusmeldung sendet. |
| Größe | 8 Bit |
| Wertebereich | 0–255 |
| Standardwert | 240 |
| Interpretation | `y = x * 360 + 30; [y] = s` |
***
## 2.2 Statusparameter
{% tabs %}
{% tab title="GET STATUS PARAMETER TX ENABLE REGISTER" %}
Nach erfolgreicher Verbindung mit dem LoRaWAN-Netzwerk sendet das Produkt die\
Antwort auf diesen Befehl einmal automatisch. Das Register zeigt, ob der Sensor Status-in formationen z.B. die Batteriespannung sendet
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x02` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x02 (Command ID) |
| 1 | 7:0 | ID_STATUS_PARAM_TX_EN_REG |
{% endtab %}
{% tab title="SET STATUS PARAMETER TX ENABLE REGISTER" %}
Setzt den Parameter ID\_STATUS\_PARAM\_TX\_EN\_REG. Das Register bestimmt, welche Variablen im Rahmen des zyklischen Status-Uplinks (0x04) gesendet werden.
**Beispiel**
```
0x03 F0 = Batteriespannung, Sabotagekontakt, Hall-Sensor und Anschlussklemmen aktiv
```
**Downlink**
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x03 (Command ID) |
| 1 | 7:0 | ID_STATUS_PARAM_TX_EN_REG |
{% endtab %}
{% endtabs %}
ID_STATUS_PARAM_TX_EN_REG
| Eigenschaft | Wert |
| -------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| Beschreibung | Aktiviert oder deaktiviert Parameter im zyklischen Status-Uplink. |
| Größe | 8 Bit |
| Wertebereich | 0–255 |
| Standardwert | `240` |
| Interpretation | Bit 7 = ID\_BATTERY\_VOLTAGE
Bit 6 = ID\_SABOTAGE\_CONTACT\_STATE
Bit 5 = ID\_HALL\_SENSOR\_STATE
Bit 4 = ID\_INPUT\_CLAMP\_STATE
Bit 0:3 = Res.
|
***
## 2.3 Get Status
{% tabs %}
{% tab title="GET STATUS" %}
Fragt die Statusmeldung des Produkts ab und wird automatisch zyklisch vom Produkt gesendet. Dieser Frame wird nach erfolgreicher Initialisierung des Produkts automatisch periodisch gesendet. Den Inhalt des Frames können Sie über `ID_STATUS_PARAM_TX_EN_REG (0x03)` konfigurieren.
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x04` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x04 (Command ID) |
| 1 | 7:0 | ID_STATUS_PARAM_TX_EN_REG |
| 2 | 7:0 | ID_BATTERY_VOLTAGE |
| 3 | 7:0 | ID_SABOTAGE_CONTACT_STATE |
| 4 | 7:0 | ID_HALL_SENSOR_STATE |
| 5 | 7:0 | ID_CLAMP_STATE |
{% endtab %}
{% endtabs %}
ID_STATUS_PARAM_TX_EN_REG
| Eigenschaft | Wert |
| -------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| Beschreibung | Aktiviert oder deaktiviert Parameter im zyklischen Status-Uplink. |
| Größe | 8 Bit |
| Wertebereich | 0–255 |
| Standardwert | `240` |
| Interpretation | Bit 7 = ID\_BATTERY\_VOLTAGE
Bit 6 = ID\_SABOTAGE\_CONTACT\_STATE
Bit 5 = ID\_HALL\_SENSOR\_STATE
Bit 4 = ID\_INPUT\_CLAMP\_STATE
Bit 0:3 = Res.
|
ID_BATTERY_VOLTAGE
| Eigenschaft | Wert |
|---|
| Beschreibung | Aktuelle Batteriespannung des Gerätes. |
| Größe | 8 Bit |
| Wertebereich | 0 - 255 |
| Standardwert | - |
| Interpretation | y = x * 10 + 1500 — [y] = mV |
| Persistent | Nein |
| Zugriff | r |
ID_SABOTAGE_CONTACT_STATE
| Eigenschaft | Wert |
| -------------- | :-----------------------------------------------------------------------------------------------------: |
| Beschreibung | Zustand des Sabotage Kontakts |
| Größe | 8 Bit |
| Wertebereich | 0–1 |
| Standardwert | 1 |
| Interpretation | 0 = Sabotagekontakt nicht ausgelöst
1= Sabotagekontakt ausgelöst
|
ID_HALL_SENSOR_STATE
| Eigenschaft | Wert |
| -------------- | :----------------------------------------------------------------------------------------------: |
| Beschreibung | Zustand des Hall Sensors |
| Größe | 8 Bit |
| Wertebereich | 0 - 1 |
| Standardwert | 0 |
| Interpretation | 0 = Hall Sensor nicht ausgelöst
1 = Hall Sensor ausgelöst
|
ID_CLAMP_STATE
| Eigenschaft | Wert |
| -------------- | :-----------------------------------------------------------------------------------------------------: |
| Beschreibung | Zustand der Eingangsklemme |
| Größe | 8 Bit |
| Wertebereich | 0–1 |
| Standardwert | 0 |
| Interpretation | 0 = Eingangsklemme nicht ausgelöst
1 = Eingangsklemme ausgelöst
|
***
## 2.4 Get Battery Voltage
{% tabs %}
{% tab title="GET BATTERY VOLTAGE" %}
Fragt die aktuelle Versorgungsspannung der Batterien ab.
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x05` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
| :-----------: | :----: | :------------------: |
| 0 | 7:0 | `0x05` (Command ID) |
| 1 | 7:0 | `ID_BATTERY_VOLTAGE` |
| {% endtab %} | | |
| {% endtabs %} | | |
ID_BATTERY_VOLTAGE
| Eigenschaft | Wert |
|---|
| Beschreibung | Aktuelle Batteriespannung des Gerätes. |
| Größe | 8 Bit |
| Wertebereich | 0 - 255 |
| Standardwert | - |
| Interpretation | y = x * 10 + 1500 — [y] = mV |
| Persistent | Nein |
| Zugriff | r |
***
## 2.5 Get Sabotage Contact State
{% tabs %}
{% tab title="GET SABOTAGE CONTACT STATE" %}
#### 1.5 Sabotagekontaktzustand
Fragt den Zustand des Sabotagekontakts ab: ausgelöst, unausgelöst oder deaktiviert
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x06` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
|---|
| 0 | 7:0 | 0x06 (Command ID) |
| 1 | 7:0 | ID_SABOTAGE_CONTACT_STATE |
{% endtab %}
{% endtabs %}
ID_SABOTAGE_CONTACT_STATE
| Eigenschaft | Wert |
| -------------- | :-------------------------------------------------------------------------------------------: |
| Beschreibung | Zustand des Sabotage Kontakts |
| Größe | 1 Bit |
| Wertebereich | 0–1 |
| Standardwert | 1 |
| Interpretation | 0 = Sabotage Contact idle
1= Sabotag Contact triggered
|
## 2.6 Get Error Code
{% tabs %}
{% tab title="GET ERROR CODE" %}
#### 1.6 Fehlercode
Fehlercodes werden automatisch vom Produkt gesendet, sobald ein Fehler auftritt.
**Downlink**
| Byte | Bit(s) | Value |
| :--: | :----: | :-----------------: |
| 0 | 7:0 | `0x07` (Command ID) |
**Uplink**
| Byte | Bit(s) | Value |
| :-----------: | :----: | :-----------------: |
| 0 | 7:0 | `0x07` (Command ID) |
| 1 | 7:0 | `ID_ERROR_CODE` |
| {% endtab %} | | |
| {% endtabs %} | | |
ID_ERROR_CODE
| Eigenschaft | Wert |
| -------------- | :-------------------: |
| Beschreibung | Fehlercode des Geräts |
| Größe | 8 Bit |
| Wertebereich | 0–255 |
| Standardwert | 0 |
| Interpretation | 0 = `DEVICE_READY` |
---
# 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://docs.dnt.de/dnt-lw-wsci/kommunikationsprotokoll/2.-geratestatus.md?ask=&goal=
```
`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.