---
title: "Geminox THRi"
description: "Kocioł gazowy kondensacyjny Geminox THRi podłączony przez bramkę Amit DM-OT2 OpenTherm-Modbus RTU."
url: "https://taphome.com/pl/compatibility/geminox-thri/"
language: pl
lastmod: 2026-03-20
generator: hugo
ai:
  topics: ["modbus-rtu","boiler","opentherm","rs485","gateway","dhw"]
  questions: ["Jak zintegrować kocioł Geminox THRi z TapHome?","Co kontroluje szablon Geminox THRi w TapHome?","Jak podłączyć bramkę Amit DM-OT2 OpenTherm do TapHome przez RS-485?","Jak ustawić adres przełącznikami DIP na Amit DM-OT2?","Jak działa mechanizm odczytu dodatkowych rejestrów OpenTherm?","Jak sterować temperaturą ogrzewania i CWU na kotle Geminox THRi?"]
---

# Geminox THRi

Komunikacja: Modbus RTU

- [Strona produktowa Amit DM-OT2](https://amitomation.cz/en/product/communication-converters/dm-ot2/)

Geminox THRi to gazowy kocioł kondensacyjny podłączony do TapHome przez bramkę Amit DM-OT2 (OpenTherm na Modbus RTU). DM-OT2 tłumaczy protokół OpenTherm kotła na rejestry holding Modbus RTU, dając TapHome dostęp do czujników temperatury, termostatów ogrzewania i CWU, stanu palnika oraz monitorowania mocy źródła ciepła.

Szablon wykorzystuje rejestry bitmaskowe do statusu i sterowania (H:100 i H:200), rejestry Float do temperatur i ciśnienia oraz cykliczny mechanizm odczytu dodatkowych rejestrów OT do pobierania wartości min/max z data-ID OpenTherm, które nie są zmapowane na standardowe rejestry.

## Podłączenie sprzętowe

### Przegląd bramki

Amit DM-OT2 to konwerter montowany na szynie DIN z galwanicznie izolowanym interfejsem RS-485 i interfejsem OpenTherm/+. Działa jako master OpenTherm komunikujący się z kotłem oraz jako slave Modbus RTU na magistrali RS-485.

### Dane techniczne

- **Zasilanie:** 20–30 V DC, max 30 mA
- **Temperatura pracy:** -40 °C do +70 °C
- **Protokół:** Modbus RTU Slave, RS-485
- **Prędkość transmisji:** 9600, bez parzystości, 2 bity stopu
- **Max konwerterów:** 63 w jednej sieci RS-485
- **Izolacja RS-485:** Galwaniczna, 500 V AC
- **Montaż:** Szyna DIN 35 mm

### Podłączenia zacisków

| Zacisk | Sygnał | Opis |
|--------|--------|------|
| **1** | G485 | Masa RS-485 |
| **2** | B | Sygnał RS-485 B (-) |
| **3** | A | Sygnał RS-485 A (+) |
| **4** | GND | Masa zasilania |
| **5** | +24V | Zasilanie +24 V DC |
| **6** | RC1 | Interfejs OpenTherm/+ |
| **7** | RC2 | Interfejs OpenTherm/+ |

### Okablowanie RS-485 do TapHome

Podłącz za pomocą **3-przewodowego połączenia RS-485**:

- **A** (zacisk 3) → A+/D+ na TapHome RS-485
- **B** (zacisk 2) → B-/D- na TapHome RS-485
- **G485** (zacisk 1) → GND na zasilaczu TapHome (**obowiązkowe**)

> [!WARNING]
> **Ważne — Uziemienie**
>
> Przewód masy G485 **musi** być połączony między DM-OT2 a zasilaczem TapHome. Bez prawidłowego uziemienia mogą wystąpić błędy komunikacji.

### Terminacja magistrali

DM-OT2 posiada zworki do terminacji RS-485:

- **Zworki założone** — stacja końcowa (stany idle i terminacje aktywne). Użyj na **ostatnim** urządzeniu na magistrali.
- **Zworki zdjęte** — stacja pośrednia. Użyj na wszystkich pozostałych urządzeniach.

Obie zworki muszą być zawsze ustawione jednocześnie.

## Konfiguracja

### Adresowanie przełącznikami DIP

Przełączniki DIP ADR0–ADR5 (przełączniki 1–6) ustawiają adres slave Modbus (zakres 1–63). Adres 0 jest niedozwolony.

**Obliczanie adresu:** Każdy przełącznik reprezentuje wartość binarną — ADR0=1, ADR1=2, ADR2=4, ADR3=8, ADR4=16, ADR5=32. Zsumuj wartości przełączników w pozycji ON.

**Przykłady adresów:**

| Adres | Przełączniki ON |
|-------|-----------------|
| **1** | ADR0 |
| **2** | ADR1 |
| **3** | ADR0 + ADR1 |
| **5** | ADR0 + ADR2 |
| **10** | ADR1 + ADR3 |

**Zalecane:** Adres 1 (ADR0=ON, wszystkie pozostałe OFF).

### Prędkość komunikacji

Przełączniki DIP COMM0–COMM3 (przełączniki 7–10) konfigurują prędkość transmisji i parzystość. Dla TapHome ustaw:

- **COMM0:** OFF, **COMM1:** OFF, **COMM2:** ON — wybiera 9600 baud, bez parzystości

Bez wybranej parzystości DM-OT2 automatycznie używa 2 bitów stopu. Zmiany obowiązują natychmiast.

### Wybór protokołu

Przełącznik DIP MODE (przełącznik 11) wybiera protokół:

- **Niezałożony (OFF)** — Modbus RTU (**wymagany dla TapHome**)
- **Założony (ON)** — protokół ARION

Zmiana obowiązuje po restarcie.

## Funkcje urządzenia

### Monitorowanie stanu

Trzy binarne czujniki stanu odczytują poszczególne bity z rejestru stanu (H:100):

- **Palnik** (bit 4) — wskazuje, czy płomień palnika jest aktywny
- **Ogrzewanie** (bit 2) — wskazuje, czy ogrzewanie centralne jest aktywne
- **Ogrzewanie CWU** (bit 3) — wskazuje, czy ogrzewanie ciepłej wody użytkowej jest aktywne

Czujniki te aktualizują się co 2500 ms i zapewniają wgląd w stan pracy kotła w czasie rzeczywistym.

### Sterowanie ogrzewaniem i CWU

Dwa przełączniki sterują ogrzewaniem i CWU przez rejestr sterujący (H:200):

- **Włączenie ogrzewania** (bit 5) — włącza lub wyłącza ogrzewanie centralne
- **Włączenie CWU** (bit 6) — włącza lub wyłącza ogrzewanie ciepłej wody użytkowej

Oba przełączniki wykorzystują wzorzec read-modify-write: szablon odczytuje cały rejestr H:200, maskuje docelowy bit, ustawia nową wartość i zapisuje. Debounce oparty na liczniku (cnt=5 cykli odpytywania) zapewnia, że przełącznik wyświetla zapisany stan natychmiast po przełączeniu, zapobiegając migotaniu podczas przetwarzania polecenia przez kocioł.

### Termostaty temperatury

Dwa urządzenia termostatyczne zapewniają zarówno odczyt aktualnej temperatury, jak i sterowanie wartością zadaną:

- **Temperatura obwodu grzewczego** — odczytuje aktualną temperaturę zasilania z H:102 (Float) i odczytuje/zapisuje temperaturę zadaną do H:201 (Float). Atrybut serwisowy pokazuje zakres min/max z OpenTherm data-ID 49.
- **Termostat CWU** — odczytuje aktualną temperaturę CWU z H:106 (Float) i odczytuje/zapisuje temperaturę zadaną do H:205 (Float). Atrybut serwisowy pokazuje zakres min/max z OpenTherm data-ID 48.

### Czujniki temperatury

Trzy czujniki temperatury tylko do odczytu zapewniają dodatkowe monitorowanie:

- **Temperatura spalin** (H:118) — temperatura gazów spalinowych z kotła, przydatna do monitorowania sprawności spalania
- **Temperatura wody powrotnej** (H:108) — temperatura wody powrotnej z obwodu grzewczego
- **Temperatura zewnętrzna** (H:110) — temperatura zewnętrzna z czujnika kotła, wykorzystywana do pogodowych krzywych grzewczych

Wszystkie rejestry temperatury używają 32-bitowego formatu Float (2 kolejne rejestry holding).

### Monitorowanie ciśnienia

- **Ciśnienie obwodu grzewczego** (H:114) — ciśnienie wody w obwodzie grzewczym w barach. Niskie ciśnienie może wskazywać na wyciek wody lub konieczność uzupełnienia instalacji.

### Moc źródła ciepła

- **Moc źródła ciepła** — model dimmer reprezentujący poziom modulacji kotła. Dwa atrybuty serwisowe z OpenTherm data-ID 15 pokazują minimalny procent modulacji i maksymalną moc kotła w kW.

## Odczyt dodatkowych rejestrów OpenTherm

Szablon zawiera cykliczny mechanizm do odczytu data-ID OpenTherm, które nie są bezpośrednio zmapowane na standardowe rejestry Modbus. Służy do pobierania zakresów min/max temperatur i danych o wydajności kotła.

**Jak to działa:**

1. Moduł ReadScript aktywuje odczyt dodatkowych rejestrów OT ustawiając bit 10 w H:200
2. Zapisuje żądane data-ID OpenTherm do H:216 i wyzwala odczyt przez H:217
3. Odpowiedź pojawia się w H:120, status w H:121 (1=sukces, 3=błąd)
4. Skrypt cyklicznie przechodzi przez trzy data-ID: **48** (CWU min/max), **49** (ogrzewanie min/max) i **15** (wydajność kotła)

Pobrane wartości są przechowywane w wewnętrznych zmiennych (TUV_MM, Top_MM, Kotol_MM) i udostępniane jako atrybuty serwisowe na odpowiednich urządzeniach.

## Diagnostyka serwisowa

Moduł udostępnia dziewięć atrybutów serwisowych do monitorowania:

- **Gateway ID** (H:0) — potwierdza typ bramki (197 = DM-OT2)
- **Wersja firmware** (H:1) — aktualna wersja firmware bramki
- **Czas** (H:2) — licznik czasu pracy bramki
- **Guard Time** (H:4) — limit czasu oceny awarii komunikacji Modbus w milisekundach
- **Licznik restartów** (H:8) — liczba restartów bramki (resetowalny akcją serwisową)
- **Licznik komunikatów Modbus** (H:9) — łączna liczba przetworzonych komunikatów Modbus (resetowalny akcją serwisową)
- **CWU dostępne** (H:100, bit 6) — czy ogrzewanie ciepłej wody użytkowej jest dostępne
- **TV2 dostępny** (H:100, bit 7) — czy dostępny jest wtórny obwód grzewczy
- **Moc źródła ciepła [%]** (H:112) — aktualna modulacja kotła w procentach

Dwie akcje serwisowe umożliwiają resetowanie liczników bramki:

- **Reset licznika restartów** — zeruje licznik restartów bramki (H:8)
- **Reset licznika komunikatów Modbus** — zeruje licznik komunikatów Modbus (H:9)

Moduł ReadScript monitoruje również stan komunikacji OpenTherm (H:100 bit 0) i błędy urządzenia (H:100 bit 1, H:101), raportując je jako błędy i ostrzeżenia w TapHome.

## Wskaźniki LED

| LED | Funkcja |
|-----|---------|
| **PWR** | Konwerter jest zasilany |
| **RxD** | Odbiór danych na RS-485 |
| **TxD** | Nadawanie danych na RS-485 |
| **RxOT** | Odbiór danych na OpenTherm |
| **TxOT** | Nadawanie danych na OpenTherm |

**Stan normalny:** PWR świeci, RxD/TxD migają podczas komunikacji Modbus, RxOT/TxOT migają podczas komunikacji OpenTherm.

## Rozwiązywanie problemów

### Brak komunikacji Modbus (diody RxD/TxD nie migają)

1. **Sprawdź kable RS-485:**
   - A (zacisk 3) prawidłowo podłączony do A+/D+ na TapHome
   - B (zacisk 2) prawidłowo podłączony do B-/D- na TapHome
   - **G485 (zacisk 1) podłączony do masy zasilacza TapHome** — najczęstszy problem
2. Zweryfikuj adres slave Modbus na przełącznikach DIP ADR0–ADR5
3. Potwierdź, że przełącznik DIP MODE jest w pozycji OFF (wybrany Modbus RTU)
4. Sprawdź ustawienia prędkości komunikacji (COMM0=OFF, COMM1=OFF, COMM2=ON dla 9600 baud)
5. Potwierdź, że TapHome jest ustawiony na: 9600 baud, bez parzystości, 2 bity stopu

### Brak komunikacji OpenTherm (diody RxOT/TxOT nie migają)

1. Sprawdź okablowanie między zaciskami RC1/RC2 a złączem OpenTherm kotła
2. Zweryfikuj, czy kocioł obsługuje OpenTherm (nie wszystkie modele Geminox mają interfejs OT)
3. Sprawdź, czy DM-OT2 ma prawidłowe zasilanie (20–30 V DC)

### Błąd komunikacji OT w TapHome

Jeśli TapHome zgłasza „OT communication error" (Status bit 0 = 0):

1. Sprawdź okablowanie OpenTherm między DM-OT2 a kotłem
2. Zrestartuj DM-OT2 odłączając i ponownie podłączając zasilanie
3. Sprawdź atrybut serwisowy Guard Time — jeśli ustawiony na 0, połączenie jest trwale oznaczone jako rozłączone

### Błąd urządzenia w TapHome

Jeśli TapHome zgłasza „Device error" (Status bit 1 = 1):

1. Odczytaj wartość rejestru Last Error z ostrzeżeń TapHome
2. Sprawdź w instrukcji serwisowej kotła konkretny kod błędu
3. Błąd pochodzi z samego kotła, nie z bramki

### Dodatkowe możliwości

Bramka DM-OT2 udostępnia również rejestry temperatury wody zasilającej kotła (H:116), bezpośredniej temperatury CWU (H:104) oraz dodatkowe bity sterujące na H:200 do włączania komunikacji OT i potwierdzania błędów. Mogą one zostać dodane w przyszłej aktualizacji szablonu.

## Dostępne urządzenia

Geminox THRi (via Amit DM-OT2) Moduł

Atrybuty serwisowe

|                           |                                                                                                              |
|---------------------------|--------------------------------------------------------------------------------------------------------------|
| ID bramy                  | reads H:0 (UInt16); switch: 197=\\'DM-OT2\\', other=\\'Unknown\\'; identifies the Amit DM-OT2 gateway        |
| Wersja firmware           | reads H:1 (UInt16); gateway firmware version number                                                          |
| Czas                      | reads H:2 (UInt32); gateway uptime or system time counter                                                    |
| Czas ochronny \[ms]       | reads H:4 (UInt16); Modbus guard time in milliseconds                                                        |
| Licznik resetów           | reads H:8 (UInt16); number of gateway resets since last clear                                                |
| Licznik wiadomości Modbus | reads H:9 (UInt16); total Modbus messages processed since last clear                                         |
| CWU dostępne              | reads bit 6 of Status (H:100); \\'Yes\\' if DHW heating is available, \\'No\\' otherwise                     |
| TV2 dostępne              | reads bit 7 of Status (H:100); \\'Yes\\' if secondary heating circuit (TV2) is available, \\'No\\' otherwise |
| Moc źródła ciepła \[%]    | reads H:112 (Float); current boiler modulation/power output as percentage                                    |

Akcje serwisowe

|                                   |                                                            |
|-----------------------------------|------------------------------------------------------------|
| Resetuj licznik resetów           | writes H:8 (UInt16) = 0; clears the gateway reset counter  |
| Resetuj licznik wiadomości Modbus | writes H:9 (UInt16) = 0; clears the Modbus message counter |

Palnik Kontakt reed Tylko do odczytu

Stan płomienia palnika — aktywny, gdy palnik kotła jest włączony

Rejestr: H:100 UInt16 bitmask

Ogrzewanie Kontakt reed Tylko do odczytu

Stan ogrzewania centralnego — aktywny, gdy obwód grzewczy działa

Rejestr: H:100 UInt16 bitmask

Ogrzewanie CWU Kontakt reed Tylko do odczytu

Stan ogrzewania ciepłej wody użytkowej — aktywny, gdy obwód CWU działa

Rejestr: H:100 UInt16 bitmask

Włączenie ogrzewania Przełącznik

Włącza lub wyłącza ogrzewanie centralne przez read-modify-write na rejestrze sterującym

Rejestr: H:200 UInt16 bitmask

Wartości / Stany: ON · OFF

Włączenie CWU Przełącznik

Włącza lub wyłącza ogrzewanie ciepłej wody użytkowej przez read-modify-write na rejestrze sterującym

Rejestr: H:200 UInt16 bitmask

Wartości / Stany: ON · OFF

Temperatura spalin Czujnik temperatury Tylko do odczytu

Temperatura gazów spalinowych z komory spalania kotła

Rejestr: H:118 Float Jednostka: °C numeric

Temperatura wody powrotnej Czujnik temperatury Tylko do odczytu

Temperatura wody powrotnej z obwodu grzewczego

Rejestr: H:108 Float Jednostka: °C numeric

Temperatura obwodu grzewczego Termostat

Temperatura zasilania obwodu grzewczego z regulowaną wartością zadaną i zakresem min/max z OpenTherm

Rejestr: H:102 → H:201 Float Jednostka: °C numeric

Atrybuty serwisowe

|                                         |
|-----------------------------------------|
| Temperatura obwodu grzewczego min / max |

Ciśnienie obwodu grzewczego Zmienna Tylko do odczytu

Ciśnienie wody w obwodzie grzewczym

Rejestr: H:114 Float Jednostka: bar numeric

Termostat CWU Termostat

Temperatura ciepłej wody użytkowej z regulowaną wartością zadaną i zakresem min/max z OpenTherm

Rejestr: H:106 → H:205 Float Jednostka: °C numeric

Atrybuty serwisowe

|                           |
|---------------------------|
| Temperatura CWU min / max |

Temperatura zewnętrzna Czujnik temperatury Tylko do odczytu

Temperatura zewnętrzna z czujnika kotła

Rejestr: H:110 Float Jednostka: °C numeric

Moc źródła ciepła Ściemniacz Tylko do odczytu

Poziom modulacji kotła z atrybutami serwisowymi minimalnego procentu modulacji i maksymalnej mocy

Atrybuty serwisowe

|                    |
|--------------------|
| Min modulacja \[%] |
| Max moc \[kW]      |

**Połączenie:** Modbus RTU • 9600 baud• 8N2 • Slave ID: $\[SlaveId]

Możliwe ulepszenia (5)

- H:104 DHW Temperature (direct) — H:104 Float — likely DHW flow temperature; not exposed as separate device (DHW Thermostat uses H:106 for current)
- H:116 Boiler Water Temperature — H:116 Float — boiler flow/supply water temperature; could complement return water temp
- H:200 bit 0 OT Communication Enable — Bit 0 of H:100 indicates OT comm status; corresponding control bit on H:200 could enable/disable OT communication
- H:200 bit 1 Device Error Acknowledge — Bit 1 of H:100 indicates device error; potential error acknowledgment via H:200
- H:203 Heating Circuit Desired Temperature (alternative) — Potential alternative setpoint register; template uses H:201 for heating circuit desired temp

## Źródła

- Amit DM-OT2 Datasheet
  
  [amitomation.cz](https://amitomation.cz/en/product/communication-converters/dm-ot2/) 2026-03-20
  
  [PDF](https://taphome.com/compatibility/devices/geminox-thri/manufacturer/dm-ot2-datasheet.pdf)
- Amit DM-OT2 Product Page
  
  [amitomation.cz](https://amitomation.cz/en/product/communication-converters/dm-ot2/) 2026-03-20
- OpenTherm-to-Modbus Register Reference (Unipi MM-OT101)
  
  [kb.unipi.technology](https://kb.unipi.technology/_media/files:products:extensions_gateyways:mm-ot101:mm-ot101-technical_manual_en.pdf) 2026-03-20

## Powiązana dokumentacja

- [Modbus Integration](https://taphome.com/pl/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/pl/docs/integration/modbus/)
- [Prosta konfiguracja za pomocą szablonów](https://taphome.com/pl/docs/integration/modbus/templates/)
- [Skrypty Modbus i prefetch](https://taphome.com/pl/docs/script/modbus-scripts/)
- [Funkcje Modbus](https://taphome.com/pl/docs/script/modbus/)
- [Typy danych Modbus](https://taphome.com/pl/docs/script/modbus-data-types/)

