dual_head Feature for WiZ Integration is glitching

[fealXX]

The problem

Even though the Fixture has two Lights and the diagnostics file reports the feature as available on the device, the "Dual Head Ratio" Entity is always unavailable. Enabling just one of the Lightzones through the WiZ App makes the light jump between on/off state in HA every few seconds (without the Fixture actually turning on or off).

What version of Home Assistant Core has the issue?

core-2024.7.1

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant OS

Integration causing the issue

WiZ

Link to integration documentation on our website

https://www.home-assistant.io/integrations/wiz/

Diagnostics information

config_entry-wiz-c17c6a1f992c8425977550282e796465.json

Example YAML snippet

No response

Anything in the logs that might be useful for us?

No response

Additional information

Device Info from the WiZ-App: Squire 127403, FW-Version 1.32.0

[home-assistant[bot]]

Hey there @sbidy, mind taking a look at this issue as it has been labeled with an integration (wiz) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of wiz can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign wiz Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

wiz documentation wiz source _{^{(message by IssueLinks)}}

[filipkemuel]

The issue is that the Wiz API for the dualhead light has changed.

"Dual Head Ratio" has been deprecated.

Instead the light now has two separate "Zones" ('Zone A' and 'Zone B') that woks as individual lights that one can set color, intensity and tempararure on, or set individual scenes on.

There is now also an "All" zone that acts at a seperate light but makes the changes to both zones.

This is very different to the old API that only showed one light (like the "All" zone) but then had a dualhead-ratio that would modify the brightness ratio between them.

[Quickstep3]

I'm also getting the HA events logged (light on + light off) occurring frequently - with no actual change too the lights being triggered or happening - on single lights that are grouped together in the Wiz app to act as a single set. Presumably it uses the same method as lights on a single fixture with multiple bulbs. Any chance this will be fixed in an upcoming HA update as the logs are very "noisy" as a result.

HA version 2024.8.2 HA OS 13.1

[issue-triage-workflows[bot]]

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved with the latest updates. Please make sure to update to the latest Home Assistant version and check if that solves the issue. Let us know if that works for you by adding a comment 👍 This issue has now been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.

[ugursap]

I'm having the same issue with WiZ Squire lights. I've tried the WiZ integration and adding it as a Matter device, but both methods shows it as just one single light. But the interesting thing is, when i make changes through the WiZ app, Zone A's changes can be visible in WiZ integrations and Zone B's changes can be seen in Matter integration, but if i try to control the lights over Home Assistant, it acts as a single light again.

[TerminallyChilll]

Having the same issue. Unavailable in home assistant but works in wiz

[Neffez]

There seems to be a problem with the detection of the dual head feature. I have two lamps with dual head, but the integration fails to detect it. The config json says

"bulb_type": {
        "features": {
          "color": false,
          "color_tmp": true,
          "effect": true,
          "brightness": true,
          "dual_head": false
        },
        "name": "ESP03_SHTW3RC_31G",
        "kelvin_range": {
          "max": 4000,
          "min": 2700
        },
        "bulb_type": "TW",
        "fw_version": "1.33.0",
        "white_channels": 1,
        "white_to_color_ratio": 20
},

Zones are not available.

[issue-triage-workflows[bot]]

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved with the latest updates. Please make sure to update to the latest Home Assistant version and check if that solves the issue. Let us know if that works for you by adding a comment 👍 This issue has now been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.

[sbidy]

I don't get the problem. Could you explain what exactly is not working and what the error cases are? I never got in touch with the dual head feature to be honest.

[andy0135]

Currently, Home Assistant only recognizes the device as a single entity rather than allowing independent control of Zone A and Zone B, as seen in the WiZ app. This limits functionality for users with dual-zone lights.

[sbidy]

Unfortunately, I don't have a DH bulb. So it is not that easy to reproduce. Can you please send a echo '{"method":"getSystemConfig","env":"dev","params":{}}' | nc -u -w 1 <theIPofYourBulb> 38899 to the bulb? In the moduleName property, there should be something with DH.

To be honest, I have to check if we ever considered these type of bulbs to be controlled by the different zones. Maybe the complete integration is missing.

[TerminallyChilll]

Unfortunately, I don't have a DH bulb. So it is not that easy to reproduce. Can you please send a echo '{"method":"getSystemConfig","env":"dev","params":{}}' | nc -u -w 1 <theIPofYourBulb> 38899 to the bulb? In the moduleName property, there should be something with DH.

To be honest, I have to check if we ever considered these type of bulbs to be controlled by the different zones. Maybe the complete integration is missing.

{"method":"getSystemConfig","env":"pro","result":{"mac":"d8","homeId":02,"roomId":2"rgn":"eu","moduleName":"ESP20_DHRGB_01B","fwVersion":"1.33.0","groupId":0,"ping":0,"accUdpPropRate":100}}

[Neffez]

There are 2 "types" of dual head, apparently newer ones have "zones", older ones have "ratio". This one has ratio:

{"method":"getSystemConfig","env":"pro","result":{"mac":"...","homeId":...,"roomId":...,"rgn":"eu","moduleName":"ESP03_SHTW3RC_31G","fwVersion":"1.33.0","groupId":1,"ping":0}}

[fealXX]

{"method":"getSystemConfig","env":"pro","result":{"mac":"d8a011b64835","homeId":13748725,"roomId":21460408,"rgn":"eu","moduleName":"ESP20_DHRGB_01B","fwVersion":"1.33.0","groupId":0,"ping":0,"accUdpPropRate":100}}%   

[Joelious]

Unfortunately, I don't have a DH bulb. So it is not that easy to reproduce. Can you please send a echo '{"method":"getSystemConfig","env":"dev","params":{}}' | nc -u -w 1 <theIPofYourBulb> 38899 to the bulb? In the moduleName property, there should be something with DH.

To be honest, I have to check if we ever considered these type of bulbs to be controlled by the different zones. Maybe the complete integration is missing.

Thank you for taking a look at this @sbidy :)

I'm having this issue as well. I am inept when it comes to this, but I will try to give you something, sort of a short rundown of symptoms.

Only one "light" entity shows up in HA

• If I toggle "Zone B" (in the WiZ official app), that entity also toggles in HA. (regardless of Zone A state)
• If I turn OFF "Zone A", that entity goes to OFF for half a second, then back to being shown as ON. (if Zone B is ON.)
• If I turn ON "Zone A", that entity goes to ON for half a second and back to OFF. (if Zone B is OFF)

"method": "getSystemConfig", "env": "pro", "result": { "mac": "cc408500363e", "homeId": "**REDACTED**", "roomId": "**REDACTED**", "rgn": "eu", "moduleName": "ESP20_DHRGB_01B", "fwVersion": "1.34.0", "groupId": 0, "ping": 0, "accUdpPropRate": 100, "rdIdUidHash": "REDACTED" } },

Perhaps also this information below is useful? IDK, I am pleb.

Click to see Details

"entry": {
  "title": "WiZ RGBWW Tunable 00363E",
  "data": {
    "host": "192.168.0.78"
  }
},
"data": {
  "state": {
    "mac": "cc408500363e",
    "rssi": -50,
    "devices": 2,
    "src": "hb",
    "mqttCd": 0,
    "ts": REDACTED,
    "state": true,
    "sceneId": 2,
    "speed": 100,
    "dimming": 100
  },
  "white_range": null,
  "extended_white_range": [
    2200.0,
    2700.0,
    6500.0,
    6500.0
  ],
  "bulb_type": {
    "features": {
      "color": true,
      "color_tmp": true,
      "effect": true,
      "brightness": true,
      "dual_head": true
    },
    "name": "ESP20_DHRGB_01B",
    "kelvin_range": {
      "max": 6500,
      "min": 2200
    },
    "bulb_type": "RGB",
    "fw_version": "1.34.0",
    "white_channels": 2,
    "white_to_color_ratio": 30
  },

     "getModelConfig": {
        "method": "getModelConfig",
        "env": "pro",
        "result": {
          "devTotal": 2,
          "headTotal": 2,
          "swHead": 0,
          "ps": 1,
          "hasGradient": 1,
          "nightLightOff": 0,
          "stdbyPin": 12,
          "pilotDelay": 500,
          "minDimLevel": 10,
          "devices": 1,
          "devType": 0,
          "lightType": 1,
          "pwmFreq": 2000,
          "pwmRes": 11,
          "pwmRange": [
            0,
            100
          ],
          "pwmRanges": [
            0,
            1000,
            0,
            1000,
            0,
            1000,
            0,
            1000,
            0,
            1000
          ],
          "wcr": 30,
          "nowc": 2,
          "cctRange": [
            2200,
            2700,
            6500,
            6500
          ],
          "renderFactor": [
            255,
            255,
            170,
            255,
            0,
            0,
            42,
            200,
            255,
            255
          ],
          "wizc1": {
            "mode": [
              0,
              0,
              0,
              0,
              0,
              0,
              0
            ]
          },
          "wizc2": {
            "mode": [
              0,
              0,
              0,
              0,
              0,
              0,
              0
            ]
          },
          "drvIface": 0
        }
      },

Cheers! /Joel

[issue-triage-workflows[bot]]

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved with the latest updates. Please make sure to update to the latest Home Assistant version and check if that solves the issue. Let us know if that works for you by adding a comment 👍 This issue has now been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.

[fealXX]

This has unfortunately not yet been resolved :)

[eroldan]

Hey @sbidy, I just Github sponsored you with $70 which would be great if you use to purchase one of these Wiz Squire devices and do some research. No pressure though. Thanks a lot!

[sbidy]

Hey @sbidy, I just Github sponsored you with $70 which would be great if you use to purchase one of these Wiz Squire devices and do some research. No pressure though. Thanks a lot!

Thank you! But I can feel a bit of a pressure... 😉 I will try to buy one of these but first is have to check if there are available in Germany or have to import them. My contact at Wiz is unfortunately not longer available to get the bulbs directly from there.

Let me check on the weekend.

Update: should arrive on Monday 🥳

[Digitally1234]

I didn't have this problem until I shortly opened up my IoT vlan up to internet access. I believe the light updated itself to the latest firmware and suddenly the dual head ratio feature isn't available anymore in HA. So it used to work with earlier firmwares. If only it didn't update itself...

[whereisaaron]

@sbidy I bought a Squire to test and they're pretty nice as mood / uplights! They would be awesome in HA if the two lights were exposed separately, and it sounds like that's exactly what the new version of the API does! "Instead the light now has two separate "Zones" ('Zone A' and 'Zone B') that woks as individual lights that one can set color, intensity and temperature on, or set individual scenes on." - @filipkemuel. If anything that sounds a bit simpler / cleaner than the old API? One of the cool thinks you could do, is use the lower 'mood light' to indicate events like door or motion detection etc.

I checked that are available on amazon.de and direct directly from the Wiz website for about €53.

• https://www.amazon.de/-/en/Tunable-Million-Colours-Dimmable-Control/dp/B09GBB9DTP
• https://www.wizconnected.com/de-de/p/tragbare-leuchte-squire-tischleuchte/8719514553026

Many thanks to @eroldan for the sponsoring this product / project! I tacked on $20 just now - for shipping I guess 😅

Good luck! 🙏

[sbidy]

Ok, I found some time to test. I updated the lib to interact with the bulb and the dual heads in https://github.com/sbidy/pywizlight/pull/193 . After testing I will merge and release a new version to get then integrated into the HASS integration.

Feel free to clone the branch and test with the cli tool (python -m pywizlight.cli on <IP> --device 1/2)

[artoonie]

FWIW I have tried the CLI tool and it works great on my Halo lights!

[daan1024]

I have a Wiz Squire, and can confirm this works.