homematic-rega v1.5.2

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

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 : function

new Rega(options)

rega.exec(script, callback)

Execute a rega script

Kind: instance method of Rega

rega.script(file, callback)

Execute a rega script from a file

Kind: instance method of Rega

rega.getChannels(callback)

Get all devices and channels

Kind: instance method of Rega

rega.getValues(callback)

Get all devices and channels values

Kind: instance method of Rega

rega.getPrograms(callback)

Get all programs

Kind: instance method of Rega

rega.getVariables(callback)

Get all variables

Kind: instance method of Rega

rega.getRooms(callback)

Get all rooms

Kind: instance method of Rega

rega.getFunctions(callback)

Get all functions

Kind: instance method of Rega

rega.setVariable(id, val, callback)

Set a variables value

Kind: instance method of Rega

rega.startProgram(id, callback)

Execute a program

Kind: instance method of Rega

rega.setProgram(id, active, callback)

Activate/Deactivate a program

Kind: instance method of Rega

rega.setName(id, name, callback)

Rename an object

Kind: instance method of Rega

Rega~scriptCallback : function

Kind: inner typedef of Rega

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