Updated integration Supporting the new color mode in Home Assistant. leveraged heavily form spacemanspiff2007 and jnimmo Now supports 16 bit resolution (also supports 24 bit and 32 bit but I don't know of a DMX controller that would use it) Use Brightness and RGB value separately to give more resolution to brightness to be able to make use of 16 bit resolution
The DMX integration for Home Assistant allows you to send DMX values to an Art-Net capable DMX interface. This component is a one way integration which sends Art-Net UDP packets to the DMX interface. This integration uses pyartnet libraries and requires at least Python version 3.8.
- Implement custom_white
- Reimplement KiNet
- Implement sACN (jnimmo/hass-dmx#66)
- Stop animation thread when not animating (jnimmo/hass-dmx#8 (comment))
- Implement Art-Net broadcast IP (jnimmo/hass-dmx#58)
- Implement custom_rgb (jnimmo/hass-dmx#65)
- Implement custom_any (jnimmo/hass-dmx#54, jnimmo/hass-dmx#62)
- Home Assistant (hass) >= 2021.5 for Color_Mode.
- pyartnet == 0.8.3 will load automatically.
This can be easily installed with the Home Assistant Community Store (HACS) using the repository: Breina/ha-artnet-led
Alternatively, manual installation by downloading the custom_components/artnet_led directory to the custom_components/artnet_led directory on your Home Assistant instance (generally /config/custom_components/artnet_led).
hass-dmx is a community supported Home Assistant integration, if you have any questions you can discuss with the Home Assistant DMX Community.
artnet-led lighting is configured in the configuration.yaml
file under the light domain.
Example:
light:
- platform: artnet_led
host: IP # IP of Art-Net Node
max_fps: 25 # Max 40 per second
refresh_every: 0 # Resend values if no fades are running every x seconds, 0 disables automatic refresh
universes: # Support for multiple universes
0: # Nr of Universe (see configuration of your Art-Net Node)
output_correction: quadratic # optional: output correction for the whole universe, will be used as default if nothing is set for the channel
devices:
# Dimmer
- channel: 1 # first channel of dmx dimmer
name: my_dimmer # name
type: dimmer # type
transition: 1 # default duration of fades in sec. Will be overridden by Transition sent from HA
output_correction: quadratic # optional: quadratic, cubic or quadruple. Apply different dimming curves to the output. Default is None which means linear dimming
channel_size: 16bit # width of the channel sent to DMX device, default "8bit", "16bit", "24bit" and "32bit" available.
- channel: 3
name: my_rgb_lamp
type: rgb
transition: 1
channel_size: 16bit
output_correction: quadratic
channel_setup: rbg
- channel: 125
type: color_temp
name: "my_color_temp_lamp"
min_temp: 2500K
max_temp: 6500K
channel_setup: ch
- channel: 41
type: rgbww
name: my_rgbww_lamp
transition: 10
- channel: 50
name: sp4led_1_dimmer
default_level: 255
type: fixed
- host (Required): Art-Net/DMX gateway address
- port (Optional; default=6454): Art-Net/DMX gateway port
- max-fps (Optional; default=25): frame rate for fade update (1 to 40 FPS)
- refresh_every (Optional; default=120): Seconds to resend values if no fades are running, 0 disables.
- universe (Required): Art-Net universe for following DMX channels.
- output_correction (Optional; default=linear): applied to whole universe
- 'linear'
- 'quadratic' (see Graph)
- 'cubic' (see Graph)
- 'quadruple' (see Graph)
- output_correction (Optional; default=linear): applied to whole universe
- channel (Required): The DMX channel for the light (1-512)
- name (Required): Friendly name for the light
- type (Optional; default=dimmer):
- 'fixed' (fixed single channel)
- 'binary' (single channel)
- 'dimmer' (single channel)
- 'rgb' (red, green, blue)
- 'rgbw' (red, green, blue, white)
- 'rgbww' (red, green, blue, cool-white, warm-white)
- 'color_temp' (cool-white, warm-white)
- transition (Optional; default=0): Duration in seconds of the fading animation
- output_correction (Optional; default=linear): applied to each channel, overrides universe setting.
- 'linear'
- 'quadratic' (see Graph)
- 'cubic' (see Graph)
- 'quadruple' (see Graph)
- channel_size (Optional; default= 8bit): width of the channel sent to DMX device.
- '8bit' (255 steps)
- '16bit' (65k steps)
- '24bit' (too many steps)
- '32bit' (don't ask steps)
- default_level (Optional; value at startup, if state can't or shouldn't be restored)
- min_temp (Optional; default=2700K): Only applies for types 'color_temp' and 'rgbww'
- max_temp (Optional; default=6500K): Only applies for types 'color_temp' and 'rgbww'
- channel_setup (Optional; see channel_setup)
A string to customize the channel layout of your light.
d
= dimmer (brightness 0 to 255)c
= cool white value, scaled for brightnessC
= cool white value, unscaledh
= warm white value, scaled for brightnessH
= warm white value, unscaledt
= temperature (0 = warm, 255 = cold)T
= temperature (255 = warm, 0 = cold)r
= red, scaled for brightnessR
= red, unscaledg
= green, scaled for brightnessG
= green unscaledb
= blue, scaled for brightnessB
= blue, unscaledw
= white, scaled for brightnessW
= white, unscaled
Type | Default value | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
binary | ||||||||||||||||
dimmer | ||||||||||||||||
custom_white | d |
c |
C |
h |
H |
t |
T |
ch |
||||||||
rgb | d |
r |
R |
g |
G |
b |
B |
rgb |
||||||||
rgbw | d |
r |
R |
g |
G |
b |
B |
w |
W |
rgbw |
||||||
rgbww | d |
c |
C |
h |
H |
t |
T |
r |
R |
g |
G |
b |
B |
rgbch |
- Color-Mode. This allows full independent control over: RGB setting, RGB brightness, Cool White brightness and Warm white brightness. with a separate over all brightness control. This allows you to sent the color and white levels to any value independently and then adjust the brightness of the whole light without affecting the color of the light.
- 16 bit DMX output. taking advantage of the separate brightness settings and the overall brightness allows lights to be dimmed to very low levels and still have a smooth fade due to the 65K steps you get from 16 bit
- Transition time can be specified through services to fade to a color (for RGB fixtures) or value. This currently is set to run at 25 frames per second.
- Brightness: Once a channel is turned on brightness can be controlled through the Home Assistant interface.
- Color temperature: For dual channel warm white/cool white fixtures this tunes the white temperature.
-
The graph shows different output depending on the output correction.
-
Quadratic or cubic results in much smoother and more pleasant fades when using LED Strips. The graph shows different output depending on the output correction.
From left to right: linear (default when nothing is set), quadratic, cubic then quadruple
-
LEDS must be in same order as shown in channel
-
Notes DMX king eDMX4 Pro does not seem to work if you have send less than 16 channels. Work around just add a dummy light at channel 16 or higher
- Lights are assigned a unique ID generated from the IP addreess, Port, Universe and Channel.
- Should work with any Art-Net, KiNet or e1.31 sACN enabled DMX interface.
- Artnet interface tested on DMX King eDMX4 and ENTTEC DIN Ethergate 2.
- e1.31 sACN interface tested on esPixelStick and Falcon F16v2
Art-Net™ Designed by and Copyright Artistic Licence Holdings Ltd
To enable debug logging for this component:
logger:
logs:
custom_components.artnet_led: debug