Add incomfort climate, sensor and binary_sensor (#9654)

* add incomfort climate, sensors

* tweak text

* add automation example

* tweak text

* ✏️ Tweak

source/_components/incomfort.markdown

@@ -10,25 +10,56 @@ footer: true
 logo: incomfort.png
 ha_category:
   - Water heater
+  - Climate
+  - Sensor
+  - Binary sensor
 ha_release: 0.93
 ha_iot_class: Local Polling
 ---
 
-The `incomfort` integration links Home Assistant with your Intergas Lan2RF gateway for controlling water_heater devices (the hub does not have to be in the same network as HA).
+The `incomfort` integration links Home Assistant with your Intergas Lan2RF gateway for integrating the boiler and any room thermostats attached to it.
 
-The **Water Heater** device will report back the `state` and `temperature`. Other properties are available via the device's attributes.
+The boiler is represented as a **Water Heater** device. It will report the boiler's `state` and `temperature` (current temperature). The gateway does not expose any means to directly control the boiler or change its configuration.
 
-In the future, other entities will be added to this integration (e.g. a **Sensor** for CV pressure, and a **Climate** device for room temperature).
+Note that the `temperature` will switch between the CV and Tap temperatures according to the current operating mode of the boiler.  If the boiler is neither pumping nor tapping, it will be reported as the higher of the two.
+
+Any room thermostats (there can be 0, 1 or 2) are represented as **Climate** devices. They will report the thermostat's `target_temperature` (setpoint) and `current_temperature` and the setpoint can be changed.
+
+In addition, there is a **Sensor** for CV pressure, CV temperature, and Tap temperature, and a **Binary Sensor** that will be `on` if there is a fault with the boiler (the fault code will be a state attribute).
+
+To send an alert if the CV pressure is too low or too high, consider the following automation:
+
+{% raw %}
+```yaml
+- alias: Low CV Pressure Alert
+  trigger:
+    platform: numeric_state
+    entity_id: sensor.cv_pressure
+    below: 1.0
+  action:
+  - service: notify.pushbullet_notifier
+    data_template:
+      title: "Warning: Low CH Pressure"
+      message: >-
+        {{ trigger.to_state.attributes.friendly_name }}
+        is low, {{ trigger.to_state.state }} bar.
+```
+{% endraw %}
+
+Other properties are available via each device's attributes.
 
 ### {% linkable_title Configuration %}
 
 To add your Lan2RF gateway into your Home Assistant installation, add one of the following to your `configuration.yaml` file.
 
+Older gateways do not require user authentication:
+
 ```yaml
 # Example configuration.yaml entry, older firmware with no user credentials
 incomfort:
   host: IP_ADDRESS
 ```
+
 Alternatively, if a **username** & **password** is printed on the back of the gateway:
 
 ```yaml
@@ -39,17 +70,19 @@ incomfort:
   password: PASSWORD
 ```
 
+The hub does not have to be in the same network as HA.
+
 {% configuration %}
 host:
-  description: The hostname/IP address of the Lan2RF gateway
+  description: The hostname/IP address of the Lan2RF gateway.
   required: true
   type: string
 username:
-  description: The username of the Lan2RF gateway
+  description: The username of the Lan2RF gateway, if any.
   required: inclusive
   type: string
 password:
-  description: The password of the Lan2RF gateway
+  description: The password of the Lan2RF gateway, if any.
   required: inclusive
   type: string
 {% endconfiguration %}