homegear / homegear

Interface your smart home devices with your home automation software or your own control scripts.

Homegear

Homegear is a free and open source program to interface your home automation devices or services with your home automation software or scripts. Currently supported are the following device families/systems:

• KNX
• EnOcean
• Beckhoff BK90x0
• HomeMatic BidCoS
• HomeMatic Wired
• Insteon
• Philips Hue
• Sonos
• MAX!
• Intertechno
• Kodi
• IP cams
• more to come...
• New devices can be created with ease using XML and PHP.

Homegear features the following interfaces to control your devices - all with SSL support:

• XML-RPC
• Binary-RPC
• JSON-RPC
• MQTT
• WebSockets with PHP session authentication
• HTTP (GET and POST)

If needed new interfaces can easily be added to the source code. Homegear also features:

• A built-in rich featured web server with PHP 7 and IP cam proxy support. Together with WebSockets and the script engine you can easily create web pages to bidirectionally interact with all devices known to Homegear.

• A built-in script engine using PHP 7:

  • All devices and device functions are directly accessible.

  • All PHP modules can be used:

    • Thread support using the PHP module "pthreads".

    • Low level peripheral support:

      • Directly access serial devices, I²C devices and GPIOs.
      • You immediately get notified on new data and GPIO state changes. No polling is necessary.
      • Using threads you can implement bidirectional and event driven communication.

  • A base library to easily implement your own device families.

  • XML device description files with PHP script support to easily implement individual devices.

  • Support for customized licensing modules supporting module online activation, license verification and script encryption.

Homegear is written to make it as easy as possible to integrate new devices making them accessible through all the above interfaces.

For more information, please visit https://homegear.eu, https://doc.homegear.eu and https://ref.homegear.eu. Please post your questions in our forum on https://forum.homegear.eu.

homegear's Issues

SSL stability issues / segfaults

Save CLI history

Peers are marked "unreachable" after program start

"devices select central" in CLI not working when central is manually recreated

OpenSSL segfault with version 1.0.1e

Hopefully fixed with updated OpenSSL Debian package.

HM-CFG-LAN with firmware version 0.964 is not working

When peer supports WOR, enable WOR bit on queue resend

Ask for alternative location during installation, when there is not enough space on /tmp

Support for HM-LGW

Support for multiple physical interfaces in one family

Implement RPC methods for system variables

OpenHAB 1.5 support

Parameter sets with subsets and parameters defined outside of subset are not parsed correctly from XML file

MAX! support

Test RS485 dimmer with remote of other device family

Add HomeMatic Wired devices on "announce" (message type 0x41)

README.TXT has invalid URL

The README.TXT file in the distribution-1.5.0-runtime.zip needs to be updated - it points to http://code.google.com/p/openhab/wiki/Setup

Package "curl" missing in createRPIImage.sh

Workaround for openHAB's init bug

Support for "binary://" and "binarys://" in RPC function init

Implement new RPC method "poll" to check if a device is still reachable

Crash when clients RPC server is not reachable for a longer period

Support for HM-CFG-LAN

Support for raw RS485 LAN device

Implement parameter conversion blind_test

XMLRPC <value /> is interpreted as "void".

Add debian package "keyboard-configuration" to RPI image

HomeMatic configurator can't parse some service messages

RPC event "updateDevice" is not working

Service message when no RF packets are received after a settable amount of time

Add comments to all classes and methods

Then generate documentation with an API Documentation Generator

AES support with HM-CFG-LAN

Return exception when RPC method is not implemented for device family

Segfault when closing RPC SSL connection after SSL handshake error

Implement event trigger on start up

Round BINRPC floats to 9 digits

Binary RPC response is parsed wrongly, when response is an error struct

Error creating basic auth "unauthorized" response

More documentation of the XML files

Hello,

I am currently developing a java library to talk to the Homematic LAN configuration device. While researching the BidCos protocol I found your wiki on homegear.eu. It is a really great start to get some insight into the protocol. I get the feeling that you are able to understand the device specific payloads with the help of the XML files used by the Homematic software. Could you document this process a little bit more? I saw that there are frame elements in the XML. These seem to describe the actual positions of the bytes in the frame. But what does for example an index of 9 or 10 mean? Is this 9th or 10th byte in the payload or in the whole packet? If it is the position in the whole packet I must have understand the packet format wrong, since I thought that the payload starts at byte 10?
Also what can I do with the channel and paramset elements. If you have more information on these elements could you add some explanation?
For example is it possible to read the device specific parts of the pairing process from these elements?

Thanks in advance for your help

Prefix all interface classes with "I"

AES support with HM-LGW

Error creating timed events

Unix time stamp is multiplied by 1000 before converting the variable to uint64_t

Improve implementation for LAZYCONFIG and check if it is working for all devices supporting it

RS485 Raw LAN device driver

Implement device families as dynamic modules for easier implementation of new families

Test RS485 modules only supporting sending OR receiving at the same time

Signal 11 when event handler triggers event after RPC server shutdown

Changed RPC function getLinks to support new HomeMatic configurator

Only restart RPC server on reload when config files were changed

Can't connect to CLI when CLI was previously closed with Ctrl+c