From e8b8547d0827e099422ecf996fa026f461a69612 Mon Sep 17 00:00:00 2001 From: Iskra kranj <162285659+iskrakranj@users.noreply.github.com> Date: Mon, 9 Sep 2024 08:57:20 +0200 Subject: [PATCH 1/5] Add iskra documentation (#33422) * Add iskra documentation * terminology fix * Update iskra.markdown * Updated ismra integration documentation * Iskra documentation minor typo fix * Iskra integration documentation minor fix * Iskra integration grammatical error fixes * Update iskra.markdown * tiny tweaks * Update iskra.markdown added sensors table * Update source/_integrations/iskra.markdown Co-authored-by: Joost Lekkerkerker * Update iskra.markdown * Fixed iskra documentation blank lines * Apply suggestions from code review Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/iskra.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- source/_integrations/iskra.markdown | 81 +++++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 source/_integrations/iskra.markdown diff --git a/source/_integrations/iskra.markdown b/source/_integrations/iskra.markdown new file mode 100644 index 000000000000..d0d49c5b9ea4 --- /dev/null +++ b/source/_integrations/iskra.markdown @@ -0,0 +1,81 @@ +--- +title: Iskra +description: Instructions on how to connect your Iskra energy meters to Home Assistant. +ha_release: "2024.10" +ha_category: + - Energy + - Sensor +ha_codeowners: + - '@iskramis' +ha_config_flow: true +ha_domain: iskra +ha_iot_class: local_polling +ha_platforms: + - sensor +ha_integration_type: integration +--- + + +The [Iskra](https://www.iskra.eu/) {% term integration %} allows you to connect Iskra energy meters and power quality analyzers to Home Assistant. Data is polled using Modbus TCP or the Iskra Smart Gateway's REST API. + +## Supported devices + +### Energy meters + +Most Iskra's DIN rail mountable energy meters support Modbus RTU over RS485 and IR. To integrate them, you will need a Modbus TCP gateway or Iskra's Smart Gateway: + +- Impact series ([IE38XX / IE14XX](https://www.iskra.eu/en/Iskra-Energy-meters/)) +- WM series ([WM3XX / WM1XX](https://www.iskra.eu/en/Iskra-Energy-meters/)) + +### Power quality analyzers + +These devices typically support Ethernet connections and use Modbus TCP for data polling: + +- iMT/MT series ([MTXXX / iMTXXX](https://www.iskra.eu/en/NEW_SERIES_Universal_measuring_devices_/)) +- iMC/MC series ([MCXXX / iMCXXX](https://www.iskra.eu/en/NEW_SERIES_Universal_measuring_devices_/)) + +## Configuration options + +There are two ways to configure your devices with Home Assistant: +- [Using a Smart Gateway with REST API](#smart-gateway-with-rest-api) +- [Using a Modbus TCP connection](#modbus-tcp-connection) + +### Smart Gateway with REST API + +If your device supports Modbus RTU over RS485/IR, you can use Iskra's Smart Gateway to connect them via the REST API: + +- **Smart Gateway**: Connect your devices to the Smart Gateway and add your devices to the Smart Gateway's configuration. It's also recommended to set a static IP on your smart gateway. +- **Home Assistant**: Add the Iskra integration, enter the Smart Gateway's **IP address**, and select **RestAPI** as the connection type within the Home Assistant integration. If authentication is required, Home Assistant will prompt you to enter the Smart Gateway's **credentials**. All devices configured on the Smart Gateway will be automatically added to your Home Assistant. + +### Modbus TCP connection + +If your device supports a direct internet connection, such as PQ meters (iMC/MC series/ iMT/MT series usually), you can use Modbus TCP: + +- **Device**: Find your device using the [MiQen](https://www.iskra.si/sl/Programska-oprema/MiQen/) software and configure it to use a static IP. +- **Home Assistant**: Add the Iskra integration, enter the device's **IP address**, and select **Modbus TCP** as the connection type within the Home Assistant integration. Home Assistant will prompt you to enter the Modbus TCP port and Modbus address of your device. + +{% include integrations/config_flow.md %} + +## Sensors + +The integration provides detailed information about power, current, and voltage for each phase. The data is updated every minute. + +| Name | Unit | Description | +| ------------------- | ---- | :-------------------------------------------------------------------------- | +| total_active_power | W | Total active power. | +| total_reactive_power| var | Total reactive power. | +| total_apparent_power| VA | Total apparent power. | +| phase1_power | W | Active power of phase 1. | +| phase2_power | W | Active power of phase 2. | +| phase3_power | W | Active power of phase 3. | +| phase1_voltage | V | Voltage of phase 1. | +| phase2_voltage | V | Voltage of phase 2. | +| phase3_voltage | V | Voltage of phase 3. | +| phase1_current | A | Current of phase 1. | +| phase2_current | A | Current of phase 2. | +| phase3_current | A | Current of phase 3. | +| frequency | Hz | Frequency. | + +## Note + +This integration supports Iskra's energy meters, not Iskra Emeco ones. From 9b397a850ea9295b3f9e11ca46ff112612439037 Mon Sep 17 00:00:00 2001 From: TimL Date: Mon, 9 Sep 2024 17:39:19 +1000 Subject: [PATCH 2/5] Document binary sensors for Smlight integration (#34589) --- source/_integrations/smlight.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/smlight.markdown b/source/_integrations/smlight.markdown index 71495c141fd2..23a655ac8f02 100644 --- a/source/_integrations/smlight.markdown +++ b/source/_integrations/smlight.markdown @@ -46,6 +46,8 @@ The following sensors will be created: - **Zigbee Uptime** - Uptime of Zigbee connection to ZHA/Z2M - **RAM Usage** - Monitor RAM Usage - **FS Usage** - Monitor filesystem usage +- **Ethernet** - Ethernet connection status +- **Wi-Fi** - Wi-Fi connection status The following buttons will be created: From bd4fdeb89940c5bcf1ea2ce812f2de17d56fdcde Mon Sep 17 00:00:00 2001 From: TimL Date: Mon, 9 Sep 2024 17:49:09 +1000 Subject: [PATCH 3/5] Document switch platform for Smlight integration (#34592) * Document switch platform for Smlight integration * Add title --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/smlight.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_integrations/smlight.markdown b/source/_integrations/smlight.markdown index 23a655ac8f02..fec30ece6f43 100644 --- a/source/_integrations/smlight.markdown +++ b/source/_integrations/smlight.markdown @@ -55,3 +55,10 @@ The following buttons will be created: - **Zigbee restart** - Restart Zigbee CCCC2652 or EFR32 chip - **Zigbee flash mode** - Trigger the Zigbee chip into bootloader flash mode so it can be flashed. It is possible to flash Zigbee firmware over a network socket once this is activated. +### Switches + +The following switches will be created: + +- **Disable LEDs** - Disable all LEDs on the SLZB-06x device. +- **LED night mode** - Enables night mode, which turns off the LEDs overnight, based on the times set in SLZB-06x web UI. +- **Auto Zigbee update** - This allows the core firmware on SLZB-06x to manage Zigbee firmware updates and it will automatically install updates when they are released. From 6d01f7bf7bde07f607f8c3628d2664fecc132ec6 Mon Sep 17 00:00:00 2001 From: Matrix Date: Mon, 9 Sep 2024 16:07:53 +0800 Subject: [PATCH 4/5] Update device supports list (#34614) --- source/_integrations/yolink.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/yolink.markdown b/source/_integrations/yolink.markdown index 16589ffdc1e9..cd149290fb03 100644 --- a/source/_integrations/yolink.markdown +++ b/source/_integrations/yolink.markdown @@ -99,6 +99,7 @@ The integration is tested and verified for the following devices from YoLink: - YS5007-UC (FlowSmart Meter) - YS5008-UC (FlowSmart All-in-One) - YS8017-UC (Thermometer) +- YS8008-UC (Float Thermometer) ## Actions From 26ec9c4ddf979aa191beda10fbff8ed44d77c906 Mon Sep 17 00:00:00 2001 From: G Johansson Date: Mon, 9 Sep 2024 10:13:42 +0200 Subject: [PATCH 5/5] Add EcoNet switch platform (#34637) --- source/_integrations/econet.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_integrations/econet.markdown b/source/_integrations/econet.markdown index f036a5c0a76a..8ada75431158 100644 --- a/source/_integrations/econet.markdown +++ b/source/_integrations/econet.markdown @@ -5,6 +5,7 @@ ha_category: - Binary sensor - Climate - Sensor + - Switch - Water heater ha_release: 0.61 ha_iot_class: Cloud Push @@ -16,6 +17,7 @@ ha_platforms: - binary_sensor - climate - sensor + - switch - water_heater ha_integration_type: integration --- @@ -31,6 +33,7 @@ EcoNet devices may be represented by one or more platforms. - [Binary sensor](#binary-sensor) - [Climate](#climate) - [Sensor](#sensor) +- [Switch](#switch) - [Water heater](#water-heater) ### Binary sensor @@ -45,6 +48,10 @@ The EcoNet Climate platform lets you control your EcoNet thermostat. Multi-zone The EcoNet Sensor platform lets you view sensors associated with your EcoNet thermostat or water heater. For example, alert count or available hot water. +### Switch + +The EcoNet Switch platform let's you control the EcoNet thermostat emergency heat. + ### Water heater The EcoNet water heater platform lets you control your EcoNet water heater. Water heaters do not report the current water temperature.