API Docs for: 0.5.12
Show:

Phidget Class

Extends events.EventEmitter
Defined in: lib/phidgets.js:29
Module: phidgets

The Phidget class is an abstract class providing common properties and methods to all the board-specific child classes. This class cannot be instantiated directly. Please instantiate one of the child classes instead:

This object extends Node.js' events.EventEmitter object. See that object's documentation for inherited methods.

Constructor

Phidget

()

Defined in lib/phidgets.js:29

Throws:

Error:

Unsupported device type.

Methods

_forceBetween

(
  • value
  • min
  • max
)
protected

Defined in lib/phidgets.js:848

Returns the value after making sure it falls between min and max.

Parameters:

  • value Int | Number

    The value to check

  • min Int

    The minimum value desired

  • max Int

    The maximum value desired

Returns:

int

_handleData

(
  • chunk
)
private

Defined in lib/phidgets.js:511

This function is called each time data is received from the Phidget WebSerice. It adds the data to the input buffer and checks if full lines (separated by '\n') can be reconstructed. If full lines are found they are handed over to the _parseLineInput() method for processing.

Parameters:

  • chunk String

    A chunk of utf8 encoded text to parse

_makePckString

(
  • keyword
  • [index]
)
private

Defined in lib/phidgets.js:791

Returns a /PCK string built from the specified parameters. PCK strings are the keys sent out to control the board.

Parameters:

  • keyword String

    The operation keyword to use

  • [index] Int optional

    The index of the output to use

_parseLineInput

(
  • line
)
private

Defined in lib/phidgets.js:553

Parses a single line of data typically received from the Phidget WebService. If the line is a report line, the function hands it off to the _parsePskKey() method. Otherwise, it deals with it locally.

Parameters:

  • line String

    A non-terminated line of utf8 text

_parsePhidgetSpecificData

(
  • data
)
protected

Defined in lib/phidgets.js:761

Parses Phidget-specific data received from the Phidget WebService. This function is meant to be overridden by subclasses.

Parameters:

  • data Object

    An object containing the received data

    • device String

      The device identifier (e.g. PhidgetInterfaceKey, PhidgetLED, etc.).

    • label String

      The custom label set for the device.

    • serial Int

      The serial number of the device.

    • keyword String

      A keyword identifying the type of information conveyed. It could be 'Input', 'Version', 'DataRate', etc.

    • index Int

      The numerical index (for indexed keys only)

    • value String

      The actual value.

    • status String

      The status of the key. It could be: 'added', 'changed', 'removing', etc.

_sendLine

(
  • line
)
private

Defined in lib/phidgets.js:824

Sends a line of data to the webservice

Parameters:

  • line String

    A non-terminated line of data to send

_sendPck

(
  • key
  • value
  • [persistent=false]
)
private

Defined in lib/phidgets.js:807

Sends the /PCK string (with attached value) to the webservice.

Parameters:

  • key String

    A /PCK string (typically form the _makePckString() method)

  • value Int | String

    The value to set

  • [persistent=false] Boolean optional

    Whether the value should persist or whether its for the session only.

_setPhidgetSpecificInitialState

() protected

Defined in lib/phidgets.js:781

Sets phidget-specific state before the 'opened' event is triggered. This is a good place for subclasses to assign initial values to the board. This is meant to be overridden by subclasses.

addListener

(
  • event
  • listener
)
chainable

Defined in lib/phidgets.js:262

This is an alias for the on() method.

Parameters:

  • event String

    The event to add the listener for.

  • listener Function

    The callback function to execute when the event is triggered.

close

() Phidget chainable

Defined in lib/phidgets.js:396

Closes a previously opened connection to a Phidget device.

Returns:

Phidget:

Returns the Phidget to allow method chaining.

on

(
  • event
  • listener
)
chainable

Defined in lib/phidgets.js:271

Adds a listener to the end of the listeners array for the specified event. No checks are made to see if the listener has already been added. Multiple calls passing the same combination of event and listener will result in the listener being added multiple times.

This method is inherited from Node.js' events.EventEmitter object. See that object's documentation for more details methods.

Parameters:

  • event String

    The event to add the listener for.

  • listener Function

    The callback function to execute when the event is triggered.

once

(
  • event
  • listener
)
chainable

Defined in lib/phidgets.js:288

Adds a one time listener for the event. This listener is invoked only the next time the event is fired, after which it is removed.

This method is inherited from Node.js' events.EventEmitter object. See that object's documentation for more details methods.

Parameters:

  • event String

    The event to add the listener for.

  • listener Function

    The callback function to execute when the event is triggered.

open

(
  • [options={}]
)
Phidget chainable

Defined in lib/phidgets.js:333

Opens a connection to a Phidget device. Opening a connection is a two-step process. First, a connection to the Phidget WebService (which must be running) is established. Then, a session to the specified device (which must be plugged in) is opened.

Parameters:

  • [options={}] Object optional

    Options

    • [host="127.0.0.1"] String optional

      Hostname or IP address to connect to

    • [port=5001] Int optional

      Port to connect to

    • [serial] Int optional

      Serial number of the device to connect to

    • [label] String optional

      Label of the device to connect to (can be set in the Phidgets control panel).

Returns:

Phidget:

Returns the Phidget to allow method chaining.

removeAllListeners

(
  • [event]
)
chainable

Defined in lib/phidgets.js:303

Removes all listeners, or those of the specified event.

This method is inherited from Node.js' events.EventEmitter object. See that object's documentation for more details methods.

Parameters:

  • [event] String optional

    The event to remove the listeners for.

removeListener

(
  • [event]
  • listener
)
chainable

Defined in lib/phidgets.js:315

Removes a listener from the listener array for the specified event. removeListener() will remove, at most, one instance of a listener from the listener array. If any single listener has been added multiple times to the listener array for the specified event, then removeListener() must be called multiple times to remove each instance.

This method is inherited from Node.js' events.EventEmitter object. See that object's documentation for more details methods.

Parameters:

  • [event] String optional

    The event to remove the listeners for.

  • listener Function

    The callback function to execute when the event is triggered.

Properties

host

String

Defined in lib/phidgets.js:117

The host name or address of the Phidgets WebService to connect to.

Default: 127.0.0.1

interReportPeriod

Int

Defined in lib/phidgets.js:226

The delay (in milliseconds) between report updates sent from the webservice.

Default: 8

label

String

Defined in lib/phidgets.js:143

The unique label of the device. The label must have a maximum length of 10 characters. If you try to set a longer label, the remainder will be truncated. Labels are supported only on newer devices and are remembered even when the device is unplugged. A label can only be set after a Phidget has been 'opened'. Trying to set the label before that will fail silently.

Default: undefined

name

String

Defined in lib/phidgets.js:194

[read-only] Human-readable version of the board's name (i.e. "Phidget InterfaceKit 8/8/8". This information is only available some time after the connection has been successfully opened.

Default: undefined

password

String private

Defined in lib/phidgets.js:182

The password to connect to the WebService. If specified, it will be used when opening a new connection. As soon as connected the password property will be erased. THIS IS CURRENTLY SET TO PRIVATE BECAUSE IT'S NOT IMPLEMENTED YET!

Default: undefined

port

Int

Defined in lib/phidgets.js:125

The port of the Phidgets webservice to connect to.

Default: 5001

ready

Boolean

Defined in lib/phidgets.js:94

[read-only] Whether the device is ready for use or not. A device must be 'opened' before it can be used.

reopen

Boolean

Defined in lib/phidgets.js:109

Whether to try to automatically reopen the device if it gets remotely closed.

Default: true

serial

Int

Defined in lib/phidgets.js:133

The unique serial number of the device. If specified, it will be used to connect to the matching device.

Default: undefined

serverId

Int

Defined in lib/phidgets.js:167

[read-only] The unique ID of the Phidget WebService the device is currently connected to.

Default: undefined

supportedDevices

String[]

Defined in lib/phidgets.js:58

[read-only] Array of all the devices supported by this library.

type

String

Defined in lib/phidgets.js:81

[read-only] The type of device (i.e. PhidgetInterfaceKit, PhidgetLED, etc.).

version

String

Defined in lib/phidgets.js:210

[read-only] This number distinguishes between revisions of a specific type of Phidget. It is only useful for debugging purposes. This information is only available some time after the connection has been successfully opened.

Default: undefined

Events

closed

Defined in lib/phidgets.js:435

Event emitted when the connection to a phidget has been remotely closed.

Event Payload:

  • emitter Phidget

    The actual object that emitted the event.

error

Defined in lib/phidgets.js:493

Event emitted when an error occurs while trying to open a phidget

Event Payload:

  • emitter Phidget

    The actual object that emitted the event.

  • error Error

    The error object

    • address String

      The network address

    • code String

      The error code

    • errno String

      The error number

    • message String

      The error message

    • port String

      The network port

opened

Defined in lib/phidgets.js:585

Event emitted when a phidget is successfully opened.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.

opening

Defined in lib/phidgets.js:359

Event emitted when an attempt to open a Phidget has been initiated.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.

received

private

Defined in lib/phidgets.js:535

Event emitted when a new line of data has been received from the web service. This is mostly useful for debugging purposes (hence the @private denomination). It will let you view all data coming in.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.

  • data String

    The actual string data received.

reopening

Defined in lib/phidgets.js:461

Event emitted when an attempt to automatically re-open a closed Phidget is being carried on.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.

  • data Object

    Additional data regarding the event.

    • attempt Int

      The number of re-opening attempts performed.

    • max Int

      The maximum number of attempts that will be tried before failing.

sent

private

Defined in lib/phidgets.js:835

Event emitted when a new line of data has been sent to the Phidget WebService. This is mostly useful for debugging purposes (hence the @private denomination). It will let you view all data going out.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.

  • data String

    The actual string of sent data.

timeout

Defined in lib/phidgets.js:638

Event emitted when an attempt to open a Phidget times out.

Event Payload:

  • emitter Phidget

    The actual Phidget object that emitted the event.