How is manufacturer_specific.xml being used?

Using Hassbian on a RPI 3. HASS 0.56.2.

I installed a new Zooz lightswitch to the network. Installed just fine, but came back as an “Unknown Device.” I checked:

/srv/homeassistant/lib/python3.5/site-packages/python_openzwave/ozw_config/manufacturer_specific.xml

and, sure enough, the device was not listed. So I added it under the correct manufacturer:

<Manufacturer id="015d" name="Zooz">
        <Product type="1111" id="1e1c" name="ZEN23 Toggle Switch" />
</Manufacturer>

Deleted zwcfg_xxx.xml and rebooted. New zwcfg_xxxx.xml is created, but the device is still showing as Unknown. From zwcfg_xxxx.xml:

<Manufacturer id="15d" name="Zooz">
        <Product type="1111" id="1e1c" name="Unknown: type=1111, id=1e1c" />
</Manufacturer>

Played with it multiple times and made no progress. Thinking maybe I was editing the wrong file, I looked for other instances of manufacturer_specific.xml, but couldn’t find any others.

As an experiment, I then decided to delete all my other devices from manufacturer_specific.xml (backed it up first) and rebooted. They should all show as Unknown Device now, right? But they don’t, they are all showing up correctly in zwcfg_xxxx.xml and in HASS.

I’m very confused. Is there a new way HASS/OZW is using to look up devices? Am I missing something important? Did I do something stupid (first time for everything, right?)? Please help. I’m pulling my hair out.

Can anyone explain or point me to documentation that explains how HA and OZW identify devices and incorporate their configuration options? Thanks

The controller itself caches the information about devices. I believe zwcfg_xxx.xml is used to speed up startup so that the OpenZWave software doesn’t need to load all that info in every time.

I am fairly sure that to get manufacturer_specific.xml and specific config file settings* to apply, you need to exclude and then re-include the device (remove node / add node).

* If you want your device recognized it’s not enough to put it in the manufacturer_specific.xml - that file also refers to a per-device specific config file in

/srv/homeassistant/lib/python3.5/site-packages/python_openzwave/ozw_config/config/

that describes the device and its configuration parameters. I manually created these for one device I have, it was tedious.

See this page for instructions. See the manufacturer-named folders here for many examples. If so inclined you should submit your changes back to the OpenZWave project and they will include them in the next release to help others.

netopiax, thanks for the reply.

For the record, the device does NOT need to be excluded and then reincluded in order to get the information from the updated manufacturer_specific.xml. Also, not all devices have/need a specific config file (though mine does.) Many devices simply do not have any configuration options.

I was able to resolve the issue by properly updating manufacturer_specific.xml (as described in your link to OZW) and then:

  1. Stopping HA (sudo systemctl stop home-assistant.service)
  2. Removing all of the information related to this node from the zwcfg_xxx.xml
  3. Restarting HA

Took about 10 minutes for OZW to reread the manufacturer_specific.xml

3 Likes

Good to know - I still have a bunch of Leviton dimmers that were added before appropriate device specific files were available that show up as Unknown. I thought I had followed the procedure you lay out and it didn’t work to properly identify those dimmers, but I will try again.

For the sake of posterity the mistake I made was modifying zwcfg_xxx.xml while HA was running. I think OZW rewrites the file on shutdown. I had to rename my devices after deleting them from zwcfg_xxx.xml, but they are all recognized correctly now.

Yes, zwcfg_*.xml is written when the Z-Wave mesh is stopped, which happens on Home Assistant shut down. If you’re hand editing the file then it has to be done with Home Assistant shut down.

Hey guys

Anyone would know how to resolve this issue on a HASSIO installation of HomeAssistant ?

let me know if you do, i have a few ZooZ switches that are not found properly, while the dimmers are

thanks

ie: this is what i get for the switches