User Tools

Site Tools


supported_hardware:tplink

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
supported_hardware:tplink [2023/03/04 16:23] – [TP-Link/Kasa Device:] added power recovery preset info and new screenshot James Sentmansupported_hardware:tplink [2023/03/04 16:33] (current) – added power recovery preset command James Sentman
Line 8: Line 8:
  
 **Note:** There are many and varied WiFi controllable devices out there. This one is compatible only with devices branded as TP-Link or Kasa. This is not compatible with Sonoff or any other devices that I am aware of. There may be other off brand ones that use the same local network protocol, but I wouldn’t count on it just because they are made to look like the TP-Link devices. **Note:** There are many and varied WiFi controllable devices out there. This one is compatible only with devices branded as TP-Link or Kasa. This is not compatible with Sonoff or any other devices that I am aware of. There may be other off brand ones that use the same local network protocol, but I wouldn’t count on it just because they are made to look like the TP-Link devices.
- 
-====Requirements:==== 
-This plugin requires Python3 which is not part of the standard MacOSX install. If you haven’t already done so for one of the other plugins that also require python3 please download and install that from [[https://www.python.org/downloads/]] 
  
 ====Device Configuration:==== ====Device Configuration:====
Line 75: Line 72:
 Other multi-outlet devices such as the outdoor dual outlet module and the wired outlet devices with each outlet controllable separately will show up as powerstrips with only 2 outlets or however many outlets that they support. Other multi-outlet devices such as the outdoor dual outlet module and the wired outlet devices with each outlet controllable separately will show up as powerstrips with only 2 outlets or however many outlets that they support.
  
 +====Set Power Recovery Preset Scripting Command:====
 +In the section on Kasa Device setup above the setPowerRecoveryPreset command is mentioned. This is the scripting command you can use to change the value for the Unit at any time programatically. Note that this does not actually send anything to the Unit by itself, it just sets the value in the Unit preferences so that the next time an Off is sent to the Unit it can include this value. If the lamp is already off you can then send it an Off command which will not change the visible state of the Bulb but will reset it’s preset level. If the lamp is on you cannot send it the preset except by turning it off or just dimming it to the new level. If the bulb is physically powered off then no changes of any kind can be sent to the lamp. 
  
 +This might be useful if you wanted to set a different power on level for lamps before going to bed vs in the morning and during the day or something similar to that.
  
 +<code>
 +tell xUnit “Name Of Your Kasa Bulb Unit in XTension” to setPowerRecoveryPreset( 75)
 +</code>
  
  
-====Note:==== 
  
-This plugin uses an undocumented protocol to talk to the devices on the local network and therefore does not require internet access or for the devices to be connected to the cloud in order to work. This is the same protocol that the Kasa iOS and Android app use to control the devices when on the same subnet. While I hope it is unlikely, it is possible that they could change this at any moment making the plugin unusable. I would recommend that before updating any devices firmware in the future that you verify either on this site or by experimenting with one device that things continue to work properly. 
  
-====ToDo:==== 
-  * Test with other multi-outlet devices such as the hardwired Electric Outlets that have 2 controllable outlets and the outside dual controllable outlet device. I have an outdoor unit on order which should arrive soon and I’ll be able to verify that these work or work on supporting them in the next version. 
-  * Some of the devices that support KWH tracking can also give historical information for just this day as well as monthly or other intervals. A meta data unit that tracked the usage for the current day and month would be useful. 
-  * A way to reset the KWH usage would be useful. 
-  * Some devices also report the voltage level at the plug. Create an optional meta data unit to track this for supported devices. 
  
 +====Note:====
 +
 +This plugin uses an undocumented protocol to talk to the devices on the local network and therefore does not require internet access or for the devices to be connected to the cloud in order to work. This is the same protocol that the Kasa iOS and Android app use to control the devices when on the same subnet. While I hope it is unlikely, it is possible that they could change this at any moment making the plugin unusable. I would recommend that before updating any devices firmware in the future that you verify either on this site or by experimenting with one device that things continue to work properly.
  
 ===History=== ===History===
   * The TP-Link/Kasa plugin was added as a beta version in XTension build 9.4.26 on 11/15/2019   * The TP-Link/Kasa plugin was added as a beta version in XTension build 9.4.26 on 11/15/2019
   * The automatic discovery interval was removed in version 1.1 of the plugin which was included in XTension build 9.4.28. The discovery would cause units to be lost if it intersected with an actual control or poll of a device. If you need to discover a new device click the Discover New Devices Now button at any time or use the scripting command documented above.   * The automatic discovery interval was removed in version 1.1 of the plugin which was included in XTension build 9.4.28. The discovery would cause units to be lost if it intersected with an actual control or poll of a device. If you need to discover a new device click the Discover New Devices Now button at any time or use the scripting command documented above.
 +  * Added the ability to control the power recovery preset level for Bulbs in XTension 9.5.2 and plugin version 2.0.4 in March of 2023.
supported_hardware/tplink.txt · Last modified: 2023/03/04 16:33 by James Sentman