Skip to content

Utility to manage updating and monitoring the state of a SolarNode control.

License

Notifications You must be signed in to change notification settings

SolarNetwork/sn-control-toggler-js

Repository files navigation

SolarNetwork Control Toggler

Control Toggler is a helper class that uses the SolarNetwork Instruction API to request a SolarNode to set the value of a control to 1 (on) or 0 (off), and the SolarNetwork Datum Query API to track the value of the control.

The Instruction API is asynchronous and changing a control value requires the following steps:

  • Enqueue instruction to set control value
  • Wait for SolarNode to receive, execute, and update instruction status to Completed (or Rejected)
  • Wait for SolarNode to post updated control value datum for confirmation

Control Toggler handles these steps through a simple API for setting the desired value and using a callback function to get notified when the value changes.

Some example SolarNode plugins that support on/off switching are:

Use

To include the library in your NPM-based project, run the following:

npm i solarnetwork-datum-loader

API docs

The latest API documentation is published here, or you can build the API documentation by running the apidoc script:

npm run apidoc

That will produce HTML documentation in docs/html.

About

Utility to manage updating and monitoring the state of a SolarNode control.

Topics

Resources

License

Stars

Watchers

Forks