########################################################################################## ########################################################################################## # 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 # # 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) ########################################################################################## # # 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. # # 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) # # 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 ########################################################################################## ########################################################################################## ########################################################################################## # SPECIFIC DEVICE VARIABLE SUBSTITUTIONS # If NOT using a secrets file, just replace these with the passwords etc (in quotes) ########################################################################################## substitutions: # 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. # Project Naming 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 api_key: !secret esp-api_key # unfortunately you can't use substitutions inside secrets names ota_pass: !secret esp-ota_pass # unfortunately you can't use substitutions inside secrets names static_ip_address: !secret esp-lounge6chdimmer_ip # Device Settings #relay_icon: "mdi:lightbulb-group" log_level: "INFO" # Define logging level: NONE, ERROR, WARN, INFO, DEBUG (Default), VERBOSE, VERY_VERBOSE update_interval: "60s" # update time for for general sensors etc output_1_name: "Lounge Downlights South" output_2_name: "Lounge Rafter Buttons" output_3_name: "Lounge Downlights Centre" output_4_name: "Dining Table Light" output_5_name: "Couch Spots Right" output_6_name: "Couch Spots Left" # Per-channel minimum output when ON (0.00f..1.00f). OFF remains 0%. # Adjust per channel to avoid flicker at very low levels. min_output_1: "0.20f" min_output_2: "0.20f" min_output_3: "0.20f" min_output_4: "0.20f" min_output_5: "0.10f" min_output_6: "0.10f" # Per-channel gamma correct gamma_output_1: "2.2" gamma_output_2: "2.2" gamma_output_3: "2.2" gamma_output_4: "1" 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 file: common/network_common.yaml vars: local_device_name: "${device_name}" local_static_ip_address: "${static_ip_address}" local_ota_pass: "${ota_pass}" #### HOME ASSISTANT API (choose encryption or no encryption options) #### common_api: !include file: common/api_common.yaml #file: common/api_common_noencryption.yaml vars: local_api_key: "${api_key}" #### MQTT #### common_mqtt: !include 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 #### 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_resetcount: !include common/include_resetcount_diag_sensors.yaml ######################################################################################### # ESPHome # https://esphome.io/components/esphome.html ######################################################################################### esphome: name: "${device_name}" friendly_name: "${friendly_name}" comment: "${description_comment}" # Appears on the esphome page in HA area: "${device_area}" project: name: "${project_name}" version: "${project_version}" on_boot: priority: -100 then: - lambda: |- id(dmx_ch1_sensor).publish_state(0); id(dmx_ch2_sensor).publish_state(0); id(dmx_ch3_sensor).publish_state(0); id(dmx_ch4_sensor).publish_state(0); id(dmx_ch5_sensor).publish_state(0); id(dmx_ch6_sensor).publish_state(0); ######################################################################################### # ESP Platform and Framework # https://esphome.io/components/esp32.html ######################################################################################### esp8266: board: d1_mini_pro #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: 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 # 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) #esp8266_store_log_strings_in_flash: false #tx_buffer_size: 64 ######################################################################################### # STATUS LED # https://esphome.io/components/status_led.html ######################################################################################### #status_led: # pin: # number: GPIO2 # inverted: yes ######################################################################################### # 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 id: uart_bus baud_rate: 250000 tx_pin: number: GPIO2 #ESP8266 allow_other_uses: true # For ESPHome >= 2023.12.0 stop_bits: 2 ########################################################################################## # LIGHT COMPONENT # https://esphome.io/components/light/ ########################################################################################## light: - platform: monochromatic name: ${output_1_name} output: dmx_1 id: light_test_1 default_transition_length: 10s gamma_correct: ${gamma_output_1} restore_mode: ALWAYS_ON - platform: monochromatic name: ${output_2_name} output: dmx_2 id: light_test_2 default_transition_length: 10s gamma_correct: ${gamma_output_2} restore_mode: ALWAYS_ON - platform: monochromatic name: ${output_3_name} output: dmx_3 id: light_test_3 default_transition_length: 10s gamma_correct: ${gamma_output_3} restore_mode: ALWAYS_ON - platform: monochromatic name: ${output_4_name} output: dmx_4 id: light_test_4 default_transition_length: 10s gamma_correct: ${gamma_output_4} restore_mode: ALWAYS_ON - platform: monochromatic name: ${output_5_name} output: dmx_5 id: light_test_5 default_transition_length: 3s gamma_correct: ${gamma_output_5} restore_mode: RESTORE_DEFAULT_OFF - platform: monochromatic name: ${output_6_name} output: dmx_6 id: light_test_6 default_transition_length: 3s gamma_correct: ${gamma_output_6} restore_mode: RESTORE_DEFAULT_OFF ########################################################################################## # SENSOR COMPONENT # https://esphome.io/components/sensor/ ########################################################################################## sensor: # Expose each DMX channel's current output level as 0..255 integers (post-gamma) - platform: template id: dmx_ch1_sensor name: ${output_1_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 - platform: template id: dmx_ch2_sensor name: ${output_2_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 - platform: template id: dmx_ch3_sensor name: ${output_3_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 - platform: template id: dmx_ch4_sensor name: ${output_4_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 - platform: template id: dmx_ch5_sensor name: ${output_5_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 - platform: template id: dmx_ch6_sensor name: ${output_6_name} Output icon: mdi:counter #entity_category: diagnostic accuracy_decimals: 0 update_interval: never filters: - throttle: 200ms - delta: 1 - round: 0 - clamp: min_value: 0 max_value: 255 ########################################################################################## # CUSTOM COMPONENT DMX512 # https://github.com/andyboeh/esphome-dmx512 ########################################################################################## external_components: - source: github://andyboeh/esphome-dmx512 dmx512: id: dmx uart_id: uart_bus #enable_pin: GPIOXX (Optional, I've wire 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_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: # 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 id: dmx_6_raw # Wrapped outputs: publish exact 0..255 to sensors, then forward float to raw DMX - platform: template id: dmx_1 type: float write_action: - lambda: |- const float MIN = ${min_output_1}; float scaled = state; if (state > 0.0f) { // Remap 0..1 -> MIN..1.0 (keep OFF at 0) scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch1_sensor).publish_state(scaled * 255.0f); id(dmx_1_raw).set_level(scaled); - platform: template id: dmx_2 type: float write_action: - lambda: |- const float MIN = ${min_output_2}; float scaled = state; if (state > 0.0f) { scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch2_sensor).publish_state(scaled * 255.0f); id(dmx_2_raw).set_level(scaled); - platform: template id: dmx_3 type: float write_action: - lambda: |- const float MIN = ${min_output_3}; float scaled = state; if (state > 0.0f) { scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch3_sensor).publish_state(scaled * 255.0f); id(dmx_3_raw).set_level(scaled); - platform: template id: dmx_4 type: float write_action: - lambda: |- const float MIN = ${min_output_4}; float scaled = state; if (state > 0.0f) { scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch4_sensor).publish_state(scaled * 255.0f); id(dmx_4_raw).set_level(scaled); - platform: template id: dmx_5 type: float write_action: - lambda: |- const float MIN = ${min_output_5}; float scaled = state; if (state > 0.0f) { scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch5_sensor).publish_state(scaled * 255.0f); id(dmx_5_raw).set_level(scaled); - platform: template id: dmx_6 type: float write_action: - lambda: |- const float MIN = ${min_output_6}; float scaled = state; if (state > 0.0f) { scaled = state * (1.0f - MIN) + MIN; } id(dmx_ch6_sensor).publish_state(scaled * 255.0f); id(dmx_6_raw).set_level(scaled);