From cdac56d6d893d1e49e192c89117a009d9a6f81ea Mon Sep 17 00:00:00 2001 From: "xiaoqiang.yxq" Date: Sat, 19 Apr 2025 21:34:10 +0800 Subject: [PATCH 1/5] Add Rexense integration doc --- source/_integrations/rexense.markdown | 78 +++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 source/_integrations/rexense.markdown diff --git a/source/_integrations/rexense.markdown b/source/_integrations/rexense.markdown new file mode 100644 index 000000000000..600683412264 --- /dev/null +++ b/source/_integrations/rexense.markdown @@ -0,0 +1,78 @@ +--- +title: Rexense +description: "Integrate Rexense IoT Mesh devices" +ha_category: + - Sensor + - Switch +ha_release: 2025.04 +ha_codeowners: + - '@rexense' +ha_iot_class: local_push +ha_domain: rexense +featured: false +ha_config_flow: true +ha_zeroconf: true +ha_platforms: + - sensor + - switch +ha_integration_type: device +--- + +Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. + +## High‑Level Description +The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real‑time sensor data, and switch control. + +## Installation Instructions +1. **Enable default integrations** + In your `configuration.yaml`, add: + ```yaml + default_config: + zeroconf: + ``` +2. **Restart Home Assistant** +3. **Add Rexense** + - Go to **Settings → Devices & Services** + - Click **Add Integration** + - Search for **Rexense** and select it + - Follow the prompts to either auto‑discover your devices or enter **Host** and **Port** manually + +Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. + +## Configuration Options + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Host: + description: "The Hostname or IP address of your Rexense device. You can find it via network scan or router UI." +Port: + description: "Custom TCP port of the device for HTTP basic info. Defaults to 80." +{% endconfiguration_basic %} + +## WebSocket Push Updates +After initial HTTP setup, the integration upgrades the connection to a WebSocket at `/rpc`. Devices push status updates in real time, and Home Assistant entities update immediately. + +## Entities + +### Sensors +For `REX-3PHASEMETER-01` models, the following sensors are created: +- **Phase A/B/C:** Current, Voltage, Active Power, Apparent Power, Power Factor +- **Totals:** Total Active Power, Total Apparent Power, Cumulative Energy Imported/Exported +- **Temperature** + +Each sensor has: +- **Unique ID:** `_` +- **Device & state class** for correct presentation +- **Automatic name** generated from device model and sensor type + +## Removal Instructions +To remove the Rexense integration: +1. Go to **Settings → Devices & Services** +2. Locate **Rexense** and click the trash icon to **Delete** +3. (If you previously ran as a custom component) Delete any `custom_components/rexense` folder +4. Restart Home Assistant + +No further manual cleanup is required; Home Assistant will purge entities and registry entries automatically. + +{% include integrations/remove_device_service.md %} From 264ac36c8318d65be80b72906916000ee5bcd0d8 Mon Sep 17 00:00:00 2001 From: "xiaoqiang.yxq" Date: Tue, 22 Apr 2025 16:20:45 +0800 Subject: [PATCH 2/5] =?UTF-8?q?Fix=20Rexense=20docs:=20sentence=E2=80=91st?= =?UTF-8?q?yle=20headings,=20remove=20duplicate=20removal=20steps,=20corre?= =?UTF-8?q?ct=20include=20syntax?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/_integrations/rexense.markdown | 51 ++++++++++----------------- 1 file changed, 19 insertions(+), 32 deletions(-) diff --git a/source/_integrations/rexense.markdown b/source/_integrations/rexense.markdown index 600683412264..2dc0fc491b93 100644 --- a/source/_integrations/rexense.markdown +++ b/source/_integrations/rexense.markdown @@ -20,59 +20,46 @@ ha_integration_type: device Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. -## High‑Level Description +## High-level description The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real‑time sensor data, and switch control. -## Installation Instructions -1. **Enable default integrations** +## Installation instructions +1. **Enable default integrations** In your `configuration.yaml`, add: ```yaml default_config: zeroconf: ``` -2. **Restart Home Assistant** -3. **Add Rexense** - - Go to **Settings → Devices & Services** - - Click **Add Integration** - - Search for **Rexense** and select it - - Follow the prompts to either auto‑discover your devices or enter **Host** and **Port** manually +2. **Restart Home Assistant** +3. **Add Rexense** + - Go to **Settings → Devices & Services** + - Click **Add integration** + - Search for **Rexense** and select it + - Follow the prompts to either auto-discover your devices or enter **Host** and **Port** manually Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. -## Configuration Options +## Configuration options {% include integrations/config_flow.md %} -{% configuration_basic %} -Host: - description: "The Hostname or IP address of your Rexense device. You can find it via network scan or router UI." -Port: - description: "Custom TCP port of the device for HTTP basic info. Defaults to 80." -{% endconfiguration_basic %} - -## WebSocket Push Updates -After initial HTTP setup, the integration upgrades the connection to a WebSocket at `/rpc`. Devices push status updates in real time, and Home Assistant entities update immediately. +## WebSocket push updates +After initial HTTP setup, the integration upgrades the connection to WebSocket for live updates. Sensor values and switch states are pushed in real time, and Home Assistant entities update immediately. ## Entities ### Sensors For `REX-3PHASEMETER-01` models, the following sensors are created: -- **Phase A/B/C:** Current, Voltage, Active Power, Apparent Power, Power Factor -- **Totals:** Total Active Power, Total Apparent Power, Cumulative Energy Imported/Exported -- **Temperature** +- **Phase A/B/C:** Current, Voltage, Active Power, Apparent Power, Power Factor +- **Totals:** Total Active Power, Total Apparent Power, Cumulative Energy Imported/Exported +- **Temperature** Each sensor has: - **Unique ID:** `_` -- **Device & state class** for correct presentation -- **Automatic name** generated from device model and sensor type - -## Removal Instructions -To remove the Rexense integration: -1. Go to **Settings → Devices & Services** -2. Locate **Rexense** and click the trash icon to **Delete** -3. (If you previously ran as a custom component) Delete any `custom_components/rexense` folder -4. Restart Home Assistant +- **Device & state class** for correct presentation +- **Automatic name** generated from device model and sensor type -No further manual cleanup is required; Home Assistant will purge entities and registry entries automatically. +## Removal instructions {% include integrations/remove_device_service.md %} + From 1cd17a22f2618d66b2e7f3077c3729c206135b61 Mon Sep 17 00:00:00 2001 From: "xiaoqiang.yxq" Date: Tue, 22 Apr 2025 16:35:28 +0800 Subject: [PATCH 3/5] Fix Rexense docs: fix markdown lint and remove duplicate steps --- source/_integrations/rexense.markdown | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/source/_integrations/rexense.markdown b/source/_integrations/rexense.markdown index 2dc0fc491b93..cba2a3eddc35 100644 --- a/source/_integrations/rexense.markdown +++ b/source/_integrations/rexense.markdown @@ -6,7 +6,7 @@ ha_category: - Switch ha_release: 2025.04 ha_codeowners: - - '@rexense' + - @rexense ha_iot_class: local_push ha_domain: rexense featured: false @@ -21,17 +21,24 @@ ha_integration_type: device Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. ## High-level description + The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real‑time sensor data, and switch control. ## Installation instructions + 1. **Enable default integrations** + In your `configuration.yaml`, add: + ```yaml default_config: zeroconf: ``` + 2. **Restart Home Assistant** + 3. **Add Rexense** + - Go to **Settings → Devices & Services** - Click **Add integration** - Search for **Rexense** and select it @@ -39,22 +46,27 @@ The Rexense integration enables Home Assistant to automatically discover and ma Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. + ## Configuration options {% include integrations/config_flow.md %} ## WebSocket push updates + After initial HTTP setup, the integration upgrades the connection to WebSocket for live updates. Sensor values and switch states are pushed in real time, and Home Assistant entities update immediately. ## Entities ### Sensors + For `REX-3PHASEMETER-01` models, the following sensors are created: + - **Phase A/B/C:** Current, Voltage, Active Power, Apparent Power, Power Factor - **Totals:** Total Active Power, Total Apparent Power, Cumulative Energy Imported/Exported - **Temperature** Each sensor has: + - **Unique ID:** `_` - **Device & state class** for correct presentation - **Automatic name** generated from device model and sensor type From 34af4fd52daa9028cae06739d2ac7c7545f19c7c Mon Sep 17 00:00:00 2001 From: "xiaoqiang.yxq" Date: Tue, 22 Apr 2025 16:45:49 +0800 Subject: [PATCH 4/5] Fix Rexense docs: fix markdown lint --- source/_integrations/rexense.markdown | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/source/_integrations/rexense.markdown b/source/_integrations/rexense.markdown index cba2a3eddc35..a61518b007de 100644 --- a/source/_integrations/rexense.markdown +++ b/source/_integrations/rexense.markdown @@ -20,16 +20,16 @@ ha_integration_type: device Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. -## High-level description +## Overview -The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real‑time sensor data, and switch control. +The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real-time sensor data, and switch control. ## Installation instructions 1. **Enable default integrations** In your `configuration.yaml`, add: - + ```yaml default_config: zeroconf: @@ -46,7 +46,6 @@ The Rexense integration enables Home Assistant to automatically discover and ma Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. - ## Configuration options {% include integrations/config_flow.md %} @@ -74,4 +73,3 @@ Each sensor has: ## Removal instructions {% include integrations/remove_device_service.md %} - From c58915bdb5be70316e00a0814385c1551c4b2712 Mon Sep 17 00:00:00 2001 From: "xiaoqiang.yxq" Date: Tue, 22 Apr 2025 16:58:59 +0800 Subject: [PATCH 5/5] Fix Rexense docs: fix markdown lint --- source/_integrations/rexense.markdown | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/source/_integrations/rexense.markdown b/source/_integrations/rexense.markdown index a61518b007de..7a8c70405f47 100644 --- a/source/_integrations/rexense.markdown +++ b/source/_integrations/rexense.markdown @@ -6,7 +6,7 @@ ha_category: - Switch ha_release: 2025.04 ha_codeowners: - - @rexense + - '@rexense' ha_iot_class: local_push ha_domain: rexense featured: false @@ -14,19 +14,18 @@ ha_config_flow: true ha_zeroconf: true ha_platforms: - sensor - - switch ha_integration_type: device --- -Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. +Integrate [Rexense IoT Mesh devices](https://www.rexense.com) into Home Assistant. ## Overview -The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, real-time sensor data, and switch control. +The Rexense integration enables Home Assistant to automatically discover and manage Rexense IoT Mesh devices, providing automated device discovery, and real-time sensor data. ## Installation instructions -1. **Enable default integrations** +1. **Enable default integrations and Zeroconf** In your `configuration.yaml`, add: @@ -35,16 +34,16 @@ The Rexense integration enables Home Assistant to automatically discover and ma zeroconf: ``` -2. **Restart Home Assistant** +2. **Restart Home Assistant** -3. **Add Rexense** +3. **Add Rexense integration** - - Go to **Settings → Devices & Services** + - Go to **Settings → Devices & Services** - Click **Add integration** - Search for **Rexense** and select it - - Follow the prompts to either auto-discover your devices or enter **Host** and **Port** manually + - Follow the prompts to auto-discover devices or enter **Host** and **Port** manually -Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. +Once configured, Home Assistant will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a WebSocket at `/rpc` for live updates. ## Configuration options @@ -52,7 +51,7 @@ Once configured, HA will fetch `/rex/GetBasicInfo` over HTTP then upgrade to a W ## WebSocket push updates -After initial HTTP setup, the integration upgrades the connection to WebSocket for live updates. Sensor values and switch states are pushed in real time, and Home Assistant entities update immediately. +After initial HTTP setup, the integration upgrades the connection to WebSocket for live updates. Sensor values and switch states are pushed in real time, and Home Assistant entities update immediately. ## Entities @@ -73,3 +72,4 @@ Each sensor has: ## Removal instructions {% include integrations/remove_device_service.md %} +