node-rc6

Super small home automation project, that let my Logitech Harmony One control Amazon Fire TV / Kodi Mediacenter and Philips hue lights. Runs on a Raspberry Pi with a noname RC6 USB IR receiver.

RC6 labeled IR receiver simple convert IR commands into keystrokes and is often used in connection with remote controls for Windows Media Center / Kodi / XBMC.

This package uses thouse IR inputs to control various devices in the local network.

Installation

npm install node-rc6

You also need the Android Debug Bridge (adb) as binary[^1].

Usage

You have to create devices, currently Philips hue lights and Android devices (e.g. Amazon Fire TV) are supported. Every RC6 input (even from a normal keyboard) fires an input event. Use the key to send an associated command to a device.

var rc6 = require('node-rc6');

// register devices
var fireTV = rc6.device('adb-shell', '192.168.x.x', './bin/adb');
var hue = rc6.device('hue-api', '192.168.x.x');

// event driven input observation
rc6.on('input', function(key){  
  // key corresponds the key on the keyboard
  if (key === 'enter') {
    // sends a keyevent to the Fire TV
    fireTV.execute('input keyevent KEYCODE_DPAD_CENTER');
  } else if (key === 'k') {
    // try to start Kodi on Fire TV
    fireTV.execute('am start -n org.xbmc.kodi/.Splash');
  } else if (key.match(/[01]/) !== null) {
    // turn hue lights on/off
    hue.on(key === '1');
  }
}).observe();

API

node-rc6 inherits EventEmiter

method | arguments | description -------|-----------|------------ device | string type, string ip, ... | create a new device (s. Devices) observe | void | start the RC6 input observer

Events

event | arguments | description ------|-----------|------------ start | void | observation starts end | void | observation ends (ctrl+c) input | string key | keystorke, key corresponds the name of a key on normal keyboard info | string message, object scope | info messages like child_process output, scope has information around the event, e.g. the returned json from the hue API error | string/Error error, object scope | error reporting, scope has information around the event, e.g. the returned json from the hue API debug | string message, object scope | debug messages, scope has information around the event, e.g. the returned json from the hue API

Devices

adb-shell device('adb-shell', ip, path_to_adb);

Used for Android devices which have network debugging enabled.

method | arguments | description -------|-----------|------------ execute| string command | executes a adb shell command

hue device('hue', ip);

Philips hue lights.

method | arguments | description -------|-----------|------------ on | boolean on| turn lights on/off scene | int num| My hue scene (1..n) bri | char operation, int value | change brightness by value using '=', '+' or '-' operation random| boolean sync, mixed duration, int transition | bring the hue bulbs (simultaneously or separately, use sync) to random colors, every milliseconds or random ms values (e.g. duration => [1000,3000]), use optionally transition to have always the same time for the transition effect (otherwise the transition is permanent)

Status

This is the first implementation. The logging is still silly, only two devices with micro API functionality. But it works perfect for me. No further work planed.

My personal config can be found in `captains-table.js.

Links

• Install Kodi on Amazon Fire TV
• Philips hue API

[^1]: For my environment I found adb for my Mac in the HOW-TO:Install Kodi on Fire TV (4.1 Setup ADB on Your Host) and for the Raspberry Pi in the xda-developers community.