DocumentazioneProblemi noti di WB-MAI6
ERRMODBUS001: il dispositivo risponde all’indirizzo 0xFD
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.10.0.
Descrizione
I dispositivi Fast Modbus possono interferire con dispositivi di terzi sullo stesso bus se questi utilizzano comandi speciali che iniziano con 0xFD.
Causa e dettagli
Fast Modbus riserva 0xFD ai comandi broadcast speciali. Se una richiesta di terzi inizia con 0xFD ma utilizza un comando estraneo a Fast Modbus, i dispositivi Wiren Board interessati rispondono con MODBUS_ERR_ILLEGAL_FUNCTION, disturbando l’altro scambio. Il driver del bus tratta erroneamente il pacchetto come normale traffico Modbus.
Soluzione temporanea
Evitare di condividere il bus tra i dispositivi Wiren Board interessati e i dispositivi di terzi.
Risoluzione
Corretto nel firmware 2.10.0.
ERRMODBUS002: risposta errata al comando di rilevamento 0x46
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.0.7.
Descrizione
Fast Modbus utilizzava inizialmente la funzione 0x60, poi modificata in 0x46 perché 0x60 si trovava in un intervallo riservato. La compatibilità con le versioni precedenti manteneva entrambi i codici di richiesta, ma il dispositivo rispondeva sempre con 0x60. La correzione fa rispondere con la stessa funzione utilizzata nella richiesta: 0x46 oppure 0x60.
Rimedio
Aggiornare il firmware alla versione 2.0.7.
Risoluzione
Corretto nel firmware 2.0.7.
ERRMODBUS003: comportamento imprevisto quando vengono scritti valori non validi in alcuni registri
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.1.4.
Descrizione
Quando valori nell’intervallo [256 ... 65535] vengono scritti in alcuni registri, gli 8 bit superiori vengono scartati e il firmware riceve il valore modulo 256. Ad esempio, scrivere 257 ha lo stesso effetto di scrivere 1.
Il registro dell’indirizzo del dispositivo (128) è uno di quelli interessati.
Tutti i registri funzionano come previsto entro i campi documentati. Il problema si verifica quando vengono scritti valori non validi superiori a 255.
Rimedio
Aggiornare il firmware alla versione 2.1.4.
Risoluzione
Corretto nel firmware 2.1.4.
ERRMODBUS004: risposte errate con campi di bit
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.0.7.
Descrizione
Le risposte contenenti campi di bit, comprese le letture di coil/ingressi discreti e la gestione degli eventi, potevano contenere bit alti errati.
Rimedio
Aggiornare il firmware alla versione 2.0.7.
Risoluzione
Corretto nel firmware 2.0.7.
ERRMODBUS006: risposte a richieste con parità errata
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.1.1.
Descrizione
Il dispositivo rispondeva alle richieste con parità errata anziché ignorarle.
Rimedio
Aggiornare il firmware alla versione 2.1.1.
Risoluzione
Corretto nel firmware 2.1.1.
ERRMODBUS008: comportamento imprevisto con frame di richiesta lunghi
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.4.2.
Descrizione
La ricezione di un frame più lungo di 265 byte, lunghezza massima di un frame Fast Modbus, può bloccare e riavviare il dispositivo; in alcuni casi possono andare perse anche le impostazioni.
Causa e dettagli
L’algoritmo di ricezione non gestiva le richieste non valide di dimensioni eccessive, causando un overflow del buffer e la corruzione della memoria adiacente. Il dispositivo si blocca e il watchdog lo riavvia. Frame molto grandi, superiori a circa 500 byte, possono anche corrompere le impostazioni, causando un riavvio con i parametri di comunicazione predefiniti: 9600 8N2, indirizzo 1.
Soluzione temporanea
- Non inviare richieste che superano i limiti di Modbus RTU o Fast Modbus (265 byte per Fast Modbus).
- Non collegare il dispositivo a un bus che trasporta traffico non Modbus o messaggi più lunghi di 265 byte.
Risoluzione
Corretto nel firmware 2.4.2.
ERRMODBUS009: comportamento imprevisto durante la lettura vicino all’indirizzo 0xFFFF in modalità di lettura continua
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.4.2.
Descrizione
Con la modalità di lettura continua abilitata, un intervallo di lettura che raggiunge o supera l’indirizzo 0xFFFF può bloccare e riavviare il dispositivo.
Causa e dettagli
L’algoritmo di lettura continua non gestiva l’overflow del contatore a 16 bit degli indirizzi dei registri. La lettura di 0xFFFF faceva tornare a zero il contatore e causava un ciclo infinito, seguito da un reset del watchdog.
Soluzione temporanea
Con la modalità di lettura continua abilitata, non leggere un intervallo che include 0xFFFF. I dispositivi Wiren Board non implementano alcun registro a tale indirizzo.
Risoluzione
Corretto nel firmware 2.4.2.
ERRMODBUS010: convalida errata delle richieste e gestione errata delle richieste non valide
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.4.2.
Descrizione
Il dispositivo può accettare o gestire in modo errato richieste sintatticamente non valide, restituire un codice di eccezione errato oppure imporre un limite errato al numero di registri.
Causa e dettagli
L’algoritmo di convalida gestisce in modo errato questi casi:
1) Le richieste di lettura di zero registri riescono con una risposta senza dati contenente solo intestazione e CRC. Modbus richiede l’eccezione 0x03 (ILLEGAL_DATA_VALUE).
2) Un limite unico di 125 registri viene applicato a tutte le funzioni di lettura/scrittura; il superamento restituisce 0x02 (ILLEGAL_DATA_ADDRESS). Modbus specifica invece limiti di 2000 bit per le letture di bit, 125 registri per le letture di registri di ingresso/holding, 1968 coil per le scritture multiple di coil e 123 registri holding per le scritture multiple di registri. Il superamento del limite pertinente dovrebbe restituire 0x03 (ILLEGAL_DATA_VALUE).
3) Byte Count non viene convalidato per le scritture multiple (0x0F e 0x10). Una mancata corrispondenza tra Byte Count e numero di registri dovrebbe restituire 0x03 (ILLEGAL_DATA_VALUE).
4) Le scritture di una singola coil non convalidano il valore e utilizzano il bit più significativo del valore della richiesta. Modbus ammette solo 0x0000 e 0xFF00; tutti gli altri valori dovrebbero restituire 0x03 (ILLEGAL_DATA_VALUE).
5) Le richieste strutturalmente non valide con CRC valido, ad esempio richieste troppo lunghe, vengono elaborate normalmente. Tali richieste malformate dovrebbero invece essere ignorate.
6) Vengono elaborati frame strutturalmente validi ma sovradimensionati, da 257–265 byte. I frame Modbus standard più lunghi di 256 byte non sono validi e dovrebbero essere ignorati.
Soluzione temporanea
Inviare solo richieste strutturalmente corrette e conformi alle specifiche Modbus.
Risoluzione
Corretto nel firmware 2.4.2.
ERRMODBUS011: gestione errata delle richieste non valide di configurazione degli eventi Fast Modbus
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.4.2.
Descrizione
Un comando di configurazione degli eventi (EVENT_CTRL, cmd=0x46, sub_cmd=0x18) con campi di lunghezza non validi può configurare in modo errato le notifiche degli eventi e produrre una risposta di lunghezza imprevedibile.
Causa e dettagli
Il gestore di configurazione degli eventi Fast Modbus non convalidava i campi della dimensione e della lunghezza dei blocchi dati interni. Lunghezze non valide possono portarlo a elaborare dati oltre il frame ricevuto, causando:
1) Impostazioni errate delle notifiche degli eventi, comprese variazioni spontanee delle priorità o delle maschere degli eventi.
2) Una risposta di configurazione degli eventi di lunghezza imprevedibile.
Soluzione temporanea
Inviare solo comandi Fast Modbus validi e conformi alle relative specifiche.
Risoluzione
Corretto nel firmware 2.4.2.
ERRMAI601: impedenza di ingresso della misura di tensione inferiore alle specifiche
Dispositivi interessati
Tutti i modelli MAI6.
Descrizione
In modalità di tensione riferita a massa, l’impedenza di ingresso MAI6 era circa 4 kΩ nel campo 0–2 V anziché 1 MΩ e circa 2 kΩ oltre 5 V anziché 4 kΩ. Una bassa impedenza di ingresso può alterare il segnale misurato.
Causa e dettagli
Un errore software commutava in modo errato i circuiti interni, riducendo notevolmente l’impedenza di ingresso al di sotto delle specifiche.
Risoluzione
Corretto nel firmware 2.0.5.
Raccomandazioni
- Aggiornare il firmware del dispositivo alla versione 2.0.5.
- Verificare la compatibilità di MAI6 con la sorgente del segnale, soprattutto oltre 5 V, ad esempio con sensori 0–10 V.
ERRMAI602: letture di tensione errate da sorgenti con elevata impedenza di uscita
Dispositivi interessati
Tutti i modelli MAI6.
Descrizione
Le letture di tensione nel campo 2–10 V possono essere troppo basse quando la sorgente ha un’elevata impedenza di uscita.
Causa e dettagli
L’impedenza di ingresso della misura è circa 1 MΩ a 0–2 V e 4 kΩ a 2–10 V. Per letture corrette, l’impedenza di uscita della sorgente deve essere almeno dieci volte inferiore: non più di 400 Ω nel campo 2–10 V. In caso contrario, le letture sono troppo basse.
Raccomandazioni
Utilizzare un partitore resistivo per portare la tensione nel campo 0–2 V. L’impedenza di uscita del partitore non deve superare 100 kΩ.
ERRMAI603: la misura di resistenze a tre fili superiori a 1000 Ω non riesce
Dispositivi interessati
Tutti i modelli WB-MAI6 con firmware fino a 2.0.6 inclusa.
Descrizione
Le resistenze a tre fili superiori a 1000 Ω non venivano misurate. Il problema riguardava anche le termoresistenze a tre fili: la temperatura non era disponibile quando la resistenza del sensore superava 1000 Ω.
Causa e dettagli
Un errore del firmware impediva di cambiare il metodo di misura per resistenze superiori a 1000 Ω.
Raccomandazioni
Aggiornare il firmware alla versione 2.0.7 oppure utilizzare un circuito a due fili per resistenze superiori a 1000 Ω.
ERRMAI604: risposte incondizionate alle richieste estese indirizzate a 0xFD
Dispositivi interessati
WB-MAI6 con firmware precedente a 2.0.8.
Descrizione
L’indirizzo 0xFD trasporta comandi Fast Modbus che richiedono una risposta dati e altre richieste broadcast. I dispositivi interessati rispondevano a ogni pacchetto indirizzato a 0xFD, compresi quelli senza comandi Fast Modbus.
Rimedio
Aggiornare il firmware alla versione 2.0.8.
Risoluzione
Corretto nel firmware 2.0.8.
ERRMAI605: falsi rilevamenti di contatti puliti
Dispositivi interessati
Tutti i modelli WB-MAI6 con firmware fino a 2.1.4 inclusa.
Descrizione
In modalità contatto pulito, si verificano falsi rilevamenti quando il sensore è aperto.
Causa e dettagli
Con un sensore aperto (ingresso flottante), un errore del firmware causava l’overflow di una variabile di calcolo intermedia, producendo falsi rilevamenti. Un tempo di campionamento più breve aumenta la frequenza del problema. Con Data Rate = 20 (campionamento di 50 ms), i falsi rilevamenti sono praticamente assenti; con Data Rate = 1000 (1 ms) si verificano circa una volta al minuto.
Per lo stesso motivo, la modalità di resistenza poteva mostrare un valore casuale, anche negativo, su un ingresso non collegato.
Soluzione temporanea
- Aggiornare al firmware 2.1.5 o successivo, che corregge il problema software.
- Se l’aggiornamento non è possibile, collegare una resistenza da 100–1000 kΩ tra iGND e l’ingresso per impedirne il flottamento ed evitare l’overflow del calcolo.
ERRMAI606: letture di resistenza a tre fili apparentemente valide senza contatto con il sensore
Dispositivi interessati
Tutti i modelli WB-MAI6 con firmware fino a 2.3.0 inclusa.
Descrizione
La modalità di resistenza a tre fili può mostrare letture errate, ad esempio valori negativi o prossimi a zero, quando il sensore è assente o i fili sono danneggiati.
Causa e dettagli
Le caratteristiche del circuito, le correnti di dispersione e le tolleranze dei componenti rendevano inaffidabile il rilevamento della disconnessione del sensore. Anche le interruzioni di N e/o GND non venivano rilevate.
Soluzione temporanea
Aggiornare il firmware alla versione 2.3.2 o successiva
Risoluzione
Corretto nel firmware 2.3.2. Aggiunta una misura separata della resistenza N–GND per rilevare interruzioni dei fili N e/o GND.
ERRMAI607: diafonia di tensione tra i canali
Dispositivi interessati
Tutti i modelli WB-MAI6 con firmware fino a 2.4.0 inclusa.
Descrizione
La misura oltre +5 V induce una tensione fantasma sui canali adiacenti non collegati.
Causa e dettagli
Le caratteristiche hardware del multiplexer consentono a una piccola corrente di fluire nei canali adiacenti non collegati durante misure oltre +5 V, inducendo una tensione fantasma da pochi millivolt a diversi volt.
Soluzione temporanea
Aggiornare il firmware alla versione 2.4.1 o successiva
Risoluzione
Corretto nel firmware 2.4.1
ERRMAI608: errori di misura dovuti a un’elevata resistenza di contatto delle morsettiere
Dispositivi interessati
Lotti WB-MAI6 da 1.6D (marzo 2025) a 1.7D (giugno 2026), inclusi.
Descrizione
Un’elevata resistenza di contatto delle morsettiere, più spesso su quelle a quattro posizioni, introduce un errore di misura. Il difetto è intermittente e generalmente scompare dopo aver reinserito la morsettiera. I sensori NTC e le termocoppie non sono praticamente interessati. Errore aggiuntivo massimo:
- collegamento a due fili:
- Resistenza — fino a +0.4 Ω
- Pt100 — fino a +1.0 °C
- Pt1000 — fino a +0.1 °C
- collegamento a tre fili:
- Resistenza — ±0.2 Ω
- Pt100 — ±0.5°C
- Pt1000 — ±0.05°C
Causa e dettagli
Le parti delle morsettiere montate sulla scheda e quelle accoppiate provenivano da produttori diversi. Nonostante un aspetto simile, la geometria differisce e la parte accoppiata può inserirsi in modo errato. La resistenza di contatto dei singoli contatti può raggiungere 0.2 Ω. Questo è molto più frequente sulle morsettiere a quattro posizioni; non è stato possibile riprodurlo su quelle a tre posizioni.
Soluzione temporanea
- Reinserire la morsettiera: rimuoverla e reinstallarla saldamente. In genere questo risolve il problema.
- Richiedere all’assistenza tecnica la parte accoppiata corretta della morsettiera.
Risoluzione
Corretto nel lotto 1.7D/1 (giugno 2026)