libcbus

Talks to Clipsal C-Bus using Python.

Copyright 2012-2019 Michael Farrell. Licensed under the GNU LGPL3+. For more details see COPYING and COPYING.LESSER.

Note: This software is not certified or endorsed by Clipsal or Schneider Electric. Clipsal claim that use of C-Bus with non-Clipsal hardware or software may void your warranty.

More information about the project is available on the libcbus ReadTheDocs site, and in the docs directory of the source repository.

Hardware interface support

This should work with the following C-Bus PC Interfaces (PCIs):

• 5500PC Serial PCI

• 5500PCU USB PCI

  On Linux, this requires v2.6.25 or later kernel, with the cp210x module.

• 5500CN Ethernet PCI (and likely also 5500CN2)

  This software does not support configuring the Ethernet PCI for the first time. It must already have an IP address on your network.

About this project

This is a reimplementation of the PCI serial protocol from scratch.

It does not use the libcbm library/DLL from Clipsal, or C-Gate:

• The libcbm module only runs on x86_32 systems, and is only available as a static library (closed source).

• C-Gate requires an OS and architecture specific closed source serial library (SerialIO), the Java runtime, and itself has various licensing restrictions.

As such, it should run on any Python supported platform, with the exception of dbus (IPC server) components which don't work properly on Windows.

The software itself has been primarily developed on Linux with on armhf, x86_32 and x86_64 systems.

The most useful bits of this project are:

• cdbusd, which shares events from the C-Bus PCI in D-Bus.

• saged, which is a WebSocket server that communicates with cdbusd.

• sage (in sage_root), which is a jQueryMobile-based JavaScript web app which can connect to saged.