Welcome

clipsal
2009-11-19
2013-04-02
  • clipsal
    clipsal
    2009-11-19

    **Introduction**

    For a number of years, Clipsal have used "The Cbus Module" as the means of connecting a compound cbus automation system device, to cbus.

    The link is through a PC Interface IC, and "The Cbus Module" provides a C API which applications can use to isolate themselves from the low level details of the PCI and its communication protocol.

    The source code for "The Cbus module" has been available on a restricted basis for some time. Clipsal have decided to release this as open source software.

    Contributions, updates, bug fixes, or improvements may be suggested. Clipsal may or may not accept those for incorporation into the main baseline (which continues to be maintained outside SourceForge, in Clipsals internal version control systems). However as Clipsal make improvements they will be replicated here from time to time.

    Clipsal's hope is that the very simple Boost licence, and the wide availability of this software, will encourage and simplify life for external product developers.

    **Design Considerations**

    C-Bus Module is written to be as portable as possible. It compiles in something like 10 or 12 separate C compilers, on machines ranging from small embedded processors (eg MSP430 family, Hitachi H8, Atmel AVR) through to larger systems running Windows and Linux.

    C-Bus module has been used on many embedded platforms, and is carefully designed to have a small executable and RAM footprint - which can be tailored up and down according to needs.

    **Adding new compiler support**
    Look in and modify the file cbus_general.h

    **Tailoring**

    The file cbus_config.h needs to be created. Use cbus_config_default.h as a template and make edits to suit. Take care, and understand what you are doing. The definition of the Cbus Interface Levels can be found in the document "Cbus Interface REquirements" which you can find here:
    http://training.clipsal.com/downloads/OpenCBus/OpenCBusProtocol.html