npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

fake-isy-994i

v0.2.2

Published

Node.js server that acts like a ISY-994i. Unsupported and no longer under active development.

Downloads

117

Readme

fake-isy-994i

(C) Rod Toll 2015-2017, Licensed under the MIT-LICENSE.

ACTIVE DEVELOPMENT & SUPPORT SUSPENDED

I am suspending support for this project. This means I will no longer be addressing any open bugs, responding to feature requests or releasing new versions. Between work and my home life there simply isn't the time. I will leave the repository online and the package on npm but that is it. As this code is licensed under the MIT license you are of course welcome to branch this code and make it your own and use it in your own projects -- but you do so, as always, with no warranty or support from me.

Old Readme..

Provides an express based server which emulates an ISY-99i/994i from Universal Devices. (http://www.universal-devices.com). For information on the ISY's rest interface see the Universal Devices SDK here: https://www.universal-devices.com/isy-developers/.

Purpose

I built this project so I could test libraries and applications which interface with the ISY without having to go against my live device. The occupants of the house don't appreciate lights turning on and off randomly as I run unit tests. I felt this was a stronger solution then local mocks as they can be used to test against from multiple languages. I use it to test my Node.js Node library: https://github.com/rodtoll/isy-js. Hopefully you find it useful!

Getting Started

First clone the repository and then run the server:

1. $ git clone https://github.com/rodtoll/isy-js.git
2. $ cd isy-js
3. $ npm install
4. node start.js

How It Works

The server loads configuration from three files which represent the state of the ISY:

  • nodeFile - The results of a call to /rest/nodes. This includes the list of folders, devices and scenes.
  • elkStatusFile - The results of a call to /elk/get/status. This shows the status of the elk devices.
  • elkTopologyFile - The results of a call to /elk/get/topology. This shows the toplogy of the elk network.
  • variable1File - The results of a call to /rest/vars/definitions/1. This shows variables isy is supporting of type 1.
  • variable2File - The results of a call to /rest/vars/definitions/2. This shows variables isy is supporting of type 1.

The server uses this to initialize a server which allows you to operate on the devices specified. Not all operations are supported, but the basics are.

See Supported Operations for which operations have been implemented.

In Code

The server is simple to start. Just import the server object, setup your config options, create a server and start it.

Included right in your project:

var ISYServer = require('ISYServer').ISYServer

// Setup config options
var config = {};

var server = new ISYServer(3000,config);
server.start();

Instructions when pulled in via npm coming soon once package is published.

Configuration Options

The second parameter to the ISYServer constructor is a config object. There are a number of optional parameters you can specify in the object. All are optional as all have defaults.

Configuration options:

  • loggerEnabled - Set to true to have log messages sent to the console, false otherwise. Default: true
  • elkEnabled - Should the server support elk operations. (Not all are supported yet). Default: true
  • extendedErrors - Should the server include additional error information in responses to help with debuging. The messages appear in the tag in the response body. Default: true
  • userName - What username does the server expect? Default: admin
  • password - What password does the server expect? Default: password
  • requireAuth - Should auth be enforced? Useful if you just want to experiment before getting your auth setup.
  • nodeFile - Fully qualified path to file containing raw results of a call to an ISY in the /rest/nodes path. See example-nodes.xml for a sample.
  • variable1File - Fully qualified path to file containing raw results of a call to an ISY in the /rest/vars/definitions/1 path. See example-variables-1.xml for a sample.
  • variable2File - Fully qualified path to file containing raw results of a call to an ISY in the /rest/vars/definitions/2 path. See example-variables-2.xml for a sample.
  • elkStatusFile - Fully qualified path to file containing raw results of a call to an ISY with elk enabled in the /rest/elk/get/status. See example-elk-status.xml for a sample (and it is the default).
  • elkTopologyFile - Fully qualified path to file containing raw results of a call to an ISY with elk enabled in the /rest/elk/get/topology. See example-elk-topology.xml for a sample (and it is the default).
  • logResponseBody - Should the body of responses being sent be sent to the log. Default: false
  • logWebSockets - Should the body of messages sent to websockets be sent to the log. Default: false
  • failVariableCalls - Should calls to get variable state fail? This emulates behavior of ISY when no variables are set.

Sample:

var config = {
    loggerEnabled: true,
    elkEnabled: true,
    extendedErrors: true,
    userName: 'admin',
    password: 'password',
    requireAuth: true,
    nodeFile: './example-nodes.xml',
    elkStatusFile: './example-elk-status.xml',
    elkTopologyFile: './example-elk-topology.xml',
    logResponseBody: false,
    logWebSockets: false
}

NOTE: start.js shows all options specified and they are set to their defaults.

Supported Operations

The following REST operations are supported:

  • /config/reset - Drops all websocket connections, resets all devices and nodes back to the state as specified in the nodeFile, elkStatusFile and elkToplogyFile.
  • /config/<configname>/<configValue> - Sets the configuration value specified to the specified value. boolean should be true or false (case sensitive). NOTE: If you change any of the file parameters you will need to do a reset (as above) to load the new configs.
  • /rest/nodes/<ISY Address>/cmd/DON - ISY on operation.
  • /rest/nodes/<ISY Address>/cmd/DON/<dimlevel> - ISY on with dim level operation.
  • /rest/nodes/<ISY Address>/cmd/DOF - ISY off operation.
  • /rest/nodes/<ISY Address>/cmd/DFON - ISY Fast On operation.
  • /rest/nodes/<ISY Address>/cmd/DFOF - ISY Fast Off operation.
  • /rest/nodes/<ISY Address>/cmd/BEEP - ISY BEEP operation.
  • /rest/nodes - ISY Get nodes operation.
  • /rest/elk/get/topology - ISY Get elk topology operation.
  • /rest/elk/get/status - ISY Get elk topology operation.
  • /rest/vars/definitions/<type> - ISY get variable definitions of the specified type.
  • /rest/vars/get/<type>/ - Get current state of all the variables of the specified type.
  • /rest/vars/get/<type>/<id> - Get the current state of the variable of the specified type and id.
  • /rest/vars/set/<type>/<id>/<value> - Sets the current value of the variable of the specified type and id.

Additionally, websocket and web notifications are supported as per the ISY documentation.

Notifications supported:

  • Initial device state for all devices
  • Device state changes
  • Variable changes

Notifications not yet supported:

  • Initial response including client id
  • Elk device notifications / alarm state notifications.
  • All other notification types not listed above.

Example Configuration

The example files included are from an actual server which has a large network (200 devices including scenes). It has Elk, ISY and ZWave devices included.

TODO

  • Command-line overrides for config.
  • Support for programs.
  • Support for Elk commands.
  • Support for alarm state.
  • More robust websocket support. Fill out rest of notifications.
  • Tighten validation on websocket connectivity. Current implementation is more forgiving then the actual ISY.