https://github.com/mifi/libxcomfort

Open source library for controlling Moeller XComfort devices through the USB/RS232 dongle
https://github.com/mifi/libxcomfort

actuators automation dimmers home-automation library moeller remote-control

Last synced: 24 days ago
JSON representation

Open source library for controlling Moeller XComfort devices through the USB/RS232 dongle

• Host: GitHub
• URL: https://github.com/mifi/libxcomfort
• Owner: mifi
• Created: 2012-10-04T16:50:27.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2019-10-22T07:57:37.000Z (about 5 years ago)
• Last Synced: 2024-10-04T19:15:08.785Z (about 1 month ago)
• Topics: actuators, automation, dimmers, home-automation, library, moeller, remote-control
• Language: C
• Size: 46.9 KB
• Stars: 29
• Watchers: 13
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
libxcomfort

===========

libxcomfort is an open source library for controlling Moeller / Eaton's xComfort devices through the CKOZ-00/03 USB dongle. Currently RS232 is not implemented, only the USB protocol.

It can currently be used for:

* Getting/setting the dim value.

* Starting/stopping gradual up/down dimming

* Turning actuators/dimmers hard on/off.

* Some other commands like reporting temperatures/measurements have been partially reverse engineered but not implemented

The main library code is located under "CKOZ-00_03" and can be used to control the CKOZ/00/03 communication interface. This interface is used for integrating Moeller systems with for instance a computer program.

Note that the devices to control need to be paired to the comm interface using the _programming_ interface and the MRF program from Moeller.

There also exists some code for controlling devices directly using the CRSZ-00/01 _programming_ interface, that is actually used for programming devices. Working RS232 packet for setting a dimmer actuator to a desired level has been implemented for this device.

All the code is GPL licensed.

Software requirements

* libusb 1

* libmicrohttpd

Concepts

* Datapoint: This is an integer assigned to a particular device association when programming the interface using CRSZ-00/01

* Level: Goes from 0-100

Tips

* When programming the interface using CRSZ-00/01, use standard programming for each button, but set the dim range to 0%-100% so that you can dim through the whole range using commands.

* If you want to control multiple actuators from the same command, link multiple actuators to the USB interface with the same datapoint number. For instance, if you want to dim all actuators in your apartment using one command, you draw one line in MRF from each actuator to the interface and set the same datapoint number for all connections.

Demo: This is my webapp communicating with xcomfortd over HTTP:

http://www.youtube.com/watch?v=WUE6hSZoo9w