Merge pull request #8 from MrSerth/master

Add Fan Control (incl. Rotation Speed, WindFree mode) and Humidity Sensor

README.md

@@ -10,11 +10,23 @@ Homebridge plugin for controlling Samsung Air Conditioner using the [smartthings
      - Make sure you select all scopes in the devices section.
      - Make sure you can see the devices you want to use for the current user, in the ["My Devices" tab](https://account.smartthings.com/).
 5. Copy the token and paste it in the token property of the plugin (config.json).
-6. [Optional] In case your smartthings account returns the temperature in Fahrenheit, set the Temperature unit config property to F and also make sure that your device in HomeKit is also set to Fahrenheit. Otherwise leave the default value for Temperature unit.
+
+## Optional Settings
+
+- In case your smartthings account returns the temperature in Fahrenheit, set the Temperature unit config property to F and also make sure that your device in HomeKit is also set to Fahrenheit. Otherwise leave the default value for Temperature unit.
+- Enable showing the humidity value if desired: The value will be shown as 0% as long as the device is turned off or just started. This is a limitation of the smartthings api.
+- If your Air conditioners support the WindFree option, enable the `windFreeSupported` option (config.json). This allows you to enable the WindFree mode through the "oscillation" settings of the _fan_ while the normal oscillation (fixed vs all directions) is available through the Air conditioner in Apple Home. This changes makes it easier to enable the WindFree mode if the fan and Air conditioner settings are grouped in Apple Home (which is the default if added through Homebridge).
 
 ## Features
 - Import all AC devices in your smartthings account
 - Turning AC on and off
 - Getting and setting target temperature
 - Getting current temperature
-- Getting and setting mode
+- Getting and setting AC mode
+- Turning the fan on and off
+- Getting and setting fan operation mode (manual / automatic)
+- Getting and setting rotation speed of the fan 
+  - A target fan speed of automatic will report with a rotation speed of 0% as the actual rotation speed cannot be determined.
+- Getting and setting oscillation mode
+- Getting and setting WindFree mode (if supported)
+- Getting current humidity (if enabled)

config.schema.json

@@ -22,6 +22,18 @@
         "type": "string",
         "required": true,
         "default": "C"
+      },
+      "showHumidity": {
+        "title": "Show humidity values",
+        "type": "boolean",
+        "required": true,
+        "default": false
+      },
+      "windFreeSupported": {
+        "title": "Enable WindFree support",
+        "type": "boolean",
+        "required": true,
+        "default": false
       }
     }
   }