SOMA pushed a firmware update that lets the SOMA Smart Shades 3 motor join a Zigbee 3.0 network directly — no more SOMA Connect bridge required. Hubitat's built-in Generic Zigbee Shade driver mostly works, but it doesn't handle the motor's quirks around target-position echoes, does not hold opening / closing through travel, and doesn't decode the ZCL Default Response acks.
This is a purpose-built driver that fixes all of that.
Supported devices
| Device | Manufacturer string | Model | Protocol | Status |
|---|---|---|---|---|
| SOMA Smart Shades 3 | WazombiLabs |
SmartShades3 |
Zigbee 3.0 |  Tested |
| SOMA Smart Shades 3 | SOMA |
SmartShades3 |
Zigbee 3.0 | Fingerprint declared, same hardware |
If your motor reports a different manufacturer string, please post the fingerprint line from Get Info → Logs and I'll add it.
Features:
- Full shade control — open, close, set to any position (0–100%), start/stop, and refresh
- Live movement status — the tile shows opening / closing the whole time the shade is moving, not just when you press the button, so dashboards and Rule Machine can react while it's in motion
- Instant final status — when a move finishes, the tile updates to open / closed / partially open right away
- Rock-steady position — no flickering or jumping in the position value while the shade moves
- Clear logs — every command is confirmed in the log (e.g. "ack: Close -> SUCCESS")
- Extra info on the device page — motor speed (as set in the SOMA app), battery voltage, and shade type
- Battery level via the standard Battery capability
- Invert-position toggle for shades mounted in reverse
- Three logging levels (descriptive / debug / trace) for easy troubleshooting
Installation
Option A — Hubitat Package Manager (recommended)
Search for SOMA Smart Shades 3 (Zigbee) driver
Option B — Manual install (works today):
- Hubitat UI → Drivers Code → + New Driver → Import → paste:
https://raw.githubusercontent.com/uDevel/hubitat-soma-shades-3/main/soma-smart-shades-3.groovy
→ Import → Save.
2. In the SOMA phone app, update the motor to the latest firmware and enable Zigbee mode for each shade.
3. In Hubitat: Devices → Add Device → Zigbee → Start Zigbee pairing, then put the SOMA motor into pairing mode (long-press per SOMA's instructions).
4. If the device pairs as a generic "Device", change Type on the device page to SOMA Smart Shades 3 → Save Device → click Configure.
5. Verify with the dashboard tile or by calling refresh from the device page.
[details="Advanced: verify the fingerprint"] On the device page, click Get Info, then open the top-nav Logs page. The driver will print a fingerprint line — if the manufacturer or inClusters don't match either fingerprint in the driver, it's probably a new firmware revision and I'll add yours so future pairings auto-detect. [/details]
Preferences:
- Invert position — flip if your shade reports open when it's actually closed
- Battery report interval — how often the shade reports its battery level (60–1440 min; the shade's own minimum is 1 hour)
- Motion settle timeout — how long to wait after movement stops before locking in the final status (1–30 s, default 3)
Commands table:
| Command | What it does |
|---|---|
| open | Fully open the shade |
| close | Fully close the shade |
| setPosition(0–100) | Move to a specific position (0 = closed, 100 = open) |
| startPositionChange("open" | "close") |
| stopPositionChange | Stop the shade mid-move |
| identify(seconds=30) | Make the motor reveal itself (blink / buzz / jog) — handy when you have several shades |
| readSettings | Pull the shade's current settings into the logs |
| refresh | Re-read position and battery |
| configure | Sets up the shade's reporting — click once after pairing |
Source code
GitHub: GitHub - uDevel/hubitat-soma-shades-3: Hubitat Zigbee driver for the SOMA Smart Shades 3 (WazombiLabs SmartShades3) · GitHub
Raw driver: https://raw.githubusercontent.com/uDevel/hubitat-soma-shades-3/main/soma-smart-shades-3.groovy
License: MIT
Issues, feature requests, and fingerprint contributions are welcome on GitHub Issues.
Related threads
- Soma Smart Shades 3 now supports Zigbee — original community announcement
- Zigbee Window Shade driver with positioning for modules/motors that don't report position — inspiration for some of the UX decisions