Troubleshooting

Discovery

This plugin discovers devices by sending out a discovery packet over broadcast UDP to port 9999. TP-Link devices should be listening on port 9999 for this packet and should respond. You can test this by using the tplink-smarthome-api command line tool. If you are not seeing a device you expect, you may want to try modifying the broadcast address to match your network's subnet. For example 192.168.0.255, 10.255.255.255, etc. If you needed to change the default broadcast address, then you will also want to change the configuration for this plugin to match.

Preferably run this on the same machine you are running homebridge:

1. Install tplink-smarthome-api:
   • npm install --global tplink-smarthome-api
2. Run search command:
   • tplink-smarthome-api search
3. If your device is not found you can try modifying the broadcast address from the default of 255.255.255.255:
   • tplink-smarthome-api search --broadcast 192.168.0.255

Example output:

Searching...
startDiscovery({
  discoveryInterval: 2000,
  discoveryTimeout: 10000,
  breakoutChildren: true,
  broadcast: '255.255.255.255'
})
KL430(US) bulb IOT.SMARTBULB 10.0.1.178 9999 57F2BEC0BD48 801222BAA511374991036875D0A280AD1D35A16F KL430
HS110(US) plug IOT.SMARTPLUGSWITCH 10.0.1.238 9999 1199491D5251 80064D5B31A829A388155ADA551103C21833EB96 Hs110 v1
LB130(US) bulb IOT.SMARTBULB 10.0.1.35 9999 40C5C8CD4D01 801279C8E7092E3AF5FEDCB54056CE6E185998AA Lb130
HS110(US) plug IOT.SMARTPLUGSWITCH 10.0.1.214 9999 9A7D24ECF2FA 8006FF769E5C9248D4E4266B3B1344D8173F7DCA Hs110 v1.1
HS100(US) plug IOT.SMARTPLUGSWITCH 10.0.1.37 9999 74321F3203EA 80061DB94A7B919930FA4AE280CBDC9F1749CD14 Hs100
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Plug 1
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Plug A
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Plug 3
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Testing 25
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Testing 8
HS300(US) plug IOT.SMARTPLUGSWITCH 10.0.1.136 9999 5C859CBBC5D5 8006579C4910F870CEB5F25F972EBD561AA33F02 Testing 87
HS105(US) plug IOT.SMARTPLUGSWITCH 10.0.1.41 9999 CEC09E9B9FEB 80066A3C8B9500CF3B95D595FDEF005B18AF176A Hs105 v2