Add Emulated Kasa (#14391)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>

source/_integrations/emulated_kasa.markdown

@@ -0,0 +1,93 @@
+---
+title: Emulated Kasa
+description: Instructions on how to integrate Emulated Kasa within Home Assistant.
+ha_category:
+  - Energy
+ha_iot_class: Local Push
+ha_release: 0.112
+ha_config_flow: false
+ha_codeowners:
+  - '@kbickar'
+ha_domain: emulated_kasa
+---
+
+The Emulated Kasa integration emulates a TP-Link Kasa smart plug and announces the power usage of configured devices to any that might request it on the local network. 
+
+For example, the [Sense Energy Monitor](/integrations/sense) can use this to identify power usage.
+
+The configuration includes a list of entities to expose with attributes for the published name and current power usage.
+If the entity is a sensor or has a `current_power_w` attribute (such as in a smart switch), that value will be reported as the current power usage unless the power field is defined.
+The power field can contain a hardcoded value, a sensor, or a template (see configuration example).
+
+<div class='note'>
+
+The provided power unit must be the current power usage in Watts.  Values of `kW` can be converted, but the values of `kWh` cannot be used.
+
+</div>
+
+## Configuration
+
+This integration requires the entities exposed to be listed in your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+emulated_kasa:
+  entities:
+    light.dining_room:
+      power: 40.2
+```
+
+{% configuration %}
+entities:
+  description: A list of entities exposed.
+  required: true
+  type: map
+  keys:
+    name:
+      description: Name visible to external devices.
+      required: false
+      type: string
+    power:
+      description: The current power usage in watts. This can be set to a static value or a template.
+      required: false
+      type: [integer,float,template]
+    power_entity:
+      description: A sensor measuring the current power usage in watts.
+      required: false
+      type: string
+{% endconfiguration %}
+
+A full configuration sample looks like the one below.
+
+{% raw %}
+```yaml
+# Example configuration.yaml entry
+emulated_kasa:
+  entities:
+    # uses the current_power_w attribute of the switch
+    switch.ac:
+      name: "A/C"
+    # uses the sensor state value
+    sensor.power_meter:
+      name: "Power Meter"
+    # uses static value
+    light.dining_room:
+      name: "Dining Room Lights"
+      power: 40.2
+    # uses template based on state of device
+    fan.ceiling_fan:
+      power: >-
+                {% if is_state_attr('fan.ceiling_fan','speed', 'low') %} 2
+                {% elif is_state_attr('fan.ceiling_fan','speed', 'medium') %} 12
+                {% elif is_state_attr('fan.ceiling_fan','speed', 'high') %} 48
+                {% endif %}
+    # uses value from 3rd party sensor
+    light.wled:
+      name: "Strip Lights"
+      power_entity: sensor.light_power_w
+    # uses template to convert device state into watts
+    sensor.ups_kw:
+      name: UPS Power
+      power: "{{ float(states('sensor.ups_kw')) * 1000 }}"
+```
+{% endraw %}

source/_integrations/sense.markdown

@@ -56,3 +56,9 @@ Sensors are added for both usage and production with the following names:
 Binary sensors are created for each of the devices detected by your Sense monitor to show their power state.
 
 Sensors are created for each of the devices detected by your Sense monitor to show their power usage in Watts.
+
+<div class='note'>
+
+The [Emulated Kasa](/integrations/emulated_kasa) integration can be used to expose devices in Home Assistant to the Sense Monitor by emulating TP-Link Kasa Smart Plugs.
+
+</div>