Update README.md (#175)

Author: reedy

README.md

@@ -1,6 +1,6 @@
 # <img src="https://brands.home-assistant.io/sigen/dark_icon.png" alt="Sigenergy" width="50" style="vertical-align:Left;" />  Sigenergy ESS Integration for Home Assistant
 
-[![Stable][releases-shield]][releases] [![HACS Badge][hacs-badge]][hacs-link] ![Project Maintenance][maintenance-shield] [![GitHub Activity][commits-shield]][commits] [![License][license-shield]](LICENSE.md)
+[![Stable][releases-shield]][releases] [![HACS Badge][hacs-badge]][hacs-link] ![Project Maintenance][maintenance-shield] [![GitHub Activity][commits-shield]][commits] [![License][license-shield]](LICENSE)
 
 <!-- ![Downloads][downloads]  -->
 
@@ -15,36 +15,39 @@
 [hacs-link]: https://hacs.xyz/
 
 ## Overview
-Monitor and control your Sigenergy Energy Storage System (ESS) from Home Assistant. 
+Monitor and control your Sigenergy Energy Storage System (ESS) from Home Assistant.
 
 ## Features
 - **UI‑Driven Setup** with DHCP discovery of inverters and chargers
-- **Dynamic Device Management** (Plants, Inverters, AC/DC Chargers)  
-- **Real‑Time Metrics** for power flows, energy statistics, SoC/SoH  
-- **Control Capabilities** for EMS work modes and more
+- **Dynamic Device Management** (Plants, Inverters, AC/DC Chargers)
+- **Real‑Time Metrics** for power flows, energy statistics, SoC/SoH
+- **Control Capabilities** for EMS (energy management system) work modes and more
 - **Configurable update interval** in three update frequencies for faster updates
 
 ## Enhance with Add-ons
 Take your setup further with community add-ons and tools:
-- Si-GCG "sigenergy_projects": https://github.com/Si-GCG/sigenergy_projects
+- [Si-GCG "sigenergy_projects"](https://github.com/Si-GCG/sigenergy_projects)
 
-More add-ons and enhancements are coming—stay tuned.
+More add-ons and enhancements are coming; stay tuned!
 
 ## Requirements
-- Sigenergy ESS firmware SPC109 or newer is required starting with integration v1.1.0. If your device runs older firmware and does not auto-update, upgrade the firmware or use a previous integration release until updated.
-- [Home Assistant](https://www.home-assistant.io/) at least version 2025.2
-- [Sigenergy ESS](https://www.sigenergy.com/) with Modbus‑TCP enabled by your installer. And prefferably confirmed with a screenshot of your DeviceID. If using AC Charger, that will have the id `1` and the inverter has to be set to a higher ID, for example `2`.
-- Prefferably assign a **static IP** to your Sigenergy device in your router to ensure it always receives the same IP address.
+- Sigenergy ESS firmware `SPC109` or newer is required starting with version `v1.1.0` of the integration. If your device runs older firmware and does not auto-update, upgrade the firmware or use a previous integration release until you have updated the firmware.
+- [Home Assistant](https://www.home-assistant.io/) at least version `2025.2`.
+- [Sigenergy ESS](https://www.sigenergy.com/) with Modbus‑TCP enabled by your installer. And preferably confirmed with a screenshot of your `DeviceID`. If using an AC Charger, that will have the id `1` and the inverter has to be set to a higher ID, for example `2`.
+- Preferably assign a **static IP** to your Sigenergy device in your router to ensure it always receives the same IP address.
 
 ## Installation
 ### HACS (Recommended)
-1. Go to **HACS > Integrations** in Home Assistant  
-2. Search and install **Sigenergy ESS Integration**   
+
+[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=TypQxQ&repository=Sigenergy-Local-Modbus&category=Integration)
+
+1. Go to **HACS > Integrations** in Home Assistant
+2. Search and install **Sigenergy ESS Integration**
 3. Restart Home Assistant
 
 ### Manual
-1. Download the latest `.zip` from the [Releases](https://github.com/TypQxQ/Sigenergy-Local-Modbus/releases) page  
-2. Extract and copy `custom_components/sigen` into your HA `custom_components/` folder  
+1. Download the latest `.zip` from the [Releases](https://github.com/TypQxQ/Sigenergy-Local-Modbus/releases) page
+2. Extract and copy `custom_components/sigen` into your HA `custom_components/` folder
 3. Restart Home Assistant
 
 ## Configuration & Usage
@@ -55,46 +58,50 @@ Plant (IP:Port)
    ├─ Inverter 1 (ID 2)
    │    └─ DC Charger (via Inverter 2)
    ├─ Inverter 2 (ID 3)
-   └─ AC Charger (ID 1) ** Is 1 by default and very hard to change ** 
+   └─ AC Charger (ID 1) ** Is 1 by default and very hard to change **
 ```
 
-
 ### Initial Setup (Discovery)
 ![Discovered Sigenergy System](docs/images/discovery_demo.png)
 1. Navigate to **Settings > Devices & Services**
-2. If your Sigenergy device is discovered automatically on the network, it will appear under **Discovered**.  
-    If not discovered, try unplugging and replugging the network cable of your Sigenergy system.  
-    If discovery still fails, see the [Troubleshooting](#troubleshooting) section below.
-> Controls are **read-only by default**. To enable control features, you must explicitly activate them in the integration configuration **and** allow them in Home Assistant. This precaution helps prevent unintended changes or adverse effects.
+2. If your Sigenergy device is discovered automatically on the network, it will appear under **Discovered**.
+    * If not discovered, try unplugging and replugging the network cable of your Sigenergy system.
+    * If discovery still fails, see the [Troubleshooting](#troubleshooting) section below.
 
+> [!NOTE]
+> Controls are **read-only by default**. To enable control features, you must explicitly activate them in the integration configuration **and** allow them in Home Assistant. This precaution helps prevent unintended changes or adverse effects.
 
 ### Manual Initial Setup
 1. Navigate to **Settings > Devices & Services > Add Integration**
-2. Search for **Sigenergy**  
-3. If discovered, click **Configure**; otherwise select manually  
-4. Enter **Host IP**, **Port** (default 502), and first **Device ID**  
+2. Search for **Sigenergy**
+3. If discovered, click **Configure**; otherwise select manually
+4. Enter **Host IP**, **Port** (default 502), and first **Device ID**
 5. Add additional Inverters/Chargers via the same Plant entry
 
 ### Reconfiguration & Options
-1.  Navigate to **Settings > Devices & Services**.
-2.  Find your **Sigenergy** integration entry and click **Configure**.
-3.  From the configuration menu, you can:
-    *   Adjust **Plant** settings (e.g., read-only, refresh intervals).
-    *   Modify settings for individual **Inverters** or **Chargers**.
-> While it is technically possible to assign different IP addresses and ports to devices, it is not advised. For best results and reliable operation, all devices within a plant should use the same IP address and port.
+1. Navigate to **Settings > Devices & Services**.
+2. Find your **Sigenergy** integration entry and click **Configure**.
+3. From the configuration menu, you can:
+    * Adjust **Plant** settings (e.g., read-only, refresh intervals).
+    * Modify settings for individual **Inverters** or **Chargers**.
+
+> [!NOTE]
+> While it is technically possible to assign different IP addresses and ports to devices, it is not advised. For best results and more reliable operation, all devices within a plant should use the same IP address and port.
 
 ### Add Additional Devices
 
-1. Navigate to **Settings > Devices & Services**.  
-2. Select the **Sigenergy** integration and click **Add Device**.  
-3. Follow the prompts to add extra inverters, chargers, or a new plant.  
+1. Navigate to **Settings > Devices & Services**.
+2. Select the **Sigenergy** integration and click **Add Device**.
+3. Follow the prompts to add extra inverters, chargers, or a new plant.
 
 ## Entities & Controls
 
-**Plant Entities:** active/reactive power, PV power, SoC, grid flows, EMS mode  
-**Inverter Entities:** MPPT metrics, battery SoC/SoH, phase data  
-**AC Charger:** charging power, total energy, system state  
-**Controls:** EMS work modes are exposed via `select` entities, and optional `button`/`switch` controls are available.  
+* **Plant Entities:** active/reactive power, PV power, SoC, grid flows, EMS mode
+* **Inverter Entities:** MPPT metrics, battery SoC/SoH, phase data
+* **AC Charger:** charging power, total energy, system state
+* **Controls:** EMS work modes are exposed via `select` entities, and optional `button`/`switch` controls are available
+
+> [!NOTE]
 > Controls are **read-only by default** unless  explicitly enabled in the integration configuration.
 
 ## Quickstart Automation Example
@@ -118,17 +125,17 @@ action:
 - Check Home Assistant logs for `sigen` errors.
 
 ## Contributing
-Contributions welcome!  
-1. Fork the repo and create a branch  
-2. Add tests under `tests/components/sigen/`  
-3. Follow Home Assistant coding and config‑flow patterns  
-4. Submit a Pull Request
+Contributions welcome!
+1. Fork the repo and create a branch
+2. Add tests under `tests/components/sigen/`
+3. Follow Home Assistant coding and config‑flow patterns
+4. Submit a Pull Request to this repository
 
 ## Support & Links
-- Issues: https://github.com/TypQxQ/Sigenergy-Local-Modbus/issues  
-- Discussions: https://github.com/TypQxQ/Sigenergy-Local-Modbus/discussions  
-- Add-ons & tools: https://github.com/Si-GCG/sigenergy_projects  
-- HACS docs: https://hacs.xyz/
+- [Issues](https://github.com/TypQxQ/Sigenergy-Local-Modbus/issues)
+- [Discussions](https://github.com/TypQxQ/Sigenergy-Local-Modbus/discussions)
+- [Add-ons & tools](https://github.com/Si-GCG/sigenergy_projects)
+- [HACS docs](https://hacs.xyz/)
 
 ## License
-MIT License © [Andrei Ignat]
+[MIT License © [Andrei Ignat]](LICENSE)