A Node.js library enabling the use of various Phidgets interface boards.
npm install phidgets
>In 2017, Phidgets Inc. released version 22 of their API.
>This version of the API bears very little resemblance to version 21 which this module was
>written for. Furthermore, the new API was finally ported to
>JavaScript (both browser and Node.js).
>Given these changes, continuing to develop this module makes very little sense. So, it has
>been decided to discontinue its development.
>The code will remain here should you want to continue using it. You are welcome to fork it
>and use it in any way you please.
>Evan and Jean-Philippe were
>happy to provide a solution for the JavaScript world when none existed. Now that it's no
>longer the case, it's time to move on. Farewell...
Phidget boards are a great prototyping tool which can handle
digital inputs and outputs, along with a great array of analog sensors (RFID, temperature,
distance, etc.). Node.js and io.js are fantastic
networking library which makes it easy to create fast networked applications. This
project aims to make it simple for them to interact. Synergy!
For stand-alone Phidget Single Board Computers
(phidgetsbc), this assumes you have
configured the server via the web portal. Since you will be connecting to the Phidget
server via TCP, be sure you can access the server from the machine running this project.
This library can interface with multiple phidget boards connected to a single computer via
the Phidget WebService.
``javascript`
npm install phidgets
Phidgets Inc. makes a line of phidget boards which are
themselves small ARM Debian computers. It it possble to run Node.js on them, and use this
package locally. Here's a gist with the steps and a
blog post about how
to get this up and running.
The most common way to interact with a phidgets board is to set up listeners for
whatever you are interested in. For example, this code will log to the console all changes
detected on the analog sensor inputs of the device:
`javascript
var phidgets = require('phidgets');
var pik = new phidgets.PhidgetInterfaceKit();
pik.on('sensor', function(emitter, data) {
console.log('Sensor: ' + data.index + ', value: ' + data.value);
});
pik.open();
`
##### Using events
Obviously, many other events are available. The exact events vary with the device type. As
an example, here are the events specific to PhidgetInterfaceKit devices:
* "input" : triggered when a digital input changes status
* "sensor" : triggered when data is received on the analog sensors
* "output" : triggered when the status of a digital output changes
The following events are common to all phidgets:
* "opening" : triggered when a connection to a phidget board is attempted
* "reopening" : triggered when trying to automatically reconnect to a remotely-closed
phidget
* "timeout" : triggered when a connection attempt times out
* "opened" : triggered when a the connection attempt has succeeded and the board is
ready
* "closed" : triggered when the connection to the board has been closed (locally or
remotely)
* "error" : triggered when an error occured
##### Using chaining
Since all relevant functions are chainable, the above example can be written more
concisely:
`javascript
var phidgets = require('phidgets');
var pik = new phidgets.PhidgetInterfaceKit()
.on('input', function(emitter, data) {
console.log('Digital input: ' + data.index + ', value: ' + data.value);
})
.open();
`
##### Calling the open() method
When no parameters are passed to the open() method, the first matching device on the
local machine is used. If you have multiple devices connected, you can connect to a
specific one by passing its serial number or label (as defined in the Phidget WebService
control panel). You can also, if necessary, specify a password:
`javascript`
pik.open({
serial: 123456,
label: "mydevice",
password: "abc"
});
If you need, you can connect to devices on another machine:
`javascript`
pik.open({
host: "123.123.123.123",
port: 5001
});
##### Retrieving data from the board
As illustrated above, you can retrieve data by adding the appropriate listeners
('input', 'sensor', etc.). You can also, at any time, manually check the status of anyPhidgetLED
inputs, sensors, leds, outputs, etc. Depending on the type of board you are using, all of these
will or will not be available. For example, on a board, there are no inputsPhidgetLED.leds
or sensors. However, you can still read the state of all LEDS by looking at the object. This object will look like this:
`javascript`
{
0: 0,
1: 67,
2: 0,
3: 13,
// etc.
count: 64 // The total number of inputs/outputs/leds/etc. (as reported by the board)
}
For example, if you wanted to periodically check the status of an analog sensor hooked up
to port 3 of a , you could to the following:
`javascript
var phidgets = require('phidgets');
var pik = new phidgets.PhidgetInterfaceKit()
.on('opened', function(emitter) {
setInterval(
function() { console.log("Sensor 3: " + pik.sensors[3].value); },
1000
);
})
.open();
`
##### Sending data to the board
The outputs object is meant to be read-only. If you want to change the value of anPhidgetInterfaceKit
output, use the relevant method. For example, to change an output on a, you would use the PhidgetInterfaceKit.setOutput() method. To doPhidgetLED
the same on a , you would use PhidgetLED.setBrightness().
Currently, all interface kit boards are supported through the PhidgetInterfaceKit`
object. This includes boards such as:
* PhidgetInterfaceKit 8/8/8 normal and mini-format
* PhidgetInterfaceKit 2/2/2
* PhidgetInterfaceKit 0/16/16
* PhidgetInterfaceKit 8/8/8 (with and without hub)
Also included in the library is full support for the following boards:
* PhidgetBridge
* PhidgetLED
* PhidgetRFID
* PhidgetStepper
* PhidgetTemperatureSensor
If this primer wasn't enough, the full API documentation is available for download in
the docs folder. You can also view it online.
The API in version 0.5.0 and above has changed significantly and is not backwards-compatible
with version 0.4.0. If you need to maintain projects using the older version, you can still
download an archive of version 0.4.0.