[renault] Renault more channels and HVAC ON / toggle charge mode

bundles/org.openhab.binding.renault/README.md

@@ -1,43 +1,132 @@
 # Renault Binding
 
-This binding allow MyRenault App. users to get battery status and other data from their cars.
+This binding allows MyRenault App. users to get battery status and other data from their cars. 
+They can also heat their cars by turning ON the HVAC status and toggle the car's charging mode.
 
-A binding that translates the [python based renault-api](https://renault-api.readthedocs.io/en/latest/) in an easy to use binding. 
+The binding translates the [python based renault-api](https://renault-api.readthedocs.io/en/latest/) in an easy to use openHAB java binding. 
 
 
 ## Supported Things
 
 Supports MyRenault registered cars with an active Connected-Services account.
 
-This binding can only retrieve information that is available in the the MyRenault App.
+This binding can only retrieve information that is available in the MyRenault App.
 
 
 ## Discovery
 
 No discovery
 
+
 ## Thing Configuration
 
 You require your MyRenault credential, locale and VIN for your MyRenault registered car.
 
-| Parameter         | Description                            | Required |
-|-------------------|----------------------------------------|----------|
-| myRenaultUsername | MyRenault Username.                    | yes      |
-| myRenaultPassword | MyRenault Password.                    | yes      |
-| locale            | MyRenault Location (language_country). | yes      |
-| vin               | Vehicle Identification Number.         | yes      |
-| refreshInterval   | Interval the car is polled in minutes. | no       |
-
-## Channels
+| Parameter         | Description                                                                | Required |
+|-------------------|----------------------------------------------------------------------------|----------|
+| myRenaultUsername | MyRenault Username.                                                        | yes      |
+| myRenaultPassword | MyRenault Password.                                                        | yes      |
+| locale            | MyRenault Location (language_country).                                     | yes      |
+| vin               | Vehicle Identification Number.                                             | yes      |
+| refreshInterval   | Interval the car is polled in minutes.                                     | no       |
+| updateDelay       | How long to wait for commands to reach car and update to server in seconds.| no       |
 
-Currently all available channels are read only:
-
-| Channel ID   | Type          | Description                     |
-|--------------|---------------|---------------------------------|
-| batterylevel | Number        | State of the battery in %       |
-| hvacstatus   | Switch        | HVAC status switch              |
-| image        | String        | Image URL of MyRenault          |
-| location     | Location      | The GPS position of the vehicle |
-| odometer     | Number:Length | Total distance travelled        |
 
+## Channels
 
+| Channel ID             | Type               | Description                                     | Read Only |
+|------------------------|--------------------|-------------------------------------------------|-----------|
+| batteryavailableEnergy | Number:Energy      | Battery Energy Available                        | Yes       |
+| batterylevel           | Number             | State of the battery in %                       | Yes       |
+| chargingmode           | String             | Charging mode. always_charging or schedule_mode | No        |
+| chargingstatus         | String             | Charging status                                 | Yes       |
+| chargingremainingtime  | Number:Time        | Charging time remaining                         | Yes       |
+| plugstatus             | String             | Status of charging plug                         | Yes       |
+| estimatedrange         | Number:Length      | Estimated range of the car                      | Yes       |
+| odometer               | Number:Length      | Total distance travelled                        | Yes       |
+| hvacstatus             | String             | HVAC status HVAC Status (ON, OFF, PENDING)      | No        |
+| hvactargettemperature  | Number:Temperature | HVAC target temperature (19 to 21)              | No        |
+| externaltemperature    | Number:Temperature | Temperature outside of the car                  | Yes       |
+| image                  | String             | Image URL of MyRenault                          | Yes       |
+| location               | Location           | The GPS position of the vehicle                 | Yes       |
+| locationupdated        | DateTime           | Timestamp of the last location update           | Yes       |
+
+
+## Limitations
+
+Some channels may not work depending on your car and MyRenault account.
+
+The "externaltemperature" only works on a few cars.
+
+The "hvactargettemperature" is used by the hvacstatus ON command for pre-conditioning the car. 
+This seams to only allow values 19, 20 and 21 or else the pre-conditioning command will not work.
+
+
+## Example
+
+renaultcar.sitemap:
+
+```
+sitemap renaultcar label="Renault Car" {
+    Frame {
+        Image item=RenaultCar_ImageURL
+        Default item=RenaultCar_BatteryLevel icon="batterylevel"
+        Default item=RenaultCar_BatteryEnergyAvailable icon="energy"
+        Default item=RenaultCar_PlugStatus icon="poweroutlet"
+        Default item=RenaultCar_ChargingStatus icon="switch"
+        Selection item=RenaultCar_ChargingMode mappings=[SCHEDULE_MODE="Schedule mode",ALWAYS_CHARGING="Instant charge"] icon="switch"
+        Default item=RenaultCar_ChargingTimeRemaining icon="time"
+        Default item=RenaultCar_EstimatedRange
+        Default item=RenaultCar_Odometer
+        Selection item=RenaultCar_HVACStatus mappings=[ON="ON"] icon="switch"
+        Setpoint item=RenaultCar_HVACTargetTemperature minValue=19 maxValue=21 step=1 icon="temperature"
+        Default item=RenaultCar_LocationUpdate icon="time"
+        Default item=RenaultCar_Location
+    }
+}
+```
+
+![Sitemap](doc/sitemap.png)
+
+If you do not have a smart charger and want to limit the charge of the battery you can set up an  active 15 minute charge schedule in the MyRenault App.
+Then create a Dimmer item "RenaultCar_ChargeLimit" and set it to 80% for example. This rule will change the RenaultCar_ChargingMode to schedule_mode when the limit is reached.
+This stops charging after the battery level reaches the charge limit.
+
+ChargeRenaultCarLimit Code
+
+```
+configuration: {}
+triggers:
+  - id: "1"
+    configuration:
+      itemName: RenaultCar_BatteryLevel
+    type: core.ItemStateUpdateTrigger
+  - id: "3"
+    configuration:
+      itemName: RenaultCar_ChargeLimit
+    type: core.ItemStateUpdateTrigger
+  - id: "4"
+    configuration:
+      itemName: RenaultCar_PlugStatus
+    type: core.ItemStateUpdateTrigger
+conditions: []
+actions:
+  - inputs: {}
+    id: "2"
+    configuration:
+      type: application/vnd.openhab.dsl.rule
+      script: >-
+        if ( RenaultCar_PlugStatus.state.toString == 'PLUGGED' ) {
+          if ( RenaultCar_BatteryLevel.state as Number >= RenaultCar_ChargeLimit.state as Number ) {
+            if (RenaultCar_ChargingMode.state.toString == 'ALWAYS_CHARGING' ) {
+              RenaultCar_ChargingMode.sendCommand("SCHEDULE_MODE")
+            }
+          } else {
+            if (RenaultCar_ChargingMode.state.toString == 'SCHEDULE_MODE' ) {
+              RenaultCar_ChargingMode.sendCommand("ALWAYS_CHARGING")
+            }
+          }
+        }
+    type: script.ScriptAction
+
+```

bundles/org.openhab.binding.renault/src/main/java/org/openhab/binding/renault/internal/RenaultBindingConstants.java

@@ -30,9 +30,18 @@ public class RenaultBindingConstants {
     public static final ThingTypeUID THING_TYPE_CAR = new ThingTypeUID(BINDING_ID, "car");
 
     // List of all Channel ids
+    public static final String CHANNEL_BATTERY_AVAILABLE_ENERGY = "batteryavailableenergy";
     public static final String CHANNEL_BATTERY_LEVEL = "batterylevel";
+    public static final String CHANNEL_CHARGING_MODE = "chargingmode";
+    public static final String CHANNEL_CHARGING_STATUS = "chargingstatus";
+    public static final String CHANNEL_CHARGING_REMAINING_TIME = "chargingremainingtime";
+    public static final String CHANNEL_ESTIMATED_RANGE = "estimatedrange";
+    public static final String CHANNEL_EXTERNAL_TEMPERATURE = "externaltemperature";
     public static final String CHANNEL_HVAC_STATUS = "hvacstatus";
+    public static final String CHANNEL_HVAC_TARGET_TEMPERATURE = "hvactargettemperature";
     public static final String CHANNEL_IMAGE = "image";
     public static final String CHANNEL_LOCATION = "location";
+    public static final String CHANNEL_LOCATION_UPDATED = "locationupdated";
     public static final String CHANNEL_ODOMETER = "odometer";
+    public static final String CHANNEL_PLUG_STATUS = "plugstatus";
 }

bundles/org.openhab.binding.renault/src/main/java/org/openhab/binding/renault/internal/RenaultConfiguration.java

@@ -27,4 +27,5 @@ public class RenaultConfiguration {
     public String locale = "";
     public String vin = "";
     public int refreshInterval = 10;
+    public int updateDelay = 30;
 }