> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glifo.cat/llms.txt
> Use this file to discover all available pages before exploring further.

# ED1 Citilab Board

> ESPHome configuration for integrating the ED1 Citilab ESP32 educational board with Home Assistant.

<img src="https://mintcdn.com/glifocat/BsHIwv1IWmZVQiMv/images/ed1-board.png?fit=max&auto=format&n=BsHIwv1IWmZVQiMv&q=85&s=9a7cd8c4d2ece12b80ad3b7f66d9e745" alt="ED1 Board" width="1280" height="720" data-path="images/ed1-board.png" />

<img src="https://mintcdn.com/glifocat/BsHIwv1IWmZVQiMv/images/ed1-front.png?fit=max&auto=format&n=BsHIwv1IWmZVQiMv&q=85&s=69556f6182be82c81538685a31aa4b1b" alt="ED1 front view showing TFT display and touch buttons" width="1160" height="788" data-path="images/ed1-front.png" />

<img src="https://mintcdn.com/glifocat/BsHIwv1IWmZVQiMv/images/ed1-back.png?fit=max&auto=format&n=BsHIwv1IWmZVQiMv&q=85&s=82e35dafa2253f2928ecf7eb3b2ffe89" alt="ED1 back view showing expansion headers and battery holder" width="1160" height="788" data-path="images/ed1-back.png" />

The [ED1](https://citilab.eu) is a Spanish ESP32-based educational board with a TFT display, LED matrix, capacitive touch buttons, and various sensors. This project provides [ESPHome](https://esphome.io) YAML configurations to integrate it with [Home Assistant](https://www.home-assistant.io/).

## Built-in hardware

* **1.44" TFT display** (ST7735) -- shows device status, IP address, temperature
* **6 capacitive touch buttons** -- exposed as binary sensors
* **Light sensor** -- ambient light percentage
* **Buzzer** -- PWM audio output
* **IR receiver** (38 kHz) -- remote control support
* **WiFi signal and uptime sensors**
* **CPU temperature monitoring**
* **Bluetooth proxy** -- extends Home Assistant BLE range

## Expansion support

These peripherals connect to the board's expansion headers:

* **LED matrix** (WS2812) -- GPIO12 output for LED strips (e.g., 32x8 = 256 LEDs)
* **Stepper motors** (2x 28BYJ-48) -- via MCP23009 I/O expander and ULN2004A drivers

## Board revisions

The ED1 comes in two hardware revisions: Rev 1.0 and Rev 2.3. Core packages work on both revisions, but some peripherals differ between them. See the [hardware overview](/ed1-hoas/hardware/overview) for details.

## Next steps

Head to the [quick start](/ed1-hoas/quick-start) guide to flash your first configuration.