Problemi noti di Wiren Board 8

Errata hardware e software di Wiren Board 8. Verificare il modello, il lotto e la versione software interessati da ciascun problema prima di applicarne il rimedio.

ERRWB84001: incompatibilità con alcuni switch e router Ethernet

Dispositivi interessati: Wiren Board 8.4.3, lotti v8.4.3A/4G, v8.4.3A/4G1 e v8.4.3A/4G2.

Il collegamento Ethernet si attiva ma non passa alcun dato quando il dispositivo è collegato a determinati switch o router. Ridurre la velocità del collegamento a 10 Mbit/s ripristina il funzionamento. Il PHY Ethernet CH182H è incompatibile con alcuni dispositivi di rete, tra cui MikroTik hAPac2 e eero Dual-band 350 Mbps Wireless Router.

Un controllore con questo PHY riporta:

cat /sys/devices/platform/external-ethernet-phys/external-ethernet-phys:soft-mdio0/mdio_bus/gpio-0/gpio-0:00/phy_id
0x73719011

Soluzione temporanea: utilizzare un dispositivo di rete compatibile oppure ridurre temporaneamente la velocità di collegamento a 10 Mbit/s fino alla sostituzione del dispositivo di rete o del controllore. Corretto nelle revisioni successive del controllore. I controllori della revisione 8.4.3 interessati che presentano questa incompatibilità hanno diritto alla sostituzione in garanzia.

ERRWB84002: possibile cortocircuito durante l’installazione del modulo processore

Lotti interessati: 8.4.3A/4G e v8.4.4A/4G.

Le tolleranze di produzione del modulo processore possono causare un disallineamento delle piazzole di contatto rispetto ai contatti del connettore SO-DIMM. Uno spostamento eccessivo verso il connettore dei moduli laterali può causare un cortocircuito su alcuni dispositivi. Posizionare il modulo verso lo slot della scheda SD non causa questo problema.

Soluzione temporanea: un distanziatore è montato sul fermo del connettore più vicino al connettore dei moduli laterali per mantenere il modulo processore verso lo slot della scheda SD. Il connettore SO-DIMM reca anche un’etichetta Do not remove . Se il distanziatore viene perso, durante l’installazione posizionare il modulo completamente verso lo slot della scheda SD. Corretto nelle revisioni successive del controllore.

ERRWB84003: instabilità del motore delle regole

Dispositivi interessati: Wiren Board 8.4.3, lotto 8.4.3A/4G, prodotto prima del 23 maggio 2024.

Il motore delle regole installato supporta WB8 in modo incompleto e può funzionare in modo inaffidabile. Aggiornare il software:

apt update
apt upgrade

Senza accesso a Internet, scaricare l’immagine FIT stabile più recente, aggiornare il controllore e copiare anche l’immagine in /mnt/data/.wb-restore/factoryreset.fit. Corretto nei firmware più recenti.

ERRWB84004: instabilità del driver MQTT

Dispositivi interessati: Wiren Board 8.4.3, lotti 8.4.3A/4G e 8.4.3A/4G1, prodotti prima dell’11 giugno 2024.

Il supporto incompleto di WB8 nel firmware installato può causare un funzionamento instabile del driver MQTT. Aggiornare il software:

apt update
apt upgrade

Senza accesso a Internet, scaricare l’immagine FIT stabile più recente, aggiornare il controllore e copiare anche l’immagine in /mnt/data/.wb-restore/factoryreset.fit. Corretto nei firmware più recenti.

ERRWB84005: Ethernet smette di funzionare dopo un aggiornamento del kernel e un riavvio

Dispositivi interessati: Wiren Board 8.4.3 di qualsiasi lotto, aggiornato tra il 16 e il 19 agosto 2024, con linux-image-wb8 versione 6.8.0-wb100.

Un errore nel file DTS configura Ethernet in modo errato. Dopo un aggiornamento del kernel tramite APT o dell’immagine FIT e un riavvio, le porte Ethernet smettono di funzionare.

Aggiornare con apt update && apt upgrade. Senza accesso a Internet, installare l’immagine FIT stabile più recente tramite Debug Network, Wi-Fi o un’unità USB; non è necessaria una copia aggiuntiva dell’immagine. Corretto in linux-image-wb8 versione 6.8.0-wb101 e versioni successive.

ERRSUPERCAP0001: limite di alimentazione di 36 V con i moduli supercondensatore interessati

Moduli interessati: WBMZ4-SUPERCAP, WBMZ3-SUPERCAP e WBMZ2-SUPERCAP.

Un controllore dotato di un modulo interessato non deve essere alimentato oltre 36 V. Il convertitore di uscita del modulo utilizza un diodo con tensione nominale massima di 40 V. Una tensione di alimentazione del controllore maggiore può provocare la rottura di questo diodo, danneggiando il modulo di riserva ed eventualmente il controllore.

Soluzione temporanea: limitare l’alimentazione del controllore a 36 V. Se è necessaria un’alimentazione di riserva con una tensione di alimentazione maggiore, richiedere la sostituzione in garanzia del modulo. Corretto in WBMZ6-SUPERCAP v6.1 e successivi e WBMZ4-SUPERCAP v4.3 e successivi.

ERRWB74004: il modem GSM si disconnette a causa di interferenze elettromagnetiche esterne

Dispositivi interessati: Wiren Board 7.4 e 8.4 con schede modem WBC2-4G precedenti alla versione 3.7.

I contattori elettromagnetici vicini al controllore possono indurre interferenze che disconnettono il modem. Il bus USB utilizzato per la comunicazione con il modem è sensibile a queste interferenze. I messaggi tipici del kernel includono:

option1 ttyUSB0: GSM modem (1-port) converter now disconnected from ttyUSB0
option 3-1:1.2: device disconnected

ModemManager segnala comandi seriali scaduti e timeout ripetuti delle porte, quindi rilascia le porte USB del modem. Il servizio riavvia automaticamente il modem.

Soluzioni temporanee:

• Allontanare il più possibile dal controllore le sorgenti di interferenze dovute agli archi elettrici.
• Montare un circuito snubber adeguato in parallelo ai contatti del relè che controlla la bobina del contattore. I valori di esempio sono una resistenza da 100 Ω, 1 W in serie con un condensatore da 0.1 µF, 1000 V. La soppressione degli archi sui contatti riduce sostanzialmente le interferenze.
• Anche un ponticello corto di filo spesso, lungo meno di 1 cm, tra la massa della scheda modem vicino al connettore dell’antenna e la massa più vicina sulla scheda del controllore risolve il problema, ma richiede modifiche e saldature accurate sulla scheda.

Correzione: la versione 3.7 della scheda modem aggiunge un ulteriore contatto a molla di massa.

ERRWBC001: il modem GSM si disconnette a causa delle proprie interferenze elettromagnetiche

Dispositivi interessati: Modem WBC2-4G precedenti alla revisione v3.7A.

Il modem scompare dal sistema; il riavvio aiuta solo brevemente o non aiuta affatto. Con una stazione base distante, un segnale debole e l’antenna corta standard, le trasmissioni del modem possono interferire con il controllore USB, disconnettendo i dispositivi USB, in particolare il modem stesso.

Il log del kernel mostra la disconnessione e la riconnessione delle porte seriali del modem, ad esempio:

option1 ttyUSB0: GSM modem (1-port) converter now disconnected from ttyUSB0
option 3-1:1.2: device disconnected
usb 3-1: new high-speed USB device number 8 using ehci-platform
usb 3-1: GSM modem (1-port) converter now attached to ttyUSB0

Il servizio riavvia automaticamente il modem. Un ponticello corto di filo spesso, lungo meno di 1 cm, tra la massa del modem vicino al connettore dell’antenna e la massa più vicina sulla scheda del controllore risolve il problema, ma richiede una saldatura accurata. La revisione v3.7A e le successive aggiungono un contatto a molla che collega il piano di massa del modem al guscio del connettore USB-A del controllore per sopprimere le interferenze.

Migliorare la ricezione, ad esempio alzando o spostando l’antenna. Se ciò non è efficace o non è possibile, richiedere la sostituzione in garanzia con un modem versione 3.7 o successiva.

ERRWB84006: riavvii periodici del controllore

Dispositivi interessati: tutti i controllori Wiren Board 8.4.3 prodotti prima dell’11 settembre 2024.

Il controllore si riavvia inaspettatamente. La console di debug mostra Kernel panic - not syncing: hung_task: blocked tasks; journald non contiene voci corrispondenti. Un errore software invia un comando con opcode 0 alla memoria eMMC, dopo il quale il driver Linux smette di inviare ulteriori comandi.

Aggiornare con apt update && apt upgrade. Senza accesso a Internet, installare l’immagine FIT stabile più recente tramite Debug Network, Wi-Fi o un’unità USB; non è necessaria una copia aggiuntiva dell’immagine. Corretto nella release wb-2407 con wb-rules 2.20.17 o successivo e wb-mqtt-confed 1.14.11 o successivo.

ERRWB84007: ripristino delle impostazioni di fabbrica non riuscito

Dispositivi interessati: Wiren Board 8.4.3 su cui è stata installata l’immagine FIT del 13 novembre 2024, 202411131702_wb-2410_bullseye_wb8x.fit, che è stata ritirata.

Dopo l’installazione di questa immagine con qualsiasi metodo, un ripristino delle impostazioni di fabbrica tramite l’immagine interna senza supporti esterni ridimensiona la partizione root a 1 GB e impedisce al controllore di avviarsi o aggiornarsi normalmente. L’immagine ripristina erroneamente il vecchio schema di partizionamento A/B, non più supportato dal resto del software.

Rimedio: eseguire un ripristino delle impostazioni di fabbrica da un supporto esterno utilizzando l’immagine FIT stabile più recente. Corretto nei firmware più recenti.

ERRWB84008: APT non trova aggiornamenti

Dispositivi interessati: Wiren Board 8.4.4, lotto 8.4.4B/2G 1.2A-2G, prodotto il 13 agosto 2024.

Il firmware di fabbrica era vincolato a una release specifica anziché al canale stabile, quindi apt update && apt upgrade non trovava nuove release stabili. Installare un’immagine FIT attuale oppure eseguire wb-release -t stable -y. Sono disponibili immagini FIT corrette e le immagini interessate sono state ritirate.

ERRWBEC0001: impossibile spegnere il controllore

Dispositivi interessati: Wiren Board 7.4 e 8.4 con firmware WBEC 2.0.0 o 2.0.1, installato manualmente o fornito con wb-2410 tra il 14 e il 22 novembre 2024. I lotti interessati includono 7.4.4D/2GCA, 7.4.4E/1G, 7.4.4E/2GC, 8.4.4D/2G e 8.4.4E/4G.

Un difetto della modalità sospensione di WBEC impedisce lo spegnimento tramite il pulsante, poweroff o rtcwake. Il controllore può riaccendersi spontaneamente dopo lo spegnimento e la rimozione dell’alimentazione. I controllori in funzione continua non sono interessati durante il funzionamento normale.

Aggiornare il firmware WBEC. Corretto in WBEC 2.0.2; i controllori spediti dopo il 25 novembre 2024 non sono interessati.

ERRWB8M0001: etichette errate degli slot SIM

Lotti interessati: Da WB8M v8.5.2A/M a v8.5.2D/M.

I numeri delle SIM sul pannello frontale erano invertiti. SIM1 è a sinistra; SIM2 è più vicina al bordo dell’involucro. Se necessario, spostare la scheda nell’altro slot. Corretto nei lotti successivi.

ERRWB84009: funzionamento instabile delle porte RS-485

Dispositivi interessati: tutti i controllori Wiren Board 8 contemplati da questa errata.

Il controllore a volte non riceve una risposta Modbus al primo tentativo. Il log di wb-mqtt-serial può contenere:

WARNING: [modbus] failed to read 1 input(s) @ 123 of device </dev/ttyRS485-1 115200 8 N 2> modbus:130: Serial protocol error: request timed out

Anche l’utilizzo di minicom sulle porte RS-485 del controllore può interrompere la ricezione fino al riavvio. La causa è una commutazione errata delle modalità del ricetrasmettitore RS-485 nel kernel Linux.

Soluzione temporanea: evitare minicom sulle porte RS-485 del controllore finché non sarà disponibile la correzione. Riavviare per ripristinare le porte interessate dopo l’utilizzo di minicom. È prevista una correzione software.

ERRWB840010: connessione cloud assente dopo l’installazione dell’immagine

Dispositivi interessati: Controllori Wiren Board 8 aggiornati a wb-2507 tramite immagini FIT tra il 5 e il 9 agosto 2025.

Le prime immagini wb-2507 errate omettevano il provider cloud. Le informazioni sul cloud sono assenti dalla pagina System e l’esecuzione di wb-cloud-agent restituisce No one provider was found.

Aggiungere il provider manualmente:

wb-cloud-agent add-provider https://wirenboard.cloud

Corretto nel software del controllore dall’11 agosto 2025. Eseguire apt update; apt upgrade -y oppure installare un’immagine FIT attuale.

ERRWB8001: file di configurazione vuoti sui nuovi controllori

Dispositivi interessati: Wiren Board 7/8 prodotti dopo ottobre 2025 e Wiren Board 7/8 con software interessato installato tra il 1 ottobre 2025 e il 30 luglio 2026.

L’interruzione dell’alimentazione durante il primo o il secondo avvio di un controllore nuovo o ripristinato alle impostazioni di fabbrica può lasciare i file /mnt/data/etc/wb-*.conf vuoti perché non sono ancora stati scritti sulla memoria flash. L’interfaccia web segnala quindi errori di analisi, ad esempio:

Server error: Failed to parse JSON /etc/wb-mqtt-serial.conf:* Line 1, Column 1 Syntax error: value, object or array expected. (-32000)

Collegarsi tramite SSH ed elencare i file vuoti:

find /mnt/data/etc -maxdepth 1 -type f -name 'wb-*.conf*' -empty

Corretto in wb-2606 del 31 luglio 2026. Aggiornare e riavviare; i file vuoti verranno popolati con i valori predefiniti di fabbrica e i file di configurazione esistenti rimarranno invariati:

apt update
apt upgrade
reboot

Se l’aggiornamento è temporaneamente indisponibile, sostituire i file vuoti in /mnt/data/etc/ con file validi provenienti da un controllore funzionante mediante WinSCP o scp, oppure eseguire un ripristino delle impostazioni di fabbrica. Un ripristino delle impostazioni di fabbrica cancella tutti i dati del controllore. Aggiornare alla prima occasione.

ERRWB85001: protezione contro l’inversione di polarità assente sulle porte 1-Wire

Dispositivi interessati: Wiren Board 8.5.3 nei lotti da v8.5.3B a v8.5.3G, v8.5.3J/2G e v8.5.3J/4G; sensori WB-MS nei lotti v4.4K, v4.4L e v4.4L/2.

Nel circuito di protezione 1-Wire è stato montato un componente con specifiche errate. Le altre protezioni rimangono, ma la tensione negativa non viene bloccata. La tensione negativa può derivare da errori di cablaggio o da interferenze di apparecchiature di commutazione di potenza vicine. Può danneggiare la porta 1-Wire o l’intero dispositivo.

Verificare i collegamenti 1-Wire prima dell’accensione, tenere il dispositivo lontano dalle sorgenti di interferenze e seguire le raccomandazioni di cablaggio del bus 1-Wire. È disponibile la sostituzione in garanzia. Corretto in Wiren Board 8.5.3 dal lotto v8.5.3K e in WB-MS dal lotto v4.4M.

ERRWB8002: errori di comunicazione del chip di sicurezza ATECC

Dispositivi interessati: Wiren Board 8 con linux-wb precedente a 6.8.0-wb161 e release precedenti a wb-2606.

Gli errori riguardano Wiren Board Cloud e altri servizi che dipendono da ATECC. Un messaggio tipico del log è:

RuntimeError: Cert /var/lib/wb-cloud-agent/device_bundle.crt.pem and key ATECCx08:00:02:C0:00 seem to be inconsistent (possibly because of CPU board missmatch)!

Due problemi di concorrenza causano il guasto. Il driver I2C implementato via software utilizza GPIO anziché un controllore I2C hardware; l’accesso simultaneo ad ATECC e ad altri GPIO dello stesso banco può portare le linee I2C in uno stato errato. Inoltre, l’accesso non sincronizzato da parte di più servizi può intercalare le richieste e consegnare le risposte al client sbagliato.

Se ATECC non risponde, riavviare per ripristinarlo. Aggiornare a wb-2606, che corregge il driver del kernel (linux-image-wb8 6.8.0-wb161) e i servizi interessati.

ERRWB8003: possibili guasti della RAM

Dispositivi interessati: Wiren Board 8 (WB8-2G-16G-IND) dei lotti 8.5.3G/2G2, 8.5.3G/4G5, 8.5.3J/2G, 8.5.3J/2G2, 8.5.3J/4GD, 8.5.3K/2G, 8.5.3K/2G1, 8.5.3K/2G1D e 8.5.3K/2GD; Wiren Board 8M (WB8M-2G-16G-IND) lotto v8.5.3G/2GM.

Un numero limitato di controllori può sviluppare guasti casuali sotto carico intensivo della RAM, che aumentano nel tempo: i servizi si arrestano e si riavviano senza una causa apparente, gli aggiornamenti dei pacchetti o le verifiche dei file segnalano errori di checksum oppure il controllore si riavvia dopo un kernel panic. Dopo il riavvio può funzionare normalmente per un certo periodo prima che i guasti si ripresentino.

systemd[1]: example.service: Main process exited, code=killed, status=4/ILL

Lo stato può anche essere 11/SEGV. Test prolungati a pieno carico hanno individuato un chip RAM difettoso i cui errori aumentavano esponenzialmente nell’arco di diverse ore entro un intervallo limitato di indirizzi di memoria. Guasti simili in altre unità di questi lotti sono considerati improbabili ma non possono essere esclusi.

Testare la RAM sospetta con il programma preinstallato memtester. Arrestare prima il carico di lavoro del controllore perché il test utilizza quasi tutta la memoria disponibile.

1. Eseguire free -m e leggere la colonna available .
2. Testare 100 MB in meno rispetto a tale valore. Ad esempio, se sono disponibili 1300 MB, eseguire memtester 1200M 1.

Un test completo può richiedere circa un’ora. Tutte le righe dei risultati devono terminare con ok. Se una qualsiasi riporta FAILURE, il controllore ha diritto alla sostituzione in garanzia.

ERRWBUSB0001: la console Debug USB smette di ricevere

Dispositivi interessati: tutte le revisioni di Wiren Board 7 e Wiren Board 8, incluso Wiren Board 8M.

L’output della console di debug si interrompe, sebbene il controllore continui a funzionare e ad accettare comandi. Il buffer HT42B534 va in overflow se la porta del computer è chiusa o l’applicazione non legge abbastanza velocemente. Nei test il problema si è verificato con 130 byte a porta chiusa; con la porta aperta, la soglia dipende dal buffering sul computer.

Riproduzione del problema

Collegare la console a un computer Linux e configurare minicom. Eseguire i comandi sul controllore come root tramite SSH.

1. Sul computer, aprire la porta sostituendo il percorso del dispositivo secondo necessità: minicom -D /dev/ttyACM0 -b 115200 -8 -o.
2. Uscire senza reimpostare la porta: Ctrl+A, Q, quindi confermare.
3. Sul controllore, eseguire printf '%0300d\n' 0 > /dev/ttyS0.
4. Riaprire minicom con lo stesso comando. Sul controllore, eseguire echo HOLTEK_TEST > /dev/ttyS0. Possono apparire dati precedenti, ma HOLTEK_TEST non compare.

Soluzione temporanea

In minicom, cambiare i bit di stop da 1 a 2 e poi ripristinarli: Ctrl+A, quindi P → X → Enter; poi Ctrl+A, P → W → Enter. Non inviare comandi alla console durante la modifica.

Su Windows 11, nei test la chiusura e la riapertura della porta COM hanno ripristinato la ricezione. In PuTTY, chiudere la finestra e riaprire la connessione seriale. In MobaXterm, chiudere la scheda Serial e riaprire la sessione salvata.

Ripetere il comando HOLTEK_TEST; l’output dovrebbe ora apparire. I messaggi persi non possono essere recuperati. Ridurre le ricorrenze mantenendo aperta la porta in un’applicazione che la legge continuamente. È prevista una correzione hardware per le future versioni di Wiren Board 8.

ERRWB840011: le porte MOD1/MOD2 si bloccano o ritrasmettono vecchi dati RS-485

Dispositivi interessati: Wiren Board 8.5.x con linux-wb 6.8.0-wb159 o precedente.

Quando MOD1 e MOD2 vengono interrogate contemporaneamente e una delle porte viene chiusa o reimpostata, ad esempio durante un riavvio di wb-mqtt-serial o la riconfigurazione di una porta, entrambe le porte possono interrompere l’interrogazione fino al riavvio.

Se uno svuotamento del buffer di trasmissione (tcflush()) o la chiusura della porta si sovrappone alla comunicazione con il controllore integrato, la porta può ritrasmettere fino a 4 KB di dati eliminati. Su RS-485 ciò si manifesta come una nuova trasmissione di vecchi frame Modbus; la chiusura della porta richiede circa 10 secondi.

Due condizioni di competizione in wbec-uart accedono al buffer circolare di trasmissione senza il blocco della porta. Durante la chiusura, il driver può accedere a un buffer già liberato, mandando in crash il thread di interrupt del controllore integrato e mantenendo permanentemente occupato il mutex condiviso MOD1/MOD2, lasciando processi non interrompibili nello stato D. Un trasferimento avviato prima di uno svuotamento può anche aggiornare il buffer già azzerato, ripristinando e ritrasmettendo dati eliminati.

Riavviare se le porte sono già bloccate. Fino all’aggiornamento del kernel, ridurre al minimo i riavvii di wb-mqtt-serial e la riconfigurazione delle porte sui controllori che interrogano sia MOD1 sia MOD2. Eseguire apt update; apt upgrade -y. Corretto in linux-image-wb8 6.8.0-wb160 e versioni successive.