---
title: "Cyclogic CL-MC030x"
description: "Ovládejte Samsung DVM, CAC, FJM a RAC jednotky přes Modbus RTU na F1/F2 — ON/OFF, režim, ventilátor, lamely a termostat. Šablona pro CL-MC03**C."
url: "https://taphome.com/cs/compatibility/cyklogic-cl-mc030x/"
language: cs
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 integrovat Samsung HVAC do TapHome přes Cyclogic CL-MC030x?","Co je Cyclogic CL-MC030x a které Samsung vnitřní jednotky podporuje?","Kolik Samsung vnitřních jednotek dokáže Cyclogic CL-MC030x ovládat?","Jaký gateway potřebuji pro připojení Cyclogic CL-MC030x k TapHome?","Proč se Samsung klimatizace přepne na chlazení, když v TapHome zvolím Heat?","Proč jsou teploty na Cyclogic CL-MC030x 10× menší, než by měly být?","Jaká je Modbusová mapa registrů Cyclogic CL-MC030x?"]
---

# Cyclogic CL-MC030x

Komunikace: Modbus TCP

- [Oficiální stránka 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)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Série Cyclogic CL-MC03**C (znak **`x`** v názvu šablony je zástupný symbol pro variantní příponu `1` / `8` / `16` / `32` / `64`) je Modbus RTU interface modul, který přenáší Samsung vnitřní jednotky na Modbusovou síť. Připojuje se přímo na **Samsung F1/F2 komunikační sběrnici vnitřní jednotky** a zpřístupňuje ON/OFF, provozní režim, žádanou/pokojovou teplotu, otáčky ventilátoru a kývání lamel jako Modbusové holding registry. Modul vyrábí **Cyclogic Inc.** (Korejská republika) a OEM-distribuuje ho Samsung HVAC pro severoamerický trh — zařízení, mapa registrů a protokol jsou identické ve všech pěti variantách, liší se pouze maximální počet adresovatelných vnitřních jednotek.

| Model | Počet ovládaných vnitřních jednotek |
|-------|-------------------------------------|
| CL-MC0301C | 1 (typicky RAC) |
| CL-MC0308C | 1 – 8 (malé DVM/CAC/FJM) |
| CL-MC0316C | 1 – 16 (střední DVM) |
| CL-MC0332C | 1 – 32 (velké DVM) |
| CL-MC0364C | 1 – 64 (maximální DVM, jeden adaptér na venkovní jednotku) |

Kompatibilní Samsung vnitřní jednotky zahrnují **DVM S** (`AM****N****/AA`), **CAC** (`AC****N****/AA`), **FJM** (`AJ0***N****/AA`) a **RAC** (`AR*********N**`). Samsung **Novus** RAC modely `AR**JSALBWKNCV` a `AR**JSFLBWKNCV` výslovně **nejsou podporovány**.

CL-MC03**C je Modbus RTU slave; TapHome `ModbusTcpCCU` se k němu připojuje přes externí **Modbus RTU/TCP gateway**, který převádí RS-485 sběrnici na Ethernet. Aktuální TapHome šablona adresuje **pouze první vnitřní jednotku (IDU 00)** na sběrnici — pro instalace s více vnitřními jednotkami je třeba šablonu importovat jednou pro každou jednotku (viz *Řešení problémů* níže).

> [!WARNING]
> Mezi TapHome XML šablonou a dokumentací výrobce Cyclogic / Samsung bylo identifikováno několik nesrovnalostí — zejména **prohozená označení Heat a Cool** v selektoru režimu a **dělitel teploty /100** namísto dokumentovaného /10. Před nasazením šablony do produkce si projděte sekci *Nesrovnalosti mezi šablonou a dokumentací výrobce*.

## Hardwarové připojení

CL-MC03**C je malý modul v pouzdře na DIN lištu (100 × 80 × 24 mm) s jednořadou svorkovnicí na čelní straně. Šest označených konektorů nese komunikaci, napájení a pomocné I/O linky.

### Svorkovnice

![Svorkovnice Cyclogic CL-MC03**C — MODBUS INT (RS-485 ke gatewayi), RS-485 (F1/F2 k Samsungu), MODBUS EXT (rezervováno), POWER (12 V DC), DO (výstup chyby) a DRY CONT (vstup nuceného ON/OFF)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/wiring-terminals_hu_937870580ffff8f4.jpg)

| # | Konektor | Popis |
|---|----------|-------|
| 1 | **MODBUS INT** | RS-485 (RX+ / RX−) — k externímu Modbus RTU/TCP gatewayi |
| 2 | **RS-485** | F1 / F2 — ke svorkám F1/F2 Samsung vnitřní jednotky |
| 3 | **MODBUS EXT** | Rezervováno — nepoužívá se |
| 4 | **POWER** | Napájení 12 V DC (+ / −) |
| 5 | **DO** | Digitální výstup — kontakt sepne (12 – 24 V DC) při chybě Samsung systému |
| 6 | **DRY CONT** | Bezpotenciálový vstup pro externí nucené ON/OFF (např. okenní kontakt) |

Modul je **napájen 12 V DC**, typicky přímo ze svorek **V1/V2** Samsung vnitřní jednotky na vnitřním PCB — pro běžné instalace není potřeba samostatný zdroj. Volitelně lze použít i externí 12 V DC adaptér. Samsung submittal potvrzuje, že modul akceptuje 12 – 24 V DC, ale instalační příručka Cyclogic uvádí jako jmenovitou hodnotu 12 V DC.

> [!WARNING]
> Před otevřením Samsung vnitřní jednotky kvůli přístupu ke svorkám F1/F2 a V1/V2 odpojte síťové napájení. Před zapnutím modulu zkontrolujte polaritu na svorce POWER. Maximální délka RS-485 (Modbus) sběrnice je **500 m**; modul instalujte pouze do interiéru — provozní teplota je **0 °C až 40 °C** (32 °F až 104 °F).

### Topologie systému

![Topologie Cyclogic CL-MC03**C — Případ 1 (DVM/CAC, DIP SW2 OFF) s jedním modulem na F1/F2 sběrnici a Případ 2 (RAC, DIP SW2 ON) s jedním modulem na RAC systém na sdíleném Modbus masteru](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/system-connection-diagram_hu_3acea40f45ac7ab.jpg)

V závislosti na integrovaném Samsung typu jsou dvě platné topologie:

- **Případ 1 — DVM / CAC** (DIP SW2 = **OFF**, NASA protokol): jeden CL-MC03 modul je umístěn na F1/F2 sběrnici, kterou sdílí jedna venkovní jednotka a až 64 vnitřních jednotek. Zvolte variantu pokrývající celkový počet IDU venkovní jednotky — sizing je jednorázový, dva adaptéry nelze stohovat na téže venkovní jednotce (viz *Řešení problémů*).
- **Případ 2 — RAC** (DIP SW2 = **ON**, Non-NASA protokol): jeden CL-MC03 modul na RAC venkovní systém (typicky `CL-MC0301C` — jedna IDU). Více modulů je na stejné RS-485 sběrnici, každý s jedinečnou slave adresou nastavenou přes rotary switche.

Obě topologie sdílejí jeden externí RS-485/Ethernet gateway, který vůči TapHome funguje jako Modbus master.

## Konfigurace

### DIP switche

![DIP switche na čelní straně Cyclogic CL-MC03**C — SW1 (firmware update) a SW2 (výběr Samsung AC protokolu — RAC/FJM vs DVM/CAC)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/dip-switches_hu_b3d8b4e6997047d3.jpg)

| Switch | Poloha | Funkce |
|--------|--------|--------|
| **SW2** (protokol) | **ON** | RAC / FJM — modelová čísla `AR*****`, `AJ*****` (Non-NASA protokol) |
| **SW2** (protokol) | **OFF** | DVM / CAC — modelová čísla `AM*****`, `AC****` (NASA protokol) |
| **SW1** (firmware) | **ON** (default) | Vypnuto — běžný provoz |
| **SW1** (firmware) | **OFF** | Zapnuto — režim stahování firmwaru (během běžného provozu nepoužívat) |

> [!WARNING]
> SW2 musí být nastaven **před** zapnutím modulu — zapojení modulu na špatnou protokolovou rodinu (např. SW2 = OFF na RAC systému nebo SW2 = ON na DVM systému) způsobí **úplně žádnou komunikaci** se Samsung vnitřní jednotkou. Cyclogic příručka to označuje za nejčastější instalační chybu.

### Modbusová slave adresa (RSW1 + RSW2)

Modbusová slave adresa (RS-485 adresa, kterou bude gateway pollovat tento modul) se nastavuje dvěma BCD rotary switchi na DPS, přístupnými po odšroubování čtyř šroubů na zadní straně pouzdra:

- **RSW1** — desítky (`0` – `6`)
- **RSW2** — jednotky (`0` – `9`)

Společná hodnota tvoří slave adresu, platný rozsah **00 – 63**. Každý modul na stejné RS-485 sběrnici musí mít **jedinečnou adresu** — nejčastějším konfliktem je více `CL-MC0301C` modulů ponechaných na tovární hodnotě. TapHome šablona má v import parametrech **default Slave ID = 1**; pokud rotary switche ponecháte na této adrese, importovanou konfiguraci není nutné měnit.

### Parametry Modbus protokolu

Tyto hodnoty jsou pevně nastaveny ve firmwaru modulu a **nelze** je změnit přes DIP switche — RS-485 strana gatewaye musí být nakonfigurována shodně:

| Parametr | Hodnota |
|----------|---------|
| Režim | Modbus RTU **slave** |
| Baud rate | **19 200 bps** (Samsung submittal uvádí `19600` — překlep standardní rychlosti Samsung F-busu 19 200) |
| Parita | Even (sudá) |
| Stop bity | 1 |
| Formát rámce | 8E1 (8 datových bitů, sudá parita, 1 stop bit) |
| Funkční kódy | `03` (Read Holding Registers), `06` (Preset Single Register) |
| Šířka registru | 2 bajty (16 bit) |
| Maximální délka RS-485 sběrnice | 500 m |

### Aktivace Modbus komunikace přes TCP gateway

CL-MC03**C je nativně Modbus RTU zařízení — TapHome se k němu připojuje přes Modbus TCP prostřednictvím externího **Modbus RTU/TCP gatewaye** (někdy označovaného jako RS-485/Ethernet konvertor). Funguje jakýkoliv gateway s režimem **transparent / pass-through Modbus TCP-to-RTU bridge**; běžně používané modely jsou Waveshare RS485-to-Ethernet, série USR-TCP232 a Hi-Flying / HF série.

Konfigurace na gatewayi (názvy menu se liší podle modelu):

1. Připojte RS-485 svorky A/B gatewaye na svorku **MODBUS INT** modulu (RX+ → A, RX− → B). Gateway napájejte ze samostatného zdroje (typicky 5 – 24 V DC).
2. Sériový port gatewaye nastavte na **19 200 bps, 8 datových bitů, sudá parita, 1 stop bit**, aby se shodoval s pevnými nastaveními modulu. Pokud gateway exponuje i parametr časování rámce, ponechte ho na Modbus default (3,5 znaků idle).
3. Provozní režim gatewaye nastavte na **Modbus TCP slave / Modbus TCP-to-RTU bridge / transparent gateway** (terminologie se liší podle výrobce) na TCP portu **502**.
4. Gatewayi přiřaďte **statickou IP adresu** v lokální síti — buď přes DHCP rezervaci na routeru, nebo přímo ve webovém UI gatewaye. TapHome šablona má default `192.168.0.1`; shoda s touto adresou eliminuje potřebu měnit import parametr.
5. Pokud má gateway zabudovaný **120 Ω terminační rezistor**, povolte ho jen pokud gateway sedí na konci RS-485 sběrnice.

Při importu šablony v TapHome zadejte:

- **IP adresa** — IP gatewaye v lokální síti (default: `192.168.0.1`)
- **Slave ID** — Modbusová adresa modulu nastavená přes RSW1 + RSW2 (default: `1`)

> [!TIP]
> Více `CL-MC03**C` modulů na stejné RS-485 sběrnici může sdílet jeden gateway — každý modul se adresuje přes jeho rotary slave adresu jako Modbus unit ID v TapHome.

## Schopnosti zařízení

Šablona polluje **6 holding registrů** (H:0, H:1, H:4, H:5, H:8, H:9) každých 2,5 s pro vnitřní jednotku 00 na F1/F2 sběrnici a zpřístupňuje 5 logických zařízení.

### ON/OFF

Jednoduchý spínač pro zapnutí nebo vypnutí vnitřní jednotky. Čte register H:0 (Bool) — `0` = OFF, `1` = ON.

> [!NOTE]
> Cyclogic register 40001 (= H:0) je dokumentován jako **2-bajtový kombinovaný write příkaz** s Data 1 = ON/OFF a Data 2 = Mode. TapHome šablona zapisuje pouze bajt Bool ON/OFF, takže provozní režim je třeba nastavit samostatně přes zařízení Mode. Na většině Samsung vnitřních jednotek je částečný zápis akceptován pouze jako ON/OFF a stávající režim se zachová — ověřte na reálném hardwaru.

### Mode

Selektor provozního režimu. Cyclogic / Samsung manuály dokumentují následující kódy:

| Kód v manuálu | Režim |
|---------------|-------|
| 0 | Auto |
| 1 | Cooling (chlazení) |
| 2 | Dry (odvlhčování) |
| 3 | Fan (ventilátor) |
| 4 | Heat (topení) |
| 11 | Auto Cool (pouze čtení) |
| 12 | Auto Dry (pouze čtení) |
| 13 | Auto Fan (pouze čtení) |
| 14 | Auto Heat (pouze čtení) |

> [!WARNING]
> TapHome šablona **prohazuje označení Heat a Cool** oproti Cyclogic / Samsung manuálům: pozice šablony `1` má označení „Heat", ale Modbus hodnota `1` je dokumentována jako **Cooling**, a pozice šablony `4` má označení „Cool", ale hodnota `4` je dokumentována jako **Heat**. Na reálné Samsung jednotce tedy volba „Heat" v TapHome UI spustí **chlazení** a volba „Cool" spustí **topení**. Před spolehnutím se na označení **ověřte na reálném hardwaru** — hodnoty šablony může být nutné přemapovat podle toho, co Samsung vnitřní jednotka skutečně dělá.

> [!NOTE]
> Sub-režimy Auto-COOL / Auto-DRY / Auto-FAN / Auto-HEAT jsou dokumentovány jako hodnoty **pouze pro čtení**, které odrážejí vnitřní stav jednotky při provozu v režimu Auto. TapHome šablona je exponuje na pozicích 5 – 8 s raw hodnotami 5 – 8, ale výrobce uvádí hodnoty 11 – 14. Zápis kterékoliv z těchto pozic pošle vnitřní jednotce nedokumentovanou Modbus hodnotu a výsledek je nedefinován — při ovládání jednotky z TapHome je nechte na Auto.

Čte a zapisuje register H:1 (Int16). Interval pollingu: 2,5 s.

### Otáčky ventilátoru

Selektor otáček ventilátoru. Cyclogic / Samsung manuály dokumentují pouze **5 hodnot** (0 – 4):

| Kód v manuálu | Otáčky |
|---------------|--------|
| 0 | Automatické |
| 1 | Low (nízké) |
| 2 | Middle (střední) |
| 3 | High (vysoké) |
| 4 | Turbo |

> [!WARNING]
> TapHome šablona vkládá nestandardní slot „Position-5" při hodnotě `2`, čímž posouvá MIDDLE / HIGH / TURBO na hodnoty `3` / `4` / `5`. Na reálné Samsung jednotce tedy volba „Mid" v TapHome UI ve skutečnosti spustí **HIGH** (raw hodnota `3`), „High" spustí **TURBO** (raw hodnota `4`) a „Turbo" pošle raw hodnotu `5`, což není platný kód otáček. Sloty 6 – 9 (Position-6, Position-7, 8, 9) jsou placeholder hodnoty nedosažitelné na reálných Samsung vnitřních jednotkách. Před spolehnutím se na označení **ověřte na reálném hardwaru**.

> [!NOTE]
> Podle Cyclogic manuálu je register 40009 (= H:8) **2-bajtový kombinovaný write příkaz** s Data 1 = Fan Speed a Data 2 = Louver. TapHome šablona zapisuje pouze bajt otáček a poloha lamel se zapisuje samostatně jako jeden bajt do registru H:9 — toto nemusí souhlasit s tím, co každý gateway očekává na kombinovaném registru H:8. Ověřte na reálném hardwaru.

Čte a zapisuje register H:8 (Int16). Interval pollingu: 2,5 s.

### Poloha lamel (Louver Swing)

Ovládání kývání lamel dekorativního panelu. Cyclogic / Samsung manuály dokumentují pouze **4 hodnoty** (0 – 3):

| Kód v manuálu | Poloha |
|---------------|--------|
| 0 | Swing OFF |
| 1 | Swing ON: horní a dolní lamely |
| 2 | Swing ON: pravé a levé lamely |
| 3 | Swing ON: horní a dolní + pravé a levé lamely |

> [!WARNING]
> TapHome šablona **duplikuje** „RIGHT & LEFT LOUVER" jako pozici 2 i pozici 3 — pozice 3 má být podle dokumentace výrobce „UPPER & LOWER + RIGHT & LEFT LOUVER". Pozice 4 – 9 (kombinované U&D / R&L lamely, Swing ON, Position-7, Position-6, Position-5 Vertical, Swirl) jsou **nedokumentované** v Cyclogic a Samsung manuálech — mohou to být spekulativní sloty určené pro jiné než dekorativní kazetové jednotky, ale na standardních nástěnných, kazetových a kanálových jednotkách nejsou dosažitelné. Před spolehnutím se na označení **ověřte na reálném hardwaru**.

Čte a zapisuje register H:9 (Int16). Interval pollingu: 2,5 s.

### Termostat

Žádaná hodnota a aktuální pokojová teplota. Čte register H:4 (Int16, R/W) pro žádanou hodnotu a register H:5 (Int16, pouze pro čtení) pro pokojovou teplotu.

> [!WARNING]
> TapHome šablona aplikuje **dělitel /100** (a násobitel `* 100` při zápisu) na oba registry teploty, ale Cyclogic Rev. 2 manuál a Samsung submittal **oba uvádějí /10**: raw `250` = 25,0 °C, ne raw `2500` = 25,0 °C. Na reálné Samsung vnitřní jednotce:
> - Žádané hodnoty zapsané z TapHome budou **10× větší** (např. nastavení 25 °C zapíše do registru raw `2500`, což zařízení interpretuje jako 250,0 °C a odmítne nebo ořeže).
> - Hodnoty pokojové teploty budou **10× menší** (např. raw `235` se zobrazí jako 2,35 °C namísto 23,5 °C).
>
> Pokud pozorujete hodnoty 10× menší, je to téměř určitě příčina. **Ověřte na reálném hardwaru** a kontaktujte TapHome, aby v šabloně opravili scaling z `/100` na `/10`.

Interval pollingu: 2,5 s.

## Nesrovnalosti mezi šablonou a dokumentací výrobce

Několik rozporů mezi TapHome XML šablonou a Cyclogic Rev. 2 (říjen 2017) manuálem / Samsung submittalem (SHA-DVMS-03162021) je popsáno výše. Souhrn:

| Oblast | Šablona | Manuál | Dopad |
|--------|---------|--------|-------|
| Označení režimu (pozice 1 a 4) | 1 = Heat, 4 = Cool | 1 = Cooling, 4 = Heat | Volba „Heat" spustí chlazení a naopak — ověřte na hardwaru |
| Pozice režimu 5 – 9 | Raw hodnoty 5 – 9 (Auto-*) | Auto-* sub-režimy používají hodnoty **11 – 14** a jsou pouze pro čtení | Zápis pozic 5 – 9 pošle nedokumentované hodnoty — nedefinované chování |
| Pozice otáček 2 – 9 | Vkládá nestandardní „Position-5" při hodnotě 2, posouvá Mid/High/Turbo | Manuál dokumentuje pouze hodnoty 0 – 4 | „Mid" → HIGH, „High" → TURBO, „Turbo" → neplatné; pozice 6 – 9 placeholder |
| Poloha lamel 3 | Duplikát „Right & Left Louver" | Má být „Upper & Lower + Right & Left Louver" | Označení nesedí — hodnota registru je správná |
| Poloha lamel 4 – 9 | Různá označení včetně „Swirl", „Position-5 (Vertical)" | Manuál dokumentuje pouze hodnoty 0 – 3 | Nedokumentované — nedefinované na standardních nástěnných / kazetových / kanálových jednotkách |
| Scaling termostatu | `/ 100` a `* 100` | `/ 10` a `* 10` | Zapsané žádané hodnoty 10× větší, pokojová teplota 10× menší |
| Zápis ON/OFF | Jeden Bool bajt (pouze Data 1) | Kombinovaný 2-bajtový příkaz (Data 1 = ON/OFF, Data 2 = Mode) | Na většině jednotek akceptován jako částečný zápis, ale ověřte zachování režimu |
| Zápis otáček | Jeden Int16 (pouze Data 1) | Kombinovaný 2-bajtový příkaz (Data 1 = Fan, Data 2 = Louver) | Poloha lamel se zapisuje samostatně na H:9 — ověřte chování na reálném hardwaru |

Jsou to s velkou pravděpodobností bugy XML šablony, které by se měly opravit proti reálnému hardwaru.

## Řešení problémů

### Žádná Modbus komunikace

1. Ověřte, zda je **DIP SW2** nastaven správně pro Samsung rodinu — **OFF** pro DVM / CAC (NASA, prefixy modelů `AM`, `AC`), **ON** pro RAC / FJM (Non-NASA, prefixy modelů `AR`, `AJ`). Špatný protokol = žádná komunikace.
2. Ověřte, zda je modul napájen — zelená LED PWR / System na čelní straně musí svítit. Pokud je napájen z V1/V2, zkontrolujte, zda je Samsung vnitřní jednotka připojena k síti.
3. Potvrďte, že **slave adresa** na RSW1 + RSW2 odpovídá Slave ID v import parametrech TapHome (tovární default = `01`, default šablony = `1`).
4. Zkontrolujte nastavení sériového portu gatewaye: **19 200 bps, 8 datových bitů, sudá parita, 1 stop bit** (8E1) — toto je nejčastěji špatná konfigurace na straně gatewaye.
5. Potvrďte, že je gateway v režimu **Modbus TCP-to-RTU transparent bridge** (ne virtuální COM port) a poslouchá na TCP portu **502**.
6. Ověřte polaritu zapojení na **MODBUS INT** — RX+ na A gatewaye, RX− na B gatewaye. Některé gateway používají opačnou konvenci polarity; pokud LED blikají bez úspěšného pollingu, prohoďte oba vodiče.
7. Zkontrolujte, že na stejné RS-485 sběrnici není druhý modul se stejnou RSW adresou.

### Žádané hodnoty a pokojová teplota jsou 10× menší

TapHome XML aplikuje dělitel `/100` na registry H:4 a H:5, ale dokumentace výrobce uvádí `/10`. Žádaná hodnota 25 °C bude tedy přenášena jako raw `2500` Samsung vnitřní jednotce, která očekává raw `250`, a hodnota pokojové teploty raw `235` (= 23,5 °C podle manuálu) se v TapHome UI zobrazí jako `2,35 °C`. Použijte Modbus debug nástroj v TapHome pro čtení raw hodnot registrů a kontaktujte TapHome, aby v šabloně opravili scaling z `/100` na `/10`.

### Výběr Heat a Cool je obrácený

Pozice šablony pro Heat a Cool nesedí s Cyclogic manuálem (šablona `1` = Heat / hodnota `1`, manuál `1` = Cooling). Na reálné Samsung jednotce tedy volba „Heat" v TapHome UI spustí **chlazení** a „Cool" spustí **topení**. Než bude šablona opravena, vybírejte podle fyzického chování, ne podle označení.

### Pozice režimu 5 – 9 nic nedělají nebo se chovají nepředvídatelně

Tyto pozice zapisují Modbus hodnoty 5 – 9 do registru H:1, ale Cyclogic manuál uvádí pro Auto-* sub-režimy hodnoty **11 – 14** a explicitně uvádí, že jsou pouze pro čtení. Zápis hodnot 5 – 9 pošle vnitřní jednotce nedokumentované kódy — výsledek je nedefinován a závisí na firmwaru Samsung. Volbu režimu omezte pouze na pozice 0 – 4.

### Pozice otáček Mid / High / Turbo nesedí s označením

TapHome šablona vkládá nestandardní slot „Position-5" při hodnotě 2, čímž posouvá MIDDLE / HIGH / TURBO na hodnoty šablony 3 / 4 / 5. Označení „Mid" v TapHome tedy ve skutečnosti spustí **HIGH**, „High" spustí **TURBO** a „Turbo" pošle raw hodnotu `5`, což není dokumentovaný kód otáček. Vybírejte podle fyzického chování, ne podle označení, dokud se šablona neopraví.

### Jedna vnitřní jednotka na multi-IDU adaptéru neodpovídá

Pokud máte `CL-MC0308C` nebo větší a chcete ovládat více než první vnitřní jednotku, samotná současná šablona nestačí — polluje pouze registry pro IDU 00. Pro každou další IDU importujte šablonu podruhé (potřetí, …) a v importované konfiguraci upravte adresy registrů přidáním `+20 × N` ke každé (např. IDU 01 → H:20, H:21, H:24, H:25, H:28, H:29). Nativní multi-IDU šablona je v plánech.

### Dva adaptéry na téže venkovní jednotce nepokryjí všechny vnitřní jednotky

Dva menší `CL-MC03**C` varianty nelze stohovat na týž Samsung venkovní systém — oba moduly počítají IDU adresy od `00` nahoru a výše číslované IDU budou nedosažitelné. Nahraďte oba moduly jedním větším variantem dimenzovaným na celkový počet IDU (podle Samsung HVAC FAQ, listopad 2016).

## Dostupná zařízení 5

Tato zařízení se po importu zobrazí v TapHome.

Cyclogic CL-MC030x Modul

ON/OFF Přepínač Čtení i zápis

Zapíná nebo vypíná Samsung vnitřní jednotku (register H:0, Bool — 0 = OFF, 1 = ON)

Registr: H:0 Bool

Hodnoty / Stavy: ON · OFF

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Režim Vícestavový přepínač Čtení i zápis

Provozní režim — Auto, Heat, Dry, Fan, Cool (register H:1; šablona prohazuje označení Heat a Cool oproti Cyclogic manuálu — ověřte na reálném hardwaru. Pozice 5 – 9 posílají nedokumentované hodnoty a chovají se nepředvídatelně)

Registr: H:1 Int16 numeric

Hodnoty / Stavy: Auto · Heat · Dry · Fan · Cool · Auto COOL · Auto DRY · Auto FAN · Auto HEAT

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Otáčky ventilátoru Vícestavový přepínač Čtení i zápis

Otáčky ventilátoru — Auto, Low, Middle, High, Turbo (register H:8; šablona vkládá nestandardní slot 'Position-5' při hodnotě 2, takže 'Mid' spustí HIGH a 'High' spustí TURBO na reálném hardwaru. Pozice 6 – 9 jsou placeholder hodnoty nedosažitelné na Samsung vnitřních jednotkách)

Registr: H:8 Int16 numeric

Hodnoty / Stavy: Auto · Low · Mid · High · Turbo

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Poloha lamel Vícestavový přepínač Čtení i zápis

Kývání lamel dekorativního panelu — Swing Off, horní a dolní, pravé a levé, kombinované horní a dolní / pravé a levé (register H:9; pozice 4 – 9 jsou v Cyclogic manuálu nedokumentované a nedosažitelné na standardních nástěnných, kazetových a kanálových jednotkách)

Registr: H:9 Int16 numeric

Hodnoty / Stavy: Swing OFF · UPPER & LOWER LOUVER · RIGHT & LEFT LOUVER · UPPER&LOWER/RIGHT&LEFT LOUVER

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Termostat Termostat Čtení i zápis

Žádaná hodnota a aktuální pokojová teplota v °C (register H:4 R/W žádaná hodnota, register H:5 pouze pro čtení pokojová teplota; šablona aplikuje dělitel /100, ale výrobce uvádí /10 — čtené hodnoty mohou být 10× menší a zapsané žádané hodnoty 10× větší, dokud se šablona neopraví)

Registr: H:4 Int16 Jednotka: °C numeric

Čtení teploty

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

Čtení požadované teploty

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

Zápis požadované teploty

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

**Připojení:** Modbus TCP • Slave ID: $\[SlaveId]

Možná vylepšení (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

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| Slave ID          | `1`           |
| IP adresa         | `192.168.0.1` |

## Zdroje

- 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 výrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci.

## Související dokumentace

- [Modbus Integration](https://taphome.com/cs/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/cs/docs/integration/modbus/)
- [Jednoduché nastavení pomocí šablon](https://taphome.com/cs/docs/integration/modbus/templates/)
- [Skripty Modbus a prefetch](https://taphome.com/cs/docs/script/modbus-scripts/)
- [Funkce Modbus](https://taphome.com/cs/docs/script/modbus/)
- [Datové typy Modbus](https://taphome.com/cs/docs/script/modbus-data-types/)