From c581c6d5bac85be7fccd8f00e9b77f3ab256f085 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Mon, 26 Apr 2021 21:40:52 +0200 Subject: [PATCH] Add Z-Wave deprecation notes to old docs (#17605) --- source/_docs/z-wave.markdown | 6 ++++++ source/_docs/z-wave/adding.markdown | 6 ++++++ source/_docs/z-wave/controllers.markdown | 6 ++++++ source/_docs/z-wave/device-specific.markdown | 6 ++++++ source/_docs/z-wave/devices.markdown | 6 ++++++ source/_docs/z-wave/entities.markdown | 2 +- source/_docs/z-wave/events.markdown | 6 ++++++ source/_docs/z-wave/installation.markdown | 7 +++++++ source/_docs/z-wave/query-stage.markdown | 6 ++++++ source/_docs/z-wave/services.markdown | 6 ++++++ 10 files changed, 56 insertions(+), 1 deletion(-) diff --git a/source/_docs/z-wave.markdown b/source/_docs/z-wave.markdown index 9dffc7e31d7..479f0206ab7 100644 --- a/source/_docs/z-wave.markdown +++ b/source/_docs/z-wave.markdown @@ -3,6 +3,12 @@ title: "Z-Wave" description: "Using Z-Wave with Home Assistant." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ [Z-Wave](https://www.z-wave.com/) integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a [supported Z-Wave USB stick or module](/docs/z-wave/controllers/) to be plugged into the host. There is currently support for climate, covers, lights, locks, sensors, switches, and thermostats. All will be picked up automatically after configuring this platform. diff --git a/source/_docs/z-wave/adding.markdown b/source/_docs/z-wave/adding.markdown index f7c3d3467b8..9aff94c29b5 100644 --- a/source/_docs/z-wave/adding.markdown +++ b/source/_docs/z-wave/adding.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Devices - Adding and Removing" description: "How to add and remove Z-Wave devices." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ ## Adding Devices To add a [Z-Wave device](/docs/z-wave/devices/): diff --git a/source/_docs/z-wave/controllers.markdown b/source/_docs/z-wave/controllers.markdown index bf9290e4263..b9fd52a7b4e 100644 --- a/source/_docs/z-wave/controllers.markdown +++ b/source/_docs/z-wave/controllers.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Controllers" description: "Extended instructions how to setup Z-Wave." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ ## Supported Z-Wave USB Sticks & Hardware Modules You need to have a compatible Z-Wave stick or module installed. This needs to be a *static controller*, which most Z-Wave sticks and modules will be. If yours is a *bridge* device then it won't work with [OpenZWave](http://openzwave.com/), which is what provides Home Assistant's Z-Wave capabilities. USB sticks using the new 700 series Z-Wave platform are not compatible. The following devices have been confirmed to work: diff --git a/source/_docs/z-wave/device-specific.markdown b/source/_docs/z-wave/device-specific.markdown index 4f1235009c1..980a7a12b29 100644 --- a/source/_docs/z-wave/device-specific.markdown +++ b/source/_docs/z-wave/device-specific.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Device Specific Settings" description: "Notes for specific Z-Wave devices." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ ## Device Categories ### Motion or alarm sensors diff --git a/source/_docs/z-wave/devices.markdown b/source/_docs/z-wave/devices.markdown index 2a629c2d7e6..b30926faf76 100644 --- a/source/_docs/z-wave/devices.markdown +++ b/source/_docs/z-wave/devices.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Devices" description: "What you need to know about Z-Wave devices." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ ## Devices, Nodes, Entities The *device* is the hardware, and also used when referring to the node and all its entities. There are 3 main types of devices: diff --git a/source/_docs/z-wave/entities.markdown b/source/_docs/z-wave/entities.markdown index 089ccf628f9..6b8fc943aca 100644 --- a/source/_docs/z-wave/entities.markdown +++ b/source/_docs/z-wave/entities.markdown @@ -5,7 +5,7 @@ description: "A summary of common entity names."
-This is a work in progress, based upon reports in the forum, the author's own devices and reading of various documentation. It will be incomplete, so if you have a device that isn't reported here or have a device that reports a different value, please provide a report in the [Z-Wave section](https://community.home-assistant.io/c/configuration/zwave) of the forum or the `#zwave` channel on [Discord](https://discord.gg/RkajcgS). +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/).
diff --git a/source/_docs/z-wave/events.markdown b/source/_docs/z-wave/events.markdown index 4ce3284e6fc..6003fad3a60 100644 --- a/source/_docs/z-wave/events.markdown +++ b/source/_docs/z-wave/events.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Events" description: "Events generated by the Z-Wave component." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ ## zwave.network_complete Home Assistant will trigger an event when the Z-Wave network is complete, meaning all of the nodes on the network have been queried. This can take quite some time, depending on wakeup intervals on the battery-powered devices on the network. diff --git a/source/_docs/z-wave/installation.markdown b/source/_docs/z-wave/installation.markdown index 55a87a9cf1f..397a9057e51 100644 --- a/source/_docs/z-wave/installation.markdown +++ b/source/_docs/z-wave/installation.markdown @@ -3,6 +3,13 @@ title: "Z-Wave" description: "Installation of the Z-Wave component." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ + Z-Wave can be configured using the Z-Wave *Integration* in the *Configuration* menu, or manually using an entry in `configuration.yaml` ## Configuration diff --git a/source/_docs/z-wave/query-stage.markdown b/source/_docs/z-wave/query-stage.markdown index 81f5f1f5b7d..2d07055f5cd 100644 --- a/source/_docs/z-wave/query-stage.markdown +++ b/source/_docs/z-wave/query-stage.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Query Stage" description: "What are the Query Stages." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ When the Z-Wave mesh is first started, the controller will go through all the following stages for every device on the mesh. This is a slow process, and to complete requires that the devices be awake. While devices that are mains or USB powered are always awake, battery-powered devices spend most of their time asleep. Because of this, you can expect that after startup your battery powered devices will spend time in `Initializing (CacheLoad)` - how long depends on the device. Your devices will still function normally while marked as `Initializing`. diff --git a/source/_docs/z-wave/services.markdown b/source/_docs/z-wave/services.markdown index ba6a914e3b6..43d4bebcdbb 100644 --- a/source/_docs/z-wave/services.markdown +++ b/source/_docs/z-wave/services.markdown @@ -3,6 +3,12 @@ title: "Z-Wave Services" description: "Services exposed by the Z-Wave component." --- +
+ +This Z-Wave integration is deprecated and replaced with a [new implementation based on Z-Wave JS](/integrations/zwave_js); it's currently in beta, and you can [try it now](/integrations/zwave_js/). + +
+ The `zwave` integration exposes multiple services to help maintain the network. All of these are available through the Z-Wave control panel. | Service | Description |