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.
How to use the ED1 board with Home Assistant.
Available entities
After adding the device, these entities become available:
Lights
| Entity ID | Type | Description |
|---|
light.ed1_led_matrix | RGB Light | 32x8 LED matrix |
Switches
| Entity ID | Type | Description |
|---|
switch.ed1_buzzer | Switch | Buzzer on/off control |
Sensors
| Entity ID | Type | Unit | Description |
|---|
sensor.ed1_light_level | Sensor | % | Ambient light level |
sensor.ed1_wifi_signal | Sensor | dBm | WiFi signal strength |
sensor.ed1_cpu_temperature | Sensor | °C | ESP32 internal temperature |
sensor.ed1_uptime | Sensor | s | Device uptime |
| Entity ID | Type | Description |
|---|
binary_sensor.ed1_button_up | Binary Sensor | Up button |
binary_sensor.ed1_button_down | Binary Sensor | Down button |
binary_sensor.ed1_button_left | Binary Sensor | Left button |
binary_sensor.ed1_button_right | Binary Sensor | Right button |
binary_sensor.ed1_button_ok | Binary Sensor | OK button |
binary_sensor.ed1_button_x | Binary Sensor | X button |
Text
| Entity ID | Type | Description |
|---|
text.ed1_matrix_text | Text | Send text to LED matrix |
Diagnostic
| Entity ID | Type | Description |
|---|
text_sensor.ed1_ip_address | Text Sensor | Device IP address |
Stepper motors (requires stepper package)
| Entity ID | Type | Description |
|---|
number.ed1_motor_1_steps | Number | Set Motor 1 steps (-4096 to +4096) |
number.ed1_motor_2_steps | Number | Set Motor 2 steps (-4096 to +4096) |
button.ed1_motor_1_cw | Button | Motor 1 clockwise 512 steps |
button.ed1_motor_1_ccw | Button | Motor 1 counter-clockwise 512 steps |
button.ed1_motor_2_cw | Button | Motor 2 clockwise 512 steps |
button.ed1_motor_2_ccw | Button | Motor 2 counter-clockwise 512 steps |
button.ed1_motors_stop | Button | Stop motors and power down coils |
IR receiver (logs only)
The IR receiver does not create Home Assistant entities. Received IR codes appear in the ESPHome logs and can be used to trigger automations via ESPHome actions. See ESPHome configuration for configuration details.
Dashboard examples
Basic card
type: entities
title: ED1 Board
entities:
- entity: light.ed1_led_matrix
- entity: text.ed1_matrix_text
- entity: switch.ed1_buzzer
- entity: sensor.ed1_light_level
- entity: sensor.ed1_cpu_temperature
- entity: sensor.ed1_wifi_signal
LED matrix control card
type: vertical-stack
cards:
- type: light
entity: light.ed1_led_matrix
name: LED Matrix
- type: entities
entities:
- entity: text.ed1_matrix_text
name: Display Text
type: glance
title: ED1 Buttons
entities:
- entity: binary_sensor.ed1_button_up
name: Up
- entity: binary_sensor.ed1_button_down
name: Down
- entity: binary_sensor.ed1_button_left
name: Left
- entity: binary_sensor.ed1_button_right
name: Right
- entity: binary_sensor.ed1_button_ok
name: OK
- entity: binary_sensor.ed1_button_x
name: X
Sensor gauges
type: horizontal-stack
cards:
- type: gauge
entity: sensor.ed1_light_level
name: Light
min: 0
max: 100
severity:
green: 50
yellow: 20
red: 0
- type: gauge
entity: sensor.ed1_cpu_temperature
name: CPU Temp
min: 20
max: 80
severity:
green: 40
yellow: 60
red: 70
Automation examples
Display notification on matrix
alias: "Display notification on ED1"
trigger:
- platform: state
entity_id: binary_sensor.front_door
to: "on"
action:
- service: text.set_value
target:
entity_id: text.ed1_matrix_text
data:
value: "DOOR!"
- delay:
seconds: 10
- service: text.set_value
target:
entity_id: text.ed1_matrix_text
data:
value: ""
alias: "ED1 OK button toggles living room"
trigger:
- platform: state
entity_id: binary_sensor.ed1_button_ok
to: "on"
action:
- service: light.toggle
target:
entity_id: light.living_room
alias: "ED1 Up button - next scene"
trigger:
- platform: state
entity_id: binary_sensor.ed1_button_up
to: "on"
action:
- service: input_select.select_next
target:
entity_id: input_select.scene_selector
Light level automation
alias: "Auto lights based on ED1 sensor"
trigger:
- platform: numeric_state
entity_id: sensor.ed1_light_level
below: 30
condition:
- condition: state
entity_id: sun.sun
state: "below_horizon"
action:
- service: light.turn_on
target:
entity_id: light.desk_lamp
Display current time
alias: "Update ED1 with time every minute"
trigger:
- platform: time_pattern
minutes: "/1"
action:
- service: text.set_value
target:
entity_id: text.ed1_matrix_text
data:
value: "{{ now().strftime('%H:%M') }}"
Display weather
alias: "Show weather on ED1"
trigger:
- platform: state
entity_id: weather.home
action:
- service: text.set_value
target:
entity_id: text.ed1_matrix_text
data:
value: "{{ state_attr('weather.home', 'temperature') }}C"
Buzzer alert on motion
alias: "ED1 buzzer on motion"
trigger:
- platform: state
entity_id: binary_sensor.motion_sensor
to: "on"
action:
- service: switch.turn_on
target:
entity_id: switch.ed1_buzzer
- delay:
milliseconds: 200
- service: switch.turn_off
target:
entity_id: switch.ed1_buzzer
Stepper motor control
alias: "Rotate Motor 1 half turn"
trigger:
- platform: state
entity_id: binary_sensor.ed1_button_up
to: "on"
action:
- service: number.set_value
target:
entity_id: number.ed1_motor_1_steps
data:
value: 256 # Half turn (180°)
Open/close with steppers
alias: "ED1 Motor Blinds Control"
trigger:
- platform: state
entity_id: input_boolean.blinds_open
action:
- choose:
- conditions:
- condition: state
entity_id: input_boolean.blinds_open
state: "on"
sequence:
- service: number.set_value
target:
entity_id: number.ed1_motor_1_steps
data:
value: 1024 # Open position
- conditions:
- condition: state
entity_id: input_boolean.blinds_open
state: "off"
sequence:
- service: number.set_value
target:
entity_id: number.ed1_motor_1_steps
data:
value: -1024 # Close position
Scripts
Flash matrix red (alert)
flash_ed1_alert:
alias: "Flash ED1 Matrix Red"
sequence:
- repeat:
count: 5
sequence:
- service: light.turn_on
target:
entity_id: light.ed1_led_matrix
data:
rgb_color: [255, 0, 0]
brightness: 255
- delay:
milliseconds: 200
- service: light.turn_off
target:
entity_id: light.ed1_led_matrix
- delay:
milliseconds: 200
Cycle through colors
ed1_color_cycle:
alias: "ED1 Color Cycle"
sequence:
- service: light.turn_on
target:
entity_id: light.ed1_led_matrix
data:
rgb_color: [255, 0, 0]
- delay:
seconds: 1
- service: light.turn_on
target:
entity_id: light.ed1_led_matrix
data:
rgb_color: [0, 255, 0]
- delay:
seconds: 1
- service: light.turn_on
target:
entity_id: light.ed1_led_matrix
data:
rgb_color: [0, 0, 255]
Bluetooth proxy
The ED1 acts as a Bluetooth proxy, extending Home Assistant’s BLE range.
Setup
- Ensure
bluetooth_proxy is enabled in ESPHome config
- In Home Assistant, go to Settings > Devices & Services
- Bluetooth integration will automatically use the ED1 as a proxy
Use cases
- Detect BLE devices further from HA server
- Track Bluetooth thermometers, plant sensors
- Connect to Bluetooth devices in other rooms
Tips
Reduce API traffic
If the device disconnects frequently, reduce sensor update rates:
sensor:
- platform: wifi_signal
update_interval: 300s # 5 minutes instead of 60s
Entity naming
Entity IDs are derived from name fields. To customize:
sensor:
- platform: internal_temperature
name: "ED1 CPU Temp" # becomes sensor.ed1_cpu_temp
Multiple boards
For multiple ED1 boards, change the device name:
esphome:
name: ed1-kitchen
friendly_name: ED1 Kitchen
