diff --git a/blog/2020-11-06-launching-gladys-assistant-4.md b/blog/2020-11-06-launching-gladys-assistant-4.md index c9ac0449..3b3b2bd4 100644 --- a/blog/2020-11-06-launching-gladys-assistant-4.md +++ b/blog/2020-11-06-launching-gladys-assistant-4.md @@ -79,7 +79,7 @@ Today, hundreds of home automation devices are already available in Gladys Assis To date, Gladys Assistant supports peripherals: -- Z-Wave ([doc](/docs/integrations/zwave/)) +- Z-Wave - Xiaomi ([doc](/docs/integrations/xiaomi/)) - Philips Hue ([doc](/docs/integrations/philips-hue/)) - Sonoff (Tasmota) ([doc](/docs/integrations/tasmota/)) diff --git a/docs/integrations/zwave.md b/docs/integrations/zwave.md deleted file mode 100644 index 6e1676b7..00000000 --- a/docs/integrations/zwave.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -id: zwave -title: Z-Wave -sidebar_label: Z-Wave ---- - -:::warning -December 2022: This Open-Zwave integration is now deprecated, and we are migrating to Zwave-js-ui, a new library written in pure JS, more robust, and with a wide range of compatible devices. - -In the meantime, we highly recommend that you use Gladys + Node-RED + ZWaveJS2mqtt instead of this integration. - -If you want to help us migrate to ZWaveJS, we are looking for maintainers, join us on the forum if you want to help. -::: - -## Connect your USB dongle to your Raspberry Pi - -First, plug your Z-Wave dongle to your Raspberry Pi. - -## Select in Gladys the USB port of your dongle - -Then, go the `Integrations -> Z-Wave` tab in Gladys, and go to the `Settings` page. - -Here, you can select the USB port of your Z-Wave dongle. - -Gladys will now take a few minutes to scan your network. - -## Add your Z-Wave in Gladys - -Back to the `Configuration` tab, you can now add each devices to Gladys! diff --git a/docs/integrations/zwavejs-ui.md b/docs/integrations/zwavejs-ui.md new file mode 100644 index 00000000..0d0f1e92 --- /dev/null +++ b/docs/integrations/zwavejs-ui.md @@ -0,0 +1,45 @@ +--- +id: zwavejs-ui +title: Integrate your Z-Wave devices with Z-Wave JS UI +sidebar_label: Z-Wave JS UI +--- + +:::warning +January 2024: This integration is in alpha for now. + +Only one type of device is supported: The [Fibaro Door Opening Sensor](https://www.amazon.com/Fibaro-FGDW-002-1-Window-Temperature-Sensor/dp/B074FCG1PF?crid=AMCFKK427FRN&keywords=Fibaro+door+sensor+2&qid=1704977401&sprefix=fibaro+door+sensor+2%2Caps%2C164&sr=8-1&linkCode=ll1&tag=gladproj-20&linkId=3e61bb12444e6d8265e7440bd0174456&language=en_US&ref_=as_li_ss_tl). + +We are looking for help to integrate other devices! +::: + +Gladys Assistant offers integration with [Z-Wave JS UI](https://zwave-js.github.io/zwave-js-ui/#/), a software application for controlling Z-Wave devices. + +Gladys connects to the same MQTT broker as Z-Wave JS UI and receives MQTT messages whenever a device's status changes. + +## Installing Z-Wave JS UI + +Please visit the [Z-Wave JS UI](https://zwave-js.github.io/zwave-js-ui/#/) website for Z-Wave JS UI installation instructions. + +## Configuring Z-Wave JS UI + +For integration with Gladys to work properly, 2 settings are required. + +First, you need to set the MQTT parameters in the parameters, in particular the "name" field, which defines the MQTT topic to which messages will be sent. + +![Z-Wave JS UI Configuration MQTT](../../static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg) + +Next, configure the "Gateway" section as follows: + +![Z-Wave JS UI Configuration Gateway](../../static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg) + +## Connect Gladys to Z-Wave JS UI + +To enable Gladys to communicate with Z-Wave JS UI, you need to provide Gladys with the URL and connection information for the MQTT broker on which Z-Wave JS UI is published. + +Go to the "Configuration" tab to add this information. + +## Discover Z-Wave JS UI + +Go to the "Discovered" tab to see the devices your Z-Wave JS UI instance exposes. + +You can then add them to Gladys with a single click! diff --git a/i18n/fr/docusaurus-plugin-content-blog/2020-11-06-launching-gladys-assistant-4.md b/i18n/fr/docusaurus-plugin-content-blog/2020-11-06-launching-gladys-assistant-4.md index c44e5bb2..7a71678e 100644 --- a/i18n/fr/docusaurus-plugin-content-blog/2020-11-06-launching-gladys-assistant-4.md +++ b/i18n/fr/docusaurus-plugin-content-blog/2020-11-06-launching-gladys-assistant-4.md @@ -80,7 +80,7 @@ Aujourd'hui, des centaines de périphériques domotiques sont déjà disponibles A ce jour, Gladys Assistant supporte les périphériques : -- Z-Wave ([doc](/fr/docs/integrations/zwave/)) +- Z-Wave - Xiaomi ([doc](/fr/docs/integrations/xiaomi/)) - Philips Hue ([doc](/fr/docs/integrations/philips-hue/)) - Sonoff (Tasmota) ([doc](/fr/docs/integrations/tasmota/)) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwave.md b/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwave.md deleted file mode 100644 index e0247d09..00000000 --- a/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwave.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -id: zwave -title: Z-Wave -sidebar_label: Z-Wave ---- - -:::warning -Décembre 2022: Cette intégration utilise Open-Zwave et n'est plus supportée. - -Nous travaillons actuellement sur une migration vers Zwave-js-ui (Voir avancement [sur le forum](https://community.gladysassistant.com/t/v4-integration-z-wave/6057/68?u=pierre-gilles)). - -En attendant, nous vous conseillons de passer par Node-RED + ZwaveJS2MQTT. - -- [Tutoriel Gladys + Node-RED sur Youtube](https://www.youtube.com/watch?v=bpmHzR8_S5g) -- [Tutoriel ZwaveJS2mqtt sur le forum](https://community.gladysassistant.com/t/node-red-zwavejs2mqtt-et-volet-roulants-zmnhcd1/6589) -- [Tutoriel Gladys + Node-RED + ZwaveJS sur le forum](https://community.gladysassistant.com/t/node-red-integration-z-wave/6626) - -::: - -## Connectez votre clé USB Z-Wave à votre Raspberry Pi - -Gladys Assistant a été testé avec la clé [Aeotec Z-Stick GEN5](https://www.amazon.fr/Contr%C3%B4leur-Z-Wave-Plus-Z-Stick-GEN5/dp/B00YETCNOE?tag=gladproj-21) et la clé [Z-Wave.me](https://www.amazon.fr/gp/product/B00QJEY6OC/?tag=gladproj-21). - -D'autres clés sont sûrement compatibles, n'hésitez pas à nous dire si vous faites fonctionner une autre clé avec Gladys Assistant. - -Branchez en USB votre clé USB au Raspberry Pi (ou autre machine) faisant tourner Gladys Assistant. - -## Sélectionnez le port USB dans Gladys Assistant - -Rendez-vous dans `Intégrations -> Z-Wave -> Paramètres`: vous devriez pouvoir sélectionner le port USB sur lequel est connectée votre clé USB Z-Wave. - -![Z-Wave ajouter clé USB](../../../../../static/img/docs/fr/configuration/zwave/zwave-key.png) - -Cliquez sur connecter. - -## Laissez Gladys Assistant découvrir vos appareils - -Pendant quelques minutes, Gladys Assistant va scanner le réseau Z-Wave pour découvrir tous les appareils Z-wave disponible. - -Vous devriez ensuite pouvoir connecter vos appareils à Gladys Assistant. - -Vous retrouverez dans l'onglet configuration les appareils Z-Wave que Gladys Assistant a trouvé. - -Une fois les appareils ajoutés, vous les retrouverez dans l'onglet "Appareils" : - -![Z-Wave liste des appareils](../../../../../static/img/docs/fr/configuration/zwave/zwave-device-added.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwavejs-ui.md b/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwavejs-ui.md new file mode 100644 index 00000000..e532e847 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/integrations/zwavejs-ui.md @@ -0,0 +1,45 @@ +--- +id: zwavejs-ui +title: Intégrez vos appareils Z-Wave grâce à Z-Wave JS UI +sidebar_label: Z-Wave JS UI +--- + +:::warning +Janvier 2024: Cette intégration est en alpha pour l'instant. + +Seul un type d'appareil est supporté: Le [Fibaro Détecteur d'ouverture de porte](https://www.domadoo.fr/fr/peripheriques/4105-fibaro-detecteur-d-ouverture-z-wave-doorwindow-sensor-2-blanc-5902701700348.html?domid=17). + +Nous sommes à la recherche d'aide pour intégrer d'autres appareils ! +::: + +Gladys Assistant propose une intégration avec [Z-Wave JS UI](https://zwave-js.github.io/zwave-js-ui/#/), un logiciel qui permet de contrôler des appareils Z-Wave. + +Gladys se connecte au même broker MQTT que Z-Wave JS UI et reçoit des messages MQTT à chaque changement d'état d'un appareil. + +## Installer Z-Wave JS UI + +Nous vous invitons à vous rendre sur le site de [Z-Wave JS UI](https://zwave-js.github.io/zwave-js-ui/#/) pour trouver les instructions d'installation de Z-Wave JS UI. + +## Configurer Z-Wave JS UI + +Afin que l'intégration avec Gladys fonctionne correctement, 2 réglages sont nécessaires. + +Il faut d'abord régler dans les paramètres les paramètres MQTT, notamment le champ "name" qui va définir le topic MQTT sur lequel les messages seront envoyés. + +![Z-Wave JS UI Configuration MQTT](../../../../../static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg) + +Ensuite, il est nécessaire de configurer la section "Gateway" de la manière suivante : + +![Z-Wave JS UI Configuration Gateway](../../../../../static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg) + +## Connecter Gladys à Z-Wave JS UI + +Afin que Gladyus puisse communiquer avec Z-Wave JS UI, il faut fournir à Gladys l'URL et les informations de connexion au broker MQTT sur lequel publie Z-Wave JS UI. + +Rendez-vous dans l'onglet "Configuration" pour ajouter ces informations. + +## Découverte Z-Wave JS UI + +Rendez-vous sur l'onglet "Découvert" pour voir les appareils que votre instance Z-Wave JS UI expose. + +Vous pouvez ensuite les ajouter à Gladys d'un seul clic! diff --git a/sidebars.js b/sidebars.js index b9c8350c..2e0fa3d9 100644 --- a/sidebars.js +++ b/sidebars.js @@ -43,7 +43,7 @@ module.exports = { "integrations/tuya", "integrations/xiaomi", "integrations/zigbee2mqtt", - "integrations/zwave", + "integrations/zwavejs-ui", ], }, { diff --git a/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg b/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg new file mode 100644 index 00000000..a23b4a4b Binary files /dev/null and b/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg differ diff --git a/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg b/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg new file mode 100644 index 00000000..a592386a Binary files /dev/null and b/static/img/docs/en/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg differ diff --git a/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg b/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg new file mode 100644 index 00000000..a23b4a4b Binary files /dev/null and b/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-gateway-configuration.jpg differ diff --git a/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg b/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg new file mode 100644 index 00000000..a592386a Binary files /dev/null and b/static/img/docs/fr/configuration/zwavejs-ui/zwavejs-ui-mqtt-configuration.jpg differ