Skip to main content

Interface to DALI lighting systems

Project description

DALI (“Digital Addressable Lighting Interface”) defines how lighting control gear (eg. fluorescent ballasts, LED dimmers) and input devices (push buttons, motion detectors, etc.) should interoperate. It is standardised in IEC 62386.

IEC 62386 contains several parts. Part 101 contains general requirements for all system components, part 102 covers general requirements for control gear, and part 103 describes general requirements for control devices. Parts 2xx extend part 102 with lamp-specific extensions and parts 3xx extend part 103 with input device specific extensions.

This library has been written with reference to the following documents:

  • IEC 62386-101:2014 (general requirements for system components)

  • IEC 62386-102:2014 (general requirements for control gear)

  • IEC 62386-103:2014 (general requirements for control devices)

  • IEC 62386-201:2009 (fluorescent lamps)

  • IEC 62386-202:2009 (self-contained emergency lighting)

  • IEC 62386-205:2009 (supply voltage controller for incandescent lamps)

  • IEC 62386-207:2009 (LED modules)

  • IEC 62386-301:2017 (particular requirements for push button input devices)

  • IEC 62386-303:2017 (particular requirements for occupancy sensor input devices)

I do not have copies of the other parts of the standard; they are fairly expensive to obtain. The library is designed to be extensible; adding support for the other parts ought to be easy and self-contained.

The dali.memory module supports the extended memory bank specifications created and maintained by the Digital Illumination Interface Alliance:

  • DiiA DALI Part 251 — Memory Bank 1 Extension

  • DiiA DALI Part 252 — Energy Reporting

  • DiiA DALI Part 253 — Diagnostics & Maintenance

Python versions supported

This library currently requires Python version 3.7 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-dali-0.11.tar.gz (130.8 kB view hashes)

Uploaded Source

Built Distribution

python_dali-0.11-py3-none-any.whl (150.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page