Holman WiFi Tap timers intergration?

Gurgeh88 · April 15, 2023, 11:43am

Hi all, if you’re after a super simple and straight-forward way to integrate the Holman tap timers into Home Assistant like I was then use the following video from Lewis at Everything Smart Home to get it working through Google Home. Now, you have to use input booleans to manually set the status of the tap (e.g. running) in HA but I’m happy with that as a bodgy workaround for very little effort in terms of setup. Now I have a nice and easy button on my dashboard or I use automations to turn the sprinkler on and off accordingly. Hope that helps anyone who has been bashing their head against the wall trying to get these working (I have the WX1). If you don’t have Google Home then I don’t know how to help you.

Docrob · May 7, 2023, 9:28am

Hi.
I’d like to add the socket to HA as well as the WX1. I have the CID for the socket - but what DPS are associated with the socket?
Thanks for all your work on the WX1 - excellent stuff.

brazen00 · August 15, 2023, 3:04am

Hi all. Thanks to all previous posters for their work on decoding the DPs on this. The tuya-local integration via HACS now recognises the WX1 Tap Timer. See the PR here Create holman_wx1_taptimer.yaml by Brazen00 · Pull Request #979 · make-all/tuya-local · GitHub. I did not get the full functionality to work, as tuya-local does not have a set_dp service, but the basic functionality is there.

danielcheney · September 6, 2023, 3:51am

Hi All,
I’m fairly new to this, but managed to get my WX2 working after a few hours effort. Thought i’d share the things I got caught on as others might find it handy:

I used @NeriedAU fork of Local Tyua (Thanks Ash), having previously had installed the rospogrigo fork I had some trouble when switching over to NeriedAU’s version. I ended up resolving this by deleting the LocalTyua folder from \custom_components and rebooting my HAOS device completely.
After copying the new version back into custom_components and re installing, I was trying to verify it was indeed the NeriedAU’s version. Clicking the ‘Documentation’ button in the LocalTuya integration actually took me to rospogrigo’s github fork. It looks like the documentation link may not have been updated as a part of the fork. I note on my install the ‘do not configure a cloud api account’ is unticked by default, which was an indicator I was now using the correct version.
I was having trouble locating the ‘CID’ value for my tap timer. I couldn’t find clear instructions how to get Tuya-cli installed/working, but ended up finding the value using the Tuya IOT platform ‘Industry Basic Service’ API via the dev website, under ‘Industry Devices Management’ > ‘Get Device Information’ and checking the device_id of the timer itself, I located the ‘Node_id’ value, which works as the CID. In my instance the socket was 01B and the tap timer 011.
Once I entered the correct CID and added the device in LocalTuya, I souced a list of the dp_id’s using the ‘query properties’ API under Tyua IOT Platform > Device control.

Freddo333 · September 9, 2023, 1:34am

Thanks for the tips @danielcheney

Just for the ease of anyone else using the WX2, the dps values are

{
  dps: {
    '101': 0,
    '102': 0,
    '103': 0,
    '105': '2',
    '106': '0',
    '107': 15,
    '108': true,
    '113': '0',
    '114': '24',
    '115': false,
    '117': false,
    '119': '1',
    '120': 0,
    '125': false,
    '127': 'HOLxxxxx-xxx-xxx-xxx',
    '150': 0,
    '151': 0,
    '152': 25,
    '153': '3',
    '154': 10,
    '155': true,
    '160': '24',
    '161': false,
    '162': false,
    '166': false
  },
  cid: 'C21'
}

unfortunately it seems that the CIDs are different between people so one will need to them themselves (using ether tuya-cli or the above instructions for Tuya IOT platform)

As far as the DPS values for the wx2, it appears that the second valve has the same values as valve 1 + 49 (e.g. 101 on valve one is 150 on valve 2)

epajfl00 · September 9, 2023, 3:10am

I’ve switch all my devices from LocalTuya to a more robust one on HACS TuyaLocal, don’t get the two confused, they are very different.
Once the device is in the library of devices any user can use the config that is already defined, no need to guess what ID’s do what.
I know for a fact that the device “holman_wx1_taptimer” is already available to use.
Just a note, you must delete the LocalTuya device before using it with TuyaLocal.
Just need the usual, Device IP address, Tuya Device ID and Tuya Local Key.
Give it a go.

Neil11 · September 10, 2023, 3:08am

Anyone able to give me any information on an alternative to the Holman wifi hub. Mine took a power spike which killed it and Holman do not supply hub separately.

Freddo333 · September 10, 2023, 4:11am

Unfortunately the wx1 and wx2 use a proprietary signal to connect to the hub so I don’t think there are any alternatives to the hub itself.

If there aren’t any on the secondhand market, getting a wx1 with a hub and selling the wx1 is probably your best option. Otherwise you will need to replace the timer and hub with another brand.

FrontBottom · September 19, 2023, 9:01am

For the WX2 owners out there. I’ve gone with a “tuya-local” approach. I’m not sure on the pros & cons of tuya-local vs local tuya, but upon seeing that a only device file needed to be created seemed to be the path of least hassle/resistance for me. Have put my device file in a gist. It works as is for me but I’m sure some of the other dps values might come into play when other sensors are deployed etc. I’ll refine it over the coming days…

FrontBottom · September 21, 2023, 11:46pm

For anyone following at home, have raised “new device” request.

izevaka · September 24, 2023, 12:36am

Hey, thanks for putting this together. I’m trying to add my WX2 now. Installed the HACS integration, have the local keys, and downloaded your gist to the devices folder. When I add it in the UI, it doesn’t pick up the device and gives an option of one of these three

Is there anything else I need to do to add a new device to the tuyalocal integration?

Here is my tuya-cli get output:

{
  dps: {
    '101': 0,
    '102': 0,
    '103': 14,
    '105': '2',
    '106': '0',
    '107': 25,
    '108': true,
    '113': '0',
    '115': false,
    '117': false,
    '120': 0,
    '125': false,
    '127': 'HOL9H007-062-055-000',
    '150': 0,
    '151': 0,
    '152': 27,
    '153': '0',
    '154': 25,
    '155': true,
    '160': '0',
    '161': false,
    '162': false,
    '166': false
  },
  cid: '991'
}

Side note, the product id seems to be different for me. I tried changing it but it didn’t help.

{
  "result": [
    {
      "active_time": 1695509296,
      "category": "wg2",
      "create_time": 1695444492,
      "custom_name": "",
      "icon": "smart/icon/ay1556838860681oKmdO/1746f926ee7e6541d8188bf6ec32801f.png",
      "id": "xxx",
      "ip": "xxx",
      "is_online": true,
      "lat": "xxx",
      "local_key": "xxx",
      "lon": "xxx",
      "model": "Emate gateway",
      "name": "Wi-Fi Hub",
      "product_id": "v9vxvkwqa48ayhlr",
      "product_name": "Wi-Fi Hub",
      "sub": false,
      "time_zone": "+10:00",
      "update_time": 1695509296,
      "uuid": "xxx"
    }
  ],
  "success": true,
  "t": 1695514650101,
  "tid": "xxx"
}

FrontBottom · September 24, 2023, 2:04am

Howdy - that product_id matches my Hub. I assume the product_id in my gist matches your actual timer tap? FYI - that Garza is the one that mine default maches too. I assume you added the holman_wx2_taptimer.yaml to the devices folder and restarted?

Easiest way to debug is to turn on debugging for the add-on - it makes it pretty easy to see what the issue is.

logger:
  default: info 
  logs:
    custom_components.tuya_local: debug

Feel free to post your debug output here (should just need to look at the Holman WX2 Tap Timer lines when it is trying to match) - maybe screenshot the tuya-local add integration screen too.

izevaka · September 24, 2023, 4:52am

@FrontBottom Oh nice one thanks! Yep, confirming the actual tap is the same id.

Going to give it a go with the debug and see what happens.

EDIT: Found the culprit from the log:

2023-09-24 15:16:05.586 DEBUG (MainThread) [custom_components.tuya_local.helpers.device_config] Not match for Holman WX2 Tap Timer, missing required DPs: [{'114': 'str'}, {'119': 'str'}]

My DPs did not contain 114 (12/24 time setting) and 119 (metric/imperial units). So I toggled both of those settings in the app and it worked!

This was outright the most painful integration ever, thanks all for the wealth of information in this thread, finally got there!

Here are some notes for what I needed to do:

Create the iot developer account as per https://github.com/codetheweb/tuyapi/blob/d88fd6c84b228b42f0b6aedd84f0ac3cdb1a5523/docs/SETUP.md
Link SmartLife app in the iot backend (could be the Tuya app too)
Add the plug manually in the SmartLife app (it wouldn’t automatically detect for me). Used one of the zigbee gateways and it managed to find it. I suspect there may be more than one gateway that you can choose, it’ll pick up the right one anyway.
Install tuya-cli and go through the wizard to get the local keys and the device CID
Toggle the 24H time setting and the Metric/Imperial setting in the app
Install tuya-local in HACS
Copy the WX2 timer YAML file from the gist into Home Assistant /config/custom_components/tuya_local/devices directory (if it doesn’t exist already)
Add the tap timer in tuya-local (Device id from the hub, Local Key of the hub, CID of the tap timer).

FrontBottom · September 24, 2023, 11:56pm

Nice - looks like 114 & 119 will need to be made optional too. Will add that to the issue.

(For others reading your steps - for step 6.5, don’t forget to copy the new device file into the tuya-local devices folder and restart!)

izevaka · September 25, 2023, 12:15am

@FrontBottom Cheers. True indeed, will update the steps

Tmbao · October 3, 2023, 10:28pm

Not sure if helpful but I spent quite a bit of time trying to reverse engineer the BX1. I can now have basic controls on it over wifi via an esp32 (because my HA server is too far from the tap). Let me know if you want me to share it

NeriedAU · October 7, 2023, 10:05am

Hey @FrontBottom and @izevaka - this is great. Haven’t touched my watering system for a few months. Was hoping to fix Local Tuya to support more than 3 devices per gateway, but seems that might be a problem with the device as the same thing happens with Tuya Local

I haven’t spent much time with it, but this is what I am getting when I add the Holman WX1 taps to Local Tuya - it’s not listing the Holman WX1 template. Next thing I was going to try was moving my Holman Gateway to the same network as Home Assistant - in the process of moving stuff to an IoT network thinking that might resolve the local device polling with TinyTuya where its not finding the devices on the network; Home Assistant may be in a similar situation where it can’t poll the device for DP states etc?

2023-10-07 10:21:46.972 WARNING (MainThread) [custom_components.tuya_local.config_flow] Device matches garza_irrigation_system with quality of 43%. DPS: {“updated_at”: 1696634504.521108, “101”: 8, “102”: 57, “103”: 0, “105”: “2”, “106”: “0”, “107”: 20, “108”: true, “113”: “0”, “115”: true, “116”: false, “117”: true, “120”: 0, “125”: false, “127”: “HOL9H007-023-055-000”}

FrontBottom · October 8, 2023, 2:52am

Howdy - good timing @NeriedAU. I bought a WX1 yesterday and added it today. There is an issue with one of the data types in the current WX1 device file.

I added to my WX2 “issue” here describing the change that needs to be made to the WX1 device file to be able to add it successfully. (You will need to change a data type for dps 116).

I wasn’t aware of that 3 sub-device limit - was planning on getting another WX2 in the next few days, but assume I will have an issue then with the WiFi Socket and WX1 ansd WX2 already there …?

FYI - It looks like the next release of tuya-local will have WX2 support added officially and updated WX1.

NeriedAU · October 8, 2023, 9:44pm

Perfect! That did the trick, thanks mate.

Yeh I’d be interested to know if the WX2 lets you have more devices polling through the gateway. At the moment, if I add a fourth device, i.e. 3 tap timers and the smart power switch, one of the devices goes offline. I was trying some smarts to reuse the existing connection to the gateway but that was a significant change and I kept hitting walls.

funtastix · October 8, 2023, 10:18pm

Question: when you add using Tuya Local, you’ll lose the ability to write to the base64 encoded DPs? Wonder if there is something that can be done about that. It would reduce the template code in my instance by a lot, but I like what I have now, where all controls are within HA