DocumentaciónProblemas conocidos de WB-LED
ERRMRGBW-D04: los valores de Hue no cambian en MQTT durante el cambio continuo de color de la tira RGB
Dispositivos afectados
WB-MRGBW-D y WB-LED desde la versión 3.4.1.
Descripción
En el modo RGB + W, el cambio continuo de color RGB no genera deliberadamente eventos del registro Hue. Hue cambia con mucha frecuencia y generaría un tráfico excesivo en el bus. En consecuencia, los dispositivos con direcciones superiores a la del WB-LED o WB-MRGBW-D podrían quedar sin consultar.
Solución provisional
Edite la plantilla del dispositivo: en la sección del registro RGB Strip Hue (dirección 2014), establezca el parámetro sporadic en false.
Resolución
Actualice el controlador Wiren Board a la versión wb-2407 o posterior. Si ya está instalado wb-2407, actualice sus paquetes. Esta actualización desactiva los eventos del registro Hue.
Desde el firmware 3.8.0 se vuelven a generar eventos Hue durante el cambio continuo de color: un retardo limita la frecuencia de eventos durante el ajuste automático del tono para evitar sobrecargar el bus. En las plantillas WB-LED y WB-MRGBW-D a partir de wb-mqtt-serial 2.255.0, RGB Strip Hue (dirección 2014) vuelve a utilizar el modo esporádico. Ya no se necesita la solución manual alternativa.
ERRMRGBW-D05: Las acciones al encender y de Safety Mode no funcionan correctamente
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware desde 3.5.0 hasta 3.5.2, ambos incluidos.
Descripción
En los siguientes modos de funcionamiento:
- cualquier modo con una tira CCT
- RGB+W
las acciones al encender y de Safety Mode funcionan incorrectamente.
La plantilla wb-mqtt-serial también contiene etiquetas incorrectas de acciones al encender: interprete No action como Switch off y Switch off como Restore previous state.
Resolución
Corregido en el firmware 3.5.3 y wb-mqtt-serial v2.157.1. Actualice el firmware del dispositivo y el software del controlador.
ERRMRGBW-D06: Los registros de configuración de acciones por tipo de pulsación funcionan incorrectamente
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware desde 3.5.0 hasta 3.5.2, ambos incluidos.
Descripción
Los registros de configuración de acciones en las direcciones 768–819 y 832–883 funcionan incorrectamente.
Solución provisional
Utilice los registros 1000–1063 para configurar las acciones.
Resolución
No se prevé ninguna corrección. Los registros defectuosos se eliminaron del firmware a partir de 3.5.3.
ERRMRGBW-D07: los registros de nivel de los canales se restablecen a los valores predeterminados al encender el regulador
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware desde 3.5.0 hasta 3.5.2, ambos incluidos.
Descripción
Un error de firmware hacía que los niveles de canal cargaran sus valores predeterminados al encender, en lugar de los valores existentes al apagar.
Resolución
Corregido en el firmware 3.5.3. Actualice el firmware del dispositivo.
ERRMRGBW-D08: Las acciones de entrada siempre funcionan en el modo de seguridad, independientemente de los ajustes
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware desde 3.5.0 hasta 3.5.2, ambos incluidos.
Descripción
Un error del firmware hace que las acciones de entrada de pulsadores o interruptores funcionen siempre en Safety Mode, independientemente del ajuste Input control in safe mode.
Resolución
Corregido en el firmware 3.5.3. Actualice el firmware del dispositivo.
ERRMODBUS001: El dispositivo responde a la dirección 0xFD
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.4.4.
Descripción
Los dispositivos Fast Modbus pueden interferir con dispositivos de terceros del mismo bus si estos utilizan comandos especiales que comienzan por 0xFD.
Causa y detalles
Fast Modbus reserva 0xFD para comandos especiales de difusión. Si una solicitud de terceros comienza con 0xFD pero utiliza un comando ajeno a Fast Modbus, los dispositivos Wiren Board afectados responden con MODBUS_ERR_ILLEGAL_FUNCTION y alteran el otro intercambio. El controlador de software del bus interpreta incorrectamente el paquete como tráfico Modbus ordinario.
Solución provisional
Evite compartir un bus entre dispositivos Wiren Board afectados y dispositivos de terceros.
Resolución
Corregido en el firmware 3.4.4.
ERRMODBUS002: Respuesta incorrecta a la orden de descubrimiento 0x46
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.4.2.
Descripción
Fast Modbus utilizaba originalmente la función 0x60, que posteriormente se cambió a 0x46 porque 0x60 estaba en un rango reservado. La compatibilidad con versiones anteriores conservó ambos códigos de solicitud, pero el dispositivo siempre respondía con 0x60. La corrección responde con la misma función utilizada en la solicitud: 0x46 o 0x60.
Solución
Actualice el firmware a 3.4.2.
Resolución
Corregido en el firmware 3.4.2.
ERRMODBUS003: Comportamiento inesperado cuando se escriben valores no válidos en algunos registros
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.5.3.
Descripción
Cuando los valores del rango [256 ... 65535] se escriben en algunos registros, se descartan los 8 bits superiores y el firmware recibe el valor módulo 256. Por ejemplo, escribir 257 tiene el mismo efecto que escribir 1.
El registro de dirección del dispositivo (128) es uno de los registros afectados.
Todos los registros funcionan como se espera dentro de sus rangos documentados. El problema se produce cuando se escriben valores no válidos superiores a 255.
Solución
Actualice el firmware a 3.5.3.
Resolución
Corregido en el firmware 3.5.3.
ERRMODBUS004: respuestas incorrectas de campos de bits
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.4.2.
Descripción
Las respuestas que contienen campos de bits, incluidas las lecturas de bobinas/entradas discretas y la gestión de eventos, podían contener bits altos incorrectos.
Solución
Actualice el firmware a 3.4.2.
Resolución
Corregido en el firmware 3.4.2.
ERRMODBUS005: lectura incorrecta de distintos registros de bobinas en una sola solicitud
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.4.4.
Descripción
La lectura de varios registros de bobina diferentes en direcciones consecutivas mediante una sola solicitud devolvía valores incorrectos; por ejemplo, 2 y 3 en WB-MSW/WB-MWAC, o 3 y 4 en WB-LED.
Solución
Actualice el firmware a 3.4.4.
Resolución
Corregido en el firmware 3.4.4.
ERRMODBUS006: respuestas a solicitudes con paridad incorrecta
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.5.1.
Descripción
El dispositivo respondía a solicitudes con paridad incorrecta en lugar de ignorarlas.
Solución
Actualice el firmware a la versión 3.5.1.
Resolución
Corregido en el firmware 3.5.1.
ERRMODBUS007: Pérdida de eventos cuando dos dispositivos transmiten simultáneamente en un mismo bus
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.8.0.
Descripción
Cuando dos dispositivos de un mismo bus tienen eventos pendientes simultáneamente, uno puede transmitir un paquete de eventos incompleto.
Causa y detalles
En Fast Modbus, el maestro solicita eventos. Todos los dispositivos con eventos pendientes participan en el arbitraje; el ganador responde y los demás esperan a la siguiente solicitud.
Un evento generado espera a ser transmitido. Una vez que el dispositivo coloca su trama en el bus, el evento se marca como enviado. El siguiente acuse de recibo del maestro para ese dispositivo elimina los eventos enviados de su cola. Este es el mecanismo normal de confirmación.
El defecto marcaba los eventos como enviados demasiado pronto, al recibir la solicitud de eventos, antes de terminar el arbitraje. Si el dispositivo ganaba el arbitraje, el funcionamiento era normal. Si perdía, no se transmitía ningún paquete, pero sus eventos ya estaban marcados como enviados. Una confirmación posterior para ese dispositivo también confirmaba esos eventos no enviados y los eliminaba de la cola antes de que llegaran al maestro.
El valor de la interfaz web no se actualiza y no se publica ningún mensaje MQTT, aunque los registros del dispositivo siguen siendo correctos. Se pierde la notificación del cambio.
Por ejemplo, si las entradas de dos módulos de relé del mismo bus se cierran simultáneamente, un módulo puede actualizarse correctamente en la interfaz web mientras el otro pierde algunos eventos y sigue apareciendo en su estado anterior a pesar de haber conmutado físicamente.
Solución provisional
Desactive temporalmente el funcionamiento basado en eventos para los registros afectados estableciendo sporadic en false en la plantilla del dispositivo. Los registros se consultarán entonces con el intervalo configurado.
Resolución
Corregido en el firmware 3.8.0.
ERRMODBUS008: Comportamiento inesperado con tramas de solicitud largas
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.8.1.
Descripción
Recibir una trama de más de 265 bytes, la longitud máxima de una trama Fast Modbus, puede bloquear y reiniciar el dispositivo; en algunos casos también pueden perderse los ajustes.
Causa y detalles
El algoritmo de recepción no procesaba las solicitudes no válidas de tamaño excesivo, lo que provocaba un desbordamiento del búfer y la corrupción de la memoria adyacente. El dispositivo se bloquea y el watchdog lo reinicia. Las tramas muy grandes, de más de aproximadamente 500 bytes, también pueden dañar los ajustes y provocar un reinicio con los parámetros de comunicación predeterminados: 9600 8N2, dirección 1.
Solución provisional
- No envíe solicitudes que superen los límites de Modbus RTU o Fast Modbus (265 bytes para Fast Modbus).
- No conecte el dispositivo a un bus que transporte tráfico no Modbus o mensajes de más de 265 bytes.
Resolución
Corregido en el firmware 3.8.1.
ERRMODBUS009: Comportamiento inesperado al leer cerca de la dirección 0xFFFF en modo de lectura continua
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.8.1.
Descripción
Con el modo de lectura continua habilitado, un rango de lectura que alcance o cruce la dirección 0xFFFF puede bloquear y reiniciar el dispositivo.
Causa y detalles
El algoritmo de lectura continua no gestionaba el desbordamiento del contador de direcciones de registro de 16 bits. Leer 0xFFFF hacía que el contador volviera al inicio y provocaba un bucle infinito, seguido de un reinicio por watchdog.
Solución provisional
Con el modo de lectura continua activado, no lea un rango que incluya 0xFFFF. Los dispositivos Wiren Board no tienen ningún registro implementado en esa dirección.
Resolución
Corregido en el firmware 3.8.1.
ERRMODBUS010: Validación incorrecta de solicitudes y gestión incorrecta de solicitudes no válidas
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.8.1.
Descripción
El dispositivo puede aceptar o gestionar incorrectamente solicitudes sintácticamente no válidas, devolver un código de excepción incorrecto o imponer un límite incorrecto al número de registros.
Causa y detalles
El algoritmo de validación trata incorrectamente estos casos:
1) Las solicitudes para leer cero registros se ejecutan con éxito y devuelven una respuesta sin datos que contiene únicamente cabecera y CRC. Modbus exige la excepción 0x03 (ILLEGAL_DATA_VALUE).
2) Se aplica un único límite de 125 registros a todas las funciones de lectura/escritura; superarlo devuelve 0x02 (ILLEGAL_DATA_ADDRESS). Sin embargo, Modbus especifica límites de 2000 bits para las lecturas de bits, 125 registros para las lecturas de registros de entrada/mantenimiento, 1968 bobinas para las escrituras de múltiples bobinas y 123 registros de mantenimiento para las escrituras de múltiples registros. Superar el límite aplicable debería devolver 0x03 (ILLEGAL_DATA_VALUE).
3) Byte Count no se valida en escrituras múltiples (0x0F y 0x10). Una discrepancia entre Byte Count y el número de registros debería devolver 0x03 (ILLEGAL_DATA_VALUE).
4) Las escrituras de una única bobina no validan el valor y utilizan el bit más significativo del valor de la solicitud. Modbus solo permite 0x0000 y 0xFF00; todos los demás valores deberían devolver 0x03 (ILLEGAL_DATA_VALUE).
5) Las solicitudes con estructura no válida pero CRC válido, como las de longitud excesiva, se procesan normalmente. En cambio, estas solicitudes malformadas deberían ignorarse.
6) Se procesan tramas estructuralmente válidas, pero de tamaño excesivo, de 257–265 bytes. Las tramas Modbus estándar de más de 256 bytes no son válidas y deberían ignorarse.
Solución provisional
Envíe únicamente solicitudes estructuralmente correctas que cumplan la especificación Modbus.
Resolución
Corregido en el firmware 3.8.1.
ERRMODBUS011: Tratamiento incorrecto de solicitudes no válidas de configuración de eventos Fast Modbus
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.8.1.
Descripción
Una orden de configuración de eventos (EVENT_CTRL, cmd=0x46, sub_cmd=0x18) con campos de longitud no válidos puede configurar incorrectamente las notificaciones de eventos y generar una respuesta de longitud impredecible.
Causa y detalles
El manejador de configuración de eventos Fast Modbus no validaba los campos de tamaño y longitud interna del bloque de datos. Las longitudes no válidas pueden hacer que procese datos fuera de la trama recibida, lo que provoca:
1) Ajustes incorrectos de notificación de eventos, incluidos cambios espontáneos en las prioridades o máscaras de eventos.
2) Una respuesta de configuración de eventos de longitud impredecible.
Solución provisional
Envíe únicamente comandos Fast Modbus válidos que cumplan su especificación.
Resolución
Corregido en el firmware 3.8.1.
ERRMODBUS012: El dispositivo deja de transmitir eventos Fast Modbus
Dispositivos afectados
WB-MRGBW-D y WB-LED con firmware anterior a 3.9.2.
Descripción
El dispositivo deja de enviar eventos Fast Modbus e indica continuamente que no hay eventos (sub_cmd=0x12) en respuesta a las solicitudes de eventos (cmd=0x46, sub_cmd=0x10). Los controles de la interfaz web se bloquean mientras los registros del dispositivo siguen cambiando.
Cuanto más frecuentemente cambia un valor con eventos habilitados, antes aparece el problema. En las pruebas con supresión de rebotes de 1 ms, la transmisión de eventos se detuvo después de 23 minutos con 200 impulsos de entrada por segundo y después de varias horas con 100 impulsos por segundo. También puede ocurrir con cambios poco frecuentes, pero es mucho menos probable. El controlador de software no registra ningún error porque el dispositivo informa válidamente de que no hay eventos pendientes.
Para el diagnóstico, lea directamente el registro sin eventos, por ejemplo, el contador de impulsos de entrada:
modbus_client_rpc -mrtu -pnone -s2 /dev/ttyRS485-1 -b115200 -a1 -r32 -t0x03
Si el registro aumenta pero el control de la interfaz web no cambia, este problema está presente.
Causa y detalles
El contador de eventos no enviados se comparte entre un gestor de interrupciones y el bucle principal sin una sincronización correcta. Una interrupción durante una operación de lectura-modificación-escritura en el bucle principal puede perder un incremento del contador. El incremento no puede recuperarse porque solo se produce cuando un evento entra por primera vez en la cola. El dispositivo cree entonces que no tiene nada que enviar, a pesar de haber eventos en cola.
La condición persiste hasta que el dispositivo se reinicia. Otro evento puede vaciar temporalmente la cola acumulada y actualizar el control una vez, pero la discrepancia reaparece inmediatamente. Por ello, una instalación sin otros cambios parece bloqueada.
La probabilidad aumenta con la frecuencia de eventos y la carga del bus, ya que los accesos simultáneos se vuelven más probables.
Solución provisional
Reiniciar el dispositivo restaura los eventos hasta que el problema vuelve a producirse. Reiniciar el controlador o reiniciar wb-mqtt-serial no ayuda: el estado se mantiene en el dispositivo y volver a configurar los eventos no lo restablece.
Reduzca la probabilidad aumentando el tiempo antirrebote de las entradas o deshabilitando los eventos de los registros que cambian con frecuencia. Hasta que se actualice el firmware, lea los valores directamente de los registros.
Resolución
Corregido en el firmware 3.9.2.
ERRLED0001: No se ha configurado una acción de pulsación corta para las entradas 1–3
Dispositivos afectados
Todos los WB-LED v1.3A, v1.3A/T, v1.3C, v1.3H, v1.3I, v1.3I/1, v1.3I/2, v1.3J/1, v1.3J/1A, v1.3J/2, v1.3J/2A, v1.3K, v1.3L, v1.3M, v1.3M/1, V1.4A, V1.4A/1, v1.4A/2, v1.4B, v1.4B/1, v1.4C, v1.5A, v1.5A/1, v1.5A/2, v1.5A/3, v1.5B, v1.5B/1, v1.5B/2, v4.3M
Descripción
Un error en las pruebas de fabricación impidió restablecer los ajustes predeterminados tras las pruebas. Los dispositivos salieron de producción con parámetros incorrectos:
- Acción de pulsación corta de la entrada 1: Disabled en lugar de Toggle RGB
- Acción de pulsación corta de la entrada 2: Disabled en lugar de Increase RGB strip hue (HSV-H, with wraparound)
- Acción de pulsación corta de la entrada 3: Disabled en lugar de Toggle channel 4
Solución provisional
- Utilice la interfaz web del controlador y la plantilla del dispositivo para establecer los valores correspondientes
- Escriba manualmente 0x3009 en el registro 0x1000, 0x900e en 0x1001 y 0x3003 en 0x1002
Resolución
Corregido en el lote v1.5B/3
ERRLED0002: inversión de fase incorrecta en el modo 4W
Dispositivos afectados
Todos los dispositivos WB-LED con firmware de 3.5.0 a 3.6.0, ambos incluidos.
Se aplica al modo 4W, con todos los canales conectados en paralelo.
Descripción
Para distribuir uniformemente la carga de la fuente de alimentación, los pares de canales 1–2 y 3–4 funcionan en fases opuestas, excepto en el modo 4W.
Un error del firmware cargaba incorrectamente el ajuste de inversión de fase desde la memoria no volátil al arrancar. Por ello, los pares de canales 1–2 y 3–4 siempre funcionaban en fases opuestas, incluso en modo 4W con todos los canales en paralelo. Esto podía activar la protección contra sobrecorriente. La inversión de fase funciona correctamente después de cambiar al modo 4W, hasta el siguiente reinicio.
Solución provisional
- preferiblemente: actualice el firmware a 3.6.1 o posterior
- después de reiniciar, cambie a otro modo y vuelva a 4W
Resolución
Corregido en el firmware 3.6.1.
ERRLED0003: Recuperación incorrecta tras disparos por sobrecorriente en canales en paralelo
Dispositivos afectados
Todos los dispositivos WB-LED con firmware hasta 3.6.0 inclusive.
Se aplica a los modos de regulación 2W+W+W, W+W+2W, 2W+2W, CCT+2W, 2W+CCT y 4W.
Descripción
Un error del firmware enciende los canales uno a uno después de que se active la protección contra sobrecorriente, incluso cuando el modo de funcionamiento requiere canales en paralelo. Esto puede superar el límite de corriente de un canal individual y volver a activar la protección.
Solución provisional
Actualice el firmware a 3.6.1 o posterior.
Resolución
Corregido en el firmware 3.6.1. Los canales en paralelo se encienden simultáneamente.
ERRLED0004: El regulador no puede funcionar a plena carga con canales en paralelo
Dispositivos afectados
Todos los dispositivos WB-LED con firmware hasta 3.6.0 inclusive.
Se aplica a los modos de regulación 2W+W+W, W+W+2W, 2W+2W, CCT+2W, 2W+CCT y 4W.
Descripción
Un error del firmware actualizaba los valores PWM de forma asíncrona, permitiendo que un canal en paralelo se activara antes que los demás. La corriente pasaba entonces por un solo transistor hasta que se activaban los otros transistores en paralelo, lo que disparaba la protección de hardware contra sobrecorriente.
Solución provisional
Actualice el firmware a 3.6.1 o posterior.
Resolución
Corregido en el firmware 3.6.1. PWM se aplica de forma sincronizada a los canales en paralelo.
ERRLED0005: La potencia total de los canales de las tiras CCT no está normalizada
Dispositivos afectados
WB-LED y WB-MRGBW-D con firmware hasta 3.6.1 inclusive
Se aplica a los modos del regulador CCT+W+W, CCT+2W, W+W+CCT, 2W+CCT y CCT+CCT.
Descripción
El algoritmo de mezcla CCT no mantiene constante la potencia total. La potencia aumenta a medida que la temperatura de color se acerca al centro del rango y alcanza su máximo al 50%, cuando ambos canales funcionan con el brillo máximo.
Solución provisional
Actualice el firmware a 3.7.0 o posterior. Active CCT strip power normalization.
Resolución
Corregido en el firmware 3.7.0