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).
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
| # | 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.
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
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
| 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) |
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):
- 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).
- 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).
- 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.
- 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. - 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)
Assegnate al gateway TCP-RTU un indirizzo IP statico nelle impostazioni DHCP del router, in modo che l’indirizzo non cambi dopo un riavvio. Più moduli
CL-MC03**Csullo 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.
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) |
Il template TapHome scambia le etichette Heat e Cool rispetto ai manuali Cyclogic / Samsung: la posizione
1del template è etichettata “Heat” ma il valore Modbus sottostante1è documentato come Cooling, e la posizione4del template è etichettata “Cool” ma il valore4è 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.
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 |
Il template TapHome inserisce uno slot “Position-5” non standard al valore
2, spostando MIDDLE / HIGH / TURBO sui valori3/4/5. Su un’unità Samsung reale, selezionare “Mid” dall’interfaccia TapHome attiverà di fatto HIGH (valore grezzo3), “High” attiverà TURBO (valore grezzo4), e “Turbo” invierà il valore grezzo5, 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.
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 |
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.
Il template TapHome applica un divisore /100 (e moltiplicatore
* 100in scrittura) a entrambi i register di temperatura, ma il manuale Cyclogic Rev. 2 e il submittal Samsung specificano entrambi /10: grezzo250= 25,0 °C, non grezzo2500= 25,0 °C. Su un’unità interna Samsung reale:
- I setpoint scritti da TapHome appariranno 10× più piccoli (es. impostando 25 °C si scriverà nel register grezzo
2500che il dispositivo interpreta come 250,0 °C e rifiuta o limita).- Le letture di temperatura ambiente appariranno 10× più piccole (es. grezzo
235apparirà 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
/100a/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 10× più piccoli, 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
- 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 modelloAR,AJ). Protocollo errato = nessuna comunicazione. - 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.
- 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). - 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.
- Confermare che il gateway sia in modalità Modbus TCP-to-RTU transparent bridge (non modalità COM virtuale) e in ascolto sulla porta TCP 502.
- 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.
- 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).
