Overview

このモジュールはPhilips hueをECHONET Liteプロトコルに対応させるプログラムを作るものです． ECHONET Liteプロトコルはスマートハウス機器の通信プロトコルです．

内部ではnode-hue-apiとechonet-liteモジュールに依存しています．

The module 'hue-echonet-lite' depends on node-hue-api.js and echonet-lite.js.

Install

下記コマンドでモジュールをインストールできます．

You can install the module as following command.

> npm install node-hue-api
> npm install echonet-lite
> npm install hue-echonet-lite

Demos

// ECHONET Lite
var EL = require('echonet-lite');
objList = ['029001', '029002', '029003'];

// Philips hue
var hueEL = require('hue-echonet-lite');
hueEL.initialize("hue-developper", 3, EL);  // developer name, number of lightings

// ノードプロファイルに関しては内部処理するので，ユーザーはエアコンに関する受信処理だけを記述する．
var elsocket = EL.initialize( objList, function( rinfo, els ) {

	switch( els.DEOJ ) {
	  case '029000':  /// 一般照明か確認しておく
	  case '029001':
	  case '029002':
	  case '029003':
		hueEL.ELprocess( rinfo, els );
		break;

	  case '0ef000':  // ノードプロファイル
	  case '0ef001':
		break;

	  default:
		console.log( "EOJ is not found: " + els.DEOJ );
		break;
	}

	// console.dir( EL.facilities );
});

//////////////////////////////////////////////////////////////////////
// 全て立ち上がったのでINFで照明ONの宣言，本当はゲートウェイから点灯状態を持ってくるべきかも
EL.sendOPC1( '224.0.23.0', [0x02,0x90,0x01], [0x0e,0xf0,0x01], 0x73, 0x80, [0x30]);
EL.sendOPC1( '224.0.23.0', [0x02,0x90,0x02], [0x0e,0xf0,0x01], 0x73, 0x80, [0x30]);
EL.sendOPC1( '224.0.23.0', [0x02,0x90,0x03], [0x0e,0xf0,0x01], 0x73, 0x80, [0x30]);

Data stracture

各hueのライトは下記のオブジェクトを基礎として生成されます。

// 照明オブジェクトのクラス（のようなもの）
var lightingsObj = {
	// super
	"80": [0x30],  // 動作状態
	"81": [0xff],  // 設置場所
	"82": [0x00, 0x00, 0x66, 0x00], // EL version, 1.1
	"88": [0x42],  // 異常状態
	"8a": [0x00, 0x00, 0x77], // maker code
	"9d": [0x04, 0x80, 0xc0],        // inf map, 1 Byte目は個数
	"9e": [0x04, 0x80, 0xc0],        // set map, 1 Byte目は個数
	"9f": [0x0b, 0x80, 0x81, 0x82, 0x88, 0x8a, 0x9d, 0x9e, 0x9f, 0xb6, 0xc0], // get map, 1 Byte目は個数
	// child
	"b6": [0x45], // 点灯モード設定
	"c0": [0x40, 0x40, 0x40] // カラー灯モード時RGB設定
};

このオブジェクトが配列になったものが，

HC.lightsArray: []

です。

APIs

//////////////////////////////////////////////////////////////////////
// 基本的なAPI

// initialize
HC.initialize = function(developper, num, el)
// 全情報のJSON取得
HC.getHueJSON = function(callback)


//////////////////////////////////////////////////////////////////////
// 電源状態
HC.setHueOn = function(channel)
HC.setHueOff = function(channel)
HC.getHueOnOff = function(channel, callback)


//////////////////////////////////////////////////////////////////////
// HSV形式
HC.setHueHue = function(channel, hue)
HC.setHueSaturation = function(channel, saturation)
HC.setHueBrightness = function(channel, brightness)
HC.setHueHSV = function(channel, hue, saturation, brightness)
HC.getHueHSV = function(channel, callback)


//////////////////////////////////////////////////////////////////////
// RGB入力を受けつけて内部ではxyYに変換して利用する，ただしYはbri
HC.setHueRGB = function(channel, red, green, blue)
// xyYをとってRGBをゲットする，ただしYはbri
HC.getHueRGB = function(channel, callback)


//////////////////////////////////////////////////////////////////////
// XY方式
HC.setHueXY = function(channel, x, y)
HC.getHueXY = function(channel, callback)

攻略情報

Demosを見てください。 なお，RGBとHSV，xyYに関する計算についてはPhilips Hueスターターセットに入ってるランプの測定値から式を作っています。 この電球は緑を持っていないのでGが出ませんし，実はランプそのものがy=2.0のガンマ特性を持っているので，そのあたりの補正が入っています。 Philips Hue Lightstripあたりを使う場合は通常のRGB LEDランプのように使用できると思いますから，計算式を変えたほうがよいかもしれません。

Author

神奈川工科大学 創造工学部 ホームエレクトロニクス開発学科．

Dept. of Home Electronics, Faculty of Creative Engineering, Kanagawa Institute of Technology.

杉村　博

SUGIMURA, Hiroshi

Log

0.0.5 developer nameを確認するようにした。lan内に複数ブリッジある時にうまくゆく。

0.0.4 dependenciesが理想とちがったのでやめる。

0.0.3 bug fix

0.0.2 node-hue-api 2.3.0に対応，dependenciesの追加とnupnpSearch対応。

0.0.1 とりあえず作る．