Introduction
SONOFF Matter-enabled devices allow you to build a seamless, local, and cross-platform smart home experience. While many Matter devices require Thread support, SONOFF offers Wi-Fi-based Matter devices that can connect directly to your network and be integrated with Home Assistant using the Matter integration—no Thread Border Router required.
This guide walks you through connecting SONOFF's Matter over Wi-Fi devices to Home Assistant using its built-in Matter protocol support.
—— Learn More about Matter
Preparation
Before you begin, make sure you have the following ready:
- Home Assistant OS (Make sure you have the latest version of Home Assistant installed).
- In Home Assistant, have the Matter integration installed. (Go to Settings > Devices & Services > Add Integration, and search for "Matter".)
- Home Assistant Companion App on your smartphone.
- Matter-certified device with a QR code or setup code.
- A stable 2.4GHz Wi-Fi network.
Setup Guide
Here I'll show you the process of adding the SONOFF M5 Matter Smart Wall Switch to Home Assistant. Let's follow the steps.
Step 1: Power on Your SONOFF Matter Device
- Install and wire SONOFF M5 Matter
- Power it on — the device enters the pairing mode by default when powered on for the first time, and the LED indicator flashes two short and one long.
Step 2: Add the Device in the Home Assistant App
- Open the Home Assistant app on your phone.
- Go to Settings > Devices & Services.
- Click Add Integration button, search Matter, then select Add Matter device.
In the dialog, select No, it's new..
- Press and hold the M5 Matter button (usually 5–10 seconds) until the LED blinks rapidly to enter the pairing mode.
- Scan the QR code of M5 Matter or select More options… to manually enter the Commission code.
- Click Add to "Home Assistant" button.
This starts the commissioning process, which may take a few minutes
If it is not convenient to scan the QR code on the device, you can also click Enable Pairing Mode in the Device Settings of the eWeLink app to generate a QR code or Copy code.
After adding, you can control and configure M5 Matter in Home Assistant. Start automating!
SONOFF Matter Device List
All SONOFF Matter devices listed below can be directly added to Home Assistant:
|
Category |
Product Name |
|
DIY Smart Switch |
Smart Roller Shutter Switch | MINI-RBS |
|
Wi-Fi Smart Switch (Dry Contact Relay) | MINI-D |
|
|
MINI Extreme Wi-Fi Smart Switch | MINIR4M |
|
|
Smart Wall Switch |
SwitchMan Smart Wall Switch | M5 Matter |
Stay tuned for more SONOFF Matter-compatible devices.
Troubleshooting
Device not found during pairing?
Make sure the device is in pairing mode (LED blinking rapidly).
Check that your Matter device is on the same 2.4GHz Wi-Fi network as Home Assistant.
Reboot your router and Home Assistant if necessary.
Matter Server not working?
Ensure the Matter add-on is started in Home Assistant.
Restart Home Assistant Core and try again.
QR code missing or damaged?
Find the QR code in the product Quick Guide.
Use the numeric setup code (you can find it in the App - Device Settings).
Device added but not responding?
Check IP address and Wi-Fi strength.
Restart the device or re-pair.
FAQ
Q: Do I need a Thread Border Router to use SONOFF Matter devices with Home Assistant?
A: No. SONOFF Matter devices like MINIR4M and M5 Matter connect via Wi-Fi, so no Thread is required.
Q: Is cloud required for Matter integration?
A: No. Once paired with Home Assistant, Matter operates locally without any cloud dependency.
Q: Can I control these devices with both Home Assistant and another platform?
A: Yes, Matter supports multi-admin. After adding to Home Assistant, you can also share the device with Apple Home, Google Home, etc. (as long as the device supports it).
Q: Can I add the same SONOFF Matter device to multiple controllers?
A: Yes. Multi-admin pairing allows a single Matter device to be shared with multiple platforms like Home Assistant, Alexa, or Google Home.
Q: Can I update the firmware of SONOFF Matter devices via Home Assistant?
A: No, you should update it in the eWeLink App.