chore: update readme

README.md

@@ -1,11 +1,63 @@
-AS OF RIGHT NOW THIS IS ONLY USEFUL FOR `IBS-M2` POOL SENSOR. It's a hacky approach to limitations with the tuya apigw repo.
+> AS OF RIGHT NOW THIS IS ONLY USEFUL FOR `IBS-M2` POOL SENSOR. It's a hacky approach to limitations with the tuya apigw repo.
 
-# Why
+# Background
 
 This is all just a workaround to a breaking API change: https://github.com/tuya/tuya-device-sharing-sdk/issues/11
 
 I'd ideally like to merge this PR: https://github.com/home-assistant/core/pull/113214
 into the base Tuya integration, but the API change means the non-standard data points aren't available in home assistant.
 
-# What
 I forked an old version of the HA repo, using the legacy Tuya SDK.
+
+# Setup:
+1. This integration reverts the Tuya core integration to use the [tuya-iot-python-sdk](https://github.com/tuya/tuya-iot-python-sdk) which returns the `DP Instruction` set instead of just the `Standard Instruction` so follow it's standard [setup](https://github.com/tuya/tuya-iot-python-sdk)
+
+>I've logged [an issue](https://github.com/tuya/tuya-device-sharing-sdk/issues/11) with the Tuya team, if they merge that I'll be able to merge my [PR](https://github.com/tuya/tuya-device-sharing-sdk/issues/11) into core
+
+2. Toggle the `DP Instruction`
+
+In the cloud portal, the edit pencil on the device card links to the `Change Control Instruction Mode`
+
+![Change Control Instruction](screenshots/device-card.png)
+
+Select `DP Instruction`, you should see the additional value populate.
+
+![DP Instruction](screenshots/instruction-mode.png)
+
+
+# Hardware
+- Sensor: [IBS-M2](https://amzn.to/3wX0Ir3)
+- Switch: [Dwenwils Pool Timer](https://amzn.to/3wX0Ir3)
+
+All in I spent ~$150, the cheapest alternative I could find was ~$650
+
+# Configuration
+I have two of the Dwenwils Pool Timers, one controlling my pump and the other controlling my heater.
+
+## Other Automations
+> Add a variable to detect when the heater was last turned off, configure your pump to stay on (or turn back on) for 20 minutes after the heater was last one. Some heaters say they don't need the pump to remain on, but this will almost certainly increase the longevitiy of your heater
+
+Use the generic_thermostat to control a pool heater
+
+```yaml
+climate:
+  - platform: generic_thermostat
+    name: Pool Heater
+    heater: switch.pool_heater_socket_1
+    target_sensor: sensor.ibs_m2_temperature_2
+    min_temp: 75
+    max_temp: 100
+    ac_mode: false
+    target_temp: 85
+    cold_tolerance: 2.0
+    hot_tolerance: 2.0
+    min_cycle_duration:
+      seconds: 600
+    initial_hvac_mode: "off"
+    away_temp: 80
+    precision: 0.1
+```
+
+# Other Ideas
+1. I'll probably add weather integration that controls the pool temp based on the weather (no point in heating when it's raining or on a particularly cool night or overcast day where we wont want to swim)
+2. I happen to have multiple sensors, instead of having one sit on the shelf I'm going to play with creating a sensor that averages the and is used as the `target_sensor` in the climate control.

info.md

@@ -1,11 +1,63 @@
-AS OF RIGHT NOW THIS IS ONLY USEFUL FOR `IBS-M2` POOL SENSOR. It's a hacky approach to limitations with the tuya apigw repo.
+> AS OF RIGHT NOW THIS IS ONLY USEFUL FOR `IBS-M2` POOL SENSOR. It's a hacky approach to limitations with the tuya apigw repo.
 
-# Why
+# Background
 
 This is all just a workaround to a breaking API change: https://github.com/tuya/tuya-device-sharing-sdk/issues/11
 
 I'd ideally like to merge this PR: https://github.com/home-assistant/core/pull/113214
 into the base Tuya integration, but the API change means the non-standard data points aren't available in home assistant.
 
-# What
 I forked an old version of the HA repo, using the legacy Tuya SDK.
+
+# Setup:
+1. This integration reverts the Tuya core integration to use the [tuya-iot-python-sdk](https://github.com/tuya/tuya-iot-python-sdk) which returns the `DP Instruction` set instead of just the `Standard Instruction` so follow it's standard [setup](https://github.com/tuya/tuya-iot-python-sdk)
+
+>I've logged [an issue](https://github.com/tuya/tuya-device-sharing-sdk/issues/11) with the Tuya team, if they merge that I'll be able to merge my [PR](https://github.com/tuya/tuya-device-sharing-sdk/issues/11) into core
+
+2. Toggle the `DP Instruction`
+
+In the cloud portal, the edit pencil on the device card links to the `Change Control Instruction Mode`
+
+![Change Control Instruction](screenshots/device-card.png)
+
+Select `DP Instruction`, you should see the additional value populate.
+
+![DP Instruction](screenshots/instruction-mode.png)
+
+
+# Hardware
+- Sensor: [IBS-M2](https://amzn.to/3wX0Ir3)
+- Switch: [Dwenwils Pool Timer](https://amzn.to/3wX0Ir3)
+
+All in I spent ~$150, the cheapest alternative I could find was ~$650
+
+# Configuration
+I have two of the Dwenwils Pool Timers, one controlling my pump and the other controlling my heater.
+
+## Other Automations
+> Add a variable to detect when the heater was last turned off, configure your pump to stay on (or turn back on) for 20 minutes after the heater was last one. Some heaters say they don't need the pump to remain on, but this will almost certainly increase the longevitiy of your heater
+
+Use the generic_thermostat to control a pool heater
+
+```yaml
+climate:
+  - platform: generic_thermostat
+    name: Pool Heater
+    heater: switch.pool_heater_socket_1
+    target_sensor: sensor.ibs_m2_temperature_2
+    min_temp: 75
+    max_temp: 100
+    ac_mode: false
+    target_temp: 85
+    cold_tolerance: 2.0
+    hot_tolerance: 2.0
+    min_cycle_duration:
+      seconds: 600
+    initial_hvac_mode: "off"
+    away_temp: 80
+    precision: 0.1
+```
+
+# Other Ideas
+1. I'll probably add weather integration that controls the pool temp based on the weather (no point in heating when it's raining or on a particularly cool night or overcast day where we wont want to swim)
+2. I happen to have multiple sensors, instead of having one sit on the shelf I'm going to play with creating a sensor that averages the and is used as the `target_sensor` in the climate control.