--- title: "Cyclogic CL-MC030x" description: "Controlla unità Samsung DVM, CAC, FJM e RAC via Modbus RTU sul bus F1/F2 — ON/OFF, modalità, ventola, lamelle e termostato. Template CL-MC03**C." url: "https://taphome.com/it/compatibility/cyklogic-cl-mc030x/" language: it 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: ["Come integrare Samsung HVAC con TapHome tramite Cyclogic CL-MC030x?","Cos'è il Cyclogic CL-MC030x e quali unità interne Samsung supporta?","Quante unità interne Samsung può controllare un Cyclogic CL-MC030x?","Quale gateway serve per collegare il Cyclogic CL-MC030x a TapHome?","Perché il mio condizionatore Samsung passa al raffreddamento quando seleziono Heat in TapHome?","Perché le temperature impostate sul Cyclogic CL-MC030x sono 10× più piccole?","Qual è la mappa dei registri Modbus del Cyclogic CL-MC030x?"] --- # Cyclogic CL-MC030x Comunicazione: Modbus TCP - [Sito ufficiale 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) > Indirizzo di rete > > TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione La serie Cyclogic CL-MC03**C (la **`x`** nel nome del template è un carattere jolly per il suffisso di variante `1` / `8` / `16` / `32` / `64`) è un modulo di interfaccia Modbus RTU che mette in comunicazione le unità interne Samsung con una rete Modbus. Si collega direttamente al **bus di comunicazione Samsung F1/F2 dell'unità interna** ed espone ON/OFF, modalità di funzionamento, temperatura impostata/ambiente, velocità ventola e oscillazione lamelle come holding register Modbus. Il modulo è prodotto da **Cyclogic Inc.** (Repubblica di Corea) ed è OEM-distribuito da Samsung HVAC per il mercato nordamericano — dispositivo, mappa dei registri e protocollo sono identici in tutte e cinque le varianti, cambia solo il numero massimo di unità interne indirizzabili. | Modello | Numero di unità interne controllate | |---------|-------------------------------------| | CL-MC0301C | 1 (tipico RAC) | | CL-MC0308C | 1 – 8 (DVM/CAC/FJM piccoli) | | CL-MC0316C | 1 – 16 (DVM medi) | | CL-MC0332C | 1 – 32 (DVM grandi) | | CL-MC0364C | 1 – 64 (DVM massimo, un adattatore per sistema esterno) | Le unità interne Samsung compatibili includono **DVM S** (`AM****N****/AA`), **CAC** (`AC****N****/AA`), **FJM** (`AJ0***N****/AA`) e **RAC** (`AR*********N**`). I modelli Samsung **Novus** RAC `AR**JSALBWKNCV` e `AR**JSFLBWKNCV` esplicitamente **non sono supportati**. Il CL-MC03**C è uno slave Modbus RTU; il `ModbusTcpCCU` di TapHome si collega ad esso tramite un **gateway Modbus RTU-TCP** esterno che converte il bus RS-485 in Ethernet. Il template TapHome attuale indirizza **solo la prima unità interna (IDU 00)** sul bus — per installazioni multi-IDU il template deve essere importato una volta per ogni unità interna (vedi *Risoluzione dei problemi* di seguito). > [!WARNING] > Tra il template XML TapHome e la documentazione del produttore Cyclogic / Samsung sono state identificate diverse incongruenze — in particolare uno **scambio tra le etichette Heat e Cool** nel selettore di modalità e un **fattore di scala temperatura /100** invece del documentato /10. Prima di mettere in produzione il template consultare la sezione *Incongruenze tra template e documentazione del produttore*. ## Collegamento hardware Il CL-MC03**C è un modulo compatto in custodia per guida DIN (100 × 80 × 24 mm) con una morsettiera a riga singola sul fronte. Sei connettori etichettati portano comunicazione, alimentazione e linee I/O ausiliarie. ### Morsettiera ![Morsettiera Cyclogic CL-MC03**C — MODBUS INT (RS-485 al gateway), RS-485 (F1/F2 a Samsung), MODBUS EXT (riservato), POWER (12 V DC), DO (uscita errore) e DRY CONT (ingresso ON/OFF forzato)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/wiring-terminals_hu_937870580ffff8f4.jpg) | # | Connettore | Descrizione | |---|------------|-------------| | 1 | **MODBUS INT** | RS-485 (RX+ / RX−) — al gateway esterno Modbus RTU-TCP | | 2 | **RS-485** | F1 / F2 — ai morsetti F1/F2 dell'unità interna Samsung | | 3 | **MODBUS EXT** | Riservato — non utilizzato | | 4 | **POWER** | Alimentazione 12 V DC (+ / −) | | 5 | **DO** | Uscita digitale — il contatto si chiude (12 – 24 V DC) in caso di errore del sistema Samsung | | 6 | **DRY CONT** | Ingresso a contatto pulito per ON/OFF forzato esterno (es. contatto finestra) | Il modulo è **alimentato a 12 V DC**, tipicamente prelevati direttamente dai morsetti **V1/V2** dell'unità interna Samsung sulla scheda interna — per installazioni tipiche non serve un alimentatore separato. In alternativa si può utilizzare un alimentatore 12 V DC fornito in opera. Il submittal Samsung conferma che il modulo accetta 12 – 24 V DC, ma il manuale di installazione Cyclogic indica 12 V DC come valore nominale. > [!WARNING] > Scollegare l'alimentazione di rete dall'unità interna Samsung prima di aprirla per accedere ai morsetti F1/F2 e V1/V2. Verificare la polarità sul connettore POWER prima di alimentare il modulo. La lunghezza massima del bus RS-485 (Modbus) è di **500 m**; installare il modulo solo in interno — la temperatura operativa è **0 °C – 40 °C** (32 °F – 104 °F). ### Topologia del sistema ![Topologia Cyclogic CL-MC03**C — Caso 1 (DVM/CAC, DIP SW2 OFF) con un modulo per bus F1/F2 e Caso 2 (RAC, DIP SW2 ON) con un modulo per sistema RAC su Modbus master condiviso](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/system-connection-diagram_hu_3acea40f45ac7ab.jpg) In base alla famiglia Samsung integrata sono possibili due topologie valide: - **Caso 1 — DVM / CAC** (DIP SW2 = **OFF**, protocollo NASA): un modulo CL-MC03 sul bus F1/F2 condiviso da un'unità esterna e fino a 64 unità interne. Scegliere la variante che copre il numero totale di IDU del sistema esterno — il dimensionamento è una tantum, due adattatori non possono essere impilati sulla stessa unità esterna (vedi *Risoluzione dei problemi*). - **Caso 2 — RAC** (DIP SW2 = **ON**, protocollo Non-NASA): un modulo CL-MC03 per sistema RAC esterno (tipicamente `CL-MC0301C` — singola IDU). Più moduli sullo stesso bus RS-485, ognuno con un indirizzo slave univoco impostato tramite gli switch rotativi. Entrambe le topologie condividono un unico gateway esterno RS-485-Ethernet che funge da Modbus master verso TapHome. ## Configurazione ### DIP switch ![DIP switch sul fronte del Cyclogic CL-MC03**C — SW1 (aggiornamento firmware) e SW2 (selezione protocollo Samsung AC — RAC/FJM vs DVM/CAC)](https://taphome.com/images/compatibility/cyklogic-cl-mc030x/dip-switches_hu_b3d8b4e6997047d3.jpg) | Switch | Posizione | Funzione | |--------|-----------|----------| | **SW2** (protocollo) | **ON** | RAC / FJM — modelli `AR*****`, `AJ*****` (protocollo Non-NASA) | | **SW2** (protocollo) | **OFF** | DVM / CAC — modelli `AM*****`, `AC****` (protocollo NASA) | | **SW1** (firmware) | **ON** (default) | Disabilitato — funzionamento normale | | **SW1** (firmware) | **OFF** | Abilitato — modalità download firmware (non usare durante il funzionamento normale) | > [!WARNING] > SW2 deve essere impostato **prima** di alimentare il modulo — collegare il modulo alla famiglia di protocollo errata (es. SW2 = OFF su un sistema RAC o SW2 = ON su un sistema DVM) provoca **nessuna comunicazione** con l'unità interna Samsung. Il manuale Cyclogic lo segnala come l'errore di installazione più comune. ### Indirizzo slave Modbus (RSW1 + RSW2) L'indirizzo slave Modbus (l'indirizzo RS-485 con cui il gateway interrogherà questo modulo) si imposta tramite due switch rotativi BCD sulla scheda, accessibili dopo aver rimosso le quattro viti sul retro della custodia: - **RSW1** — cifra delle decine (`0` – `6`) - **RSW2** — cifra delle unità (`0` – `9`) Il valore combinato forma l'indirizzo slave, intervallo valido **00 – 63**. Ogni modulo sullo stesso bus RS-485 deve avere un **indirizzo univoco** — il conflitto più comune è avere più moduli `CL-MC0301C` lasciati al valore di fabbrica. Il template TapHome è fornito con **Slave ID predefinito = 1** nei parametri di importazione; se mantenete gli switch rotativi su questo indirizzo, non occorre modificare la configurazione importata. ### Parametri del protocollo Modbus Questi valori sono fissati nel firmware del modulo e **non possono** essere modificati tramite DIP switch — il lato RS-485 del gateway deve essere configurato di conseguenza: | Parametro | Valore | |-----------|--------| | Modalità | Modbus RTU **slave** | | Baud rate | **19 200 bps** (il submittal Samsung indica `19600` — refuso per la velocità standard del bus F Samsung 19 200) | | Parità | Even (pari) | | Stop bit | 1 | | Formato frame | 8E1 (8 bit dati, parità pari, 1 stop bit) | | Codici funzione | `03` (Read Holding Registers), `06` (Preset Single Register) | | Larghezza registro | 2 byte (16 bit) | | Lunghezza massima bus RS-485 | 500 m | ### Abilitazione della comunicazione Modbus tramite gateway TCP Il CL-MC03**C è un dispositivo Modbus RTU nativo — TapHome si collega ad esso tramite Modbus TCP attraverso un **gateway Modbus RTU-TCP** esterno (a volte chiamato convertitore RS-485-Ethernet). Funziona qualsiasi gateway in grado di operare in modalità **transparent / pass-through Modbus TCP-to-RTU bridge**; modelli comunemente usati: Waveshare RS485-to-Ethernet, serie USR-TCP232 e serie Hi-Flying / HF. Configurazione sul gateway (i nomi dei menu variano in base al modello): 1. Collegare i morsetti A/B RS-485 del gateway al morsetto **MODBUS INT** del modulo (RX+ → A, RX− → B). Alimentare il gateway dalla propria fonte (tipicamente 5 – 24 V DC). 2. Impostare la porta seriale del gateway a **19 200 bps, 8 bit dati, parità pari, 1 stop bit** per allinearsi alle impostazioni firmware fisse del modulo. Se il gateway espone anche un parametro di temporizzazione del frame, lasciarlo al default Modbus (3,5 caratteri idle). 3. Impostare la modalità operativa del gateway su **Modbus TCP slave / Modbus TCP-to-RTU bridge / transparent gateway** (la terminologia varia per produttore) sulla porta TCP **502**. 4. Assegnare al gateway un **indirizzo IP statico** sulla rete locale — tramite la prenotazione DHCP del router o direttamente nell'interfaccia web del gateway. Il template TapHome ha come default `192.168.0.1`; se mantenete questo indirizzo, non dovete modificare il parametro di importazione. 5. Se il gateway dispone di una **resistenza di terminazione 120 Ω** integrata, abilitatela solo se il gateway si trova a un'estremità del bus RS-485. Quando importate il template in TapHome, fornite: - **Indirizzo IP** — l'IP del gateway sulla rete locale (default: `192.168.0.1`) - **Slave ID** — l'indirizzo Modbus del modulo impostato tramite RSW1 + RSW2 (default: `1`) > [!TIP] > Più moduli `CL-MC03**C` sullo stesso bus RS-485 possono condividere un singolo gateway — ogni modulo è raggiunto selezionando il suo indirizzo slave rotativo come Modbus unit ID in TapHome. ## Funzionalità del dispositivo Il template interroga **6 holding register** (H:0, H:1, H:4, H:5, H:8, H:9) ogni 2,5 s per l'unità interna 00 sul bus F1/F2 ed espone 5 dispositivi logici. ### ON/OFF Semplice interruttore per accendere o spegnere l'unità interna. Legge il register H:0 (Bool) — `0` = OFF, `1` = ON. > [!NOTE] > Il register Cyclogic 40001 (= H:0) è documentato come **comando di scrittura combinato a 2 byte** con Data 1 = ON/OFF e Data 2 = Mode. Il template TapHome scrive solo il byte Bool ON/OFF, quindi la modalità di funzionamento deve essere impostata separatamente tramite il dispositivo Mode. Sulla maggior parte delle unità interne Samsung la scrittura parziale è accettata solo come ON/OFF e la modalità esistente viene preservata — verificare su hardware reale. ### Mode Selettore della modalità di funzionamento. I manuali Cyclogic / Samsung documentano i seguenti codici: | Codice nel manuale | Modalità | |--------------------|----------| | 0 | Auto | | 1 | Cooling (raffreddamento) | | 2 | Dry (deumidificazione) | | 3 | Fan (ventilazione) | | 4 | Heat (riscaldamento) | | 11 | Auto Cool (sola lettura) | | 12 | Auto Dry (sola lettura) | | 13 | Auto Fan (sola lettura) | | 14 | Auto Heat (sola lettura) | > [!WARNING] > Il template TapHome **scambia le etichette Heat e Cool** rispetto ai manuali Cyclogic / Samsung: la posizione `1` del template è etichettata "Heat" ma il valore Modbus sottostante `1` è documentato come **Cooling**, e la posizione `4` del template è etichettata "Cool" ma il valore `4` è documentato come **Heat**. Su un'unità Samsung reale, selezionare "Heat" dall'interfaccia TapHome attiverà quindi il **raffreddamento**, e selezionare "Cool" attiverà il **riscaldamento**. Prima di affidarsi alle etichette **verificare su hardware reale** — i valori del template potrebbero dover essere rimappati a seconda di ciò che fa effettivamente l'unità interna Samsung. > [!NOTE] > Le sotto-modalità Auto-COOL / Auto-DRY / Auto-FAN / Auto-HEAT sono documentate come valori **di sola lettura** che riflettono lo stato interno dell'unità in modalità Auto. Il template TapHome le espone come posizioni 5 – 8 con valori grezzi 5 – 8, ma il produttore specifica i valori 11 – 14. Scrivere una qualsiasi di queste posizioni invierà un valore Modbus non documentato all'unità interna e il risultato è indefinito — lasciatele su Auto quando controllate l'unità da TapHome. Legge e scrive il register H:1 (Int16). Intervallo di polling: 2,5 s. ### Velocità ventola Selettore della velocità ventola. I manuali Cyclogic / Samsung documentano solo **5 valori** (0 – 4): | Codice nel manuale | Velocità | |--------------------|----------| | 0 | Automatica | | 1 | Low (bassa) | | 2 | Middle (media) | | 3 | High (alta) | | 4 | Turbo | > [!WARNING] > Il template TapHome inserisce uno slot "Position-5" non standard al valore `2`, spostando MIDDLE / HIGH / TURBO sui valori `3` / `4` / `5`. Su un'unità Samsung reale, selezionare "Mid" dall'interfaccia TapHome attiverà di fatto **HIGH** (valore grezzo `3`), "High" attiverà **TURBO** (valore grezzo `4`), e "Turbo" invierà il valore grezzo `5`, che non è un codice di velocità ventola valido. Gli slot 6 – 9 (Position-6, Position-7, 8, 9) sono valori segnaposto non raggiungibili sulle unità interne Samsung reali. Prima di affidarsi alle etichette **verificare su hardware reale**. > [!NOTE] > Secondo il manuale Cyclogic, il register 40009 (= H:8) è un **comando di scrittura combinato a 2 byte** con Data 1 = velocità ventola e Data 2 = lamella. Il template TapHome scrive solo il byte della ventola e la posizione della lamella viene scritta separatamente come singolo byte nel register H:9 — questo potrebbe non corrispondere a ciò che ogni gateway si aspetta sul register combinato H:8. Verificare su hardware reale. Legge e scrive il register H:8 (Int16). Intervallo di polling: 2,5 s. ### Posizione lamelle (Louver Swing) Controllo dell'oscillazione delle lamelle del pannello decorativo. I manuali Cyclogic / Samsung documentano solo **4 valori** (0 – 3): | Codice nel manuale | Posizione | |--------------------|-----------| | 0 | Swing OFF | | 1 | Swing ON: lamelle superiori e inferiori | | 2 | Swing ON: lamelle destra e sinistra | | 3 | Swing ON: lamelle superiori e inferiori + destra e sinistra | > [!WARNING] > Il template TapHome **duplica** "RIGHT & LEFT LOUVER" come posizione 2 e posizione 3 — la posizione 3 dovrebbe essere "UPPER & LOWER + RIGHT & LEFT LOUVER" secondo la documentazione del produttore. Le posizioni 4 – 9 (lamelle U&D / R&L combinate, Swing ON, Position-7, Position-6, Position-5 Vertical, Swirl) **non sono documentate** nei manuali Cyclogic e Samsung — potrebbero essere slot speculativi destinati a unità a cassetta non decorative, ma non sono raggiungibili su unità a parete, a cassetta e canalizzate standard. Prima di affidarsi alle etichette **verificare su hardware reale**. Legge e scrive il register H:9 (Int16). Intervallo di polling: 2,5 s. ### Termostato Setpoint e temperatura ambiente attuale. Legge il register H:4 (Int16, R/W) per il setpoint e il register H:5 (Int16, sola lettura) per la temperatura ambiente. > [!WARNING] > Il template TapHome applica un **divisore /100** (e moltiplicatore `* 100` in scrittura) a entrambi i register di temperatura, ma il manuale Cyclogic Rev. 2 e il submittal Samsung **specificano entrambi /10**: grezzo `250` = 25,0 °C, non grezzo `2500` = 25,0 °C. Su un'unità interna Samsung reale: > - I setpoint scritti da TapHome saranno **10× troppo grandi** (es. impostando 25 °C si scriverà nel register grezzo `2500` che il dispositivo interpreta come 250,0 °C e rifiuta o limita). > - Le letture di temperatura ambiente appariranno **10× più piccole** (es. grezzo `235` apparirà come 2,35 °C anziché 23,5 °C). > > Se osservate valori distanti di un fattore 10, è quasi certamente la causa. **Verificare su hardware reale** e contattare TapHome per far correggere la scala del template da `/100` a `/10`. Intervallo di polling: 2,5 s. ## Incongruenze tra template e documentazione del produttore Diverse discrepanze tra il template XML TapHome e il manuale Cyclogic Rev. 2 (ott. 2017) / submittal Samsung (SHA-DVMS-03162021) sono documentate sopra. In sintesi: | Area | Template | Manuale | Impatto | |------|----------|---------|---------| | Etichette modalità (posizioni 1 e 4) | 1 = Heat, 4 = Cool | 1 = Cooling, 4 = Heat | Selezionare "Heat" attiva il raffreddamento e viceversa — verificare su hardware | | Posizioni modalità 5 – 9 | Valori grezzi 5 – 9 (Auto-*) | Le sotto-modalità Auto-* usano valori **11 – 14** e sono di sola lettura | Scrivere le posizioni 5 – 9 invia valori non documentati — comportamento indefinito | | Posizioni ventola 2 – 9 | Inserisce "Position-5" non standard al valore 2, sposta Mid/High/Turbo | Il manuale documenta solo i valori 0 – 4 | "Mid" → HIGH, "High" → TURBO, "Turbo" → non valido; posizioni 6 – 9 segnaposto | | Posizione lamelle 3 | Duplicato di "Right & Left Louver" | Dovrebbe essere "Upper & Lower + Right & Left Louver" | Etichetta non corrisponde — il valore del register è corretto | | Posizione lamelle 4 – 9 | Etichette varie tra cui "Swirl", "Position-5 (Vertical)" | Il manuale documenta solo i valori 0 – 3 | Non documentate — indefinite su unità a parete / a cassetta / canalizzate standard | | Scala termostato | `/ 100` e `* 100` | `/ 10` e `* 10` | Setpoint scritti 10× troppo grandi, temperatura ambiente 10× più piccola | | Scrittura ON/OFF | Singolo byte Bool (solo Data 1) | Comando combinato a 2 byte (Data 1 = ON/OFF, Data 2 = Mode) | Sulla maggior parte delle unità accettato come scrittura parziale, ma verificare conservazione modalità | | Scrittura ventola | Singolo Int16 (solo Data 1) | Comando combinato a 2 byte (Data 1 = Fan, Data 2 = Louver) | La posizione lamelle è scritta separatamente in H:9 — verificare comportamento su hardware reale | Sono molto probabilmente bug del template XML che dovrebbero essere corretti rispetto all'hardware reale. ## Risoluzione dei problemi ### Nessuna comunicazione Modbus 1. Verificare che il **DIP SW2** sia impostato correttamente per la famiglia Samsung — **OFF** per DVM / CAC (NASA, prefissi modello `AM`, `AC`), **ON** per RAC / FJM (Non-NASA, prefissi modello `AR`, `AJ`). Protocollo errato = nessuna comunicazione. 2. Verificare che il modulo sia alimentato — il LED verde PWR / System sul fronte deve essere acceso. Se alimentato da V1/V2, confermare che l'unità interna Samsung sia collegata alla rete. 3. Confermare che l'**indirizzo slave** su RSW1 + RSW2 corrisponda allo Slave ID nei parametri di importazione TapHome (default di fabbrica = `01`, default del template = `1`). 4. Verificare le impostazioni della porta seriale del gateway: **19 200 bps, 8 bit dati, parità pari, 1 stop bit** (8E1) — è la configurazione errata più comune lato gateway. 5. Confermare che il gateway sia in modalità **Modbus TCP-to-RTU transparent bridge** (non modalità COM virtuale) e in ascolto sulla porta TCP **502**. 6. Verificare la polarità del cablaggio su **MODBUS INT** — RX+ all'A del gateway, RX− al B del gateway. Alcuni gateway usano convenzioni di polarità opposte; se i LED lampeggiano senza polling riuscito, scambiare i due cavi. 7. Verificare che nessun secondo modulo sullo stesso bus RS-485 sia configurato con lo stesso indirizzo RSW. ### Setpoint e temperatura ambiente fuori scala di un fattore 10 Il template XML TapHome applica un divisore `/100` ai register H:4 e H:5, ma la documentazione del produttore specifica `/10`. Un setpoint di 25 °C verrà quindi trasmesso come grezzo `2500` a un'unità interna Samsung che si aspetta grezzo `250`, e una lettura di temperatura ambiente grezzo `235` (= 23,5 °C secondo il manuale) apparirà come `2,35 °C` nell'interfaccia TapHome. Usate lo strumento di debug Modbus di TapHome per leggere i valori grezzi dei register, poi contattate TapHome per far correggere la scala del template da `/100` a `/10`. ### La selezione Heat e Cool è invertita Le posizioni del template per Heat e Cool non corrispondono al manuale Cyclogic (template `1` = Heat / valore `1`, manuale `1` = Cooling). Su un'unità Samsung reale, selezionare "Heat" dall'interfaccia TapHome attiverà quindi il **raffreddamento** e "Cool" attiverà il **riscaldamento**. Finché il template non è corretto, scegliete in base al comportamento fisico anziché all'etichetta. ### Le posizioni di modalità 5 – 9 non fanno nulla o si comportano in modo imprevedibile Queste posizioni scrivono i valori Modbus 5 – 9 nel register H:1, ma il manuale Cyclogic specifica i valori **11 – 14** per le sotto-modalità Auto-* e nota esplicitamente che sono di sola lettura. Scrivere i valori 5 – 9 invia codici non documentati all'unità interna — il risultato è indefinito e dipende dal firmware Samsung. Limitate la selezione di modalità solo alle posizioni 0 – 4. ### Le posizioni ventola Mid / High / Turbo non corrispondono all'etichetta Il template TapHome inserisce uno slot "Position-5" non standard al valore 2, spostando MIDDLE / HIGH / TURBO sui valori del template 3 / 4 / 5. L'etichetta TapHome "Mid" attiva quindi di fatto **HIGH**, "High" attiva **TURBO**, e "Turbo" invia il valore grezzo `5` che non è un codice ventola documentato. Scegliete in base al comportamento fisico anziché all'etichetta finché il template non è corretto. ### Una unità interna su un adattatore multi-IDU non risponde Se avete un `CL-MC0308C` o più grande e volete controllare più della prima unità interna, il solo template attuale non è sufficiente — interroga solo i register per IDU 00. Per ogni IDU aggiuntiva, importate il template una seconda (terza, …) volta e modificate gli indirizzi dei register all'interno della configurazione importata aggiungendo `+20 × N` a ciascuno (es. IDU 01 → H:20, H:21, H:24, H:25, H:28, H:29). Un template multi-IDU nativo è in roadmap. ### Due adattatori sulla stessa unità esterna non coprono tutte le unità interne Non potete impilare due varianti `CL-MC03**C` più piccole sullo stesso sistema esterno Samsung — entrambi i moduli conteranno gli indirizzi IDU da `00` in avanti e le IDU con numerazione più alta saranno irraggiungibili. Sostituite i due moduli con una singola variante più grande dimensionata sul numero totale di IDU (secondo le FAQ Samsung HVAC, nov. 2016). ## Dispositivi disponibili 5 Questi dispositivi compaiono in TapHome dopo l'importazione. Cyclogic CL-MC030x Modulo ON/OFF Interruttore Lettura e scrittura Accende o spegne l'unità interna Samsung (register H:0, Bool — 0 = OFF, 1 = ON) Registro: H:0 Bool Valori / Stati: ON · OFF Lettura stato interruttore ```taphome MODBUSR(H, 0, Bool) ``` Scrittura stato interruttore ```taphome MODBUSWNE(H, 0, Bool, St) ``` Modalità Interruttore multivalore Lettura e scrittura Modalità di funzionamento — Auto, Heat, Dry, Fan, Cool (register H:1; il template scambia le etichette Heat e Cool rispetto al manuale Cyclogic — verificare su hardware reale. Le posizioni 5 – 9 inviano valori non documentati e si comportano in modo imprevedibile) Registro: H:1 Int16 numeric Valori / Stati: Auto · Heat · Dry · Fan · Cool · Auto COOL · Auto DRY · Auto FAN · Auto HEAT Lettura stato interruttore ```taphome MODBUSR(H, 1, Int16) ``` Scrittura stato interruttore ```taphome MODBUSWNE(H, 1, Int16, Mu) ``` Velocità ventola Interruttore multivalore Lettura e scrittura Velocità ventola — Auto, Low, Middle, High, Turbo (register H:8; il template inserisce uno slot 'Position-5' non standard al valore 2, quindi 'Mid' attiva HIGH e 'High' attiva TURBO su hardware reale. Le posizioni 6 – 9 sono segnaposto non raggiungibili sulle unità interne Samsung) Registro: H:8 Int16 numeric Valori / Stati: Auto · Low · Mid · High · Turbo Lettura stato interruttore ```taphome MODBUSR(H, 8, Int16) ``` Scrittura stato interruttore ```taphome MODBUSWNE(H, 8, Int16, Mu) ``` Posizione lamelle Interruttore multivalore Lettura e scrittura Oscillazione lamelle del pannello decorativo — Swing Off, superiore e inferiore, destra e sinistra, combinato superiore e inferiore / destra e sinistra (register H:9; le posizioni 4 – 9 non sono documentate nel manuale Cyclogic e non sono raggiungibili su unità a parete, a cassetta e canalizzate standard) Registro: H:9 Int16 numeric Valori / Stati: Swing OFF · UPPER & LOWER LOUVER · RIGHT & LEFT LOUVER · UPPER&LOWER/RIGHT&LEFT LOUVER Lettura stato interruttore ```taphome MODBUSR(H, 9, Int16) ``` Scrittura stato interruttore ```taphome MODBUSWNE(H, 9, Int16, Mu) ``` Termostato Termostato Lettura e scrittura Setpoint e temperatura ambiente attuale in °C (register H:4 R/W setpoint, register H:5 sola lettura temperatura ambiente; il template applica un divisore /100 ma il produttore specifica /10 — i valori letti possono apparire 10× più piccoli e i setpoint scritti 10× troppo grandi finché il template non è corretto) Registro: H:4 Int16 Unità: °C numeric Lettura temperatura ```taphome MODBUSR(H, 5, Int16) / 100 ``` Lettura temperatura desiderata ```taphome MODBUSR(H, 4, Int16) / 100 ``` Scrittura temperatura desiderata ```taphome MODBUSWNE(H, 4, Int16, Se * 100) ``` **Connessione:** Modbus TCP • Slave ID: $\[SlaveId] Possibili miglioramenti (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. ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------|---------------| | Slave ID | `1` | | Indirizzo IP | `192.168.0.1` | ## Fonti - 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) I documenti del produttore sono © dei rispettivi proprietari. Sono forniti così come pubblicati dal produttore, solo a titolo informativo. ## Documentazione correlata - [Modbus Integration](https://taphome.com/it/compatibility/modbus-guide/) - [Modbus - Configurazione](https://taphome.com/it/docs/integration/modbus/) - [Configurazione semplice utilizzando modelli](https://taphome.com/it/docs/integration/modbus/templates/) - [Script Modbus e prefetch](https://taphome.com/it/docs/script/modbus-scripts/) - [Funzioni Modbus](https://taphome.com/it/docs/script/modbus/) - [Tipi di dati Modbus](https://taphome.com/it/docs/script/modbus-data-types/)