How to migrate from the old fixture definitions?

All your current fixtures are now still supported! Here's the process to get your integration migrated.

Installing

Our integration name changed from artnet_led to dmx. HACS doesn't allow this, so we are unable to upgrade this in-place. Therefore a manual release is needed for the beta.

Under the release download the source code.

In this ZIP, navigate to custom_components/dmx and copy this dmx folder into your Home Assistant's custom_components folder.

Find your fixture format

Most of the previously supported fixtures already have a generic fixture variant for you to download.

Download as: Open Fixture Library JSON

Examples:

• Single dimmer
• CW/WW
• Dimmer/color temperature
• RGB
• Dimmer/RGB
• RGBWW

This downloads a ZIP, inside this ZIP ignore the manufacturers.json and copy the JSON file of fixture itself into your HomeAssistants config/fixtures folder, which you will need to create. The config folder is the one that houses your configuration.yaml.

This fixture format is extremely flexible and contains templating, channel switching, matrixes, and many other crazy things, and we're compatible with all of it. :)

You can go ahead and use the editor or write a JSON by hand.

Note down the shortName of your fixtures, or name if it has no shortName, we will use these in the next step.

Adding the fixtures to your house

Now that you have all the types of lights configured, it's time to add them. This step is explained in detail in Configuration.

Aftercare

If the new light fixtures now work, you may remove the old artnet_led folder and remove the old entities from your system.

When the 1.0.0 releases, this integration will be submitted for HACS default repositories, so manual installation won't be needed any more.