Awesome

homematic-rega

Node.js Homematic CCU ReGaHSS Remote Script Interface

This module encapsulates the communication with the "ReGaHSS" - the logic layer of the Homematic CCU.

• execute arbitrary scripts
• get names and ids of devices and channels
• get variables including their value und meta data
• set variable values
• get programs
• execute programs
• activate/deactivate programs
• get rooms and functions including assigned channels
• rename objects

i18n placeholders (e.g. ${roomKitchen}) are translated by default.

You can find offical and inoffical documentation of the homematic scripting language at wikimatic.de.

Pull Requests welcome! :)

Install

$ npm install homematic-rega

Usage Example

const Rega = require('homematic-rega');

const rega = new Rega({host: '192.168.2.105'});

rega.exec('string x = "Hello";\nWriteLine(x # " World!");', (err, output, objects) => {
    if (err) {
        throw err;
    } 
    console.log('Output:', output);
    console.log('Objects:', objects);
});

rega.getVariables((err, res) => {
    console.log(res);
});

API

<a name="Rega"></a>

Rega

Kind: global class

• Rega
  • new Rega(options)
  • instance
    • .exec(script, [callback])
    • .script(file, [callback])
    • .getChannels(callback)
    • .getValues(callback)
    • .getPrograms(callback)
    • .getVariables(callback)
    • .getRooms(callback)
    • .getFunctions(callback)
    • .setVariable(id, val, [callback])
    • .startProgram(id, [callback])
    • .setProgram(id, active, [callback])
    • .setName(id, name, [callback])
  • inner
    • ~scriptCallback : <code>function</code>

<a name="new_Rega_new"></a>

new Rega(options)

<a name="Rega+exec"></a>

rega.exec(script, [callback])

Execute a rega script

Kind: instance method of <code>Rega</code>

<a name="Rega+script"></a>

rega.script(file, [callback])

Execute a rega script from a file

Kind: instance method of <code>Rega</code>

<a name="Rega+getChannels"></a>

rega.getChannels(callback)

Get all devices and channels

Kind: instance method of <code>Rega</code>

<a name="Rega+getValues"></a>

rega.getValues(callback)

Get all devices and channels values

Kind: instance method of <code>Rega</code>

<a name="Rega+getPrograms"></a>

rega.getPrograms(callback)

Get all programs

Kind: instance method of <code>Rega</code>

<a name="Rega+getVariables"></a>

rega.getVariables(callback)

Get all variables

Kind: instance method of <code>Rega</code>

<a name="Rega+getRooms"></a>

rega.getRooms(callback)

Get all rooms

Kind: instance method of <code>Rega</code>

<a name="Rega+getFunctions"></a>

rega.getFunctions(callback)

Get all functions

Kind: instance method of <code>Rega</code>

<a name="Rega+setVariable"></a>

rega.setVariable(id, val, [callback])

Set a variables value

Kind: instance method of <code>Rega</code>

<a name="Rega+startProgram"></a>

rega.startProgram(id, [callback])

Execute a program

Kind: instance method of <code>Rega</code>

<a name="Rega+setProgram"></a>

rega.setProgram(id, active, [callback])

Activate/Deactivate a program

Kind: instance method of <code>Rega</code>

<a name="Rega+setName"></a>

rega.setName(id, name, [callback])

Rename an object

Kind: instance method of <code>Rega</code>

<a name="Rega..scriptCallback"></a>

Rega~scriptCallback : <code>function</code>

Kind: inner typedef of <code>Rega</code>

Related projects

• node-red-contrib-ccu - Node-RED nodes for the Homematic CCU.
• homematic-manager - Cross-platform App to manage Homematic devices and links.
• hm2mqtt.js - Interface between Homematic and MQTT.
• binrpc - Node.js client/server for the Homematic BINRPC protocol.
• homematic-xmlrpc - Node.js client/server for the Homematic XMLRPC protocol.

License

MIT (c) Sebastian Raff