2025.3.4
首页 ▸ Integrations ▸

WiZ

The WiZ integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] allows you to control your WiZ lights and smart sockets. The devices are set up through your Wi-Fi network and don’t need any additional bridge or gateway.

These devices have been sold under at least the following brands:

The integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] can report the state of occupancy sensors that have been linked to a device.

配置

要将 WiZ integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

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

手动配置步骤

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

Connect WiZ devices to your network

To connect a WiZ device to your Wi-Fi network, please follow the instructions in the WiZ app (available for iOS and Android). If you have further questions, please have a look at the WiZ Support Page.

Enable local connectivity

The integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] needs to communicate locally with the WiZ device. This setting Allow local communication can be disabled or enabled in WiZ app. This setting should be enabled by default.

Steps to enable:

  1. Open the WiZ app on your phone.
  2. Click on the settings menu in the upper-left corner.
  3. Scroll down to the security settings.
  4. Enable the switch Allow local communication.

Occupancy sensors

The occupancy sensors will only be added once a motion event is detected. Home Assistant can detect the sensors if they turn on at least one device when the room is occupied, and turn off at least one device when the room is not occupied. Sensors that are not linked to a device cannot be detected.

When a device is linked to an occupancy sensor, by default, the sensor will be disabled for 30 minutes after manual control.

Devices linked to the occupancy sensor that was last controlled manually will show an unknown at startup. The state will be known the next time the light is controlled by the sensor.

Power monitoring sensors

A power monitoring sensor is available on devices with the following hardware modules:

  • ESP25_SOCKET_01
  • ESP20_SHDW_31R
  • ESP20_SHRGB_31R
  • ESP20_SHTW_31R

Effect speed

The speed of an effect can be controlled via a number entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more]. The entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] will only be available when an effect has been set that allows the speed to be adjusted.