TP-Link Omada
tplink_omada
The TP-Link Omada integration allows you to control your TP-Link Omada SDN Devices such as network switches, access points, and internet gateways.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
Omada controllers work by local polling; enabling 2FA on the controller account breaks the integration.
- Works5
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| TP-Link ER7212PC Omada gateway | Works | PoE port control added for integrated gateway and switchSaved copyProposed change Adding control of PoE ports on integrated Omada Gateway+Switch devices like the ER7212PC. Annoyingly, this required a bit more rework than I expected because PoE control is a port configuration API, whereas the other control switches act on the port status API. While Excerpt saved from GitHub on 2026-10-23. | PR #114138 · 2024-03 | |
| TP-Link Omada OC200 | Works | Listed as supported controller in the docsSaved copySupported devices: OC200; OC220; OC300; Software Controller. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| TP-Link Omada OC220 | Works | Listed as supported controller in the docsSaved copySupported devices: OC200; OC220; OC300; Software Controller. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| TP-Link Omada OC300 | Works | Listed as supported controller in the docsSaved copySupported devices: OC200; OC220; OC300; Software Controller. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| TP-Link Omada Software Controller | Works | Listed as supported controller in the docsSaved copySupported devices: OC200; OC220; OC300; Software Controller. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| TP-Link Omada OC200 with 2FA | Not working | 2FA login breaks the integration; 2FA now required for local login on newer firmwareSaved copyThe problem Implemented the required Omada 2FA Authentication using MS Authenticator. Integration error states Two-factor authentication required for local user (-30165). I have functional local and cloud control, both ask for a @FA code. Realize the HA integration won't work with cloud control. Was previously working before transition. Appreciate any help you can provide. ### What version of Home Assistant Core has the issue? 2024.7.3 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration … Excerpt saved from GitHub on 2026-10-23. | Issue #122309 · 2024-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 3,444 (0.49%) |
|---|---|
| Quality scale | Bronze |
| Added in | Home Assistant 2023.3 |
| Set up in the UI | Yes |
| Maintainers | @MarkGodwin |
Devices listed in its documentation
- OC200
- OC220
- OC300
- Software Controller
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
