From 6fc44eac1bd1d6a0630e1654ec361ac5d2f7b051 Mon Sep 17 00:00:00 2001 From: Martin Hjelmare Date: Tue, 19 Oct 2021 12:06:32 +0200 Subject: [PATCH] Update Z-Wave integrations deprecation and migration status (#19856) --- source/_integrations/ozw.markdown | 9 +++++---- source/_integrations/zwave.markdown | 2 +- source/_integrations/zwave_js.markdown | 6 ++++-- 3 files changed, 10 insertions(+), 7 deletions(-) diff --git a/source/_integrations/ozw.markdown b/source/_integrations/ozw.markdown index 1ad01cd2f9a..9685123f0dd 100644 --- a/source/_integrations/ozw.markdown +++ b/source/_integrations/ozw.markdown @@ -1,5 +1,5 @@ --- -title: OpenZWave (beta) +title: OpenZWave (deprecated) description: Instructions on how to integrate OpenZWave with Home Assistant. ha_category: - Switch @@ -22,14 +22,15 @@ ha_platforms: - switch --- -This integration allows you to utilize OpenZWave's ozwdaemon to control a Z-Wave network over MQTT. -
- As of mid-2021 this integration, as well as the upstream ozwdaemon project, are not currently maintained. If you're starting out with Z-Wave in Home Assistant, we recommend that you use [the Z-Wave JS integration](/integrations/zwave_js). + This integration is deprecated. We recommend using [the Z-Wave JS integration](/integrations/zwave_js). + + The OpenZWave integration will no longer receive any updates. The technical dependencies may render this integration unusable in the future, at which time it may be removed.
+This integration allows you to utilize OpenZWave's ozwdaemon to control a Z-Wave network over MQTT. ## Requirements diff --git a/source/_integrations/zwave.markdown b/source/_integrations/zwave.markdown index 026de32f162..7ffd523b611 100644 --- a/source/_integrations/zwave.markdown +++ b/source/_integrations/zwave.markdown @@ -33,7 +33,7 @@ ha_platforms: This integration is deprecated. We recommend using [the Z-Wave JS integration](/integrations/zwave_js). -The Z-Wave integration will no longer receive any updates. It will not be removed unless it becomes incompatible with a future version of Python. +The Z-Wave integration will no longer receive any updates. The technical dependencies may render this integration unusable in the future at which time it may be removed. diff --git a/source/_integrations/zwave_js.markdown b/source/_integrations/zwave_js.markdown index 83587a7bf6d..b08c7c778c0 100644 --- a/source/_integrations/zwave_js.markdown +++ b/source/_integrations/zwave_js.markdown @@ -493,16 +493,18 @@ You can keep track of the Roadmap for the Z-Wave JS integration [here](https://g If you're new to Home Assistant, use Z-Wave JS. -The `zwave` integration has been marked as deprecated and will no longer receive any updates like new device files. The `ozw` integration will receive new device files if they are provided by upstream. +The `zwave` and `ozw` integrations have been marked as deprecated and will no longer receive any updates. It is perfectly doable to switch over from one of the above mentioned previous integrations to the new Z-Wave JS integration. The good news is that your entire Z-Wave network is **stored on your stick** so you will not have to run through your house to recreate your network. -If you are currently running the [`zwave`](/integrations/zwave/) or [`ozw`](/integrations/ozw/) Z-Wave integration and it works fine, there is **no need to switch over at this time** to Z-Wave JS. What is important to know is that all development focus currently goes to Z-Wave JS. The previous implementations are provided as-is. They will **NOT be removed** without proper notice but in time there *might* come technical dependencies that render one or both of those integrations unusable. +If you are currently running the [`zwave`](/integrations/zwave/) or [`ozw`](/integrations/ozw/) Z-Wave integration we recommend you to migrate to Z-Wave JS. All development focus now goes to Z-Wave JS. The previous implementations are provided as-is. They will not be removed without proper notice but in time there might come technical dependencies that render one or both of those integrations unusable. ### Automatic migration wizard For the `zwave` integration there is a migration wizard that will help you set up the Z-Wave JS integration, remove the `zwave` integration and migrate the entities and devices that can be mapped from the `zwave` integration to the Z-Wave JS integration. Some entities may not be able to migrate automatically and you will need to rename the corresponding available Z-Wave JS entities manually, after the migration. Before completing the migration you will be shown a list of entities that could not be migrated automatically, and you'll have the option to abort or continue with the migration. The migration wizard is available from the `zwave` integration configuration panel in the GUI. +There is no automatic migration wizard for the `ozw` integration. Please follow the manual migration path below if you want to migrate from `ozw` to Z-Wave JS. + ### In a nutshell this is what the migration path looks like 1) Make a **backup** of your Home Assistant configuration. If you're running the supervisor this is very easy to do by creating a backup. You should do this so you'll be able to quickly revert if you may run into unexpected problems.