> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/cube-os-fr/prise-en-main/ajouter-des-appareils/appareils-zigbee.md).

# Appareils Zigbee

## **1. Installer les adaptateurs Zigbee**

Si vous avez suivi les étapes facultatives pour Zigbee lors de l’installation de CUBE, vous pouvez passer à [Étape 2](#id-2.-initialize-zigbee) pour initialiser votre dongle en tant que coordinateur de votre réseau Zigbee.

Avant d’ajouter un appareil Zigbee, vous avez besoin d’un adaptateur Zigbee, généralement un dongle USB. Insérez l’adaptateur Zigbee dans le port USB de l’appareil exécutant CUBE OS.

**Pour les utilisateurs de machines virtuelles**: Après avoir inséré l’adaptateur Zigbee, ajoutez-le aux paramètres de la machine virtuelle et redémarrez CUBE. Des étapes détaillées se trouvent dans le [guide d’installation](/cube-os-fr/prise-en-main/quickstart/machine-virtuelle.md).

### **1.1 Adaptateurs compatibles**

CUBE est compatible avec divers adaptateurs Zigbee de différents fabricants. Il prend actuellement en charge des piles de protocoles telles que EZSP, Deconz, Zstack et Zigate. Bien que tout adaptateur prenant en charge ces piles de protocoles puisse être utilisé, les suivants sont recommandés :

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Autres répertoriés](https://darkxst.github.io/silabs-firmware-builder/) par le développeur @darkxst 

## **2. Initialiser Zigbee**

{% stepper %}
{% step %}
Après avoir branché votre adaptateur Zigbee. CUBE affiche une fenêtre contextuelle, telle que `Dongle connecté` lorsque l’adaptateur est détecté.

<div align="left"><figure><img src="/files/fced6669ec2133d2ae7fbde8dbdaf10b3ce91983" alt="" width="277"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Avec un **dongle Zigbee SONOFF**, cliquez sur `Démarrer la configuration`.

Si le dongle exécute déjà une version de firmware Zigbee prise en charge, CUBE termine automatiquement la configuration. Si la version du firmware n’est pas prise en charge, CUBE propose un flashage en un clic vers la version stable recommandée.

<div align="left"><figure><img src="/files/9ee73815402b9e99ec32b40488ec78ccaca0b0d1" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Avec un **adaptateur Zigbee non SONOFF**, cliquez sur `Démarrer la configuration`.

Si l’adaptateur exécute déjà une version de firmware Zigbee prise en charge, CUBE termine automatiquement la configuration. Si la version du firmware n’est pas prise en charge, utilisez l’outil de flashage du fabricant pour installer la version stable recommandée avant de continuer. **Sinon**, CUBE ne peut pas contrôler les appareils Zigbee avec cet adaptateur.
{% endstep %}

{% step %}
Une fois que l’adaptateur a terminé sa mise à niveau du firmware et sa configuration, vous pouvez maintenant ajouter des appareils Zigbee.

<div align="left"><figure><img src="/files/bb3d2aeeb064d902c1788bf9541cdcebf8dc4c54" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Si CUBE ne détecte pas votre adaptateur Zigbee, ajoutez-le manuellement en saisissant les informations requises :

<img src="/files/2739cd807082ca613729ab3f8a8b457f51cf2d16" alt="" data-size="original">

* **Chemin série**: Vérifiez la section « Tout le matériel » sur la page des paramètres pour connaître le chemin du port série de l’adaptateur Zigbee inséré.

<img src="/files/afe53f5834075a586baa829fffb33452950ed825" alt="" data-size="original">

* **Type de pile de protocoles**: CUBE prend actuellement en charge EZSP, Deconz, ZStack et Zigate. Consultez la documentation de l’adaptateur ou la page d’achat pour connaître le type correct.
* **Vitesse du port**: Facultatif. Non requis pour tous les adaptateurs Zigbee.
* **Flux de données**: Facultatif. Non requis pour tous les adaptateurs Zigbee.

Cliquez sur `Confirmer` pour enregistrer la configuration. Si la configuration réussit, vous pouvez commencer à ajouter des appareils Zigbee. En cas d’échec, vérifiez le message d’erreur et mettez à jour la configuration.

<img src="/files/a476994819ae9da592a1310544ec359ff217d9fe" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Comme un réseau Zigbee ne peut avoir qu’une seule configuration d’adaptateur, les configurations multiples ne sont pas prises en charge. Si un adaptateur configuré est retiré puis réinséré, CUBE détectera automatiquement l’appareil et vous guidera pour le restaurer sans nécessiter de reconfiguration.
{% endhint %}

## **3. Ajouter des appareils Zigbee**

{% stepper %}
{% step %}
Après la configuration, sur la page d’ajout d’appareil, cliquez sur « Démarrer l’appairage » pour ajouter automatiquement les appareils Zigbee en mode appairage.

{% hint style="info" %}
Si votre appareil Zigbee n’est pas trouvé, assurez-vous qu’il est en mode de configuration du réseau et vérifiez l’absence d’interférences radio excessives autour de lui.
{% endhint %}

<img src="/files/e0545a78eff403b4f7ae9a335a322ba27942db93" alt="" data-size="original">
{% endstep %}

{% step %}
Les appareils Zigbee détectés seront ensuite ajoutés à votre CUBE OS, prêts à être affectés à une pièce ou à être renommés.

<img src="/files/1ac16aa19d2b1589a59570f333a8de6aa0c1c120" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Le nombre total d’appareils Zigbee pouvant être ajoutés est limité, selon le matériel et le firmware de l’adaptateur.

Dans certains cas, vous devez ajouter des appareils routeurs supplémentaires (par exemple des prises connectées, des lumières, des répéteurs de signal) pour ajouter davantage d’appareils alimentés par batterie comme des capteurs.
{% endhint %}

## 4. Compatibilité potentielle

CUBE est **compatible avec des centaines d’appareils Zigbee**. Cependant, il existe des différences importantes entre les produits de différents fabricants en raison de la complexité et de la grande variété d’appareils. Cela signifie que la compatibilité avec tous les appareils ne peut pas être garantie, mais des améliorations seront apportées de manière itérative.

Veuillez vous diriger vers <https://cube-web.ewelink.cc/> pour vérifier la compatibilité.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/cube-os-fr/prise-en-main/ajouter-des-appareils/appareils-zigbee.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.