Clarify readme and changes

Author: timcharper

addons/io/org.openhab.io.homekit/CHANGES.md

@@ -4,7 +4,21 @@
 
 ### Breaking changes
 
-You will need to reconfigure the homekit thermostat mapping values when upgrading to this plugin, in order to set the defaults for the currentHeatingCoolingMode value mappings.
+The following config options have been renamed:
+
+* `org.openhab.homekit:thermostatCoolMode` to `org.openhab.homekit:thermostatTargetModeCool`
+* `org.openhab.homekit:thermostatHeatMode` to `org.openhab.homekit:thermostatTargetModeHeat`
+* `org.openhab.homekit:thermostatAutoMode` to `org.openhab.homekit:thermostatTargetModeAuto`
+* `org.openhab.homekit:thermostatOffMode` to `org.openhab.homekit:thermostatTargetModeOff`
+
+Further, the following required config options have been specified:
+
+* `org.openhab.homekit:thermostatCurrenModeCooling`
+* `org.openhab.homekit:thermostatCurrenModeHeating`
+* `org.openhab.homekit:thermostatCurrenModeOff`
+
+
+You will need to update your homekit configuration accordingly, either by editing your homekit config file, or by editing the configuration for the IO service using the paper UI.
 
 ### Thermostat fixes
 

addons/io/org.openhab.io.homekit/README.md

@@ -22,10 +22,16 @@ Other settings, such as using Fahrenheit temperatures, customizing the thermosta
 org.openhab.homekit:port=9124
 org.openhab.homekit:pin=031-45-154
 org.openhab.homekit:useFahrenheitTemperature=true
-org.openhab.homekit:thermostatCoolMode=CoolOn
-org.openhab.homekit:thermostatHeatMode=HeatOn
-org.openhab.homekit:thermostatAutoMode=Auto
-org.openhab.homekit:thermostatOffMode=Off
+
+org.openhab.homekit:thermostatTargetModeCool=CoolOn
+org.openhab.homekit:thermostatTargetModeHeat=HeatOn
+org.openhab.homekit:thermostatTargetModeAuto=Auto
+org.openhab.homekit:thermostatTargetModeOff=Off
+
+org.openhab.homekit:thermostatCurrentModeHeating=Heating
+org.openhab.homekit:thermostatCurrentModeCooling=Cooling
+org.openhab.homekit:thermostatCurrentModeOff=Off
+
 org.openhab.homekit:networkInterface=192.168.0.6
 ```