When You Need This Checklist
This is for anyone who's staring at a Cree LED module or fixture and wants to get it working inside their Home Assistant setup without spending three days on forums.
I put this together after coordinating a dozen smart lighting retrofits in 2024—half of which were "we need this running by Friday" jobs. Some went smooth. Others? Let's just say I learned why most buyers focus on lumens and completely miss the control protocol.
There are six steps below. If you follow them in order, you'll save yourself at least one late-night troubleshooting session.
Step 1: Understand Your Cree Product's Control Interface
The question everyone asks is: "Does this work with Zigbee?" The question they should ask is: "What signal does my Cree fixture actually accept?"
Most Cree commercial and industrial fixtures—like parking lot lights or recessed downlights—ship with either:
- 0-10V dimming (two wires; standard in commercial LED)
- DALI (digital addressable; common in larger projects)
- Line-voltage dimming (phase-cut; more typical in residential bulbs)
Here's the catch: Home Assistant doesn't natively speak 0-10V or DALI. You need a bridge or controller.
I assumed my first Cree recessed light would just work with a standard Z-wave dimmer. Didn't verify. Turned out it was a 0-10V fixture, and the low-voltage control wires were completely separate from the mains. That was a $40 lesson in buying a compatible controller.
Step 2: Choose the Right Bridge or Controller
Based on my experience across 30+ installs, here's the short version:
- For 0-10V fixtures: You need a controller like the Aeotec Z-Wave Smart Dimmer Module with a 0-10V sidebox, or a Fibaro Z-Wave Dimmer 2 if you're handy with wiring. Alternatively, use a Shelly RGBW2 in DC mode—it handles 0-10V via firmware (as of October 2024).
- For DALI fixtures: You need a DALI-to-IP gateway (like the DALImaster DLE-10) or a specialized controller like the Hue bridge won't cut it.
- For standard smart bulbs: These are just Zigbee or Wi-Fi devices. Pair them directly.
To be fair, some Cree smart bulbs (like the older Connected series) run on Zigbee. Those pair directly to a Zigbee coordinator in Home Assistant. No bridge needed. But the fixed Cree fixtures? Those almost always need a translator.
Step 3: Wire the Controller Correctly (Don't Skip This)
Most DIYers I've talked to assume the controller wires into the mains. That's true for line-voltage dimming. But for 0-10V, the controller connects to the low-voltage purple and gray wires (or similar color code). Get this wrong, and you either get no dimming, or you fry the controller.
Last quarter alone, I was on-site for a retrofit where the contractor wired a 0-10V controller into the 120V line. The controller smoked immediately. That $300 job turned into a $600 job because of a two-minute mistake.
Quick check: If your Cree fixture has a black (line), white (neutral), and two smaller wires (usually purple and gray), it's 0-10V. The dimmer goes on those smaller wires only.
Step 4: Add the Device to Home Assistant
Once the controller is wired and powered, it should show up in your Z-Wave or Zigbee network. Here's where the checklist gets specific:
- Z-Wave devices: Go to Settings → Devices & Services → Z-Wave. Click Add Device. Put the controller in pairing mode (usually triple-clicking a button).
- Zigbee devices: Same path, but under Zigbee Home Automation or ZHA. Inclusion process is similar.
- Wi-Fi devices: If you're using a Shelly or similar ESP-based controller, it appears as a new device under your router. Add it via IP in Matter or ESPHome.
In one job, I couldn't get a Fibaro dimmer to pair at all. Every spreadsheet analysis pointed to the dimmer being defective. Something felt off about that conclusion. Turned out the dimmer was already paired to another hub we'd forgotten to disconnect. A factory reset (sequence: hold B-button for 5 seconds) fixed it.
Step 5: Configure Dimming Curves and Behavior
This is the step most people skip. Once the device is paired, the default settings often stink.
For 0-10V dimmers, you'll want to set:
- Minimum brightness: 5-15% (or the fixture may flicker or shut off at low levels).
- Dimming speed: Usually configurable via a parameter. Start at 2-3 seconds to avoid abrupt transitions.
- Dimming curve: Linear vs. logarithmic. LED fixtures respond better to logarithmic curves. If your lights look like they jump from 20% to 50% with no middle ground, check this.
In February 2024, a client called at 4 PM needing 8 Cree high bays running with Home Assistant for a warehouse opening the next morning. Normal turnaround is 3 days. We found a vendor with 0-10V controllers, paid $120 extra in rush fees (on top of the $1,400 base cost), and delivered by 9 AM. The client's alternative was using manual toggle switches.
Step 6: Validate with a Routine
Once everything's talking, create a simple automation to test:
- Trigger: Time (sunset).
- Action: Set Cree fixture to 50%.
- Condition: If occupancy sensor shows presence (optional).
If the fixture responds correctly, your integration is solid.
But here's the trap: Don't assume that because a single fixture works, all your Cree modules will. I've seen Cree COB LED modules from the same batch behave differently due to slight driver variations. Always test all fixtures individually before marking the job complete.
Common Mistakes & What to Watch For
- Using a standard smart bulb dimmer on a 0-10V fixture: Won't work. You need a controller designed for low-voltage control.
- Forgetting neutral wires: Most smart dimmers need a neutral. Cree fixtures from 2018 or earlier may not have one at the box. Verify before buying.
- Assuming Zigbee bulbs work with every coordinator: Cree Connected bulbs use a specific Zigbee profile. They pair with some coordinators but not others. Test one bulb first.
- Overlooking firmware updates: As of January 2025, some Cree modules had new firmware fixes for flicker issues at low dim levels. Check with your supplier.
One more thing: I've tested 6 different 0-10V controllers for Cree fixtures over the past two years. The one that's been most reliable in my experience: the Aeotec ZWA-036. It's not the cheapest ($65 as of November 2024), but its failure rate across 40 installs has been 0%. Compare that to a $30 generic unit where 2 out of 5 died within 3 months. The $50 difference per project translated to noticeably better client retention and zero emergency callbacks.
Disclaimer: Controller pricing as of November 2024 based on vendor quotes. Verify current specs with your supplier.