2025.3.4
首页 ▸ Integrations ▸

Z-Wave.Me

This integration allows you to control a Z-Wave network via the Z-Wave.Me Z-Way. It combines the performance and the power of the diagnostics tools built-in Z-Way with the flexibility of Home Assistant. The integration brings all Z-Way devices in Home Assistant (Z-Wave, Zigbee, EnOcean, HTTP based, and others).

配置

要将 Z-Wave.Me integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Z-Wave.Me 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

URL

The IP address with the port of the Z-Way server. The IP address can be prefixed with wss:// if HTTPS should be used instead of HTTP (when using find.z-wave.me remote access service or public IP with SSL).

API Token

Z-Way API access token of the Z-Way server. To get the token go to the Z-Way user interface Smart Home UI > Menu > Settings > Users > Administrator > API token.

When connecting via find.z-wave.me remote access service you need to use a token with a global scope (log-in to Z-Way via find.z-wave.me for this).

Example of connecting to Z-Way in the local network:

  • URL: 192.168.1.39:8083
  • API Token: /112f7a4a-0051-cc2b-3b61-1898181b9950

Example of connecting to Z-Way via remote access find.z-wave.me:

  • URL: wss://find.z-wave.me
  • API Token: 0481effe8a5c6f757b455babb678dc0e764feae279/112f7a4a-0051-cc2b-3b61-1898181b9950

Example of connecting to Z-Way with a static public IP address:

  • URL: wss://87.250.250.242:8083
  • API Token: /112f7a4a-0051-cc2b-3b61-1898181b9950

Warning

To grant access only to certain devices, create a new user and select the necessary devices from the list. Then use the API token of that user. It is suggested not to use the API token of the admin.

Tip

You can use Z-Wave.Me UI with its enhanced Z-Wave network diagnostics tools together with the Home Assistant UI.

Hardware requirements

Z-Wave.Me Z-Way requires Z-Wave.Me hardware:

Installing Z-Way

Z-Wave.Me Z-Way runs on various platforms: Raspberry Pi OS, Linux, Windows. Installation instructions are available here: https://z-wave.me/z-way/download-z-way/

Migration to Z-Way

To migrate from any other Z-Wave controller to Z-Way, include Z-Way as a secondary controller (with security to let Z-Way learn the network key). Use the Z-Way migration tool to make the controller primary in your network.