From 062b0ef0d3f23c8f3ce2bf5d4bb0b05c9e793732 Mon Sep 17 00:00:00 2001
From: pglab-electronics <89299919+pglab-electronics@users.noreply.github.com>
Date: Fri, 14 Feb 2025 21:21:13 +0100
Subject: [PATCH] Add pglab documentation (#31251)

* Add pglab documentation

* only document initial supported device

* update with the right code owner

* update device web links

* update ha release date

* Update device name to uppercase to be consistent with external pglab web site

* Tiny style tweaks

* Move config steps after prereqs

* add integration removal steps

* fix markdown

* tweak capitalization

---------

Co-authored-by: Pierluigi <p.garaventa@gmail.com>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/pglab.markdown | 61 +++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 source/_integrations/pglab.markdown

diff --git a/source/_integrations/pglab.markdown b/source/_integrations/pglab.markdown
new file mode 100644
index 00000000000..c0c989eaa7c
--- /dev/null
+++ b/source/_integrations/pglab.markdown
@@ -0,0 +1,61 @@
+---
+title: PG LAB Electronics
+description: Instructions on how to integrate PG LAB Electronics with Home Assistant.
+ha_category:
+  - Switch
+ha_release: "2025.3"
+ha_iot_class: Local Push
+ha_config_flow: true
+ha_codeowners:
+  - "@pglab-electronics"
+ha_domain: pglab
+ha_platforms:
+  - switch
+ha_integration_type: integration
+---
+
+The **PG LAB Electronics** {% term integrations %} allows you to control [PG LAB Electronics](https://www.pglab.dev/) devices in Home Assistant.
+
+## Supported devices
+
+- [E-BOARD](https://www.pglab.dev/shop/p/e-board): Controller board to interface I2C devices by a local LAN connection.
+- [E-RELAY](https://www.pglab.dev/shop/p/e-relay): 8 Channels relay board controlled by I2C connection.
+- [E-SWITCH]: Coming soon
+
+Each E-BOARD device can be connected to a maximum of 8 E-RELAY boards. E-BOARD can control
+up to 64 relays or 32 shutters or a mixed configuration.
+
+## Prerequisites
+
+- MQTT broker and the [MQTT integration](/integrations/mqtt/) set up in Home Assistant.
+- PG LAB Electronics devices MQTT setting configured to communicate with the MQTT broker.
+
+Once the device is connected to your MQTT broker, it should be discovered by Home Assistant.
+Add PG LAB Electronics integration.
+
+### Device configuration
+
+Configure each PG LAB Electronics devices following these steps:
+
+1. Power the device and connect it to your local network.
+2. From your router, get the IP address of your device (for example: 192.168.1.7).
+3. Connect to the internal device web server with a web browser (**don't** use 'https://...', instead, connect to 'http://192.168.1.7').
+4. Change the default device name. Use a unique, meaningful name such as E_Board_Office, or E_Board_Garden.
+    - **Note:** Every device **MUST** have a unique name.
+5. Set up the MQTT broker address, port number, username, and password.
+6. Save the configuration and restart the device.
+
+{% include integrations/config_flow.md %}
+
+## Supported features
+
+PG LAB Electronics relays, shutters, and switches are supported.
+
+- PG LAB Relays will be added as Home Assistant `switch` entities.
+- The integration will also create diagnostic status sensors, with device different information.
+
+## Removing the integration
+
+This integration follows standard integration removal. No extra steps are required.
+
+{% include integrations/remove_device_service.md %}