WB-MSW-ZIGBEE v.4

Le WB-MSW-ZIGBEE v.4 est un multicapteur mural d’intérieur pour logements et bureaux. Selon la configuration commandée, il mesure la température, l’humidité relative, le dioxyde de carbone, les composés organiques volatils (COV), l’éclairement, les mouvements et le niveau sonore. Il comprend aussi un émetteur-récepteur infrarouge pour commander les climatiseurs et d’autres équipements. L’appareil peut communiquer sans fil via Zigbee ou fonctionner comme capteur filaire RS-485 Modbus RTU.

Modèles et options de boîtier

Les capteurs CO₂ et COV sont optionnels et doivent être sélectionnés à la commande. Si un capteur optionnel n’est pas installé, la valeur correspondante est signalée comme nulle ou indisponible. Le boîtier standard est blanc ; des boîtiers noirs et bicolores sont aussi disponibles.

Une lentille noire réduit la mesure d’éclairement d’environ cinq à sept fois et la portée infrarouge utile d’environ 2.5 à 3 fois, généralement à 3–4 m. Les voyants sont aussi beaucoup moins lumineux à travers la lentille noire. Un couvercle plat peut être commandé lorsque la détection de mouvement, la commande infrarouge, les voyants et la mesure d’éclairement ne sont pas nécessaires. Le boîtier peut être repeint ; laissez dégagées toutes les ouvertures des capteurs et la lentille.

Caractéristiques techniques

Pour les bornes à vis, utilisez des embouts de câblage isolés simples pour des conducteurs de 0.35–1 mm² ou doubles pour des conducteurs de 0.35–0.5 mm². La longueur de manchon recommandée est de 8 mm et le couple de serrage de 0.2 N·m. Dimensionnez le câble et l’alimentation selon la chute de tension et la consommation de crête.

Fonctionnement des capteurs

Température et humidité

Le capteur SHT40 comprend une compensation automatique de la chaleur générée à l’intérieur du boîtier. Les corrections standard sont de 0.30 °C pour l’électronique principale, 0.31 °C pour le module CO₂ et 0.14 °C pour le module COV. La température et l’humidité brutes non compensées sont disponibles dans les registres Modbus 284 et 285 ; un décalage de température utilisateur est disponible dans le registre 245.

À une humidité relative supérieure à 95 %, le chauffage anticondensation s’active automatiquement pendant une seconde. Il peut être commandé manuellement avec le registre coil 2. Un mode de nettoyage distinct chauffe l’élément sensible à environ 110 °C pendant une heure et suspend temporairement les mesures normales autres que la température et l’humidité brutes. Effectuez le nettoyage uniquement à une température ambiante de 15–40 °C, jamais au-delà de 50 °C, et seulement si nécessaire car la durée de vie du chauffage est limitée. Lancez le nettoyage depuis l’interface du contrôleur ou avec le registre coil 8 ; le registre de maintien 365 indique le temps restant en secondes.

Détection de mouvement

Current Motion est une moyenne mobile courte adaptée à l’interrogation rapide. Max Motion conserve la valeur maximale sur une période configurable, de 10 secondes par défaut dans le registre 282, et convient à une interrogation plus lente. Le seuil de sensibilité peut être relevé pour réduire les déclenchements dus aux animaux. Le micrologiciel 4.37 et les versions ultérieures permettent aussi d’ajuster la constante de temps du filtre RC d’entrée. Les événements Fast Modbus permettent des notifications filaires immédiates.

Voyants et avertisseur sonore

Les voyants utilisateur rouge et vert peuvent clignoter sous commande de l’automatisation ; l’avertisseur sonore est disponible dans toutes les configurations. Les voyants utilisateur nécessitent la carte de lentille utilisée par les options éclairement et IR. Un voyant d’état vert distinct indique les échanges de données et peut être désactivé.

Émetteur-récepteur infrarouge

Le récepteur et les huit émetteurs infrarouges sont derrière la lentille. Apprenez une commande de télécommande une fois, stockez-la dans une cellule numérotée, puis reproduisez-la depuis Zigbee ou Modbus. Une commande peut contenir jusqu’à 1 000 paires d’impulsions haut/bas dont les durées sont exprimées en microsecondes. L’émetteur est volontairement à grand angle et peut commander les équipements visibles du capteur. Pour commander individuellement plusieurs climatiseurs proches, utilisez des émetteurs IR directionnels dédiés.

Éclairement et niveau sonore

Le canal d’éclairement utilise un filtre optique adapté à la sensibilité de l’œil humain et répond en environ 1.5 seconde. Le canal sonore indique un niveau de pression acoustique pondéré A en dBA et fournit un état configurable de détection de bruit.

COV et qualité de l’air intérieur

Les exemplaires fabriqués avant août 2023 peuvent contenir un module COV SGPC3. Il met environ six minutes à être prêt, renvoie 0xFFFF pendant le préchauffage et ajuste sa référence toutes les 12 heures. Les exemplaires ultérieurs utilisent un module COV ENS160 et un micrologiciel 1.5 ou ultérieur. Il indique immédiatement les COV et un indice de qualité de l’air, mais son auto-étalonnage initial prend environ 24 heures. Laissez le capteur alimenté sans interruption pendant l’étalonnage.

Dioxyde de carbone

Le module CO₂ optionnel utilise le principe infrarouge non dispersif (NDIR).

L’étalonnage automatique de la référence considère la mesure minimale observée sur sept jours comme environ 400 ppm. Pour un étalonnage fiable, la pièce doit être inoccupée ou bien ventilée pendant une partie de chaque semaine. Si cela ne peut pas être garanti, étalonnez manuellement le module à l’air frais avec l’interface filaire.

Sélection du mode Zigbee ou RS-485

Le réglage d’usine est le mode Zigbee sans fil. Coupez l’alimentation et ouvrez le boîtier avant de changer le mode.

• Les cartes antérieures à la révision 4.56 utilisent le commutateur S1 : ON correspond au mode sans fil et la position 1 au mode RS-485.
• Les cartes de révision 4.56 et ultérieures utilisent un cavalier : position 2 correspond au mode sans fil et la position 1 au mode RS-485.

En mode sans fil, le capteur est un appareil terminal et routeur Zigbee. En mode RS-485, la radio peut encore rejoindre un coordinateur comme routeur, mais les mesures ne sont pas disponibles via Zigbee. La radio communique en interne avec le contrôleur du capteur à 9 600 bit/s. Si les paramètres série du contrôleur ont été modifiés, rétablissez le débit série d’usine avant de changer de mode.

Installation et raccordement électrique

Raccordez 9–28 V DC à V+ et GND. Le voyant d’état vert clignote pendant la communication normale, sauf s’il a été désactivé. Les câbles longs nécessitent une section suffisante pour maintenir la tension au capteur dans les spécifications pendant les mesures CO₂ et les émissions IR.

Montez le capteur sur un mur intérieur, généralement à 1–1.6 m du sol, à l’écart du soleil, des radiateurs, des portes, des courants d’air et des sources de chaleur locales. Les murs extérieurs peuvent fausser les mesures de température. Une boîte d’encastrement européenne ronde de 68 mm peut être utilisée ; elle sert uniquement au câble et ne fournit pas d’espace libre derrière l’électronique. Pour un montage en saillie, utilisez des vis à tête d’environ 7 mm de diamètre et l’entraxe de trous de 60 mm.

Pour ouvrir le boîtier, tenez-le à deux mains, pressez doucement les deux moitiés et soulevez le couvercle avant.

Appairage et retrait de l’appareil Zigbee

1. Activez l’appairage sur le coordinateur Zigbee.
2. Ouvrez le boîtier et appuyez brièvement sur le bouton Pairing. Le voyant d’état vert commence à clignoter.
3. Attendez que l’appareil apparaisse dans le contrôleur, puis désactivez l’appairage sur le coordinateur.

Pour retirer l’appareil d’un réseau, désactivez d’abord l’appairage sur le coordinateur, puis appuyez brièvement sur le bouton Pairing. Le voyant d’état vert cesse de clignoter après l’effacement des informations locales du réseau.

Intégration au contrôleur

Le capteur est pris en charge par les contrôleurs Wiren Board avec zigbee2mqtt 1.32.2 ou ultérieur. Une intégration actuelle expose les canaux suivants :

• temperature, temperature_offset, th_heater et humidity ;
• co2, voc, illuminance et les données de qualité de l’air lorsque les capteurs correspondants sont installés ;
• occupancy, occupancy_level, occupancy_sensitivity et occupancy_timeout ;
• noise, noise_detected, noise_detect_level et noise_timeout ;
• state_l1 (voyant rouge), state_l2 (voyant vert), state_l3 (avertisseur sonore) et activity_led_indicator ;
• installed_version, latest_version et l’état de mise à jour ;
• linkquality, last_seen, uart_connection et uart_baud_rate.

Commande MQTT

Publiez les commandes sur zigbee2mqtt/FRIENDLY_NAME/set. Remplacez FRIENDLY_NAME par le nom de l’appareil.

{"state_l1":"ON"}
{"state_l2":"ON"}
{"state_l3":"ON"}
{"activity_led_indicator":true}

Utilisez OFF pour désactiver une sortie. Les commandes peuvent être envoyées depuis MQTT Explorer ou une automatisation wb-rules de Wiren Board.

Configuration et rapports Zigbee

Les paramètres peuvent être modifiés dans l’interface zigbee2mqtt ou par MQTT. Une règle de rapport comporte un intervalle minimal, un intervalle maximal et une variation déclenchant un rapport. Les variations de température et d’humidité sont codées en centièmes ; une valeur de 100 signifie donc 1 °C ou 1% RH. Les autres canaux utilisent leur unité affichée.

Pour une configuration directe par MQTT, publiez sur zigbee2mqtt/bridge/request/device/configure_reporting:

{
  "id": "FRIENDLY_NAME",
  "endpoint": 1,
  "cluster": "msTemperatureMeasurement",
  "attribute": "measuredValue",
  "minimum_report_interval": 10,
  "maximum_report_interval": 3600,
  "reportable_change": 100
}

Pour les attributs de niveau d’occupation et de bruit propres au fabricant, utilisez le code fabricant 26214. Les paramètres configurables comprennent :

Stockage des commandes infrarouges

Les 80 cellules de mémoire persistante sont numérotées 0–79. Utilisez les commandes suivantes sur le topic set de l’appareil :

{"learn_start":0}
{"learn_stop":0}
{"play_store":0}
{"clear_store":0}

Remplacez 0 par le numéro de cellule souhaité. Pour l’apprentissage et la reproduction temporaires en RAM, utilisez :

{"learn_ram_start":"ON"}
{"learn_ram_stop":"ON"}
{"play_ram":"ON"}

Action de sécurité

Une action de sécurité peut reproduire une commande IR enregistrée en cas de perte de communication avec le contrôleur. La temporisation redémarre après chaque paquet Modbus traité correctement ; le délai par défaut est de 10 secondes. Le fonctionnement normal reprend automatiquement au rétablissement de la communication. Par défaut, aucune commande IR n’est affectée. Configurez le délai, l’action de reproduction et le numéro de commande enregistrée avant d’activer cette fonction.

Mises à jour du micrologiciel

Le produit contient un contrôleur principal de capteur/Modbus et un contrôleur radio Zigbee. Une mise à jour Zigbee par radio (OTA) peut mettre à jour les deux contrôleurs. Une mise à jour via RS-485 ne met à jour que le contrôleur principal.

Pour des mises à jour OTA fiables, ajoutez les paramètres suivants à la configuration zigbee2mqtt et redémarrez zigbee2mqtt :

ota:
  image_block_response_delay: 50
  default_maximum_data_size: 60

systemctl restart zigbee2mqtt

Ouvrez la page de l’appareil, sélectionnez la commande de mise à jour du micrologiciel et lancez la mise à jour. Elle peut prendre environ 30 minutes. Ne coupez pas l’alimentation. Si la mise à jour échoue ou si l’alimentation est interrompue, retirez l’appareil de Zigbee et appairez-le à nouveau avant de réessayer.

zigbee2mqtt 2.8 et ultérieur peuvent afficher la version et la signature du contrôleur principal dans leur console développeur, sous le cluster sprutDeviceBase : deviceVersion, deviceSignature, deviceBootVersion, componentVersion et le componentSignature.

Migration unique vers le micrologiciel officiel

La branche officielle du micrologiciel sans fil introduite en août 2026 nécessite zigbee2mqtt 2.13.0 ou ultérieur et des appareils de numéro de série 196189 ou supérieur, fabriqués à partir d’avril 2024. Téléchargez le micrologiciel de transition fourni pour ce matériel, puis choisissez sur la page de l’appareil Firmware version → Source → Custom firmware, sélectionnez le fichier et lancez la mise à jour. Prévoyez jusqu’à 30 minutes sans débrancher l’alimentation. Cette migration ne s’effectue qu’une fois. Après migration, le modèle Zigbee est indiqué comme WB-MSW-ZIGBEE v.4; l’ancienne branche partenaire indique WB-MSW4.

Dimensions et disposition interne