Update README.md

README.md

@@ -1,39 +1,46 @@
 # Futurehome Home Assistant add-on
 
-Futurehome add-on for Home Assistant. The add-on aims to be a complete drop-in replacement for the official Futurehome app, implementing support for all Futurehome-supported device types.
+Futurehome add-on for Home Assistant. Designed to be a complete drop-in replacement for the official Futurehome app, with support for all device types compatible with the Futurehome hub.
+
+![Home Assistant screenshot](https://raw.githubusercontent.com/adrianjagielak/home-assistant-futurehome/refs/heads/master/assets/home_assistant_screenshot_dark_mode.jpg#gh-dark-mode-only)
+![Home Assistant screenshot](https://raw.githubusercontent.com/adrianjagielak/home-assistant-futurehome/refs/heads/master/assets/home_assistant_screenshot_light_mode.jpg#gh-light-mode-only)
 
 ## Features
 
-This plugin:
+This add-on:
 
-* Fetches all devices metadata from Futurehome hub and maps them to Home Assistant Devices/Entities.
-* Fetches and updates devices state.
-* Fetches and updates devices availability.
-* Supports interacting with the devices as well as the official Futurehome app did.
-* Supports pairing new Zigbee/Z-Wave/Futurehome devices (if an offchance you used any third party integration like Phillips Hue you will be able to interact with it as long as its paired with the hub. However it's recommended to directly use the appropriate Home Asisstant integration for such devices).
+* Fetches all device metadata from the Futurehome hub and maps them to Home Assistant devices/entities.
+* Fetches and updates device states.
+* Fetches and updates device availability.
+* Supports interaction with devices comparable to the official Futurehome app.
+<!--
+todo: pairing
+-->
+* Supports pairing of new Zigbee, Z-Wave, and Futurehome devices (work-in-progress).  
+  (If you’ve previously used third-party integrations—e.g. Philips Hue—you can still interact with those devices, as long as they're paired with the hub. However, it's generally recommended to use the appropriate Home Assistant integration directly for such devices.)
 
 ## Installation
 
-1. Configure Local API in Smarthub settings in Futurehome app.
-2. Block internet access (WAN) for the hub in your router settings (optional, but strongly recommended to block any future hub firmware updates).
-4. In Home Assistant enable MQTT integration.
-5. [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fadrianjagielak%2Fhome-assistant-futurehome)
-6. Search for "Futurehome" in add-on store.
-7. Install, configure, and run Futurehome add-on.
-
+1. In the Futurehome app, go to Smarthub settings and [enable Local API](https://support.futurehome.no/hc/no/articles/360033256491-Local-API-access-over-MQTT-Beta).
+2. (Optional but highly recommended) Block the hub’s internet (WAN) access in your router settings to prevent future firmware updates.
+3. In Home Assistant, enable the **MQTT** integration.
+4. [Add this add-on repository to Home Assistant](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fadrianjagielak%2Fhome-assistant-futurehome).
+5. Open the **Add-on Store** and search for "Futurehome".
+6. Install, configure, and start the Futurehome add-on.
 
 # Futurehome Device Services Compatibility Chart
 
-This chart lists all services supported by the Futurehome hub, along with their current implementation status.  
+This chart lists all services supported by the Futurehome hub, along with their current implementation status.
 
 Devices commonly consist of multiple services: for example, a presence sensor might expose a `sensor_presence` service with a `presence` (true/false) value, and also a `battery` service if it is battery-powered.
 
-Some services are more common than others. Some are deprecated entirely.
+Some services are more common than others; some are deprecated entirely.
 
-todo links to the .ts service implementations below
+<!--
+todo: links to the .ts service implementations below
+-->
 
-| Service | Example device | Implementation status |
-| --- | --- | --- |
+<!--
 | alarm_appliance | | |
 | alarm_burglar | | |
 | alarm_emergency | | |
@@ -49,38 +56,27 @@ todo links to the .ts service implementations below
 | alarm_water | | |
 | alarm_water_valve | | |
 | alarm_weather | | |
-| appliance | | |
+ -->
+
+| Service | Example device | Implementation status |
+| --- | --- | --- |
+| _alarms_ services | [Brannvarsler](https://www.futurehome.io/en_no/shop/brannvarsler-230v) | |
 | barrier_ctrl | | |
 | basic | | ✅ |
 | battery | | ✅ |
-| blinds | | |
-| boiler | | |
 | chargepoint | [Futurehome Charge](https://www.futurehome.io/en_no/shop/charge) | |
 | color_ctrl | | ✅ |
 | complex_alarm_system | | |
 | door_lock | |  |
 | doorman | | |
-| fan | | |
 | fan_ctrl | | ✅ |
-| fire_detector | | |
-| garage_door | | |
-| gas_detector | | |
-| gate | | |
-| heat_detector | | |
-| heat_pump | | |
-| heater | | |
-| input | | |
-| leak_detector | | |
-| light | | |
+| light | | ✅ |
 | media_player | | |
-| meter | | |
 | meter_elec | [HAN-Sensor](https://www.futurehome.io/en/shop/han-sensor) | |
-| meter_gas | | |
-| meter_water | | |
-| out_bin_switch | | ✅ |
+| out_bin_switch | [16A Puck Relé](https://www.futurehome.io/en_no/shop/puck-relay-16a) | ✅ |
 | out_lvl_switch | [Smart LED Dimmer](https://www.futurehome.io/en_no/shop/smart-led-dimmer-polar-white) | ✅ |
 | power_regulator | | |
-| scene_ctrl | | ✅ |
+| scene_ctrl | [Modusbryter](https://www.futurehome.io/en_no/shop/modeswitch-white) | ✅ |
 | sensor_accelx | | ✅ |
 | sensor_accely | | ✅ |
 | sensor_accelz | | ✅ |
@@ -122,22 +118,54 @@ todo links to the .ts service implementations below
 | sensor_wattemp | | ✅ |
 | sensor_weight | | ✅ |
 | sensor_wind | | ✅ |
-| siren | | |
 | siren_ctrl | | |
 | thermostat | [Thermostat](https://www.futurehome.io/en_no/shop/thermostat-w) | ✅ |
 | user_code | | |
-| virtual_meter_elec | | |
 | water_heater | | |
-| water_valve | | |
 
-| gateway | | |
-| sensor | | |
-| association | | |
-| diagnostic | | |
-| indicator_ctrl | | |
-| ota | | |
-| parameters | | |
-| technology_specific | | |
-| time | | |
-| version | | |
-| dev_sys | | |
+## Services that are deprecated, unused, or removed in newer versions of the system.
+
+| Service | Implementation status |
+| --- | --- |
+| appliance | |
+| blinds | |
+| boiler | |
+| fan | |
+| fire_detector | |
+| garage_door | |
+| gas_detector | |
+| gate | |
+| heat_detector | |
+| heat_pump | |
+| heater | |
+| input | |
+| leak_detector | |
+| meter | |
+| meter_cooling | |
+| meter_gas | |
+| meter_heating | |
+| meter_water | |
+| sensor | |
+| siren | |
+| water_valve | |
+
+## Virtual, unnecessary services (easily reproduced in stock Home Assistant)
+
+| Service | Implementation status |
+| --- | --- |
+| virtual_meter_elec | |
+
+## System or meta, not essential services
+
+| Service | Implementation status |
+| --- | --- |
+| gateway | |
+| association | |
+| diagnostic | |
+| indicator_ctrl | |
+| ota | |
+| parameters | |
+| technology_specific | |
+| time | |
+| version | |
+| dev_sys | |