← Avvio Rapido | Indice | Successivo: Connessione Hardware →
Guida Introduttiva — Passo-Passo
Questa guida si applica sia al modulo DimmerLink standalone che al controller DimmerLink integrato all'interno di un modulo Dimmer.
Passo 1: Connetti a un Terminale Seriale
Per impostazione predefinita, DimmerLink opera in modalità UART. Per verificare che funzioni, collega DimmerLink a qualsiasi adattatore USB-UART come CH340, CP2102 o CP2104.
Apri un terminale seriale che supporti: - Modalità di input/output HEX - Configurazione della porta (baud rate, bit dati, ecc.)
Terminali consigliati: - VS Code — estensione Serial Monitor - Advanced Serial Port Monitor - RealTerm, CoolTerm, SSCOM
Questa guida utilizza VS Code Serial Monitor come esempio.
Impostazioni della Porta
| Parametro | Valore |
|---|---|
| Baud Rate | 115200 |
| Data Bits | 8 |
| Parity | None (N) |
| Stop Bits | 1 |
| Formato | 8N1 |
Passo 2: Alimenta e Visualizza il Messaggio di Benvenuto
- Apri prima la porta seriale nel tuo terminale
- Poi collega DimmerLink all'adattatore USB-UART (o alimentalo)
Questo ordine garantisce di ricevere il messaggio di avvio:
Dovresti vedere:
=== DimmerLink vX.XXX ===
Mode: UART
Calibrating...Passo 3: Completa la Calibrazione
DimmerLink inizia calibrando la frequenza della rete AC. Questo è il compito di massima priorità all'avvio — il controller attende gli eventi Zero-Cross dalla rete AC prima di accettare qualsiasi comando.
Per completare la calibrazione:
- Assicurati che il modulo dimmer sia connesso alla rete AC. Un carico (lampada) non è necessario in questa fase — conta solo la connessione alla rete.
- Riavvia DimmerLink — disconnetti VCC e ricollegalo (oppure cortocircuita brevemente VCC a GND per provocare un reset).
Dopo una calibrazione riuscita vedrai:
Il messaggio mostra: - Frequenza di rete rilevata (50 Hz o 60 Hz) - Periodo di fase in microsecondi - Curva di dimming attiva - "UART mode ready"
Passo 4: Passa la Console in Modalità HEX
DimmerLink comunica utilizzando un protocollo binario (HEX). Prima di inviare comandi, passa la modalità di input del tuo terminale a HEX.
Ora prova a impostare la luminosità al 50%. Invia questo comando HEX:
02 53 00 32| Byte | Significato |
|---|---|
02 |
Byte di inizio (STX) |
53 |
Comando SET ('S') |
00 |
Indice dimmer 0 |
32 |
Luminosità 50% (0x32 = 50 decimale) |
Passo 5: Leggi la Risposta
DimmerLink risponde in formato HEX. Passa la visualizzazione output del tuo terminale in modalità HEX per vedere chiaramente le risposte.
Una risposta 00 indica che il comando è stato eseguito con successo.
| Risposta | Significato |
|---|---|
00 |
OK — comando eseguito |
F9 |
Errore di sintassi — comando sconosciuto |
FC |
Errore di scrittura Flash |
FD |
Indice dimmer non valido |
FE |
Valore parametro non valido |
Passo 6: Passa alla Modalità I2C (Opzionale)
Se hai bisogno di I2C invece di UART, invia il comando di cambio modalità:
02 5BRisposta: 00 (OK — questa è l'ultima risposta UART).
Dopo questo, DimmerLink: - Passa immediatamente alla modalità I2C - Smette di rispondere ai comandi UART - Smette di inviare messaggi al terminale - Ricorda la modalità — dopo il riavvio si avvierà in modalità I2C
Per tornare a UART da I2C, invia il comando 0x03 al registro I2C 0x01 (registro COMMAND). Consulta Comunicazione I2C per i dettagli.
Riferimento Rapido ai Comandi
| Azione | Comando HEX | Risposta Attesa |
|---|---|---|
| Imposta 0% (spento) | 02 53 00 00 |
00 |
| Imposta 25% | 02 53 00 19 |
00 |
| Imposta 50% | 02 53 00 32 |
00 |
| Imposta 75% | 02 53 00 4B |
00 |
| Imposta 100% | 02 53 00 64 |
00 |
| Leggi luminosità | 02 47 00 |
00 + byte livello |
| Leggi frequenza di rete | 02 52 |
00 32 (50 Hz) o 00 3C (60 Hz) |
| Imposta curva RMS | 02 43 00 01 |
00 |
| Passa a I2C | 02 5B |
00 |
Risoluzione dei Problemi
| Sintomo | Causa | Soluzione |
|---|---|---|
| Nessun messaggio di avvio | Porta aperta dopo l'alimentazione | Apri prima la porta, poi alimenta DimmerLink |
| Bloccato su "Calibrating..." | Dimmer non connesso alla rete AC | Collega l'alimentazione di rete, poi riavvia DimmerLink |
| Comandi non eseguiti | Ancora in calibrazione | Attendi "UART mode ready" prima di inviare comandi |
| Nessuna risposta ai comandi | Il terminale invia ASCII, non HEX | Passa l'input della console in modalità HEX |
| Nessuna risposta ai comandi | DimmerLink è in modalità I2C | Riconnetti via I2C e invia il comando SWITCH_UART |
| Frequenza rilevata errata | Riavvio instabile | Esegui un ciclo di alimentazione pulito di DimmerLink |
Supporto
Se hai bisogno di assistenza tecnica: - Visita il tuo account su rbdimmer.com - Email: [email protected]
Cosa c'è Dopo?
- Tutti i Comandi UART — riferimento completo del protocollo
- Interfaccia I2C — mappa dei registri ed esempi
- Connessione Hardware — schemi di cablaggio per le schede più diffuse
- FAQ & Troubleshooting — domande frequenti