# Unknown Z-Wave device: How to proceed? **URL:** \ **Category:** Bindings\ **Tags:** zwave1\ **Created:** [December 28, 2018, 8:27pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485 "2018-12-28T20:27:25Z")\ **Posts on this page:** 20\ **Page:** 2
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 8:38am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/21 "2019-06-15T08:38:10Z")
> [@leif](#): > > Do you need me to do anything else or will you take it from here? I will create separate database entries and revert the changes to #244. Give me a minute or two šŸ˜€ ---
**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\ **Post date:** [June 15, 2019, 8:54am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/22 "2019-06-15T08:54:52Z")
> [@leif](#): > > Isnā€™t that it? šŸ˜• Well - this is the list of command classes, but as I said, it doesnā€™t list the configuration command class. ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 8:57am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/23 "2019-06-15T08:57:15Z")
> [@chris](#): > > it doesnā€™t list the configuration command class. Itā€™s in his [xml file](https://community.openhab.org/uploads/short-url/jC8jBnFGMfWnhCkEnC3rQzaNrPJ.xml) so I guess separating the devices is a good idea: ``` COMMAND_CLASS_CONFIGURATION 1 1 false 1 ``` ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 8:58am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/24 "2019-06-15T08:58:40Z")
But what does this mean? ``` #### Device definition contains errors * Channel in endpoint 0 uses an unsupported channel (particulate_matter)! ``` Error in the xml or do you need to add this command class to the database? ---
**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\ **Post date:** [June 15, 2019, 9:00am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/25 "2019-06-15T09:00:59Z")
> [@sihui](#): > > Itā€™s in his [xml file](https://community.openhab.org/uploads/short-url/jC8jBnFGMfWnhCkEnC3rQzaNrPJ.xml) I seem to have caused confusion - sorry. I didnā€™t mean to infer that it was not supported. Clearly the device supports the configuration command class as the manual lists the configuration parameters. My point was simply that the configuration command class is not listed in EITHER manual. However, in the newer manual the config parameters ARE listed. Clearly this means that the newer device supports configuration command class, but it still doesnā€™t prove that the older device didnā€™t support the parameters. Itā€™s not uncommon for Chinese manufacturers to have really crappy manuals that donā€™t list configuration parameters. Itā€™s just not possible to say from the information we have. ---
**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\ **Post date:** [June 15, 2019, 9:03am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/26 "2019-06-15T09:03:27Z")
> [@sihui](#): > > Error in the xml or do you need to add this command class to the database? It means the database error checker doesnā€™t know about this channel. It probably means that the importer created the channel incorrectly. It would pay to use what the old device used (sensor\_particulate). ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 9:05am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/27 "2019-06-15T09:05:29Z")
> [@chris](#): > > It would pay to use what the old device used (sensor\_particulate). Okay, all done: non plus device: [https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/244](https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/244) plus device: [https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/1056](https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/1056) ---
**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\ **Post date:** [June 15, 2019, 1:48pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/28 "2019-06-15T13:48:48Z")
Interestingly, there is another device with the same issueā€¦ Myself and @TimScottz8 have been discussing off list the MCO MH8-FC. This seems to have done the same thing - ie there is a newer version that is ZWave Plus, and contains similar parameters to the PM2.5 we were discussing earlier. Currently Tim has updated [the old database entry](https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/336#), but I think we probably should take the same approach as we did above with the PM2.5 as the version Tim has is the Plus version -: [http://manuals-backend.z-wave.info/make.php?lang=en&sku=MCOEMH8-FC&cert=](http://manuals-backend.z-wave.info/make.php?lang=en&sku=MCOEMH8-FC&cert=) I wanted to move this discussion onto the forum so thereā€™s a record of what/why weā€™ve done this šŸ™‚ @sihui how did you differentiate the devices earlier - was it just with the firmware versions? I think we should do the same hereā€¦ ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 3:37pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/29 "2019-06-15T15:37:25Z")
> [@chris](#): > > This seems to have done the same thing Yes, looks like exact the same issue. > [@chris](#): > > how did you differentiate the devices earlier - was it just with the firmware versions? Yes. > [@chris](#): > > I think we should do the same here Would be great to have the xml as a starting poiint šŸ•¶ If it is not available I could add them manually ā€¦ tomorrow šŸ˜€ ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 3:44pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/30 "2019-06-15T15:44:56Z")
> [@chris](#): > > MCO MH8-FC Arghhhh, did it again: unfortunately I hit the ā€œExportā€ button, sorry ā€¦ šŸ•¶ ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 15, 2019, 4:39pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/31 "2019-06-15T16:39:28Z")
> [@chris](#): > > I think we should do the same hereā€¦ Done: non plus device: [https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/336](https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/336) plus device: [https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/1057](https://www.cd-jackson.com/index.php/zwave/zwave-device-database/zwave-device-list/devicesummary/1057) Added a comment to this post as reference, omitted the ā€œExportā€ this time šŸ˜€ As I donā€™t know the device type and id you were talking about I added them all, please remove if necessary. ---
**Author:** ![chris](https://community.openhab.org/letter_avatar_proxy/v4/letter/c/958977/32.png) [@chris](https://community.openhab.org/u/chris)\ **Post date:** [June 15, 2019, 6:22pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/32 "2019-06-15T18:22:19Z")
Thanks @sihui Iā€™ve now merged this all in to the bindingā€¦ ---
**Author:** ![leif](https://community.openhab.org/user_avatar/community.openhab.org/leif/32/38576_2.png) [@leif](https://community.openhab.org/u/leif)\ **Post date:** [June 16, 2019, 5:09am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/33 "2019-06-16T05:09:00Z")
Fantastic (and quick) work, guys! So.. hereā€™s a stupid question. What do I have to do to get the new binding? Iā€™m brand new to openhab, running 2.4 release. I have never updated yet. Any guide / recommendations? Iā€™ve already backed up my entire SSD just in case.. I definitely do not want to lose my setup. ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 16, 2019, 5:12am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/34 "2019-06-16T05:12:04Z")
Uninstall the old zwave binding, download the 2.5 snapshot zwave binding, place it in your addons folder. (this question is asked at least twice a week, so you may find more details through the forum search button). ---
**Author:** ![leif](https://community.openhab.org/user_avatar/community.openhab.org/leif/32/38576_2.png) [@leif](https://community.openhab.org/u/leif)\ **Post date:** [June 18, 2019, 6:54am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/35 "2019-06-18T06:54:07Z")
Thanks, @sihui. I did find details in the forum, and Iā€™ve tried to follow the procedures ā€“ and itā€™s not at all behaving as described! Iā€™m deeply frustrated at this point, please bear with my explanation. Hereā€™s what Iā€™ve done so far. Iā€™m running on a raspberry pi with raspbian, installed through apt-get. - Cloned the entire SSD with clonezilla (as a backup) - Uninstalled the Z-Wave binding in PaperUI - sudo service openhab2 shutdown - rm -rf /var/lib/openhab2/cache - rm -rf /var/lib/openhab2/tmp - Then I placed org.openhab.binding.zwave-2.5.0-SNAPSHOT.jar in /usr/share/openhab2/addons - sudo service openhab2 start ā€¦No Z-wave binding at all. I waited a while, no binding. Then I read some more forum posts and found that I must add it into addons.cfg, so I added it: binding = zwave,ntp,astro Now Z-Wave Binding appears in the Paper UI list, but itā€™s 2.4.0! It did not use the new jar file. On a hunch, I renamed the file to org.openhab.binding.zwave.jar, uninstalled the binding again, and stopped openhab2, deleted cache/tmp, started openhab2 again. STILL installs as 2.4.0! So then I went to the karaf console. bundle, list ZWave binding shows as 2.4.0. So I uninstalled it through karaf. Then looked up help for install. bundle:install [options] urls Okay, so it wants a URL. Fine, Iā€™ll let it download by itself: openhab\> install [https://ci.openhab.org/job/openHAB2-Bundles/lastSuccessfulBuild/artifact/bindings/org.openhab.binding.zwave/target/org.openhab.binding.zwave-2.5.0-SNAPSHOT.jar](https://ci.openhab.org/job/openHAB2-Bundles/lastSuccessfulBuild/artifact/bindings/org.openhab.binding.zwave/target/org.openhab.binding.zwave-2.5.0-SNAPSHOT.jar) It thinks for a while (obviously downloading the JAR file) and then ā€¦ Bundle IDs: Error executing command: Error installing bundles: Unable to install bundle [https://ci.openhab.org/job/openHAB2-Bundles/lastSuccessfulBuild/artifact/bindings/org.openhab.binding.zwave/target/org.openhab.binding.zwave-2.5.0-SNAPSHOT.jar:](https://ci.openhab.org/job/openHAB2-Bundles/lastSuccessfulBuild/artifact/bindings/org.openhab.binding.zwave/target/org.openhab.binding.zwave-2.5.0-SNAPSHOT.jar:) org.osgi.framework.BundleException: A bundle is already installed with the name ā€œorg.openhab.binding.zwaveā€ and version ā€œ2.5.0.201906161432ā€ !!! Now this is when frustration starts to set in. ITā€™S NOT INSTALLED. I just uninstalled it. And what I uninstalled was 2.4.0. WTF. Now Iā€™m not sure exactly what I did ā€“ I thought maybe it was a permissions issue so i chmodā€™ed the jar file to 777 in ā€¦/addons, then i deleted it and downloaded it through wget on the pi (the first time I had copied it over to the pi using samba and then used mc (midnight commander) to copy it to ā€¦/addons). At one point, in the karaf console, Z-Wave binding 2.5.x _did_ show up in the installed bundle list.. but the paper UI still claimed Z-Wave binding 2.4.0. So, I figured it needed a restart, so _sudo service openhab2 restart_ And then **again** it came back up as 2.4.0 (in paper ui) and again as 2.4.0 in karaf bundle list! So, thatā€™s where I am now, with the same joyous feeling of utter defeat I had during my first few days of trying to get openHAB to do anything at allā€¦ Itā€™s _just not working_ for me. How the heck do I get it to accept the 2.5.0 snapshot binding?? Help, please? ///Leif ---
**Author:** ![sihui](https://community.openhab.org/user_avatar/community.openhab.org/sihui/32/55674_2.png) [@sihui](https://community.openhab.org/u/sihui)\ **Post date:** [June 18, 2019, 9:05am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/36 "2019-06-18T09:05:14Z")
> [@leif](#): > > and found that I must add it into addons.cfg No, bad idea, this installs the stable zwave binding as you already found out. Installing through PaperUI oder putting the binding in addons.cfg is the same thing. To fix all your attempts make sure you uninstall the current binding, remove it from PaperUI, remove it from addons.cfg, clear cache and tmp, restart openHAB, check through Karaf if no zwave binding is available. Download the latest 2.5 zwave snapshot binding, put it in your addons folder, check through Karaf if it is in ā€œActiveā€ state. Now there could be two problems if your controller does not show up or your devices are not working: either the serial driver is missing (as a workaround just install the Serial binding, this will install the serial driver dependency) or sometimes the xstream dependency could be missing due to all the recent changes to the openHAB core and the Build system changes, this one can be fixed with: > [@Latest Zwave binding missing module?](https://community.openhab.org/t/latest-zwave-binding-missing-module/73794/13): > > In the Karaf console, what do you see when you run this? list -s | grep xstream In a recent 2.5 snapshot (build 1587), I see this. openhab\> list -s | grep xstream 65 ā”‚ Active ā”‚ 80 ā”‚ 1.4.7.1 ā”‚ org.apache.servicemix.bundles.xstream In an older 2.5 snapshot (build 1502), I see nothing. If this bundle is not installed, try dropping this jar in addons. [http://central.maven.org/maven2/org/apache/servicemix/bundles/org.apache.servicemix.bundles.xstream/1.4.7\_1/org.apache.servicemā€¦](http://central.maven.org/maven2/org/apache/servicemix/bundles/org.apache.servicemix.bundles.xstream/1.4.7_1/org.apache.servicemix.bundles.xstream-1.4.7_1.jar) Now reinitialize your device in question and you should be good to go. ---
**Author:** ![leif](https://community.openhab.org/user_avatar/community.openhab.org/leif/32/38576_2.png) [@leif](https://community.openhab.org/u/leif)\ **Post date:** [June 18, 2019, 11:34am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/37 "2019-06-18T11:34:32Z")
Okay, understanding a bit more now. Itā€™s complaining about an Unresolved requirement: Import-Package: **org.eclipse.smarthome.io.transport.serial** One major pitfall with the karaf console is that if your window is too small to show the entire width of the list, **grep wonā€™t find anything either** because apparently the text is cut off at the head-end, way before it ever gets to the console window?? Thatā€™s just bad, highly counter-intuitive behavior, this tripped me up for a while. So anyway, after fighting this for another _ **hour** _ (seriously, this is like pulling teeth), I googled and found the org.eclipse.smarthome.io.transport.serial package [here](http://ftp.mirrorservice.org/sites/download.eclipse.org/eclipseMirror/smarthome/updates-stable/plugins/) I placed it in openhab2/addons and now finally xstream, serial, and zwave are now all **Active**! But, my Z-Wave Serial Controller now shows OFFLINE - COMMUNICATION\_ERROR: Serial Error: Port{0} does not exist. The selected serial port is /dev/ttyACM0 which is what it has always been. Is that no longer the correct name? ---
**Author:** ![Kim\_Andersen](https://community.openhab.org/letter_avatar_proxy/v4/letter/k/6bbea6/32.png) [@Kim\_Andersen](https://community.openhab.org/u/Kim_Andersen)\ **Post date:** [June 18, 2019, 11:53am UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/38 "2019-06-18T11:53:22Z")
> [@leif](#): > > I placed it in openhab2/addons and now finally xstream, serial, and zwave are now all **Active**! > > But, my Z-Wave Serial Controller now shows OFFLINE - COMMUNICATION\_ERROR: Serial Error: Port{0} does not exist. > > The selected serial port is /dev/ttyACM0 which is what it has always been. > > Is that no longer the correct name? This is unfortunatly an issue with the serial driver and/or openhab 2.5. You can enter the controller and save itĀ“s setting, and it will most probably change to ONLINE again. For some reason all you have to do is to manipulate the setting (and save). wihtout actually change anything. Chris and the rest of the team is aware of this, but untill now there havnĀ“t been any fix. ItĀ“s a real pain in the ass issue, cause youĀ“ll probably have to do this, each time openhab starts, which means, if openhab restarts itself for some reason, and you not available, then youĀ“re zwave devices wont be running ā˜¹ In my opinion, this is a very serious matter. I had to change my controller settings to be using things files, as it makes it easier to ā€œfixā€. But itĀ“s still something I need to do each time I restart openhab. ---
**Author:** ![leif](https://community.openhab.org/user_avatar/community.openhab.org/leif/32/38576_2.png) [@leif](https://community.openhab.org/u/leif)\ **Post date:** [June 18, 2019, 12:00pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/39 "2019-06-18T12:00:50Z")
Thanks for your response, Kim. Ouch! Actually, that wasnā€™t it in my case. It was the way I installed org.eclipse.smarthome.io.transport.serial It wasnā€™t the only file needed. In the end, I deleted it from addons, stopped openhab and deleted the /tmp and /cache for the umpteenth time, and then finally in Karaf: ```auto feature:install openhab-transport-serial ``` After that, suddenly Z-wave 2.5.0 snapshot is working. That only took ALL &#)(%#Ā¤ DAY. Itā€™s working now though. Phew. And the next time it wonā€™t be so hard, but holy crap, maybe this procedure could be made a little easier? ---
**Author:** ![5iver](https://community.openhab.org/user_avatar/community.openhab.org/5iver/32/21201_2.png) [@5iver](https://community.openhab.org/u/5iver)\ **Post date:** [June 18, 2019, 12:07pm UTC](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485/40 "2019-06-18T12:07:38Z")
> [@Kim\_Andersen](#): > > But itĀ“s still something I need to do each time I restart openhab. This should be resolved inā€¦ > > > \* Get all serial port identifiers by calling RXTX with and without using the \`gnā€¦u.io.rxtx.SerialPorts\` property > \* Filter \`getSerialPortIdentifiers()\` stream on distinct port names > \* Fix thread safety issues by saving \`getPortIdentifiers()\` Enumeration result to new list > > Fixes #805 If you donā€™t want to use a snapshot, add all of your ports to EXTRA\_JAVA\_OPTS. > [@leif](#): > > I placed it in openhab2/addons That sounds like trouble. The serial transport is already there, and what you downloaded is probably outdated. After deleting the file, youā€™ll likely need to clear the cache to get rid of it. In Karaf, runā€¦ ``` feature:install org.openhab.transport.serial ``` Here is a script (and documentation if you want to do it all manually) for manually installing the zwave bindingā€¦ > [@Zigbee and zwave manual install script](https://community.openhab.org/t/zigbee-and-z-wave-manual-install-script/50270): > > A number of people have run into trouble performing manual installs of the Zigbee and Z-Wave bindings. A manual install (dropping the jar into addons) is rarely needed, but some people prefer a manual install over apt-get, or want to use a stable OH release with a recent Zigbee or Z-Wave binding. Here is a script that will hopefully make it easier to install, upgrade, and uninstall these bindings, and prevent some of the common issues. Who would benefit from this script: Anyone wanting to tesā€¦ [Previous page](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485.md?page=1) [Next page](https://community.openhab.org/t/unknown-z-wave-device-how-to-proceed/61485.md?page=3)