Python versions supported

This library currently requires Python version 3.10 or later.

Stability

Some of the code in this project is experimental and its API is subject to change. Modules with stable APIs are noted below.

Library structure

• dali

  • address - Device addressing; stable for gear, not stable for devices

  • command - Command registry, interface to command decoding; stable

  • device - DALI control devices as defined in IEC 62386; not stable

    • general - Commands and events from part 103

    • helpers - Useful functions and classes for working with DALI control devices

    • occupancy - Commands from part 303

    • pushbutton - Commands from part 301

    • sequences - Packaged sequences for working with DALI control devices

  • driver - Objects to communicate with physical DALI gateways or services; not stable

    • base - General driver contracts

    • hasseb - Driver for Hasseb DALI Master

    • tridonic - Driver for Tridonic DALI USB

    • daliserver - Driver for https://github.com/onitake/daliserver (needs to be adopted to dali.driver.base API)

    • hid - asyncio-based drivers for Tridonic DALI USB and hasseb DALI Master

    • serial - asyncio-based driver for Lunatone LUBA RS232 interfaces

    • atxled - Driver for ATX LED SERIAL DALI HAT

  • exceptions - DALI related exceptions

  • frame - Forward and backward frames; stable

  • gear - DALI control gear as defined in IEC 62386; stable

    • colour - Commands from part 209 (Device Type 8)

    • emergency - Commands from part 202

    • general - Commands from part 102

    • incandescent - Commands from part 205

    • led - Commands from part 207

  • memory - access to memory banks; not stable

  • sequences - packaged sequences of commands; stable

Contributors

• Stephen Early (Author)

• Robert Niederreiter

• Diogo Gomes

• Caiwan

• Boldie

• Martijn Hemeryck

• Hans Baumgartner

• Ferdinand Keil

• Sean Lanigan, Wallace Building Systems Pty Ltd

• Markus Becker

• Jan Kundrát

• Olivier Pieters

• David Russell

• Nikolay Korotkiy

Copyright

python-dali is Copyright (C) 2013–2026 Stephen Early <steve@assorted.org.uk> and other contributors.

It is distributed under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License and GNU General Public License along with this program. If not, see this link.