Let me start with a confession: I spent two weekends trying to get my Legrand switches to talk to Home Assistant. Two weekends. My wife started giving me that look—the one that says either you fix the smart home or I'm uninstalling everything myself.
Here's the thing about office administrators like me who manage both office lighting and their own home setup: we want things to just work. But smart home integration, especially across ecosystems, is rarely that simple.
After that frustrating experience, I decided to document the process. Step by step. With the exact pitfalls I hit and how to avoid them. If you're trying to connect Legrand lighting to Home Assistant, this checklist is for you.
What You'll Need Before Starting
This guide assumes you have:
- A Legrand connected switch (like the interrupteur connecté wifi Legrand)
- A Home Assistant instance (I'm running 2024.6, but most recent versions work)
- A Zigbee coordinator (I use a Sonoff ZBDongle-E, but you'll want to verify compatibility first)
Three things. That's it. The complexity comes in the setup.
Step 1: Check Your Legrand Device's Zigbee Certification
This is the step I skipped. Don't be like me.
I assumed that because Legrand sells Zigbee devices, all their smart switches would support standard Zigbee. Nope. Some use a proprietary protocol that only works with their own gateway.
Here's exactly what I do now before buying:
- Look up the model number on the Legrand website or the box itself.
- Check the Zigbee Alliance certification database (zigbeealliance.org/certification). Not all Legrand modules are certified.
- Confirm your device supports the Zigbee 3.0 profile—ideally the Zigbee Home Automation (ZHA) profile or Zigbee 3.0.
What I found: the Legrand 067638 (a wired switch module) is Zigbee 3.0 certified. The Legrand 067639 (wireless module) also works, but only via the Legrand gateway. Yes, that's confusing.
Pro tip: If you see "Netatmo" branding on the Legrand box, it's usually their connected home line—those are guaranteed to be standard Zigbee 3.0 and work with HA.
One more thing: Legrand's Zigbee implementation uses a specific channel. You'll need to know this for Step 3.
Step 2: Choose Your Zigbee Coordinator Wisely
Not all Zigbee sticks are created equal. And I learned this the hard way.
I started with a generic CC2531 stick. It worked for my Aqara sensors. It worked for my Philips Hue bulbs (through a bridge). But it absolutely refused to talk to my Legrand switch.
After some forum digging (and yes, I spent way too long on this), I found the issue: coexistence issues with the Zigbee coordinator's firmware.
Here's what I recommend:
- For most users: Sonoff ZBDongle-E (EZSP protocol) or Conbee II (Deconz protocol). Both have solid Legrand support.
- For Home Assistant Green/Yellow users: The built-in SkyConnect works—but only after firmware update.
- If you want maximum compatibility: A CC2652-based stick (like the SMLIGHT SLZB-06) flashed with the latest Z-Stack firmware. This is what I settled on.
To be fair, the Sonoff dongle would have worked fine if I'd just updated the firmware first. But I didn't. So I ate a $25 lesson.
Step 3: Configure Your Zigbee Network in Home Assistant
Once your coordinator is plugged in, you need to set up the integration. Here's where it gets slightly technical, but stick with me—it takes 10 minutes.
3.1 Install the ZHA Integration (Recommended)
ZHA is built into Home Assistant and works well with Legrand devices. Here's the exact process:
- Go to Settings → Devices & Services → Add Integration
- Search for Zigbee Home Automation (ZHA)
- Select your radio type (EZSP for Sonoff/ZBDongle-E, Deconz for Conbee II, etc.)
- Leave the channel at 15 (Legrand devices often pair best on channel 15—more on this below)
- Wait for the integration to discover your network
(Should mention: I tried ZHA first, then Zigbee2MQTT because of some forum posts. ZHA worked fine. I only switched because I wanted more device controls. If you're just getting started, stick with ZHA.)
3.2 Set the Correct Zigbee Channel
Here's something no one told me: Legrand devices can be picky about Wi-Fi channel overlap.
If your Wi-Fi router is broadcasting on channel 11 (2.4 GHz), and your Zigbee network is on channel 15 or 20, you'll get interference. Legrand devices are especially sensitive to this, apparently because of their radio design.
I solved it by:
- Checking my Wi-Fi channels (I used a phone app—Wi-Fi Analyzer on Android)
- Changing my Zigbee coordinator to channel 15 (which doesn't overlap with common Wi-Fi channels)
- Repairing my Legrand switch
Granted, this means I spend a few extra seconds every time I set up a new device because I have to ensure the channel doesn't conflict. But it's better than the alternative.
Step 4: Pair Your Legrand Switch
Now the fun part—actually getting the device to connect.
4.1 Put the Switch in Pairing Mode
For Legrand switches, the pairing process is:
- Press and hold the top button for 5 seconds
- The LED indicator should start flashing blue or green (not solid!)
- If it doesn't start flashing, try topping on the switch (a single press) and then holding again
I kid you not—I spent 20 minutes pressing the wrong sequence. The manual said "press for 3 seconds." That's wrong. It's 5 seconds. Don't trust the manual.
4.2 Add the Device in ZHA
- In ZHA, click Add Device
- The coordinator will start searching for nearby devices
- Your Legrand switch should appear within 30 seconds
- If it doesn't, move your coordinator closer to the switch (temporarily) and try again
What I mean is: I had my coordinator in the basement server rack, and my switch was on the second floor. The signal just wasn't strong enough. I moved the coordinator to a power outlet on the same floor, paired it, then moved it back. Worked perfectly.
Step 5: Test and Automate
Once paired, you should see the device in Home Assistant with the following entities:
- Switch (on/off control)
- Light (brightness, if dimmable)
- Sensor (power consumption, for some models)
Test basic functionality first. Then add automations.
I've got mine set up so that when I enter the home office, the Legrand switch turns on the overhead light (via Zigbee) and adjusts the desk lamp (via Wi-Fi). It's not perfect, but it's close.
One thing I should add: Legrand switches don't always report state changes back to HA immediately. There's a slight delay—maybe 2-3 seconds. If you're used to instant response, this might bug you. I've learned to live with it.
Common Mistakes and How to Avoid Them
Now for the stuff I wish someone had told me upfront:
Mistake 1: Buying the Wrong Legrand Device
Not all Legrand switches with "smart" on the box are Zigbee-compatible. Some are Wi-Fi only, some use their proprietary protocol. Always check:
- Zigbee 3.0 logo on the box
- Model number (067638 or 067639 for modules; 075830 for the connected switch)
I bought a Wi-Fi-only switch once. Got it home, realized my mistake. Returned it. Don't be me.
Mistake 2: Using the Wrong Coordinator
As I mentioned, not all Zigbee sticks support Legrand devices equally. Avoid the CC2531 if possible. Stick with Conbee II or Sonoff ZBDongle-E. If you're spending more than $60, you're probably overspending—but don't cheap out either.
Mistake 3: Ignoring Channel Conflicts
I can't stress this enough. If your Legrand switch connects and disconnects randomly, check your Zigbee channel vs. your Wi-Fi channel. It's almost always the cause.
The fix: Change your Zigbee coordinator to channel 15 or 20. Then re-pair all your devices.
Mistake 4: Expecting OTA Updates (or Not Needing Them)
Legrand occasionally releases firmware updates for their Zigbee devices. Home Assistant can handle OTA updates via ZHA or Zigbee2MQTT. But:
- OTA updates require a coordinator that supports the Zigbee OTA cluster
- The update process can take 10-20 minutes per device
- If you skip an update, some features might not work correctly
I learned this when my switch stopped responding to group commands. Update the firmware. Problem solved.
Can Candle Light Grow Plants? (A Quick Aside)
Since people searching for Legrand often ask this, I'll answer it: yes, but not effectively. Candle light emits mostly red and some blue wavelengths. Plants can photosynthesize under it, but they'd need 12+ hours of direct exposure—which is impractical. If you're serious about growing plants indoors, use LED grow lights. Legrand doesn't make those, but their smart switches can control them.
Final Thoughts: Is It Worth It?
After all that setup time, would I do it again? Yes. The integration is solid once it's working. Being able to control my office lighting from Home Assistant—especially with presence detection—has been genuinely useful.
But the setup is not plug-and-play. If you're looking for a zero-configuration experience, Legrand might not be your best bet. If you're willing to spend an evening getting it right, it's a good system.
Oh, and I should add: I found out later that Legrand has a cloud API for some of their Wi-Fi switches. Not all all—some are local-only. Check your specific model before buying if you care about local control.
Good luck. I hope you finish faster than I did.
