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).
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
| # | 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.
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
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
| 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) |
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):
- 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).
- 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).
- 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.
- 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. - 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)
Přiřaďte TCP/RTU gatewayi statickou IP adresu v DHCP nastaveních routeru, aby se adresa po restartu nezměnila. Více
CL-MC03**Cmodulů 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.
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í) |
TapHome šablona prohazuje označení Heat a Cool oproti Cyclogic / Samsung manuálům: pozice šablony
1má označení „Heat", ale Modbus hodnota1je dokumentována jako Cooling, a pozice šablony4má označení „Cool", ale hodnota4je 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á.
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 |
TapHome šablona vkládá nestandardní slot „Position-5" při hodnotě
2, čímž posouvá MIDDLE / HIGH / TURBO na hodnoty3/4/5. Na reálné Samsung jednotce tedy volba „Mid" v TapHome UI ve skutečnosti spustí HIGH (raw hodnota3), „High" spustí TURBO (raw hodnota4) a „Turbo" pošle raw hodnotu5, 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.
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 |
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.
TapHome šablona aplikuje dělitel /100 (a násobitel
* 100při zápisu) na oba registry teploty, ale Cyclogic Rev. 2 manuál a Samsung submittal oba uvádějí /10: raw250= 25,0 °C, ne raw2500= 25,0 °C. Na reálné Samsung vnitřní jednotce:
- Žádané hodnoty zapsané z TapHome budou 10× menší (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
235se 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
/100na/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 | Žádané hodnoty 10× menší, 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
- 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. - 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.
- Potvrďte, že slave adresa na RSW1 + RSW2 odpovídá Slave ID v import parametrech TapHome (tovární default =
01, default šablony =1). - 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.
- 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.
- 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.
- 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).
