How to update a Swidget Z-Wave 800-series insert from firmware 1.8 to 2.0 in Home Assistant. For what the update changes, see Z-Wave insert firmware: changes by version.
Before you start
- Home Assistant with the Z-Wave integration (Z-Wave JS, or the Z-Wave JS UI add-on). SmartThings can't install firmware on Swidget inserts.
- The insert is on firmware 1.8. Step 2 shows how to check. If it's on 1.7 or older, install firmware 1.8 first with these same steps (download firmware 1.8), then come back and install 2.0. Don't install 2.0 directly on 1.7 or older.
- The 2.0 firmware file. Step 1 has the download link.
- The insert stays powered for the whole update: leave it in its host and leave the circuit on.
Updates are one way. An insert on 2.0 can't be put back on 1.8. Inserts accept only firmware signed by Swidget, so a file from anywhere else is refused. Updating this way keeps the insert in your network with its settings and associations.
Update in Home Assistant
- Download the firmware file: firmware 2.0 (215 KB). The same file works for every Swidget Z-Wave 800-series insert. Save it somewhere you can find it, and don't rename it or unzip anything.
- Find the insert and check its firmware. Go to Settings, Devices & services, Z-Wave, Devices and open the insert. The Device info card shows the firmware version: it should read 1.8. If it reads 1.7 or lower, stop here and install 1.8 first (see Before you start).
- Start the update. In the Device info card, choose Update firmware (in recent versions of Home Assistant it's in the card's menu). Upload the .gbl file from step 1. If a firmware target is shown, leave it at 0. Select Begin firmware update.
- Wait for the transfer. Home Assistant shows the progress. An insert near the hub takes about 5 minutes. One that reaches the hub through other Z-Wave devices takes longer, sometimes 15 minutes or more. You can close the page; the update carries on in Home Assistant. Leave the insert powered, and don't start another update until this one has finished.
- Let the insert restart. When the transfer finishes, the insert checks the file, installs it and restarts by itself. It's back on the network within a minute and Home Assistant reports the update as successful.
- Check the new version. The Device info card now shows firmware 2.0. To see the new settings, open Configure. If they aren't there, choose Re-interview in the Device info card and wait for it to finish.
Using the Z-Wave JS UI add-on instead? Open the insert in its node list, then Advanced, Firmware update OTA, choose the same file and start the update. Steps 4 to 6 are the same.
Long Range
The update doesn't change how an insert is connected. An insert already in your network stays on standard Z-Wave mesh after updating, and keeps working exactly as before.
Home Assistant offers Long Range only when it adds a device by scanning a QR code that lists Long Range, and only with a Long Range-capable controller (an 800-series stick). Long Range is available in the US and Canada.
Inserts sold with 1.x firmware: the QR code on these labels was made for 1.x firmware and doesn't list Long Range, so Home Assistant won't offer Long Range when you scan it. If you're happy on standard mesh, there's nothing to do. To move an insert to Long Range, first update it to firmware 2.0 (older firmware can't join over Long Range). Removing the insert clears its settings and associations and removes it from Home Assistant, so note them before you start:
- Make the code. Open the Swidget Long Range QR code page in your phone's browser, take a photo of the label's QR code (or paste its digits) and select Copy code. It runs in your browser; nothing is uploaded.
- Remove. In Home Assistant, start removing a device. Then hold the insert's button for 5 to 10 seconds, until the LED turns blue, and let go.
- Add. Go to Add device. When the scanner opens, choose More options, pick the option to enter a QR code, paste the code, and choose Long Range. If Home Assistant asks for a PIN, it is the first five digits of the DSK on the insert's label. Then set up its settings and automations again. To go back to standard mesh later, remove the insert and add it again with the QR code on its label.
On Long Range the insert reports only to the hub. Long Range has no direct links between devices, so the insert's association groups and the settings that send commands straight to other devices aren't offered. Automations in Home Assistant work as usual.
If something goes wrong
The update failed or timed out. The insert keeps running its old firmware, so nothing is lost. The usual cause is a weak link to the hub. In the Device info card choose Rebuild routes, wait for it to finish, then start the update again.
The insert refused the file. Inserts accept only Swidget-signed firmware newer than the version they're running. Check that you used the file downloaded in step 1 and that the insert isn't already on 2.0.
The new settings don't appear. Choose Re-interview in the Device info card. Home Assistant then reads the insert's settings list again.
The insert doesn't respond after the update. Give it a few minutes. If it still doesn't respond, pull the insert out of its host, wait ten seconds and push it back in. If that doesn't help, contact support.
Getting help
Email support@swidget.com or use the contact form at swidget.com. Include the insert's model, its firmware version and what Home Assistant showed. For settings, association groups and parameters, see Swidget Z-Wave Inserts: Technical Reference.
Comments
0 comments
Please sign in to leave a comment.