Séria Cyclogic CL-MC03**C (znak x v názve šablóny je zástupný symbol pre variantnú príponu 1 / 8 / 16 / 32 / 64) je Modbus RTU interface modul, ktorý prenáša Samsung vnútorné jednotky na Modbusovú sieť. Pripája sa priamo na Samsung F1/F2 komunikačnú zbernicu vnútornej jednotky a sprístupňuje ON/OFF, prevádzkový režim, žiadanú/izbovú teplotu, otáčky ventilátora a kývanie lamiel ako Modbusové holding registre. Modul vyrába Cyclogic Inc. (Kórejská republika) a OEM-distribuuje ho Samsung HVAC pre severoamerický trh — zariadenie, mapa registrov a protokol sú identické vo všetkých piatich variantoch, líši sa iba maximálny počet adresovateľných vnútorných jednotiek.
| Model | Počet ovládaných vnútorných jednotiek |
|---|---|
| CL-MC0301C | 1 (typicky RAC) |
| CL-MC0308C | 1 – 8 (malé DVM/CAC/FJM) |
| CL-MC0316C | 1 – 16 (stredné DVM) |
| CL-MC0332C | 1 – 32 (veľké DVM) |
| CL-MC0364C | 1 – 64 (maximálne DVM, jeden adaptér na vonkajšiu jednotku) |
Kompatibilné Samsung vnútorné jednotky zahŕňajú 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ýslovne nie sú podporované.
CL-MC03**C je Modbus RTU slave; TapHome ModbusTcpCCU sa k nemu pripája cez externý Modbus RTU/TCP gateway, ktorý prevádza RS-485 zbernicu na Ethernet. Aktuálna TapHome šablóna adresuje iba prvú vnútornú jednotku (IDU 00) na zbernici — pre inštalácie s viacerými vnútornými jednotkami treba šablónu importovať raz pre každú jednotku (viď Riešenie problémov nižšie).
Medzi TapHome XML šablónou a dokumentáciou výrobcu Cyclogic / Samsung bolo identifikovaných niekoľko nezrovnalostí — najmä prehodené označenia Heat a Cool v selektore režimu a delič teploty /100 namiesto dokumentovaného /10. Pred nasadením šablóny do produkcie si pozri sekciu Nezrovnalosti medzi šablónou a dokumentáciou výrobcu.
Hardvérové pripojenie
CL-MC03**C je malý modul v puzdre na DIN lištu (100 × 80 × 24 mm) s jednoradovou svorkovnicou na čelnej strane. Šesť označených konektorov nesie komunikáciu, napájanie a pomocné I/O linky.
Svorkovnica
| # | Konektor | Popis |
|---|---|---|
| 1 | MODBUS INT | RS-485 (RX+ / RX−) — k externému Modbus RTU/TCP gatewayu |
| 2 | RS-485 | F1 / F2 — k F1/F2 svorkám Samsung vnútornej jednotky |
| 3 | MODBUS EXT | Rezervované — nepoužíva sa |
| 4 | POWER | Napájanie 12 V DC (+ / −) |
| 5 | DO | Digitálny výstup — kontakt sa zopne (12 – 24 V DC) pri chybe Samsung systému |
| 6 | DRY CONT | Bezpotenciálový vstup pre externé nútené ON/OFF (napr. okenný kontakt) |
Modul je napájaný 12 V DC, typicky priamo zo svoriek V1/V2 Samsung vnútornej jednotky na vnútornom PCB — pre bežné inštalácie nie je potrebný samostatný zdroj. Voliteľne možno použiť aj externý 12 V DC adaptér. Samsung submittal potvrdzuje, že modul akceptuje 12 – 24 V DC, ale inštalačná príručka Cyclogic uvádza ako menovitú hodnotu 12 V DC.
Pred otvorením Samsung vnútornej jednotky kvôli prístupu k svorkám F1/F2 a V1/V2 odpojte sieťové napájanie. Pred zapnutím modulu skontrolujte polaritu na svorke POWER. Maximálna dĺžka RS-485 (Modbus) zbernice je 500 m; modul inštalujte len do interiéru — prevádzková teplota je 0 °C až 40 °C (32 °F až 104 °F).
Topológia systému
V závislosti od integrovaného Samsung typu sú dve platné topológie:
- Prípad 1 — DVM / CAC (DIP SW2 = OFF, NASA protokol): jeden CL-MC03 modul je umiestnený na F1/F2 zbernici, ktorú zdieľa jedna vonkajšia jednotka a až 64 vnútorných jednotiek. Zvoľte variant pokrývajúci celkový počet IDU vonkajšej jednotky — sizing je jednorazový, dva adaptéry nemožno stohovať na tú istú vonkajšiu jednotku (viď Riešenie problémov).
- Prípad 2 — RAC (DIP SW2 = ON, Non-NASA protokol): jeden CL-MC03 modul na RAC vonkajší systém (typicky
CL-MC0301C— jedna IDU). Viac modulov je na rovnakej RS-485 zbernici, každý s jedinečnou slave adresou nastavenou cez rotary switche.
Obe topológie zdieľajú jeden externý RS-485/Ethernet gateway, ktorý voči TapHome funguje ako Modbus master.
Konfigurácia
DIP switche
| Switch | Poloha | Funkcia |
|---|---|---|
| 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) | Vypnuté — bežná prevádzka |
| SW1 (firmware) | OFF | Zapnuté — režim sťahovania firmvéru (počas bežnej prevádzky nepoužívať) |
SW2 musí byť nastavený pred zapnutím modulu — zapojenie modulu na zlú protokolovú rodinu (napr. SW2 = OFF na RAC systéme alebo SW2 = ON na DVM systéme) spôsobí úplne žiadnu komunikáciu so Samsung vnútornou jednotkou. Cyclogic príručka to označuje za najčastejšiu inštalačnú chybu.
Modbusová slave adresa (RSW1 + RSW2)
Modbusová slave adresa (RS-485 adresa, ktorou bude gateway poľovať tento modul) sa nastavuje dvomi BCD rotary switchmi na DPS, prístupnými po odskrutkovaní štyroch skrutiek na zadnej strane puzdra:
- RSW1 — desiatky (
0–6) - RSW2 — jednotky (
0–9)
Spoločná hodnota tvorí slave adresu, platný rozsah 00 – 63. Každý modul na rovnakej RS-485 zbernici musí mať jedinečnú adresu — najčastejším konfliktom je viacero CL-MC0301C modulov ponechaných na továrenskej hodnote. TapHome šablóna má v import parametroch default Slave ID = 1; ak rotary switche ponecháte na tejto adrese, importovanú konfiguráciu netreba meniť.
Parametre Modbus protokolu
Tieto hodnoty sú pevne nastavené vo firmvéri modulu a nemožno ich zmeniť cez DIP switche — RS-485 strana gatewaya musí byť nakonfigurovaná zhodne:
| Parameter | Hodnota |
|---|---|
| Režim | Modbus RTU slave |
| Baud rate | 19 200 bps (Samsung submittal uvádza 19600 — preklep štandardnej rýchlosti Samsung F-busu 19 200) |
| Parita | Even (párna) |
| Stop bity | 1 |
| Formát rámca | 8E1 (8 dátových bitov, párna parita, 1 stop bit) |
| Funkčné kódy | 03 (Read Holding Registers), 06 (Preset Single Register) |
| Šírka registra | 2 bajty (16 bit) |
| Maximálna dĺžka RS-485 zbernice | 500 m |
Aktivácia Modbus komunikácie cez TCP gateway
CL-MC03**C je natívne Modbus RTU zariadenie — TapHome sa k nemu pripája cez Modbus TCP prostredníctvom externého Modbus RTU/TCP gatewaya (niekedy označovaného ako RS-485/Ethernet konvertor). Funguje akýkoľvek gateway s režimom transparent / pass-through Modbus TCP-to-RTU bridge; bežne používané modely sú Waveshare RS485-to-Ethernet, séria USR-TCP232 a Hi-Flying / HF séria.
Konfigurácia na gatewayi (názvy menu sa líšia podľa modelu):
- Pripojte RS-485 svorky A/B gatewaya na svorku MODBUS INT modulu (RX+ → A, RX− → B). Gateway napájajte zo samostatného zdroja (typicky 5 – 24 V DC).
- Sériový port gatewaya nastavte na 19 200 bps, 8 dátových bitov, párna parita, 1 stop bit, aby sa zhodoval s pevnými nastaveniami modulu. Ak gateway exponuje aj parameter časovania rámca, ponechajte ho na Modbus default (3,5 znakov idle).
- Prevádzkový režim gatewaya nastavte na Modbus TCP slave / Modbus TCP-to-RTU bridge / transparent gateway (terminológia sa líši podľa výrobcu) na TCP porte 502.
- Gatewayu priraďte statickú IP adresu v lokálnej sieti — buď cez DHCP rezerváciu na routeri, alebo priamo vo webovom UI gatewaya. TapHome šablóna má default
192.168.0.1; zhoda s touto adresou eliminuje potrebu meniť import parameter. - Ak má gateway zabudovaný 120 Ω terminačný rezistor, povoľte ho len ak gateway sedí na konci RS-485 zbernice.
Pri importe šablóny v TapHome zadajte:
- IP adresa — IP gatewaya v lokálnej sieti (default:
192.168.0.1) - Slave ID — Modbusová adresa modulu nastavená cez RSW1 + RSW2 (default:
1)
Priraďte TCP/RTU gatewayu statickú IP adresu v DHCP nastaveniach routera, aby sa adresa po reštarte nezmenila. Viac
CL-MC03**Cmodulov na rovnakej RS-485 zbernici môže zdieľať jeden gateway — každý modul sa adresuje cez jeho rotary slave adresu ako Modbus unit ID v TapHome.
Schopnosti zariadenia
Šablóna poľuje 6 holding registrov (H:0, H:1, H:4, H:5, H:8, H:9) každých 2,5 s pre vnútornú jednotku 00 na F1/F2 zbernici a sprístupňuje 5 logických zariadení.
ON/OFF
Jednoduchý spínač na zapnutie alebo vypnutie vnútornej jednotky. Číta register H:0 (Bool) — 0 = OFF, 1 = ON.
Cyclogic register 40001 (= H:0) je dokumentovaný ako 2-bajtový kombinovaný write príkaz s Data 1 = ON/OFF a Data 2 = Mode. TapHome šablóna zapisuje iba bajt Bool ON/OFF, takže prevádzkový režim treba nastaviť samostatne cez zariadenie Mode. Na väčšine Samsung vnútorných jednotiek je čiastočný zápis akceptovaný len ako ON/OFF a existujúci režim sa zachová — overte na reálnom hardvéri.
Mode
Selektor prevádzkového režimu. Cyclogic / Samsung manuály dokumentujú nasledujúce kódy:
| Kód v manuáli | Režim |
|---|---|
| 0 | Auto |
| 1 | Cooling (chladenie) |
| 2 | Dry (odvlhčovanie) |
| 3 | Fan (ventilátor) |
| 4 | Heat (kúrenie) |
| 11 | Auto Cool (iba čítanie) |
| 12 | Auto Dry (iba čítanie) |
| 13 | Auto Fan (iba čítanie) |
| 14 | Auto Heat (iba čítanie) |
TapHome šablóna prehadzuje označenia Heat a Cool oproti Cyclogic / Samsung manuálom: pozícia šablóny
1má označenie „Heat", ale Modbus hodnota1je dokumentovaná ako Cooling, a pozícia šablóny4má označenie „Cool", ale hodnota4je dokumentovaná ako Heat. Na reálnej Samsung jednotke teda voľba „Heat" v TapHome UI spustí chladenie, a voľba „Cool" spustí kúrenie. Pred spoľahnutím sa na označenia overte na reálnom hardvéri — hodnoty šablóny môže byť nutné premapovať podľa toho, čo Samsung vnútorná jednotka skutočne robí.
Sub-režimy Auto-COOL / Auto-DRY / Auto-FAN / Auto-HEAT sú dokumentované ako hodnoty iba na čítanie, ktoré odzrkadľujú vnútorný stav jednotky pri prevádzke v režime Auto. TapHome šablóna ich exponuje na pozíciách 5 – 8 s raw hodnotami 5 – 8, ale výrobca uvádza hodnoty 11 – 14. Zápis ktorejkoľvek z týchto pozícií pošle vnútornej jednotke nedokumentovanú Modbus hodnotu a výsledok je nedefinovaný — pri ovládaní jednotky z TapHome ich nechajte na Auto.
Číta a zapisuje register H:1 (Int16). Interval pollingu: 2,5 s.
Otáčky ventilátora
Selektor otáčok ventilátora. Cyclogic / Samsung manuály dokumentujú iba 5 hodnôt (0 – 4):
| Kód v manuáli | Otáčky |
|---|---|
| 0 | Automatické |
| 1 | Low (nízke) |
| 2 | Middle (stredné) |
| 3 | High (vysoké) |
| 4 | Turbo |
TapHome šablóna vkladá neštandardný slot „Position-5" pri hodnote
2, čím posúva MIDDLE / HIGH / TURBO na hodnoty3/4/5. Na reálnej Samsung jednotke teda voľba „Mid" v TapHome UI spustí v skutočnosti HIGH (raw hodnota3), „High" spustí TURBO (raw hodnota4) a „Turbo" pošle raw hodnotu5, čo nie je platný kód otáčok. Sloty 6 – 9 (Position-6, Position-7, 8, 9) sú placeholder hodnoty nedosiahnuteľné na reálnych Samsung vnútorných jednotkách. Pred spoľahnutím sa na označenia overte na reálnom hardvéri.
Podľa Cyclogic manuálu je register 40009 (= H:8) 2-bajtový kombinovaný write príkaz s Data 1 = Fan Speed a Data 2 = Louver. TapHome šablóna zapisuje iba bajt otáčok a poloha lamiel sa zapisuje samostatne ako jeden bajt do registra H:9 — toto nemusí súhlasiť s tým, čo každý gateway očakáva na kombinovanom registri H:8. Overte na reálnom hardvéri.
Číta a zapisuje register H:8 (Int16). Interval pollingu: 2,5 s.
Poloha lamiel (Louver Swing)
Ovládanie kývania lamiel dekoratívneho panelu. Cyclogic / Samsung manuály dokumentujú iba 4 hodnoty (0 – 3):
| Kód v manuáli | Poloha |
|---|---|
| 0 | Swing OFF |
| 1 | Swing ON: horné a dolné lamely |
| 2 | Swing ON: pravé a ľavé lamely |
| 3 | Swing ON: horné a dolné + pravé a ľavé lamely |
TapHome šablóna duplikuje „RIGHT & LEFT LOUVER" ako pozíciu 2 aj pozíciu 3 — pozícia 3 má byť podľa dokumentácie výrobcu „UPPER & LOWER + RIGHT & LEFT LOUVER". Pozície 4 – 9 (kombinované U&D / R&L lamely, Swing ON, Position-7, Position-6, Position-5 Vertical, Swirl) sú nedokumentované v Cyclogic a Samsung manuáloch — môžu byť špekulatívne sloty určené pre iné než dekoratívne kazetové jednotky, ale na štandardných nástenných, kazetových a kanálových jednotkách nie sú dosiahnuteľné. Pred spoľahnutím sa na označenia overte na reálnom hardvéri.
Číta a zapisuje register H:9 (Int16). Interval pollingu: 2,5 s.
Termostat
Žiadaná hodnota a aktuálna izbová teplota. Číta register H:4 (Int16, R/W) pre žiadanú hodnotu a register H:5 (Int16, len na čítanie) pre izbovú teplotu.
TapHome šablóna aplikuje delič /100 (a násobiteľ
* 100pri zápise) na oba registre teploty, ale Cyclogic Rev. 2 manuál a Samsung submittal oba uvádzajú /10: raw250= 25,0 °C, nie raw2500= 25,0 °C. Na reálnej Samsung vnútornej jednotke:
- Žiadané hodnoty zapísané z TapHome budú 10× menšie (napr. nastavenie 25 °C zapíše do registra raw
2500, čo zariadenie interpretuje ako 250,0 °C a odmietne alebo orežie).- Hodnoty izbovej teploty budú 10× menšie (napr. raw
235sa zobrazí ako 2,35 °C namiesto 23,5 °C).Ak pozorujete hodnoty 10× menšie, je to takmer určite príčina. Overte na reálnom hardvéri a kontaktujte TapHome, aby v šablóne opravili scaling z
/100na/10.
Interval pollingu: 2,5 s.
Nezrovnalosti medzi šablónou a dokumentáciou výrobcu
Niekoľko rozporov medzi TapHome XML šablónou a Cyclogic Rev. 2 (október 2017) manuálom / Samsung submittalom (SHA-DVMS-03162021) je popísaných vyššie. Súhrn:
| Oblasť | Šablóna | Manuál | Dopad |
|---|---|---|---|
| Označenia režimu (pozície 1 a 4) | 1 = Heat, 4 = Cool | 1 = Cooling, 4 = Heat | Voľba „Heat" spustí chladenie a naopak — overte na hardvéri |
| Pozície režimu 5 – 9 | Raw hodnoty 5 – 9 (Auto-*) | Auto-* sub-režimy používajú hodnoty 11 – 14 a sú iba na čítanie | Zápis pozícií 5 – 9 pošle nedokumentované hodnoty — nedefinované správanie |
| Pozície otáčok 2 – 9 | Vkladá neštandardný „Position-5" pri hodnote 2, posúva Mid/High/Turbo | Manuál dokumentuje iba hodnoty 0 – 4 | „Mid" → HIGH, „High" → TURBO, „Turbo" → neplatné; pozície 6 – 9 placeholder |
| Poloha lamiel 3 | Duplikát „Right & Left Louver" | Má byť „Upper & Lower + Right & Left Louver" | Označenie nesedí — hodnota registra je správna |
| Poloha lamiel 4 – 9 | Rôzne označenia vrátane „Swirl", „Position-5 (Vertical)" | Manuál dokumentuje iba hodnoty 0 – 3 | Nedokumentované — nedefinované na štandardných nástenných / kazetových / kanálových jednotkách |
| Scaling termostatu | / 100 a * 100 | / 10 a * 10 | Žiadané hodnoty 10× menšie, izbová teplota 10× menšia |
| Zápis ON/OFF | Jeden Bool bajt (iba Data 1) | Kombinovaný 2-bajtový príkaz (Data 1 = ON/OFF, Data 2 = Mode) | Na väčšine jednotiek akceptovaný ako čiastočný zápis, ale overte zachovanie režimu |
| Zápis otáčok | Jeden Int16 (iba Data 1) | Kombinovaný 2-bajtový príkaz (Data 1 = Fan, Data 2 = Louver) | Poloha lamiel sa zapisuje samostatne na H:9 — overte správanie na reálnom hardvéri |
Sú to s veľkou pravdepodobnosťou bugy XML šablóny, ktoré by sa mali opraviť proti reálnemu hardvéru.
Riešenie problémov
Žiadna Modbus komunikácia
- Overte, či je DIP SW2 nastavený správne pre Samsung rodinu — OFF pre DVM / CAC (NASA, prefixy modelov
AM,AC), ON pre RAC / FJM (Non-NASA, prefixy modelovAR,AJ). Zlý protokol = žiadna komunikácia. - Overte, či je modul napájaný — zelená LED PWR / System na čelnej strane musí svietiť. Ak je napájaný z V1/V2, skontrolujte, či je Samsung vnútorná jednotka pripojená k sieti.
- Potvrďte, že slave adresa na RSW1 + RSW2 zodpovedá Slave ID v import parametroch TapHome (továrenský default =
01, default šablóny =1). - Skontrolujte nastavenia sériového portu gatewaya: 19 200 bps, 8 dátových bitov, párna parita, 1 stop bit (8E1) — toto je najčastejšie zlá konfigurácia na strane gatewaya.
- Potvrďte, že je gateway v režime Modbus TCP-to-RTU transparent bridge (nie virtuálny COM port) a počúva na TCP porte 502.
- Overte polaritu zapojenia na MODBUS INT — RX+ na A gatewaya, RX− na B gatewaya. Niektoré gateway používajú opačnú konvenciu polarity; ak LED blikajú bez úspešného pollingu, prehoďte oba vodiče.
- Skontrolujte, že na rovnakej RS-485 zbernici nie je druhý modul s rovnakou RSW adresou.
Žiadané hodnoty a izbová teplota sú 10× menšie
TapHome XML aplikuje delič /100 na registre H:4 a H:5, ale dokumentácia výrobcu uvádza /10. Žiadaná hodnota 25 °C bude teda prenášaná ako raw 2500 Samsung vnútornej jednotke, ktorá očakáva raw 250, a hodnota izbovej teploty raw 235 (= 23,5 °C podľa manuálu) sa v TapHome UI zobrazí ako 2,35 °C. Použite Modbus debug nástroj v TapHome na čítanie raw hodnôt registrov a kontaktujte TapHome, aby v šablóne opravili scaling z /100 na /10.
Výber Heat a Cool je obrátený
Pozície šablóny pre Heat a Cool nesedia s Cyclogic manuálom (šablóna 1 = Heat / hodnota 1, manuál 1 = Cooling). Na reálnej Samsung jednotke teda voľba „Heat" v TapHome UI spustí chladenie a „Cool" spustí kúrenie. Kým nebude šablóna opravená, vyberajte podľa fyzického správania, nie podľa označenia.
Pozície režimu 5 – 9 nič nerobia alebo sa správajú nepredvídateľne
Tieto pozície zapisujú Modbus hodnoty 5 – 9 do registra H:1, ale Cyclogic manuál uvádza pre Auto-* sub-režimy hodnoty 11 – 14 a explicitne uvádza, že sú iba na čítanie. Zápis hodnôt 5 – 9 pošle vnútornej jednotke nedokumentované kódy — výsledok je nedefinovaný a závisí od firmvéru Samsung. Voľbu režimu obmedzte iba na pozície 0 – 4.
Pozície otáčok Mid / High / Turbo nesedia s označením
TapHome šablóna vkladá neštandardný slot „Position-5" pri hodnote 2, čím posúva MIDDLE / HIGH / TURBO na hodnoty šablóny 3 / 4 / 5. Označenie „Mid" v TapHome teda v skutočnosti spustí HIGH, „High" spustí TURBO a „Turbo" pošle raw hodnotu 5, čo nie je dokumentovaný kód otáčok. Vyberajte podľa fyzického správania, nie podľa označenia, kým sa šablóna neopraví.
Jedna vnútorná jednotka na multi-IDU adaptéri neodpovedá
Ak máte CL-MC0308C alebo väčší a chcete ovládať viac než prvú vnútornú jednotku, samotná súčasná šablóna nestačí — poľuje len registre pre IDU 00. Pre každú dodatočnú IDU importujte šablónu druhý (tretí, …) raz a v importovanej konfigurácii upravte adresy registrov pridaním +20 × N ku každej (napr. IDU 01 → H:20, H:21, H:24, H:25, H:28, H:29). Natívna multi-IDU šablóna je v plánoch.
Dva adaptéry na tej istej vonkajšej jednotke nepokryjú všetky vnútorné jednotky
Dva menšie CL-MC03**C varianty nemožno stohovať na ten istý Samsung vonkajší systém — oba moduly počítajú IDU adresy od 00 nahor a vyššie číslované IDU budú nedosiahnuteľné. Nahraďte oba moduly jedným väčším variantom dimenzovaným na celkový počet IDU (podľa Samsung HVAC FAQ, november 2016).
