Pi-led-control NPM

Raspberry Pi LED Control ·

Control different types of LEDs from your Raspberry Pi.

Features

Control different types of LED and LED arrays from your application.
- Single channel
- Multi channel (e.g. RGB)
- LED segment displays
Flash LEDs at any frequency.
Animate your LEDs using your own custom functions.

Necessary supplies

Raspberry Pi (any should do, as long as it has GPIO).
LED(s).
Any necessary resistors/transistors.

Hardware instructions coming sometime in the future.

Usage

Basic Example

const { LED } = require("pi-led-control");
// Other imports: LEDArray, Animation, Curves

const led = new LED(3);
led.write(true);
led.off();

More Examples

More examples of how to use all the available imports are available in the /examples folder.

Specifications

TODO. For now, please refer to the examples and JSDocs within the code.

Development

Prerequisites

You must install Node.js and NPM before beginning to develop or use this library. Currently, only Node LTS v12, v14, and v16 are tested. Any other version is not guaranteed to work.

It's recommended you install Node.js and NPM using nvm.

Setting up Dev Environment

Run the following script in order to begin development:

git clone https://github.com/rpitv/pi-led-control.git
cd pi-led-control/
npm install
npm run prepare

You are now ready to write code. All application code is located within /src. Begin writing in your .ts files. It is presumed you will not be developing on a Raspberry Pi. If you do, then you may run the application using npm start. Otherwise, use npm test to run unit tests on your code.

Building

The library can be built with the following command:

npm run build

Building and deployment is handled by CI, if you wish to use the main NPM package.

Testing

A unit test suite is available for the full API. You may run the test suite by executing:

npm test

Since you presumably will not be developing on a Raspberry Pi, it's important to have a complete testing suite, particularly for components which interact with the Raspberry Pi GPIO pins.