Skip to content

Home Assistant TP-Link Easy Smart Switches integration

License

Notifications You must be signed in to change notification settings

lyricnz/tplink_ess

Repository files navigation

TP-Link Easy Smart Switch Integration for Home Assistant

This component queries local TP-Link ESS (Easy Smart Switches) to obtain system information, port status and statistics, VLAN configuration, etc.

tplink_ess

GitHub Release GitHub Activity License

hacs Project Maintenance

Discord Community Forum

This component will set up the following platforms.

Platform Description
binary_sensor Show port connected/disconnected status.
sensor Show info from your TPLink Easy Smart Switch.

example

Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called tplink_ess.
  4. Download all the files from the custom_components/tplink_ess/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "TPLink ESS"
  8. Select either manual configuration (by MAC address) or automatic discovery (by broadcast) and select one
  9. Enter the admin username+password for your switch
  10. Select the Area for the device and click Finish

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines