Help Adding XStick2 ZB

Just noticed this thread; I was going to create a new thread and post some notes I made when I went through the exercise of installing XCTU and the Digi XStick2 ZB on a different Windows
machine.

@chickwebb I think the steps you need to do to add the Xstick to your Hubitat mesh are covered in the last two paragraph of this post (setting the Extended PAN ID of your Hubitat mesh in XCTU and putting the hub in join mode ); at least that's how I swap the Xstick between Zigbee PANs.

So here goes:

When I got my Xstick around 2016 or so, I followed this very helpful SmartThings community post to do the setup:

Since then I've migrated the setup to a new PC and updated XCTU a few times; I'm not sure if those updates have affected the procedure described in that forum post. So I decided to do it completely from scratch on a laptop that never had XCTU installed before. I did get it working and I've listed the steps I followed below; hopefully with a combination of these and the old forum post you can get a brand new one going. Since my stick had previously been configured, I suspect that the steps I outline may not be 100% complete (for example, when I redid install of XCTU I didn't have to re-enter the Trust Center link key, as I describe below; it had already been configured).

Note that one thing from the 2015 SmartThings community post that is now missing is the XML settings file that ST community member JohnR provided; the link he hosted it from is no longer live. I have looked for it on my PC and can't seem to locate it (the PC I did the original install from is long gone). I suspect that it would likely contain the setup for the default Zigbee Trust Center Link key (this is the 'well known' key that is used during device joins to encrypt and transfer the actual unique link key that a particular hub uses for its individual PAN). My stick worked without doing this when I did the re-install, but I think you will need to enter it ("it" being the string 5A6967426565416C6C69616E63653039 ) in the KY field of the 'Security' section of the 'Working Modes > Configuration Working Mode' screen. That can be done when the rest of the setup is complete.

Make sure your Digi Xstick2 is the ZB version; that means it will support Zigbee as opposed to some other 802.15.4 protocol.

  • D/L and begin the install of XCTU from digi.com XCTU
    I chose XCTU V.6.5.12 Windows X86 x64; I skipped the 'USB for Cellular' install link shown when at the start of the install.

  • You'll get a popup saying 'could not install USB RF drivers, please install manually'; note the directory shown in the popup. When the install completes, go to the listed directory that was displayed and execute the .exe file there to install the USB RF drivers. I had my Xstick already inserted in a USB port during the install; when the USB RF driver install completed, its yellow light began blinking.

  • Start XCTU; you'll see two icons in the upper left (one has a green '+' sign, the other a magnifying glass). Click on the one with the magnifying glass. This opens 'Discover Radio Devices', select 'COM3' port and 'Next'. Then select 'Finish'; wait for several seconds the Xstick will be found. In the box that popped up click on 'Add selected devices'.

Xstick will now be shown in the left pane; it may say 'Function 23A7 Not Found in XCTU' (though a brand new stick may not at this point; mine did since it had previously been configured to use the required 23A7 function on another machine).

  • Click on the blue box and it will (probably) say 'could not find a firmware... do you want to update the radio firmware library?" Choose 'Install Legacy firmware'... it will do it. The Xstick blue box should now show "Function: Zigbee Router API'.

Note again that if the preceding steps above don't play out for you like that, it is likely because my stick was already configured when I made the notes from this reinstall.. you may find guidance in the 2015 post from ST user JohnR that would be pertinent for a brand new Xstick install as it describes a firmware update step that I didn't have to redo.

  • Now you need to 'add' the device to the PAN ID you want to scan; to do this select 'Working Modes > Configuration Working Mode' and paste the Extended PAN ID (from your hub's Zigbee details screen) ino the 'ID PAN ID' field and click on the 'pencil' icon. Click on 'profile > create config profile > next > next > create profile' to save it (if you later swap between hubs, you can reload a PAN ID profile in this way to scan different Zigbee networks}.

  • To scan the mesh, choose 'Working Modes > Network Working Mode' and on the right pane choose 'Scan'. If you get a popup saying 'cant find neighbors' you just need to put the hub into 'Add Zigbee device' mode; when it joins the PAN ID the Xstick's yellow light will blink and you should get 'found Zigbee device' on the hub's UI. You may need to stop and start the scan again once you've added the stick to the network; you should then see a series of scan passes; the routers should show up quickly but it may take many passes for all your end devices to eventually show up, especially when they have long check-in intervals (like buttons).

4 Likes