zorruno/zorruno-homeassistant
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

yaml layout updates to v1.x

Browse Source
This commit is contained in:
root
2026-02-25 21:05:21 +13:00
parent 61b0c64a1e
commit a8d2927274
44 changed files with 6521 additions and 4689 deletions
Download Patch File Download Diff File Expand all files Collapse all files
esphome/esp-lounge6chdimmer.yaml
+158 -127
View File
@@ -1,69 +1,75 @@
##########################################################################################
##########################################################################################
# 4 Channel DMX Mains Dimmer
# This is using an esp8366 (D1 Mini) sending DMX512 Serial to a trio of 2 channel
# mains lighting contollers (1.2A/Channel)
#
# Contoller: https://www.aliexpress.com/item/32838426377.html
# RS-485 TTL converter: https://www.aliexpress.com/item/1005005737922222.html
#
#:########################################################################################:#
# TITLE: 6 CHANNEL LOUNGE DMX MAINS DIMMER
# zorruno.com layout v1.0 2026
#:########################################################################################:#
# VERSIONS:
# V1.1 2025-09-13 Extended to 3 modules and installed
# V1.0 2025-09-06 First Rev (only tested one module, 2 channels at this stage, and incandescent)
##########################################################################################
#:########################################################################################:#
# HARDWARE:
# - ESP8266 D1 Mini Pro
# - 3 x 2-channel DMX mains dimmer modules (1.2 A per channel)
# Contoller: https://www.aliexpress.com/item/32838426377.html
# - RS-485 TTL converter (MAX485 style)
# RS-485 TTL converter: https://www.aliexpress.com/item/1005005737922222.html
#
# NOTES
# ------
# - Trialling with an incandescent bulb, 10% writes 26. Max value is 255 so this is 10%
# - With an incandescent, I can't see any light output below about 15%
# - Using GPIO2 as the UART TX on an ESP8266 is handy, as the onboard LED flashes with TX
# - The dimmer needs to be set to DMX mode, and given an ID of 1-999 (not standalone or dynamic)
# - there is no reason you can't run many dimmers off one ESP (limit may be in data speed lags?)
# - The dimmer is pretty smooth, and it remembers values even if no data being transmitted.
# - On my system, I am restoring all channels to ON. Power is controlled by a (smart) wallswitch
# so if all networks fail, switching the switch will power these on and restore to full brightness.
# MAX485 Module (You could also use a MAX3485 which is 3.3 V)
# - MAX485 VCC -> ESP +5V
# - MAX485 GND -> ESP GND
# - MAX485 DE -> ESP +5V
# - MAX485 RE -> Pullup so can leave unconnected (or +5V) or a designated enable_pin
# - MAX485 DI -> ESP GPIO2 (ESP8266) or GPIO5 (ESP32)
# - MAX485 A -> XLR 3 (DMX +)
# - MAX485 B -> XLR 2 (DMX -)
# - MAX485 GND -> XLR 1 (DMX GND)
#:########################################################################################:#
# OPERATION NOTES:
# - ESP8266 transmits DMX512 over UART (one-way TX only) via RS-485 adaptor
# - Dimmer modules must be set to DMX mode and assigned a fixed ID (1-999)
# - Incandescent trial notes:
# - 10% writes ~26 (max 255)
# - Very low levels may not visibly output below ~15%
# - Using GPIO2 as UART TX on ESP8266 is handy, as the onboard LED flashes with TX
# - Dimmers are smooth and remember values even if DMX data stops transmitting
# - This design assumes mains power is controlled by a smart wall switch:
# - If networks fail, toggling power restores the dimmer outputs (and this YAML restores channels to ON)
#
# System Settings on Dimmer: (onboard buttons M and < held for 2 secs)
# ------
# - Set "1 Channel" (d-1) and both channels will output the same levels. Or "2 Channel" (d-2)
# - Set reverse phase dimming/trailing edge (C-R) or Forward/Leading Edge (C-F)
# - Set minimum brightness on the dimmer, from b01-b40. Min is then 5% if b01
# - Set the 3x 8 Segment display to automatically turn off (Bon/BoF) after a period
# - pull both DE & RE high on the 485 converter to ensure data enabled (or wire to enable_pin)
#
# MAX485 Module (You could also use a MAX3485 which is 3.3V)
# ------
# MAX485 VCC -> ESP +5V
# MAX485 GND -> ESP GND
# MAX485 DE -> ESP +5V
# MAX485 RE -> Has a pullup so can leave unconnected, (or +5V)or an designated enable_pin
# MAX485 DI -> ESP32 GPIO5 or ESP8266 GPIO2
# MAX485 A -> XLR 3 (DMX +)
# MAX485 B -> XLR 2 (DMX -)
# MAX485 GND -> XLR 1 (DMX GND)
# - Set "1 Channel" (d-1) and both channels output the same level, or "2 Channel" (d-2)
# - Set reverse phase dimming / trailing edge (C-R) or forward / leading edge (C-F)
# - Set minimum brightness on the dimmer, from b01-b40 (b01 gives ~5% min)
# - Set the 3x 8 segment display to automatically turn off (Bon/BoF)
# - Pull both DE and RE high on the 485 converter to ensure data enabled (or wire enable_pin)
#
# Other useful references
# ------
# - Arduino DMX Controller https://www.youtube.com/watch?v=4PjBBBQB2m4
# - ESP32 DMX Contoller with ESPixelstick (errors in his wiring diagram)
# https://www.youtube.com/watch?v=GWZ63vsKzT8
# - ESPHome DMX512 Custom component used here: https://github.com/andyboeh/esphome-dmx512
# Includes good examples if you are expanding
##########################################################################################
##########################################################################################
# - Arduino DMX Controller: https://www.youtube.com/watch?v=4PjBBBQB2m4
# - ESP32 DMX Contoller with ESPixelstick (errors in his wiring diagram):
# https://www.youtube.com/watch?v=GWZ63vsKzT8
# - ESPHome DMX512 Custom component used here:
# https://github.com/andyboeh/esphome-dmx512
#:########################################################################################:#
# MQTT COMMANDS:
#
#:########################################################################################:#
# OFFLINE NOTES:
# - If Home Assistant is offline, lights can still be controlled locally (device continues DMX output)
# - If Wi-Fi is offline, wall switch power-cycling restores dimmer module output state (modules remember)
#:########################################################################################:#
##########################################################################################
# SPECIFIC DEVICE VARIABLE SUBSTITUTIONS
#:########################################################################################:#
# SUBSTITUTIONS: Specific device variable substitutions
# If NOT using a secrets file, just replace these with the passwords etc (in quotes)
##########################################################################################
#:########################################################################################:#
substitutions:
# Device Naming
# Device Naming
device_name: "esp-lounge6chdimmer"
friendly_name: "6 Channel Lounge Dimmer"
description_comment: "Lounge 6 Channel Mains Lighting Dimmer (3 x 2 channel modules) controlled using DMX512 protocol with a D1 Mini Pro"
device_area: "Lounge" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant.
description_comment: "Lounge 6 Channel Mains Lighting Dimmer (3 x 2 channel modules) controlled using DMX512 protocol with a D1 Mini Pro (Layout V1.0)"
device_area: "Lounge" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant.
# Project Naming
project_name: "Generic ESP8266.D1 Mini" # Project Details
project_name: "Generic ESP8266.D1 Mini" # Project Details
project_version: "v1.1" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
# Passwords & Secrets
@@ -104,12 +110,12 @@ substitutions:
gamma_output_5: "2.2"
gamma_output_6: "2.2"
#########################################################################################
#:########################################################################################:#
# PACKAGES: Included Common Packages
# https://esphome.io/components/packages.html
##########################################################################################
# Comment some of these out where not needed, eg MQTT, Web portal, SNTP, General Sensors
##########################################################################################
#:########################################################################################:#
packages:
#### WIFI, Network (Static/DHCP/IPV6 etc), Fallback AP, Safemode ####
common_wifi: !include
@@ -132,23 +138,24 @@ packages:
file: common/mqtt_common.yaml
vars:
local_device_name: "${device_name}"
#### WEB PORTAL ####
#common_webportal: !include common/webportal_common.yaml
#### SNTP (Only use if you want/need accurate timeclocks) ####
common_sntp: !include common/sntp_common.yaml
common_sntp: !include common/sntp_common.yaml
#### DIAGNOSTICS Sensors ####
diag_basic: !include common/include_basic_diag_sensors.yaml
diag_more: !include common/include_more_diag_sensors.yaml
diag_debug: !include common/include_debug_diag_sensors.yaml
diag_basic: !include common/include_basic_diag_sensors.yaml
diag_more: !include common/include_more_diag_sensors.yaml
diag_debug: !include common/include_debug_diag_sensors.yaml
#diag_resetcount: !include common/include_resetcount_diag_sensors.yaml
#########################################################################################
# ESPHome
#:########################################################################################:#
# ESPHOME:
# https://esphome.io/components/esphome.html
#########################################################################################
#:########################################################################################:#
esphome:
name: "${device_name}"
friendly_name: "${friendly_name}"
@@ -168,113 +175,126 @@ esphome:
id(dmx_ch5_sensor).publish_state(0);
id(dmx_ch6_sensor).publish_state(0);
#########################################################################################
# ESP Platform and Framework
# https://esphome.io/components/esp32.html
#########################################################################################
#:########################################################################################:#
# ESP PLATFORM AND FRAMEWORK:
# https://esphome.io/components/esp8266/
#:########################################################################################:#
esp8266:
board: d1_mini_pro
#early_pin_init: False # Initialise pins early to known values. Recommended false where switches are involved. Defaults to True.
#early_pin_init: false # Initialise pins early to known values. Recommended false where switches are involved. Defaults to true.
board_flash_mode: dout # Default is dout
restore_from_flash: true # restore some values on reboot
#:########################################################################################:#
# MDNS:
# https://esphome.io/components/mdns.html
#:########################################################################################:#
mdns:
disabled: false # Disabling will make the build file smaller (and it is still available via static IP)
#preferences:
# flash_write_interval: 0s
#########################################################################################
# ESPHome Logging Enable
#:########################################################################################:#
# LOGGING: ESPHome Logging Enable
# https://esphome.io/components/logger.html
#############################################
#:########################################################################################:#
logger:
level: "${log_level}" #INFO Level suggested, or DEBUG for testing
baud_rate: 0 #set to 0 for no logging via UART, needed if you are using it for other serial things (eg PZEM)
level: "${log_level}" # INFO Level suggested, or DEBUG for testing
baud_rate: 0 # set to 0 for no logging via UART, needed if you are using it for other serial things (eg PZEM)
#esp8266_store_log_strings_in_flash: false
#tx_buffer_size: 64
#########################################################################################
# STATUS LED
#:########################################################################################:#
# STATUS LED:
# https://esphome.io/components/status_led.html
#########################################################################################
#:########################################################################################:#
#status_led:
# pin:
# number: GPIO2
# inverted: yes
# inverted: true
#########################################################################################
# UART COMPONENT
#:########################################################################################:#
# UART COMPONENT:
# https://esphome.io/components/uart/
#########################################################################################
#:########################################################################################:#
uart:
# Needed for the DMX component.
# This UART talks to the RS485 adaptor
# There is no receiving, it is a one way send
# This UART talks to the RS485 adaptor.
# There is no receiving, it is a one-way send.
id: uart_bus
baud_rate: 250000
tx_pin:
number: GPIO2 #ESP8266
tx_pin:
number: GPIO2 # ESP8266
allow_other_uses: true # For ESPHome >= 2023.12.0
stop_bits: 2
##########################################################################################
# LIGHT COMPONENT
#:########################################################################################:#
# LIGHT COMPONENT:
# https://esphome.io/components/light/
##########################################################################################
#:########################################################################################:#
light:
- platform: monochromatic
name: ${output_1_name}
name: "${output_1_name}"
output: dmx_1
id: light_test_1
default_transition_length: 10s
gamma_correct: ${gamma_output_1}
restore_mode: ALWAYS_ON
gamma_correct: "${gamma_output_1}"
restore_mode: ALWAYS_ON
- platform: monochromatic
name: ${output_2_name}
name: "${output_2_name}"
output: dmx_2
id: light_test_2
default_transition_length: 10s
gamma_correct: ${gamma_output_2}
restore_mode: ALWAYS_ON
gamma_correct: "${gamma_output_2}"
restore_mode: ALWAYS_ON
- platform: monochromatic
name: ${output_3_name}
name: "${output_3_name}"
output: dmx_3
id: light_test_3
default_transition_length: 10s
gamma_correct: ${gamma_output_3}
restore_mode: ALWAYS_ON
gamma_correct: "${gamma_output_3}"
restore_mode: ALWAYS_ON
- platform: monochromatic
name: ${output_4_name}
name: "${output_4_name}"
output: dmx_4
id: light_test_4
default_transition_length: 10s
gamma_correct: ${gamma_output_4}
gamma_correct: "${gamma_output_4}"
restore_mode: ALWAYS_ON
- platform: monochromatic
name: ${output_5_name}
name: "${output_5_name}"
output: dmx_5
id: light_test_5
default_transition_length: 3s
gamma_correct: ${gamma_output_5}
gamma_correct: "${gamma_output_5}"
restore_mode: RESTORE_DEFAULT_OFF
- platform: monochromatic
name: ${output_6_name}
name: "${output_6_name}"
output: dmx_6
id: light_test_6
default_transition_length: 3s
gamma_correct: ${gamma_output_6}
gamma_correct: "${gamma_output_6}"
restore_mode: RESTORE_DEFAULT_OFF
##########################################################################################
# SENSOR COMPONENT
#:########################################################################################:#
# SENSOR COMPONENT:
# https://esphome.io/components/sensor/
##########################################################################################
#:########################################################################################:#
sensor:
# Expose each DMX channel's current output level as 0..255 integers (post-gamma)
# Expose each DMX channel's current output level as 0..255 integers
- platform: template
id: dmx_ch1_sensor
name: ${output_1_name} Output
name: "${output_1_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -289,7 +309,7 @@ sensor:
- platform: template
id: dmx_ch2_sensor
name: ${output_2_name} Output
name: "${output_2_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -304,7 +324,7 @@ sensor:
- platform: template
id: dmx_ch3_sensor
name: ${output_3_name} Output
name: "${output_3_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -319,7 +339,7 @@ sensor:
- platform: template
id: dmx_ch4_sensor
name: ${output_4_name} Output
name: "${output_4_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -334,7 +354,7 @@ sensor:
- platform: template
id: dmx_ch5_sensor
name: ${output_5_name} Output
name: "${output_5_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -349,7 +369,7 @@ sensor:
- platform: template
id: dmx_ch6_sensor
name: ${output_6_name} Output
name: "${output_6_name} Output"
icon: mdi:counter
#entity_category: diagnostic
accuracy_decimals: 0
@@ -362,53 +382,65 @@ sensor:
min_value: 0
max_value: 255
##########################################################################################
# CUSTOM COMPONENT DMX512
#:########################################################################################:#
# EXTERNAL COMPONENTS:
# https://github.com/andyboeh/esphome-dmx512
##########################################################################################
#:########################################################################################:#
external_components:
- source: github://andyboeh/esphome-dmx512
#:########################################################################################:#
# DMX512 COMPONENT:
# https://github.com/andyboeh/esphome-dmx512
#:########################################################################################:#
dmx512:
id: dmx
uart_id: uart_bus
#enable_pin: GPIOXX (Optional, I've wire them to be always active)
tx_pin:
#enable_pin: GPIOXX (Optional, I have wired them to be always active)
tx_pin:
number: GPIO2
allow_other_uses: true # For ESPHome >= 2023.12.0
uart_num: 1
periodic_update: true # optional. Some dimmers may turn off without regular updates.
#force_full_frames: false # optional. If true the 513 byte is always sent
#custom_break_len: 92 # optional. Break Length. Default is 92uS
#custom_break_len: 92 # optional. Break Length. Default is 92uS
#custom_mab_len: 12 # optional. Mark after Break Length. Default is 12mS
#update_interval: 500 # optional. Custom update interval. Default is 500mS
##########################################################################################
# OUTPUT COMPONENT
# https://esphome.io/components/output/ledc.html
##########################################################################################
#:########################################################################################:#
# OUTPUT COMPONENT:
# https://esphome.io/components/output/
#:########################################################################################:#
output:
# Raw DMX slots (these are the actual DMX universes/slots)
- platform: dmx512
channel: 1 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
id: dmx_1_raw
- platform: dmx512
channel: 2 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
id: dmx_2_raw
- platform: dmx512
channel: 3 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
id: dmx_3_raw
- platform: dmx512
channel: 4 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
id: dmx_4_raw
- platform: dmx512
channel: 5 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
id: dmx_5_raw
- platform: dmx512
channel: 6 # The ID we set the device to
universe: dmx # The ID of the DMX512 Component
@@ -492,5 +524,4 @@ output:
scaled = state * (1.0f - MIN) + MIN;
}
id(dmx_ch6_sensor).publish_state(scaled * 255.0f);
id(dmx_6_raw).set_level(scaled);
id(dmx_6_raw).set_level(scaled);