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>
This commit is contained in:
pglab-electronics 2025-02-14 21:21:13 +01:00 committed by GitHub
parent c82183023f
commit 062b0ef0d3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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 %}