---
title: "Cyclogic CL-MC030x"
description: "Steruj jednostkami Samsung DVM, CAC, FJM i RAC przez Modbus RTU na magistrali F1/F2 — ON/OFF, tryb, wentylator, żaluzje i termostat. Szablon CL-MC03**C."
url: "https://taphome.com/pl/compatibility/cyklogic-cl-mc030x/"
language: pl
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["modbus-tcp","modbus-rtu","rs485","air-conditioning","hvac-gateway","samsung-hvac","dvm-s","vrf","modbus-rtu-to-tcp"]
  questions: ["Jak zintegrować Samsung HVAC z TapHome przez Cyclogic CL-MC030x?","Czym jest Cyclogic CL-MC030x i które jednostki wewnętrzne Samsung obsługuje?","Iloma jednostkami wewnętrznymi Samsung może sterować Cyclogic CL-MC030x?","Jakiej bramki potrzebuję, aby podłączyć Cyclogic CL-MC030x do TapHome?","Dlaczego klimatyzacja Samsung przełącza się na chłodzenie, gdy w TapHome wybiorę Heat?","Dlaczego temperatury zadane na Cyclogic CL-MC030x są 10× za niskie?","Jak wygląda mapa rejestrów Modbus Cyclogic CL-MC030x?"]
---

# Cyclogic CL-MC030x

Komunikacja: Modbus TCP

- [Oficjalna strona Cyclogic](http://www.cyclogic.net)
- [Samsung HVAC Submittal (CL-MC03**C)](https://s3.amazonaws.com/samsung-files/Tech_Files/Controls/Central+Control/Submittals/CL-MC03+C+SUBMITTAL_MODBUS+IM_03162021.pdf)

> Adres w sieci
> 
> TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres.
> 
> [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/)

## Poradnik integracji

Seria Cyclogic CL-MC03**C (znak **`x`** w nazwie szablonu jest symbolem zastępczym dla wariantowego sufiksu `1` / `8` / `16` / `32` / `64`) to moduł interfejsu Modbus RTU, który łączy jednostki wewnętrzne Samsung z siecią Modbus. Podłącza się bezpośrednio do **magistrali komunikacyjnej Samsung F1/F2 jednostki wewnętrznej** i udostępnia ON/OFF, tryb pracy, temperaturę zadaną/pomieszczenia, prędkość wentylatora oraz ruch żaluzji jako rejestry holding Modbus. Moduł produkuje **Cyclogic Inc.** (Republika Korei), a Samsung HVAC dystrybuuje go OEM na rynek północnoamerykański — urządzenie, mapa rejestrów i protokół są identyczne we wszystkich pięciu wariantach, różni się jedynie maksymalna liczba adresowalnych jednostek wewnętrznych.

| Model | Liczba sterowanych jednostek wewnętrznych |
|-------|-------------------------------------------|
| CL-MC0301C | 1 (typowy RAC) |
| CL-MC0308C | 1 – 8 (małe DVM/CAC/FJM) |
| CL-MC0316C | 1 – 16 (średnie DVM) |
| CL-MC0332C | 1 – 32 (duże DVM) |
| CL-MC0364C | 1 – 64 (maksymalne DVM, jeden adapter na jednostkę zewnętrzną) |

Kompatybilne jednostki wewnętrzne Samsung obejmują **DVM S** (`AM****N****/AA`), **CAC** (`AC****N****/AA`), **FJM** (`AJ0***N****/AA`) oraz **RAC** (`AR*********N**`). Modele Samsung **Novus** RAC `AR**JSALBWKNCV` i `AR**JSFLBWKNCV` jednoznacznie **nie są obsługiwane**.

CL-MC03**C jest urządzeniem typu Modbus RTU slave; TapHome `ModbusTcpCCU` łączy się z nim przez zewnętrzną **bramkę Modbus RTU/TCP**, która konwertuje magistralę RS-485 na Ethernet. Aktualny szablon TapHome adresuje **tylko pierwszą jednostkę wewnętrzną (IDU 00)** na magistrali — w instalacjach z wieloma jednostkami wewnętrznymi szablon należy importować raz dla każdej jednostki (zob. *Rozwiązywanie problemów* poniżej).

> [!WARNING]
> Pomiędzy szablonem TapHome XML a dokumentacją producenta Cyclogic / Samsung zidentyfikowano kilka niezgodności — w szczególności **zamianę etykiet Heat i Cool** w selektorze trybu oraz **współczynnik skalowania temperatury /100** zamiast udokumentowanego /10. Przed wdrożeniem szablonu w produkcji zapoznaj się z sekcją *Niezgodności pomiędzy szablonem a dokumentacją producenta*.

## Połączenie hardware'owe

CL-MC03**C to mały moduł w obudowie na szynę DIN (100 × 80 × 24 mm) z jednorzędową listwą zaciskową na panelu czołowym. Sześć opisanych konektorów obsługuje komunikację, zasilanie i pomocnicze linie I/O.

### Listwa zaciskowa

![Listwa zaciskowa Cyclogic CL-MC03**C — MODBUS INT (RS-485 do bramki), RS-485 (F1/F2 do Samsunga), MODBUS EXT (zarezerwowane), POWER (12 V DC), DO (wyjście błędu) i DRY CONT (wejście wymuszonego ON/OFF)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/wiring-terminals_hu_937870580ffff8f4.jpg)

| # | Konektor | Opis |
|---|----------|------|
| 1 | **MODBUS INT** | RS-485 (RX+ / RX−) — do zewnętrznej bramki Modbus RTU/TCP |
| 2 | **RS-485** | F1 / F2 — do zacisków F1/F2 jednostki wewnętrznej Samsung |
| 3 | **MODBUS EXT** | Zarezerwowane — nieużywane |
| 4 | **POWER** | Zasilanie 12 V DC (+ / −) |
| 5 | **DO** | Wyjście cyfrowe — styk zwiera (12 – 24 V DC) przy błędzie systemu Samsung |
| 6 | **DRY CONT** | Wejście bezpotencjałowe dla zewnętrznej blokady wymuszonego ON/OFF (np. styk okienny) |

Moduł jest **zasilany 12 V DC**, zazwyczaj bezpośrednio z zacisków **V1/V2** jednostki wewnętrznej Samsung na płytce wewnętrznej — w typowych instalacjach nie potrzeba osobnego zasilacza. Opcjonalnie można użyć dostarczonego w terenie adaptera 12 V DC. Submittal Samsung potwierdza, że moduł akceptuje 12 – 24 V DC, ale instrukcja instalacji Cyclogic podaje 12 V DC jako wartość znamionową.

> [!WARNING]
> Przed otwarciem jednostki wewnętrznej Samsung w celu uzyskania dostępu do zacisków F1/F2 i V1/V2 odłącz zasilanie sieciowe. Przed włączeniem modułu sprawdź polaryzację na konektorze POWER. Maksymalna długość magistrali RS-485 (Modbus) wynosi **500 m**; moduł instaluj wyłącznie w pomieszczeniach — zakres temperatur pracy to **0 °C do 40 °C** (32 °F do 104 °F).

### Topologia systemu

![Topologia Cyclogic CL-MC03**C — Przypadek 1 (DVM/CAC, DIP SW2 OFF) z jednym modułem na magistrali F1/F2 i Przypadek 2 (RAC, DIP SW2 ON) z jednym modułem na system RAC na współdzielonym Modbus master](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/system-connection-diagram_hu_3acea40f45ac7ab.jpg)

W zależności od integrowanego rodzaju Samsunga istnieją dwie poprawne topologie:

- **Przypadek 1 — DVM / CAC** (DIP SW2 = **OFF**, protokół NASA): jeden moduł CL-MC03 znajduje się na magistrali F1/F2 współdzielonej przez jedną jednostkę zewnętrzną i do 64 jednostek wewnętrznych. Wybierz wariant pokrywający łączną liczbę IDU jednostki zewnętrznej — dobór jest jednorazowy, dwóch adapterów nie można piętrzyć na tej samej jednostce zewnętrznej (zob. *Rozwiązywanie problemów*).
- **Przypadek 2 — RAC** (DIP SW2 = **ON**, protokół Non-NASA): jeden moduł CL-MC03 na system zewnętrzny RAC (zazwyczaj `CL-MC0301C` — pojedyncza IDU). Wiele modułów znajduje się na tej samej magistrali RS-485, każdy z unikalnym adresem slave ustawionym przez przełączniki obrotowe.

Obie topologie współdzielą jedną zewnętrzną bramkę RS-485/Ethernet, która wobec TapHome działa jak Modbus master.

## Konfiguracja

### Przełączniki DIP

![Przełączniki DIP na panelu czołowym Cyclogic CL-MC03**C — SW1 (aktualizacja firmware) i SW2 (wybór protokołu Samsung AC — RAC/FJM vs DVM/CAC)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/dip-switches_hu_b3d8b4e6997047d3.jpg)

| Przełącznik | Pozycja | Funkcja |
|-------------|---------|---------|
| **SW2** (protokół) | **ON** | RAC / FJM — numery modeli `AR*****`, `AJ*****` (protokół Non-NASA) |
| **SW2** (protokół) | **OFF** | DVM / CAC — numery modeli `AM*****`, `AC****` (protokół NASA) |
| **SW1** (firmware) | **ON** (default) | Wyłączone — normalna praca |
| **SW1** (firmware) | **OFF** | Włączone — tryb pobierania firmware'u (nie używać podczas normalnej pracy) |

> [!WARNING]
> SW2 musi być ustawiony **przed** włączeniem modułu — podłączenie modułu do złej rodziny protokołu (np. SW2 = OFF na systemie RAC lub SW2 = ON na systemie DVM) skutkuje **całkowitym brakiem komunikacji** z jednostką wewnętrzną Samsung. Instrukcja Cyclogic wskazuje to jako najczęstszy błąd instalacyjny.

### Adres slave Modbus (RSW1 + RSW2)

Adres slave Modbus (adres RS-485, którym bramka będzie odpytywać ten moduł) ustawia się dwoma przełącznikami obrotowymi BCD na płytce, dostępnymi po odkręceniu czterech śrub na tylnej ściance obudowy:

- **RSW1** — cyfra dziesiątek (`0` – `6`)
- **RSW2** — cyfra jedności (`0` – `9`)

Łączna wartość tworzy adres slave, prawidłowy zakres **00 – 63**. Każdy moduł na tej samej magistrali RS-485 musi mieć **unikalny adres** — najczęstszym konfliktem jest kilka modułów `CL-MC0301C` pozostawionych na wartości fabrycznej. Szablon TapHome dostarcza w parametrach importu **domyślny Slave ID = 1**; jeśli zostawisz przełączniki obrotowe na tej wartości, importowanej konfiguracji nie trzeba zmieniać.

### Parametry protokołu Modbus

Te wartości są stałe w firmware modułu i **nie można** ich zmienić przełącznikami DIP — strona RS-485 bramki musi zostać tak skonfigurowana:

| Parametr | Wartość |
|----------|---------|
| Tryb | Modbus RTU **slave** |
| Baud rate | **19 200 bps** (submittal Samsung podaje `19600` — literówka standardowej prędkości magistrali F Samsung 19 200) |
| Parzystość | Even (parzysta) |
| Bity stopu | 1 |
| Format ramki | 8E1 (8 bitów danych, parzysta parzystość, 1 bit stopu) |
| Kody funkcji | `03` (Read Holding Registers), `06` (Preset Single Register) |
| Szerokość rejestru | 2 bajty (16 bit) |
| Maksymalna długość magistrali RS-485 | 500 m |

### Włączanie komunikacji Modbus przez bramkę TCP

CL-MC03**C jest natywnym urządzeniem Modbus RTU — TapHome łączy się z nim przez Modbus TCP za pomocą zewnętrznej **bramki Modbus RTU/TCP** (czasem nazywanej konwerterem RS-485/Ethernet). Działa każda bramka obsługująca tryb **transparent / pass-through Modbus TCP-to-RTU bridge**; powszechnie stosowane modele to Waveshare RS485-to-Ethernet, seria USR-TCP232 oraz seria Hi-Flying / HF.

Konfiguracja bramki (nazwy menu różnią się w zależności od modelu):

1. Podłącz zaciski A/B RS-485 bramki do zacisku **MODBUS INT** modułu (RX+ → A, RX− → B). Bramkę zasilaj z własnego zasilania (zazwyczaj 5 – 24 V DC).
2. Port szeregowy bramki ustaw na **19 200 bps, 8 bitów danych, parzysta parzystość, 1 bit stopu**, aby pasował do stałych ustawień firmware modułu. Jeśli bramka udostępnia również parametr czasu ramki, pozostaw go na domyślnej wartości Modbus (3,5 znaków idle).
3. Tryb pracy bramki ustaw na **Modbus TCP slave / Modbus TCP-to-RTU bridge / transparent gateway** (terminologia różni się w zależności od producenta) na porcie TCP **502**.
4. Bramce przypisz **statyczny adres IP** w sieci lokalnej — albo przez rezerwację DHCP na routerze, albo bezpośrednio w interfejsie webowym bramki. Szablon TapHome ma domyślną wartość `192.168.0.1`; zgodność z tym adresem eliminuje konieczność zmiany parametru importu.
5. Jeśli bramka ma wbudowany **rezystor terminujący 120 Ω**, włącz go tylko jeśli bramka znajduje się na końcu magistrali RS-485.

Podczas importu szablonu w TapHome podaj:

- **Adres IP** — IP bramki w sieci lokalnej (domyślnie: `192.168.0.1`)
- **Slave ID** — adres Modbus modułu ustawiony przez RSW1 + RSW2 (domyślnie: `1`)

> [!TIP]
> Wiele modułów `CL-MC03**C` na tej samej magistrali RS-485 może współdzielić jedną bramkę — każdy moduł jest adresowany przez swój adres slave przełączników obrotowych jako Modbus unit ID w TapHome.

## Funkcje urządzenia

Szablon odpytuje **6 rejestrów holding** (H:0, H:1, H:4, H:5, H:8, H:9) co 2,5 s dla jednostki wewnętrznej 00 na magistrali F1/F2 i udostępnia 5 logicznych urządzeń.

### ON/OFF

Prosty przełącznik do włączania lub wyłączania jednostki wewnętrznej. Czyta rejestr H:0 (Bool) — `0` = OFF, `1` = ON.

> [!NOTE]
> Rejestr Cyclogic 40001 (= H:0) jest udokumentowany jako **2-bajtowe łączone polecenie zapisu** z Data 1 = ON/OFF i Data 2 = Mode. Szablon TapHome zapisuje tylko bajt Bool ON/OFF, więc tryb pracy trzeba ustawić osobno przez urządzenie Mode. Na większości jednostek wewnętrznych Samsung częściowy zapis jest akceptowany jako ON/OFF, a istniejący tryb jest zachowywany — sprawdź na rzeczywistym sprzęcie.

### Mode

Selektor trybu pracy. Instrukcje Cyclogic / Samsung dokumentują następujące kody:

| Kod w instrukcji | Tryb |
|------------------|------|
| 0 | Auto |
| 1 | Cooling (chłodzenie) |
| 2 | Dry (osuszanie) |
| 3 | Fan (wentylacja) |
| 4 | Heat (grzanie) |
| 11 | Auto Cool (tylko odczyt) |
| 12 | Auto Dry (tylko odczyt) |
| 13 | Auto Fan (tylko odczyt) |
| 14 | Auto Heat (tylko odczyt) |

> [!WARNING]
> Szablon TapHome **zamienia etykiety Heat i Cool** względem instrukcji Cyclogic / Samsung: pozycja szablonu `1` ma etykietę „Heat", ale wartość Modbus `1` jest udokumentowana jako **Cooling**, a pozycja szablonu `4` ma etykietę „Cool", ale wartość `4` jest udokumentowana jako **Heat**. Na rzeczywistej jednostce Samsung wybór „Heat" w UI TapHome uruchomi więc **chłodzenie**, a wybór „Cool" uruchomi **grzanie**. Przed poleganiem na etykietach **sprawdź na rzeczywistym sprzęcie** — wartości szablonu mogą wymagać przemapowania w zależności od tego, co faktycznie robi jednostka wewnętrzna Samsung.

> [!NOTE]
> Sub-tryby Auto-COOL / Auto-DRY / Auto-FAN / Auto-HEAT są udokumentowane jako wartości **tylko do odczytu**, które odzwierciedlają stan wewnętrzny jednostki podczas pracy w trybie Auto. Szablon TapHome udostępnia je jako pozycje 5 – 8 z surowymi wartościami 5 – 8, ale producent podaje wartości 11 – 14. Zapis którejkolwiek z tych pozycji wyśle do jednostki wewnętrznej nieudokumentowaną wartość Modbus, a wynik jest niezdefiniowany — przy sterowaniu jednostką z TapHome pozostaw je na Auto.

Czyta i zapisuje rejestr H:1 (Int16). Interwał odpytywania: 2,5 s.

### Prędkość wentylatora

Selektor prędkości wentylatora. Instrukcje Cyclogic / Samsung dokumentują tylko **5 wartości** (0 – 4):

| Kod w instrukcji | Prędkość |
|------------------|----------|
| 0 | Automatyczna |
| 1 | Low (niska) |
| 2 | Middle (średnia) |
| 3 | High (wysoka) |
| 4 | Turbo |

> [!WARNING]
> Szablon TapHome wstawia niestandardowy slot „Position-5" przy wartości `2`, przesuwając MIDDLE / HIGH / TURBO na wartości `3` / `4` / `5`. Na rzeczywistej jednostce Samsung wybór „Mid" w UI TapHome faktycznie uruchomi **HIGH** (surowa wartość `3`), „High" uruchomi **TURBO** (surowa wartość `4`), a „Turbo" wyśle surową wartość `5`, co nie jest poprawnym kodem prędkości wentylatora. Sloty 6 – 9 (Position-6, Position-7, 8, 9) to wartości placeholder, nieosiągalne na rzeczywistych jednostkach wewnętrznych Samsung. Przed poleganiem na etykietach **sprawdź na rzeczywistym sprzęcie**.

> [!NOTE]
> Według instrukcji Cyclogic rejestr 40009 (= H:8) jest **2-bajtowym łączonym poleceniem zapisu** z Data 1 = Fan Speed i Data 2 = Louver. Szablon TapHome zapisuje tylko bajt prędkości wentylatora, a pozycja żaluzji jest zapisywana osobno jako jeden bajt do rejestru H:9 — może to nie zgadzać się z tym, czego każda bramka oczekuje na łączonym rejestrze H:8. Sprawdź na rzeczywistym sprzęcie.

Czyta i zapisuje rejestr H:8 (Int16). Interwał odpytywania: 2,5 s.

### Pozycja żaluzji (Louver Swing)

Sterowanie ruchem żaluzji panelu dekoracyjnego. Instrukcje Cyclogic / Samsung dokumentują tylko **4 wartości** (0 – 3):

| Kod w instrukcji | Pozycja |
|------------------|---------|
| 0 | Swing OFF |
| 1 | Swing ON: górne i dolne żaluzje |
| 2 | Swing ON: prawe i lewe żaluzje |
| 3 | Swing ON: górne i dolne + prawe i lewe żaluzje |

> [!WARNING]
> Szablon TapHome **duplikuje** „RIGHT & LEFT LOUVER" jako pozycję 2 i pozycję 3 — pozycja 3 powinna być według dokumentacji producenta „UPPER & LOWER + RIGHT & LEFT LOUVER". Pozycje 4 – 9 (łączone żaluzje U&D / R&L, Swing ON, Position-7, Position-6, Position-5 Vertical, Swirl) są **nieudokumentowane** w instrukcjach Cyclogic i Samsung — mogą to być spekulatywne sloty przeznaczone dla niedekoracyjnych jednostek kasetonowych, ale nie są osiągalne na standardowych jednostkach ściennych, kasetonowych i kanałowych. Przed poleganiem na etykietach **sprawdź na rzeczywistym sprzęcie**.

Czyta i zapisuje rejestr H:9 (Int16). Interwał odpytywania: 2,5 s.

### Termostat

Wartość zadana i aktualna temperatura pomieszczenia. Czyta rejestr H:4 (Int16, R/W) dla wartości zadanej i rejestr H:5 (Int16, tylko do odczytu) dla temperatury pomieszczenia.

> [!WARNING]
> Szablon TapHome stosuje **dzielnik /100** (i mnożnik `* 100` przy zapisie) do obu rejestrów temperatury, ale instrukcja Cyclogic Rev. 2 i submittal Samsung **oba podają /10**: surowo `250` = 25,0 °C, nie surowo `2500` = 25,0 °C. Na rzeczywistej jednostce wewnętrznej Samsung:
> - Wartości zadane zapisane z TapHome będą **10× za duże** (np. ustawienie 25 °C zapisze do rejestru surową `2500`, którą urządzenie interpretuje jako 250,0 °C i odrzuca lub przycina).
> - Odczyty temperatury pomieszczenia będą **10× za małe** (np. surowo `235` wyświetli się jako 2,35 °C zamiast 23,5 °C).
>
> Jeśli obserwujesz wartości 10× mniejsze, jest to niemal na pewno przyczyna. **Sprawdź na rzeczywistym sprzęcie** i skontaktuj się z TapHome, aby poprawić skalowanie szablonu z `/100` na `/10`.

Interwał odpytywania: 2,5 s.

## Niezgodności pomiędzy szablonem a dokumentacją producenta

Powyżej udokumentowano kilka rozbieżności pomiędzy szablonem TapHome XML a instrukcją Cyclogic Rev. 2 (październik 2017) / submittalem Samsung (SHA-DVMS-03162021). Podsumowanie:

| Obszar | Szablon | Instrukcja | Wpływ |
|--------|---------|------------|-------|
| Etykiety trybu (pozycje 1 i 4) | 1 = Heat, 4 = Cool | 1 = Cooling, 4 = Heat | Wybór „Heat" uruchamia chłodzenie i odwrotnie — sprawdź na sprzęcie |
| Pozycje trybu 5 – 9 | Surowe wartości 5 – 9 (Auto-*) | Sub-tryby Auto-* używają wartości **11 – 14** i są tylko do odczytu | Zapis pozycji 5 – 9 wysyła nieudokumentowane wartości — niezdefiniowane zachowanie |
| Pozycje wentylatora 2 – 9 | Wstawia niestandardowy „Position-5" przy wartości 2, przesuwa Mid/High/Turbo | Instrukcja dokumentuje tylko wartości 0 – 4 | „Mid" → HIGH, „High" → TURBO, „Turbo" → nieprawidłowe; pozycje 6 – 9 placeholder |
| Pozycja żaluzji 3 | Duplikat „Right & Left Louver" | Powinno być „Upper & Lower + Right & Left Louver" | Etykieta nie zgadza się — wartość rejestru jest poprawna |
| Pozycja żaluzji 4 – 9 | Różne etykiety, w tym „Swirl", „Position-5 (Vertical)" | Instrukcja dokumentuje tylko wartości 0 – 3 | Nieudokumentowane — niezdefiniowane na standardowych jednostkach ściennych / kasetonowych / kanałowych |
| Skalowanie termostatu | `/ 100` i `* 100` | `/ 10` i `* 10` | Zapisywane wartości zadane 10× za duże, temperatura pomieszczenia 10× za mała |
| Zapis ON/OFF | Pojedynczy bajt Bool (tylko Data 1) | Łączone polecenie 2-bajtowe (Data 1 = ON/OFF, Data 2 = Mode) | Na większości jednostek akceptowane jako częściowy zapis, ale sprawdź zachowanie trybu |
| Zapis wentylatora | Pojedynczy Int16 (tylko Data 1) | Łączone polecenie 2-bajtowe (Data 1 = Fan, Data 2 = Louver) | Pozycja żaluzji jest zapisywana osobno do H:9 — sprawdź zachowanie na rzeczywistym sprzęcie |

Są to z dużym prawdopodobieństwem bugi szablonu XML, które należy poprawić względem rzeczywistego sprzętu.

## Rozwiązywanie problemów

### Brak komunikacji Modbus

1. Sprawdź, czy **DIP SW2** jest ustawiony poprawnie dla rodziny Samsung — **OFF** dla DVM / CAC (NASA, prefiksy modeli `AM`, `AC`), **ON** dla RAC / FJM (Non-NASA, prefiksy modeli `AR`, `AJ`). Zły protokół = brak komunikacji.
2. Sprawdź, czy moduł jest zasilany — zielona dioda PWR / System na panelu czołowym musi się świecić. Jeśli zasilany z V1/V2, potwierdź, że jednostka wewnętrzna Samsung jest podłączona do sieci.
3. Potwierdź, że **adres slave** na RSW1 + RSW2 zgadza się ze Slave ID w parametrach importu TapHome (default fabryczny = `01`, default szablonu = `1`).
4. Sprawdź ustawienia portu szeregowego bramki: **19 200 bps, 8 bitów danych, parzysta parzystość, 1 bit stopu** (8E1) — to najczęstszy błąd konfiguracji po stronie bramki.
5. Potwierdź, że bramka jest w trybie **Modbus TCP-to-RTU transparent bridge** (nie tryb wirtualnego portu COM) i nasłuchuje na porcie TCP **502**.
6. Sprawdź polaryzację okablowania na **MODBUS INT** — RX+ do A bramki, RX− do B bramki. Niektóre bramki używają odwrotnej konwencji polaryzacji; jeśli LED migają bez udanego pollingu, zamień oba przewody.
7. Sprawdź, czy na tej samej magistrali RS-485 nie ma drugiego modułu z tym samym adresem RSW.

### Wartości zadane i temperatura pomieszczenia są 10× za małe

Szablon TapHome XML stosuje dzielnik `/100` do rejestrów H:4 i H:5, ale dokumentacja producenta podaje `/10`. Wartość zadana 25 °C będzie więc transmitowana jako surowa `2500` do jednostki wewnętrznej Samsung, która oczekuje surowej `250`, a odczyt temperatury pomieszczenia surowo `235` (= 23,5 °C według instrukcji) wyświetli się w UI TapHome jako `2,35 °C`. Użyj narzędzia debug Modbus w TapHome do odczytu surowych wartości rejestrów, a następnie skontaktuj się z TapHome, aby poprawić skalowanie szablonu z `/100` na `/10`.

### Wybór Heat i Cool jest odwrócony

Pozycje szablonu dla Heat i Cool nie zgadzają się z instrukcją Cyclogic (szablon `1` = Heat / wartość `1`, instrukcja `1` = Cooling). Na rzeczywistej jednostce Samsung wybór „Heat" w UI TapHome uruchomi więc **chłodzenie**, a „Cool" uruchomi **grzanie**. Dopóki szablon nie zostanie poprawiony, wybieraj według fizycznego zachowania, a nie według etykiety.

### Pozycje trybu 5 – 9 nic nie robią lub działają nieprzewidywalnie

Te pozycje zapisują wartości Modbus 5 – 9 do rejestru H:1, ale instrukcja Cyclogic podaje dla sub-trybów Auto-* wartości **11 – 14** i wyraźnie zaznacza, że są tylko do odczytu. Zapis wartości 5 – 9 wysyła nieudokumentowane kody do jednostki wewnętrznej — wynik jest niezdefiniowany i zależy od firmware Samsung. Wybór trybu ogranicz tylko do pozycji 0 – 4.

### Pozycje wentylatora Mid / High / Turbo nie zgadzają się z etykietą

Szablon TapHome wstawia niestandardowy slot „Position-5" przy wartości 2, przesuwając MIDDLE / HIGH / TURBO na wartości szablonu 3 / 4 / 5. Etykieta „Mid" w TapHome faktycznie uruchamia więc **HIGH**, „High" uruchamia **TURBO**, a „Turbo" wysyła surową wartość `5`, co nie jest udokumentowanym kodem prędkości wentylatora. Wybieraj według fizycznego zachowania, a nie według etykiety, dopóki szablon nie zostanie poprawiony.

### Jedna jednostka wewnętrzna na adapterze multi-IDU nie odpowiada

Jeśli masz `CL-MC0308C` lub większy i chcesz sterować więcej niż pierwszą jednostką wewnętrzną, sam aktualny szablon nie wystarczy — odpytuje tylko rejestry dla IDU 00. Dla każdej dodatkowej IDU zaimportuj szablon drugi (trzeci, …) raz i w importowanej konfiguracji popraw adresy rejestrów dodając `+20 × N` do każdego (np. IDU 01 → H:20, H:21, H:24, H:25, H:28, H:29). Natywny szablon multi-IDU jest w planach.

### Dwa adaptery na tej samej jednostce zewnętrznej nie pokrywają wszystkich jednostek wewnętrznych

Nie można piętrzyć dwóch mniejszych wariantów `CL-MC03**C` na tym samym systemie zewnętrznym Samsung — oba moduły będą liczyć adresy IDU od `00` w górę, a IDU o wyższych numerach będą nieosiągalne. Zastąp oba moduły jednym większym wariantem dobranym na łączną liczbę IDU (według FAQ Samsung HVAC, listopad 2016).

## Dostępne urządzenia 5

Te urządzenia pojawią się w TapHome po imporcie.

Cyclogic CL-MC030x Moduł

ON/OFF Przełącznik Odczyt i zapis

Włącza lub wyłącza jednostkę wewnętrzną Samsung (rejestr H:0, Bool — 0 = OFF, 1 = ON)

Rejestr: H:0 Bool

Wartości / Stany: ON · OFF

Odczyt stanu przełącznika

```taphome
MODBUSR(H, 0, Bool)
```

Zapis stanu przełącznika

```taphome
MODBUSWNE(H, 0, Bool, St)
```

Tryb Przełącznik wielowartościowy Odczyt i zapis

Tryb pracy — Auto, Heat, Dry, Fan, Cool (rejestr H:1; szablon zamienia etykiety Heat i Cool względem instrukcji Cyclogic — sprawdź na rzeczywistym sprzęcie. Pozycje 5 – 9 wysyłają nieudokumentowane wartości i działają nieprzewidywalnie)

Rejestr: H:1 Int16 numeric

Wartości / Stany: Auto · Heat · Dry · Fan · Cool · Auto COOL · Auto DRY · Auto FAN · Auto HEAT

Odczyt stanu przełącznika

```taphome
MODBUSR(H, 1, Int16)
```

Zapis stanu przełącznika

```taphome
MODBUSWNE(H, 1, Int16, Mu)
```

Prędkość wentylatora Przełącznik wielowartościowy Odczyt i zapis

Prędkość wentylatora — Auto, Low, Middle, High, Turbo (rejestr H:8; szablon wstawia niestandardowy slot 'Position-5' przy wartości 2, więc 'Mid' uruchamia HIGH, a 'High' uruchamia TURBO na rzeczywistym sprzęcie. Pozycje 6 – 9 to placeholder, nieosiągalne na jednostkach wewnętrznych Samsung)

Rejestr: H:8 Int16 numeric

Wartości / Stany: Auto · Low · Mid · High · Turbo

Odczyt stanu przełącznika

```taphome
MODBUSR(H, 8, Int16)
```

Zapis stanu przełącznika

```taphome
MODBUSWNE(H, 8, Int16, Mu)
```

Pozycja żaluzji Przełącznik wielowartościowy Odczyt i zapis

Ruch żaluzji panelu dekoracyjnego — Swing Off, górne i dolne, prawe i lewe, łączone górne i dolne / prawe i lewe (rejestr H:9; pozycje 4 – 9 są w instrukcji Cyclogic nieudokumentowane i nieosiągalne na standardowych jednostkach ściennych, kasetonowych i kanałowych)

Rejestr: H:9 Int16 numeric

Wartości / Stany: Swing OFF · UPPER & LOWER LOUVER · RIGHT & LEFT LOUVER · UPPER&LOWER/RIGHT&LEFT LOUVER

Odczyt stanu przełącznika

```taphome
MODBUSR(H, 9, Int16)
```

Zapis stanu przełącznika

```taphome
MODBUSWNE(H, 9, Int16, Mu)
```

Termostat Termostat Odczyt i zapis

Wartość zadana i aktualna temperatura pomieszczenia w °C (rejestr H:4 R/W wartość zadana, rejestr H:5 tylko do odczytu temperatura pomieszczenia; szablon stosuje dzielnik /100, ale producent podaje /10 — odczyty mogą być 10× za małe, a zapisywane wartości zadane 10× za duże, dopóki szablon nie zostanie poprawiony)

Rejestr: H:4 Int16 Jednostka: °C numeric

Odczyt temperatury

```taphome
MODBUSR(H, 5, Int16) / 100
```

Odczyt temperatury zadanej

```taphome
MODBUSR(H, 4, Int16) / 100
```

Zapis temperatury zadanej

```taphome
MODBUSWNE(H, 4, Int16, Se * 100)
```

**Połączenie:** Modbus TCP • Slave ID: $\[SlaveId]

Możliwe ulepszenia (7)

- H:10 Supply Air (Discharge) Temperature — Duct only — Int16 / 10, °C, R/W — discharge air temperature for duct-type indoor units only (ignored on cassette/wall units)
- H:11 States of Supply Air Temp Control — Int16, R/W — 0=DISABLE, 1=ENABLE; enables the discharge-air temperature control loop on duct-type units
- H:12 Set Temp. of Cooling Supply Air — Duct only — Int16 / 10, °C, R/W — discharge-air cooling setpoint for duct-type indoor units
- H:13 Set Temp. of Heating Supply Air — Duct only — Int16 / 10, °C, R/W — discharge-air heating setpoint for duct-type indoor units
- — Template only addresses indoor unit 00. The manufacturer protocol exposes IDU 01–63 by adding N×20 to each register (e.g. IDU 01 ON/OFF = H:20, IDU 02 ON/OFF = H:40). For multi-IDU systems (CL-MC0308C/0316C/0332C/0364C), the template would need to be duplicated per indoor unit or extended to expose all 64 IDUs.
- — The CL-MC03\*\*C exposes a Digital Output (DO terminal) that closes (12-24 V DC) when a Samsung system error code occurs. This is not a Modbus register — it is a hardware contact and would need to be wired to a TapHome digital input separately. The Modbus register map does not include a per-IDU error-code register.
- — Hardware dry-contact input on the gateway for external forced ON/OFF interlock (e.g. window contact, fire alarm). Not a Modbus register — would need to be wired from a TapHome digital output into the gateway directly.

## Parametry importu

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji | Domyślnie     |
|---------------------|---------------|
| Slave ID            | `1`           |
| Adres IP            | `192.168.0.1` |

## Źródła

- Cyclogic CL-MC03\*\** Modbus Interface Module Installation Manual (Rev. 2, Oct 2017)
  
  [cdn.komachine.com](https://cdn.komachine.com/media/product-catalog/Manual-CYCLOGIC-Modbus_Interface_Module.pdf) 2026-04-25
  
  [PDF](https://taphome.com/compatibility/devices/cyklogic-cl-mc030x/manufacturer/Manual-CYCLOGIC-Modbus_Interface_Module.pdf)
- Samsung HVAC Submittal — CL-MC03\*\*C Modbus Adapter (SHA-DVMS-03162021)
  
  [s3.amazonaws.com](https://s3.amazonaws.com/samsung-files/Tech_Files/Controls/Central+Control/Submittals/CL-MC03+C+SUBMITTAL_MODBUS+IM_03162021.pdf) 2026-04-25
  
  [PDF](https://taphome.com/compatibility/devices/cyklogic-cl-mc030x/manufacturer/CL-MC03_Samsung_Submittal.pdf)
- Samsung HVAC FAQ — Modbus Adapter CL-MC03\*\*C (Nov 2016)
  
  [s3.amazonaws.com](https://s3.amazonaws.com/samsung-files/Tech_Files/Controls/Misc+Supporting+Documents/CL-MC03+C_Modbus/FAQ_Modbus_11202016.pdf) 2026-04-25
  
  [PDF](https://taphome.com/compatibility/devices/cyklogic-cl-mc030x/manufacturer/FAQ_Modbus.pdf)
- Cyclogic CL-MC0301C Installation Manual (Rev. 1) — Clima Market mirror
  
  [www.climamarket.bg](https://www.climamarket.bg/wp-content/uploads/CL-MC0301C_Installation-Manual.pdf) 2026-04-25
  
  [PDF](https://taphome.com/compatibility/devices/cyklogic-cl-mc030x/manufacturer/CL-MC0301C_Installation-Manual.pdf)

Dokumenty producentów są © ich właścicieli. Udostępniamy je w formie opublikowanej przez producenta, wyłącznie w celach informacyjnych.

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