Problèmes connus du Wiren Board 8

Errata matériels et logiciels du Wiren Board 8. Vérifiez pour chaque problème le modèle, le lot et la version logicielle concernés avant d’appliquer la correction.

ERRWB84001 : incompatibilité avec certains commutateurs et routeurs Ethernet

Appareils concernés : Wiren Board 8.4.3, lots v8.4.3A/4G, v8.4.3A/4G1 et v8.4.3A/4G2.

La liaison Ethernet s’établit, mais aucune donnée ne passe avec certains commutateurs ou routeurs. Réduire le débit à 10 Mbit/s rétablit le fonctionnement. Le PHY Ethernet CH182H est incompatible avec certains équipements réseau, dont MikroTik hAPac2 et eero Dual-band 350 Mbps Wireless Router.

Un contrôleur équipé de ce PHY indique :

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

Solution de contournement : utilisez un équipement réseau compatible ou réduisez temporairement le débit à 10 Mbit/s en attendant de remplacer l’équipement réseau ou le contrôleur. Corrigé dans les révisions ultérieures du contrôleur. Les contrôleurs de révision 8.4.3 présentant cette incompatibilité peuvent être remplacés sous garantie.

ERRWB84002 : court-circuit possible lors de l’installation du module processeur

Lots concernés : 8.4.3A/4G et v8.4.4A/4G.

Les tolérances de fabrication du module processeur peuvent permettre un désalignement de ses plages de contact avec les contacts du connecteur SO-DIMM. Un déplacement excessif vers le connecteur de modules latéraux peut provoquer un court-circuit sur certains appareils. Positionner le module vers l’emplacement de carte SD ne provoque pas ce problème.

Solution de contournement : une cale est montée sur le verrou du connecteur le plus proche du connecteur de modules latéraux pour maintenir le module processeur vers l’emplacement de carte SD. Le connecteur SO-DIMM porte aussi une étiquette Do not remove . Si la cale est perdue, positionnez le module complètement vers l’emplacement de carte SD lors de l’installation. Corrigé dans les révisions ultérieures du contrôleur.

ERRWB84003 : instabilité du moteur de règles

Appareils concernés : Wiren Board 8.4.3, lot 8.4.3A/4G, fabriqué avant le 23 mai 2024.

Le moteur de règles installé prend incomplètement en charge WB8 et peut fonctionner de façon peu fiable. Mettez à jour le logiciel :

apt update
apt upgrade

Sans accès Internet, téléchargez la dernière image FIT stable, mettez le contrôleur à jour et copiez aussi l’image dans /mnt/data/.wb-restore/factoryreset.fit. Corrigé dans les micrologiciels plus récents.

ERRWB84004 : instabilité des pilotes MQTT

Appareils concernés : Wiren Board 8.4.3, lots 8.4.3A/4G et 8.4.3A/4G1, fabriqués avant le 11 juin 2024.

La prise en charge incomplète de WB8 dans le micrologiciel installé peut rendre les pilotes MQTT instables. Mettez à jour le logiciel :

apt update
apt upgrade

Sans accès Internet, téléchargez la dernière image FIT stable, mettez le contrôleur à jour et copiez aussi l’image dans /mnt/data/.wb-restore/factoryreset.fit. Corrigé dans les micrologiciels plus récents.

ERRWB84005 : Ethernet s’arrête après une mise à jour du noyau et un redémarrage

Appareils concernés : Wiren Board 8.4.3 de tout lot, mis à jour entre le 16 et le 19 août 2024, avec linux-image-wb8 version 6.8.0-wb100.

Une erreur du fichier DTS configure Ethernet incorrectement. Après une mise à jour du noyau par APT ou de l’image FIT et un redémarrage, les ports Ethernet cessent de fonctionner.

Mettez à jour avec apt update && apt upgrade. Sans accès Internet, installez la dernière image FIT stable via Debug Network, Wi-Fi ou une clé USB ; aucune copie supplémentaire de l’image n’est nécessaire. Corrigé dans linux-image-wb8 version 6.8.0-wb101 et ultérieurs.

ERRSUPERCAP0001 : limite d’alimentation de 36 V avec les modules à supercondensateurs concernés

Modules concernés : WBMZ4-SUPERCAP, WBMZ3-SUPERCAP et WBMZ2-SUPERCAP.

Un contrôleur équipé d’un module concerné ne doit pas être alimenté au-delà de 36 V. Le convertisseur de sortie du module utilise une diode prévue pour 40 V au maximum. Une tension d’alimentation supérieure du contrôleur peut provoquer le claquage de cette diode, endommageant le module de secours et éventuellement le contrôleur.

Solution de contournement : limitez l’alimentation du contrôleur à 36 V. Si une alimentation de secours est nécessaire avec une tension supérieure, demandez le remplacement du module sous garantie. Corrigé dans WBMZ6-SUPERCAP v6.1 et ultérieurs, et WBMZ4-SUPERCAP v4.3 et ultérieurs.

ERRWB74004 : déconnexion du modem GSM due à des perturbations électromagnétiques externes

Appareils concernés : Wiren Board 7.4 et 8.4 avec cartes modem WBC2-4G antérieures à la version 3.7.

Des contacteurs électromagnétiques proches du contrôleur peuvent induire des perturbations déconnectant le modem. Le bus USB utilisé pour communiquer avec le modem y est sensible. Les messages typiques du noyau comprennent :

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

ModemManager signale des dépassements de délai des commandes série et des délais répétés sur les ports, puis libère les ports USB du modem. Le service redémarre automatiquement le modem.

Solutions de contournement :

• Éloignez autant que possible les sources de perturbations par arcs électriques du contrôleur.
• Installez un réseau d’amortissement adapté aux bornes des contacts du relais commandant la bobine du contacteur. Les valeurs d’exemple sont une résistance de 100 Ω, 1 W en série avec un condensateur de 0.1 µF, 1000 V. La suppression des arcs des contacts réduit fortement les perturbations.
• Un cavalier court en fil épais de moins de 1 cm entre la masse de la carte modem près du connecteur d’antenne et la masse la plus proche de la carte du contrôleur résout aussi le problème, mais nécessite une modification et une soudure soignées.

Correction : la version 3.7 de la carte modem ajoute un contact à ressort supplémentaire de mise à la masse.

ERRWBC001 : déconnexion du modem GSM due à ses propres perturbations électromagnétiques

Appareils concernés : Modems WBC2-4G antérieurs à la révision v3.7A.

Le modem disparaît du système ; un redémarrage n’aide que brièvement ou pas du tout. Avec une station de base éloignée, un signal faible et l’antenne courte standard, les émissions du modem peuvent perturber le contrôleur USB et déconnecter les appareils USB, en particulier le modem lui-même.

Le journal du noyau montre les déconnexions et reconnexions des ports série du modem, par exemple :

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

Le service redémarre automatiquement le modem. Un cavalier court en fil épais de moins de 1 cm entre la masse du modem près du connecteur d’antenne et la masse la plus proche de la carte du contrôleur résout le problème, mais nécessite une soudure soignée. La révision v3.7A et les suivantes ajoutent un contact à ressort reliant le plan de masse du modem à la coque du connecteur USB-A du contrôleur pour supprimer les perturbations.

Améliorez la réception, par exemple en élevant ou déplaçant l’antenne. Si cela est inefficace ou impossible, demandez un remplacement sous garantie par un modem de version 3.7 ou ultérieure.

ERRWB84006 : redémarrages périodiques du contrôleur

Appareils concernés : tous les contrôleurs Wiren Board 8.4.3 fabriqués avant le 11 septembre 2024.

Le contrôleur redémarre inopinément. La console de débogage affiche Kernel panic - not syncing: hung_task: blocked tasks; journald ne contient aucune entrée correspondante. Une erreur logicielle envoie une commande d’opcode 0 au stockage eMMC, après quoi le pilote Linux cesse d’envoyer d’autres commandes.

Mettez à jour avec apt update && apt upgrade. Sans accès Internet, installez la dernière image FIT stable via Debug Network, Wi-Fi ou une clé USB ; aucune copie supplémentaire n’est nécessaire. Corrigé dans la version wb-2407 avec wb-rules 2.20.17 ou ultérieur et wb-mqtt-confed 1.14.11 ou ultérieur.

ERRWB84007 : échec du rétablissement des paramètres d’usine

Appareils concernés : Wiren Board 8.4.3 programmé avec l’image FIT du 13 novembre 2024, 202411131702_wb-2410_bullseye_wb8x.fit, qui a été retirée.

Après installation de cette image par n’importe quelle méthode, une réinitialisation d’usine utilisant l’image interne sans support externe redimensionne la partition racine à 1 GB et empêche le contrôleur de démarrer ou se mettre à jour normalement. L’image rétablit incorrectement l’ancien partitionnement A/B, qui n’est plus pris en charge par le reste du logiciel.

Mesure corrective : effectuez une réinitialisation d’usine depuis un support externe avec la dernière image FIT stable. Corrigé dans les micrologiciels plus récents.

ERRWB84008 : APT ne trouve aucune mise à jour

Appareils concernés : Wiren Board 8.4.4, lot 8.4.4B/2G 1.2A-2G, fabriqué le 13 août 2024.

Le micrologiciel d’usine était fixé sur une version précise plutôt que sur le canal stable ; ainsi, apt update && apt upgrade ne trouvait pas de nouvelles versions stables. Installez une image FIT actuelle ou exécutez wb-release -t stable -y. Des images FIT corrigées sont disponibles et les images concernées ont été retirées.

ERRWBEC0001 : impossible d’éteindre le contrôleur

Appareils concernés : Wiren Board 7.4 et 8.4 avec le micrologiciel WBEC 2.0.0 ou 2.0.1, installé manuellement ou fourni avec wb-2410 entre le 14 et le 22 novembre 2024. Les lots concernés comprennent 7.4.4D/2GCA, 7.4.4E/1G, 7.4.4E/2GC, 8.4.4D/2G et 8.4.4E/4G.

Un défaut du mode veille WBEC empêche l’arrêt avec le bouton, poweroff ou l’ rtcwake. Le contrôleur peut se rallumer spontanément après l’arrêt et le retrait de l’alimentation. Les contrôleurs fonctionnant en continu ne sont pas affectés en utilisation normale.

Mettez à jour le micrologiciel WBEC. Corrigé dans WBEC 2.0.2 ; les contrôleurs expédiés après le 25 novembre 2024 ne sont pas concernés.

ERRWB8M0001 : libellés incorrects des emplacements SIM

Lots concernés : WB8M v8.5.2A/M à v8.5.2D/M.

Les numéros SIM de la face avant étaient inversés. SIM1 est à gauche ; SIM2 est plus proche du bord du boîtier. Déplacez la carte dans l’autre emplacement si nécessaire. Corrigé dans les lots ultérieurs.

ERRWB84009 : fonctionnement instable des ports RS-485

Appareils concernés : tous les contrôleurs Wiren Board 8 visés par cet erratum.

Le contrôleur échoue parfois à recevoir une réponse Modbus au premier essai. Le journal wb-mqtt-serial peut contenir :

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

L’utilisation de minicom sur les ports RS-485 du contrôleur peut aussi arrêter la réception jusqu’au redémarrage. La cause est une commutation incorrecte des modes des émetteurs-récepteurs RS-485 dans le noyau Linux.

Solution de contournement : évitez minicom sur les ports RS-485 du contrôleur jusqu’à la disponibilité du correctif. Redémarrez pour rétablir les ports affectés après utilisation de minicom. Un correctif logiciel est prévu.

ERRWB840010 : connexion cloud absente après programmation

Appareils concernés : Contrôleurs Wiren Board 8 mis à jour vers wb-2507 avec des images FIT entre le 5 et le 9 août 2025.

Les premières images wb-2507 incorrectes omettaient le fournisseur cloud. Les informations cloud sont absentes de la page System et l’exécution de wb-cloud-agent renvoie No one provider was found.

Ajoutez manuellement le fournisseur :

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

Corrigé dans le logiciel du contrôleur à partir du 11 août 2025. Exécutez apt update; apt upgrade -y ou installez une image FIT actuelle.

ERRWB8001 : fichiers de configuration vides sur les nouveaux contrôleurs

Appareils concernés : Wiren Board 7/8 fabriqués après octobre 2025, et Wiren Board 7/8 avec le logiciel concerné installé entre le 1 octobre 2025 et le 30 juillet 2026.

Une coupure d’alimentation pendant le premier ou le deuxième démarrage d’un contrôleur neuf ou réinitialisé aux paramètres d’usine peut laisser les fichiers /mnt/data/etc/wb-*.conf vides, car ils n’ont pas été vidés vers le stockage flash. L’interface web signale alors des erreurs d’analyse, telles que :

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

Connectez-vous par SSH et listez les fichiers vides :

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

Corrigé dans wb-2606 du 31 juillet 2026. Mettez à jour puis redémarrez ; les fichiers vides seront remplis avec les paramètres d’usine et les fichiers de configuration existants resteront inchangés :

apt update
apt upgrade
reboot

Si la mise à jour est temporairement indisponible, remplacez les fichiers vides dans /mnt/data/etc/ par des fichiers valides provenant d’un contrôleur fonctionnel via WinSCP ou scp, ou effectuez une réinitialisation d’usine. Une réinitialisation d’usine efface toutes les données du contrôleur. Mettez à jour dès que possible.

ERRWB85001 : absence de protection contre l’inversion de polarité sur les ports 1-Wire

Appareils concernés : Wiren Board 8.5.3 des lots v8.5.3B à v8.5.3G, v8.5.3J/2G et v8.5.3J/4G ; capteurs WB-MS des lots v4.4K, v4.4L et v4.4L/2.

Un composant mal spécifié a été monté dans le circuit de protection 1-Wire. Les autres protections restent présentes, mais la tension négative n’est pas bloquée. Elle peut provenir d’erreurs de câblage ou de perturbations d’équipements voisins commutant de la puissance. Elle peut endommager le port 1-Wire ou l’ensemble de l’appareil.

Vérifiez les raccordements 1-Wire avant la mise sous tension, éloignez l’appareil des sources de perturbations et suivez les recommandations de câblage du bus 1-Wire. Un remplacement sous garantie est disponible. Corrigé dans Wiren Board 8.5.3 à partir du lot v8.5.3K et dans WB-MS à partir du lot v4.4M.

ERRWB8002 : échecs de communication avec la puce de sécurité ATECC

Appareils concernés : Wiren Board 8 avec linux-wb antérieur à 6.8.0-wb161 et les versions antérieures à wb-2606.

Les défaillances affectent Wiren Board Cloud et d’autres services dépendant d’ATECC. Un message typique du journal est :

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)!

Deux problèmes de concurrence provoquent le défaut. Le pilote I2C logiciel utilise des GPIO plutôt qu’un contrôleur I2C matériel ; un accès simultané à ATECC et à d’autres GPIO du même groupe peut placer les lignes I2C dans un état incorrect. De plus, des accès non synchronisés depuis plusieurs services peuvent entrelacer les requêtes et remettre les réponses au mauvais client.

Si ATECC ne répond pas, redémarrez pour le rétablir. Mettez à jour vers wb-2606, qui corrige le pilote du noyau (linux-image-wb8 6.8.0-wb161) et les services concernés.

ERRWB8003 : défauts possibles de RAM

Appareils concernés : Wiren Board 8 (WB8-2G-16G-IND) des lots 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 et 8.5.3K/2GD ; Wiren Board 8M (WB8M-2G-16G-IND) du lot v8.5.3G/2GM.

Un petit nombre de contrôleurs peut présenter des défauts aléatoires sous forte charge RAM, qui augmentent avec le temps : les services plantent et redémarrent sans cause apparente, les mises à jour de paquets ou vérifications de fichiers signalent des erreurs de somme de contrôle, ou le contrôleur redémarre après une panique du noyau. Après redémarrage, il peut fonctionner normalement un moment avant le retour des défauts.

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

L’état peut également être 11/SEGV. Des essais prolongés à pleine charge ont identifié une puce RAM défectueuse dont les erreurs augmentaient exponentiellement sur plusieurs heures dans une plage d’adresses mémoire limitée. Des défauts similaires dans d’autres appareils de ces lots sont considérés comme peu probables, sans pouvoir être exclus.

Testez une RAM suspecte avec l’outil préinstallé memtester. Arrêtez d’abord les tâches du contrôleur, car le test utilise presque toute la mémoire disponible.

1. Exécutez free -m et lisez la colonne available .
2. Testez 100 MB de moins que cette valeur. Par exemple, si 1300 MB sont disponibles, exécutez memtester 1200M 1.

Un test complet peut prendre environ une heure. Toutes les lignes de résultat doivent se terminer par ok. Si certaines indiquent FAILURE, le contrôleur peut être remplacé sous garantie.

ERRWBUSB0001 : la console USB de débogage cesse de recevoir

Appareils concernés : toutes les révisions Wiren Board 7 et Wiren Board 8, y compris Wiren Board 8M.

La sortie de la console de débogage s’arrête, bien que le contrôleur continue de fonctionner et d’accepter des commandes. Le tampon HT42B534 déborde si le port de l’ordinateur est fermé ou si son application ne lit pas assez vite. Les essais ont déclenché le problème avec 130 octets lorsque le port était fermé ; lorsqu’il est ouvert, le seuil dépend des tampons côté ordinateur.

Reproduction du problème

Raccordez la console à un ordinateur Linux et configurez minicom. Exécutez les commandes côté contrôleur en tant que root via SSH.

1. Sur l’ordinateur, ouvrez le port en adaptant le chemin de l’appareil si nécessaire : minicom -D /dev/ttyACM0 -b 115200 -8 -o.
2. Quittez sans réinitialiser le port : Ctrl+A, Q, puis confirmez.
3. Sur le contrôleur, exécutez printf '%0300d\n' 0 > /dev/ttyS0.
4. Rouvrez minicom avec la même commande. Sur le contrôleur, exécutez echo HOLTEK_TEST > /dev/ttyS0. D’anciennes données peuvent apparaître, mais pas HOLTEK_TEST.

Solution de contournement

Dans minicom, passez les bits d’arrêt de 1 à 2 puis revenez : Ctrl+A, puis P → X → Enter ; puis Ctrl+A, P → W → Enter. N’envoyez pas de commandes de console pendant ce changement.

Sous Windows 11, fermer et rouvrir le port COM a rétabli la réception pendant les essais. Dans PuTTY, fermez la fenêtre puis rouvrez la connexion série. Dans MobaXterm, fermez l’onglet Serial puis rouvrez la session enregistrée.

Répétez la commande HOLTEK_TEST ; sa sortie devrait maintenant apparaître. Les messages perdus ne peuvent pas être récupérés. Réduisez la fréquence du problème en gardant le port ouvert dans une application qui le lit en continu. Une correction matérielle est prévue pour les futures versions Wiren Board 8.

ERRWB840011 : les ports MOD1/MOD2 se bloquent ou réémettent d’anciennes données RS-485

Appareils concernés : Wiren Board 8.5.x avec linux-wb 6.8.0-wb159 ou antérieur.

Lorsque MOD1 et MOD2 sont interrogés simultanément et que l’un des ports est fermé ou réinitialisé, par exemple lors d’un redémarrage de wb-mqtt-serial ou d’une reconfiguration de port, les deux ports peuvent cesser l’interrogation jusqu’au redémarrage.

Si un vidage du tampon d’émission (tcflush()) ou une fermeture de port chevauche une communication avec le contrôleur embarqué, le port peut réémettre jusqu’à 4 KB de données supprimées. Sur RS-485, cela apparaît comme une réémission d’anciennes trames Modbus ; la fermeture du port prend environ 10 secondes.

Deux conditions de concurrence dans wbec-uart accèdent au tampon circulaire d’émission sans verrouiller le port. Pendant la fermeture, le pilote peut accéder à un tampon déjà libéré, provoquant le plantage du fil d’interruption du contrôleur embarqué et maintenant indéfiniment le mutex partagé MOD1/MOD2, ce qui laisse des processus ininterruptibles à l’état D. Un transfert commencé avant le vidage peut aussi mettre à jour le tampon déjà réinitialisé, rétablissant des données supprimées et les réémettant.

Redémarrez si les ports sont déjà bloqués. Jusqu’à la mise à jour du noyau, réduisez les redémarrages de wb-mqtt-serial et les reconfigurations de ports sur les contrôleurs interrogeant MOD1 et MOD2. Exécutez apt update; apt upgrade -y. Corrigé dans linux-image-wb8 6.8.0-wb160 et ultérieurs.