> 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-wth/kommunikationsprotokoll/3.-geratezeit.md). # 3. Gerätezeit ## 3.1 Gerätezeit {% tabs %} {% tab title="GET DEVICE TIME" %} Liest die lokale Gerätezeit aus. **Downlink** | Byte | Bit(s) | Value | | :--: | :----: | :-----------------: | | 0 | 7 | `IR` | | 0 | 6:0 | `0x08` (Command ID) | **Uplink** | Byte | Bit(s) | Value | | :----------: | :----: | :---------------------: | | 0 | 7 | Res. | | 0 | 6:0 | `0x08` (Command ID) | | 1 | 7:6 | Res. | | 1 | 5:0 | `ID_LOCAL_TIME_SECOND` | | 2 | 7:2 | `ID_LOCAL_TIME_MINUTE` | | 2 | 1:0 | `ID_LOCAL_TIME_HOUR` | | 3 | 7:5 | `ID_LOCAL_TIME_HOUR` | | 3 | 4:0 | `ID_LOCAL_TIME_DAY` | | 4 | 7 | `ID_LOCAL_TIME_DST` | | 4 | 6:4 | `ID_LOCAL_TIME_WEEKDAY` | | 4 | 3:0 | `ID_LOCAL_TIME_MONTH` | | 5 | 7:0 | `ID_LOCAL_TIME_YEAR` | | 6 | 7:0 | `ID_UTC(_DST)_OFFSET` | | {% endtab %} | | | {% tab title="SET DEVICE TIME" %} Setzt die globale Gerätezeit. Dafür muss `ID_AUTO_TIME_SYNC_EN = 0` sein. **Beispiel** ``` 0x09 7A 6F 03 1A = 15.04.2026, 14:30 UTC ``` | Byte | Bit(s) | Value | | :-----------: | :----: | :------------------------: | | 0 | 7 | Res. | | 0 | 6:0 | `0x09` (Command ID) | | 1 | 7:2 | `ID_GLOBAL_TIME_MINUTE` | | 1 | 1:0 | `ID_GLOBAL_TIME_HOUR[4:3]` | | 2 | 7:5 | `ID_GLOBAL_TIME_HOUR[2:0]` | | 2 | 4:0 | `ID_GLOBAL_TIME_DAY` | | 3 | 7:4 | Res. | | 3 | 3:0 | `ID_GLOBAL_TIME_MONTH` | | 4 | 7:0 | `ID_GLOBAL_TIME_YEAR` | | {% endtab %} | | | | {% endtabs %} | | |
ID_LOCAL_TIME_SECOND | Eigenschaft | Wert | | :------------: | :---------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Sekunden. | | Größe | 6 Bit | | Wertebereich | 0 - 59 | | Standardwert | - | | Interpretation | `y = x` — `[y] = s` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_MINUTE | Eigenschaft | Wert | | :------------: | :--------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Minuten. | | Größe | 6 Bit | | Wertebereich | 0 - 59 | | Standardwert | - | | Interpretation | `y = x` — `[y] = min` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_HOUR | Eigenschaft | Wert | | :------------: | :--------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Stunden. | | Größe | 5 Bit | | Wertebereich | 0 - 23 | | Standardwert | - | | Interpretation | `y = x` — `[y] = h` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_DAY | Eigenschaft | Wert | | :------------: | :----------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Tag. | | Größe | 5 Bit | | Wertebereich | 1 - 31 | | Standardwert | - | | Interpretation | `y = x` — `[y] = d` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_WEEKDAY | Eigenschaft | Wert | | :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Wochentag. | | Größe | 3 Bit | | Wertebereich | 0 - 6 | | Standardwert | - | | Interpretation |

0 → Montag

1 → Dienstag

2 → Mittwoch

3 → Donnerstag

4 → Freitag

5 → Samstag

6 → Sonntag

| | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_MONTH | Eigenschaft | Wert | | :------------: | :------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Monat. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | - | | Interpretation | `y = x + 1` — `[y] = Monat` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_YEAR | Eigenschaft | Wert | | :------------: | :-----------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Jahr. | | Größe | 8 Bit | | Wertebereich | 0 - 37 | | Standardwert | - | | Interpretation | `y = x + 2000` — `[y] = a` | | Persistent | Nein | | Zugriff | r |
ID_LOCAL_TIME_DST | Eigenschaft | Wert | | :------------: | :-------------------------------------------------------------------------------: | | Beschreibung | Lokale Zeit des Gerätes — Sommer-/Winterzeit. | | Größe | 1 Bit | | Wertebereich | 0 - 1 | | Standardwert | - | | Interpretation |

0 → Sommerzeit aktiv

1 → Winterzeit aktiv

| | Persistent | Nein | | Zugriff | r |
ID_UTC(_DST)_OFFSET | Eigenschaft | Wert | | :------------: | :----------------------------------: | | Beschreibung | Aktiver UTC-Offset der lokalen Zeit. | | Größe | 7 Bit | | Wertebereich | 0 - 96 | | Standardwert | - | | Interpretation | `y = x * 0,25 - 12` — `[y] = h` | | Persistent | Nein | | Zugriff | r |
ID_GLOBAL_TIME_MINUTE | Eigenschaft | Wert | | :------------: | :----------------------------------------------------------: | | Beschreibung | Minute der koordinierten Weltzeit zum Setzen der Gerätezeit. | | Größe | 6 Bit | | Wertebereich | 0 - 59 | | Standardwert | - | | Interpretation | `y = x` — `[y] = min` | | Persistent | Nein | | Zugriff | w |
ID_GLOBAL_TIME_HOUR | Eigenschaft | Wert | | :------------: | :----------------------------------------------------------: | | Beschreibung | Stunde der koordinierten Weltzeit zum Setzen der Gerätezeit. | | Größe | 5 Bit | | Wertebereich | 0 - 23 | | Standardwert | - | | Interpretation | `y = x` — `[y] = h` | | Persistent | Nein | | Zugriff | w |
ID_GLOBAL_TIME_DAY | Eigenschaft | Wert | | :------------: | :-------------------------------------------------------: | | Beschreibung | Tag der koordinierten Weltzeit zum Setzen der Gerätezeit. | | Größe | 5 Bit | | Wertebereich | 1 - 31 | | Standardwert | - | | Interpretation | `y = x` — `[y] = d` | | Persistent | Nein | | Zugriff | w |
ID_GLOBAL_TIME_MONTH | Eigenschaft | Wert | | :------------: | :---------------------------------------------------------: | | Beschreibung | Monat der koordinierten Weltzeit zum Setzen der Gerätezeit. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | - | | Interpretation | `y = x + 1` — `[y] = Monat` | | Persistent | Nein | | Zugriff | w |
ID_GLOBAL_TIME_YEAR | Eigenschaft | Wert | | :------------: | :--------------------------------------------------------: | | Beschreibung | Jahr der koordinierten Weltzeit zum Setzen der Gerätezeit. | | Größe | 8 Bit | | Wertebereich | 0 - 37 | | Standardwert | - | | Interpretation | `y = x + 2000` — `[y] = a` | | Persistent | Nein | | Zugriff | w |
## 3.2 Gerätezeit-Konfiguration {% tabs %} {% tab title="GET DEVICE TIME CONFIG" %} Liest die Gerätezeit-Konfiguration aus. **Downlink** | Byte | Bit(s) | Value | | :--: | :----: | :-----------------: | | 0 | 7 | `IR` | | 0 | 6:0 | `0x0A` (Command ID) | **Uplink**
ByteBit(s)Value
07Res.
06:00x0A (Command ID)
17ID_AUTO_TIME_SYNC_EN
16:0ID_UTC_OFFSET
27Res.
26:4ID_UTC_DST_START_WEEK_OF_MONTH
23:0ID_UTC_DST_START_MONTH
37:5ID_UTC_DST_START_WEEKDAY
34:0ID_UTC_DST_START_HOUR
47Res.
46:0ID_UTC_DST_OFFSET
57Res.
56:4ID_UTC_DST_STOP_WEEK_OF_MONTH
53:0ID_UTC_DST_STOP_MONTH
67:5ID_UTC_DST_STOP_WEEKDAY
64:0ID_UTC_DST_STOP_HOUR
77:4ID_UTC_DST_START_MINUTE
73:0ID_UTC_DST_STOP_MINUTE
{% endtab %} {% tab title="SET DEVICE TIME CONFIG" %} Setzt die Gerätezeit-Konfiguration. **Beispiel** ``` 0x0B B4 52 02 38 59 03 00 = Auto-Sync aktiv, UTC+1 im Winter, UTC+2 im Sommer, Umstellung am letzten Sonntag im März bzw. Oktober ``` | Byte | Bit(s) | Value | | :-----------: | :----: | :------------------------------: | | 0 | 7 | Res. | | 0 | 6:0 | `0x0B` (Command ID) | | 1 | 7 | `ID_AUTO_TIME_SYNC_EN` | | 1 | 6:0 | `ID_UTC_OFFSET` | | 2 | 7 | Res. | | 2 | 6:4 | `ID_UTC_DST_START_WEEK_OF_MONTH` | | 2 | 3:0 | `ID_UTC_DST_START_MONTH` | | 3 | 7:5 | `ID_UTC_DST_START_WEEKDAY` | | 3 | 4:0 | `ID_UTC_DST_START_HOUR` | | 4 | 7 | Res. | | 4 | 6:0 | `ID_UTC_DST_OFFSET` | | 5 | 7 | Res. | | 5 | 6:4 | `ID_UTC_DST_STOP_WEEK_OF_MONTH` | | 5 | 3:0 | `ID_UTC_DST_STOP_MONTH` | | 6 | 7:5 | `ID_UTC_DST_STOP_WEEKDAY` | | 6 | 4:0 | `ID_UTC_DST_STOP_HOUR` | | 7 | 7:4 | `ID_UTC_DST_START_MINUTE` | | 7 | 3:0 | `ID_UTC_DST_STOP_MINUTE` | | {% endtab %} | | | | {% endtabs %} | | |
ID_AUTO_TIME_SYNC_EN | Eigenschaft | Wert | | :------------: | :-----------------------------------------------------------------------------: | | Beschreibung | Aktiviert oder deaktiviert die automatische Zeitsynchronisation mit dem Server. | | Größe | 1 Bit | | Wertebereich | 0 - 1 | | Standardwert | 1 | | Interpretation |

0 → deaktiviert

1 → aktiviert

| | Persistent | Ja | | Zugriff | r/w |
ID_UTC_OFFSET | Eigenschaft | Wert | | :------------: | :----------------------------------------: | | Beschreibung | Abweichung der lokalen Winterzeit von UTC. | | Größe | 7 Bit | | Wertebereich | 0 - 96 | | Standardwert | 52 | | Interpretation | `y = x * 0,25 - 12` — `[y] = h` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_START_WEEK_OF_MONTH | Eigenschaft | Wert | | :------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Beschreibung | Angabe, an wievieltem Wochentag eines Monats die Sommerzeit beginnt. | | Größe | 3 Bit | | Wertebereich | 1 - 5 | | Standardwert | 5 | | Interpretation |

1 → 1. Wochentag

2 → 2. Wochentag

3 → 3. Wochentag

4 → 4. Wochentag

5 → letzter Wochentag

| | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_START_MONTH | Eigenschaft | Wert | | :------------: | :-----------------------------------: | | Beschreibung | Monat, in dem die Sommerzeit beginnt. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | 2 | | Interpretation | `y = x + 1` — `[y] = Monat` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_START_WEEKDAY | Eigenschaft | Wert | | :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Beschreibung | Wochentag, an dem die Sommerzeit beginnt. | | Größe | 3 Bit | | Wertebereich | 0 - 6 | | Standardwert | 0 | | Interpretation |

0 → Sonntag

1 → Montag

2 → Dienstag

3 → Mittwoch

4 → Donnerstag

5 → Freitag

6 → Samstag

| | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_START_HOUR | Eigenschaft | Wert | | :------------: | :------------------------------------: | | Beschreibung | Stunde, in der die Sommerzeit beginnt. | | Größe | 5 Bit | | Wertebereich | 0 - 23 | | Standardwert | 2 | | Interpretation | `y = x` — `[y] = h` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_OFFSET | Eigenschaft | Wert | | :------------: | :----------------------------------------: | | Beschreibung | Abweichung der lokalen Sommerzeit von UTC. | | Größe | 7 Bit | | Wertebereich | 0 - 96 | | Standardwert | 56 | | Interpretation | `y = x * 0,25 - 12` — `[y] = h` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_STOP_WEEK_OF_MONTH | Eigenschaft | Wert | | :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Beschreibung | Angabe, an wievieltem Wochentag eines Monats die Sommerzeit endet. | | Größe | 3 Bit | | Wertebereich | 1 - 5 | | Standardwert | 5 | | Interpretation |

1 → 1. Wochentag

2 → 2. Wochentag

3 → 3. Wochentag

4 → 4. Wochentag

5 → letzter Wochentag

| | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_STOP_MONTH | Eigenschaft | Wert | | :------------: | :---------------------------------: | | Beschreibung | Monat, in dem die Sommerzeit endet. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | 9 | | Interpretation | `y = x + 1` — `[y] = Monat` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_STOP_WEEKDAY | Eigenschaft | Wert | | :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | Beschreibung | Wochentag, an dem die Sommerzeit endet. | | Größe | 3 Bit | | Wertebereich | 0 - 6 | | Standardwert | 0 | | Interpretation |

0 → Sonntag

1 → Montag

2 → Dienstag

3 → Mittwoch

4 → Donnerstag

5 → Freitag

6 → Samstag

| | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_STOP_HOUR | Eigenschaft | Wert | | :------------: | :----------------------------------: | | Beschreibung | Stunde, in der die Sommerzeit endet. | | Größe | 5 Bit | | Wertebereich | 0 - 23 | | Standardwert | 3 | | Interpretation | `y = x` — `[y] = h` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_START_MINUTE | Eigenschaft | Wert | | :------------: | :------------------------------------: | | Beschreibung | Minute, in der die Sommerzeit beginnt. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | 0 | | Interpretation | `y = x * 5` — `[y] = min` | | Persistent | Ja | | Zugriff | r/w |
ID_UTC_DST_STOP_MINUTE | Eigenschaft | Wert | | :------------: | :----------------------------------: | | Beschreibung | Minute, in der die Sommerzeit endet. | | Größe | 4 Bit | | Wertebereich | 0 - 11 | | Standardwert | 0 | | Interpretation | `y = x * 5` — `[y] = min` | | Persistent | Ja | | Zugriff | r/w |
--- # 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-wth/kommunikationsprotokoll/3.-geratezeit.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.