← Inicio Rápido | Contenido | Siguiente: Conexión de Hardware →
Primeros Pasos — Paso a Paso
Esta guía se aplica tanto al módulo DimmerLink independiente como al controlador DimmerLink integrado dentro de un módulo Dimmer.
Paso 1: Conectar a un Terminal Serie
Por defecto, DimmerLink funciona en modo UART. Para verificar que funciona, conecta DimmerLink a cualquier adaptador USB-UART como CH340, CP2102 o CP2104.
Abre un terminal serie que soporte: - Modo de entrada/salida HEX - Configuración del puerto (velocidad en baudios, bits de datos, etc.)
Terminales recomendados: - VS Code — extensión Serial Monitor - Advanced Serial Port Monitor - RealTerm, CoolTerm, SSCOM
Esta guía utiliza VS Code Serial Monitor como ejemplo.
Configuración del Puerto
| Parámetro | Valor |
|---|---|
| Velocidad (Baud Rate) | 115200 |
| Bits de Datos | 8 |
| Paridad | Ninguna (N) |
| Bits de Parada | 1 |
| Formato | 8N1 |
Paso 2: Encender y Ver el Mensaje de Bienvenida
- Abre el puerto serie en tu terminal primero
- Luego conecta DimmerLink al adaptador USB-UART (o enciéndelo)
Este orden garantiza que captures el mensaje de inicio:
Deberías ver:
=== DimmerLink vX.XXX ===
Mode: UART
Calibrating...Paso 3: Completar la Calibración
DimmerLink comienza calibrando la frecuencia de la red AC. Esta es la tarea de mayor prioridad en el arranque — el controlador espera los eventos Zero-Cross de la red AC antes de aceptar cualquier comando.
Para completar la calibración:
- Asegúrate de que el módulo dimmer esté conectado a la red AC. No es necesaria una carga (lámpara) en esta etapa — solo importa la conexión a la red.
- Reinicia DimmerLink — desconecta VCC y vuelve a conectarlo (o cortocircuita brevemente VCC a GND para provocar un reinicio).
Tras una calibración exitosa verás:
El mensaje muestra: - Frecuencia de red detectada (50 Hz o 60 Hz) - Período de fase en microsegundos - Curva de regulación activa - "UART mode ready"
Paso 4: Cambiar la Consola al Modo HEX
DimmerLink se comunica usando un protocolo binario (HEX). Antes de enviar comandos, cambia el modo de entrada de tu terminal a HEX.
Ahora intenta configurar el brillo al 50%. Envía este comando HEX:
02 53 00 32| Byte | Significado |
|---|---|
02 |
Byte de inicio (STX) |
53 |
Comando SET ('S') |
00 |
Índice del dimmer 0 |
32 |
50% de brillo (0x32 = 50 decimal) |
Paso 5: Leer la Respuesta
DimmerLink responde en formato HEX. Cambia la visualización de salida de tu terminal al modo HEX para ver las respuestas claramente.
Una respuesta de 00 significa que el comando se ejecutó correctamente.
| Respuesta | Significado |
|---|---|
00 |
OK — comando ejecutado |
F9 |
Error de sintaxis — comando desconocido |
FC |
Error de escritura en Flash |
FD |
Índice de dimmer no válido |
FE |
Valor de parámetro no válido |
Paso 6: Cambiar al Modo I2C (Opcional)
Si necesitas I2C en lugar de UART, envía el comando de cambio:
02 5BRespuesta: 00 (OK — esta es la última respuesta UART).
Después de esto, DimmerLink: - Cambia al modo I2C inmediatamente - Deja de responder a los comandos UART - Deja de enviar mensajes al terminal - Recuerda el modo — tras un reinicio arrancará en modo I2C
Para volver a UART desde I2C, envía el comando 0x03 al registro I2C 0x01 (registro COMMAND). Consulta Comunicación I2C para más detalles.
Referencia Rápida de Comandos
| Acción | Comando HEX | Respuesta Esperada |
|---|---|---|
| Establecer 0% (apagado) | 02 53 00 00 |
00 |
| Establecer 25% | 02 53 00 19 |
00 |
| Establecer 50% | 02 53 00 32 |
00 |
| Establecer 75% | 02 53 00 4B |
00 |
| Establecer 100% | 02 53 00 64 |
00 |
| Obtener brillo | 02 47 00 |
00 + byte de nivel |
| Obtener frecuencia de red | 02 52 |
00 32 (50 Hz) o 00 3C (60 Hz) |
| Establecer curva RMS | 02 43 00 01 |
00 |
| Cambiar a I2C | 02 5B |
00 |
Solución de Problemas
| Síntoma | Causa | Solución |
|---|---|---|
| Sin mensaje de inicio | Puerto abierto después del encendido | Abre el puerto primero, luego enciende DimmerLink |
| Bloqueado en "Calibrating..." | Dimmer no conectado a la red AC | Conecta la red, luego reinicia DimmerLink |
| Comandos no se ejecutan | Todavía en calibración | Espera a "UART mode ready" antes de enviar comandos |
| Sin respuesta a los comandos | El terminal envía ASCII, no HEX | Cambia la entrada de la consola al modo HEX |
| Sin respuesta a los comandos | DimmerLink está en modo I2C | Reconecta via I2C y envía el comando SWITCH_UART |
| Frecuencia detectada incorrecta | Reinicio con ruido | Reinicia DimmerLink limpiamente cortando la alimentación |
Soporte
Si necesitas asistencia técnica: - Visita tu cuenta en rbdimmer.com - Email: [email protected]
¿Qué Sigue?
- Todos los Comandos UART — referencia completa del protocolo
- Interfaz I2C — mapa de registros y ejemplos
- Conexión de Hardware — diagramas de cableado para placas populares
- FAQ & Troubleshooting — preguntas comunes