heartbeat-led-pi
A TypeScript implementation of a heartbeat LED for Node.js on a Raspberry Pi.
Table of Contents
1. Description
This is a simple TypeScript implementation of a heartbeat LED for Node.js on a Raspberry Pi. It pulses a LED connected to a GPIO every 2s for 10ms.
2. Installation
This framework is available as a Node.js-module. You can thus use Node.js' package manager npm
to install the latest production version from the npm registry. Depending on your use case, the installation method differs slightly.
2.1 Standalone application
For using the standalone application it is best to install the package globally by running the following command.
sudo npm i -g --unsafe-perm @henningkerstan/heartbeat-led-pi
2.2 Library
For using the library in your own application install the package locally by running the following command
npm i @henningkerstan/heartbeat-led-pi
in your project's directory.
3. Usage
3.1 Standalone application
Once the package is installed, you can run it with
heartbeat-led-pi 4
if your LED is connected to GPIO pin 4; otherwise simply change to the GPIO pin you use.
3.2 Use the library in your own application
Since this framework is written in TypeScript, you can use it both with TypeScript as well as with plain JavaScript. Below you can find short examples to get you started in both languages.
The library also comes with an online documentation. A good starting point for further reading is the documentation of the HeartbeatLED class. Moreover, as this documentation is generated from source code comments using TypeDoc, a supported editor (like Visual Studio Code) can provide on-the-fly information on functions, parameters, etc..
All major functionality is contained in the HeartbeatLED class, hence you will most likely only need to import this class:
import { HeartbeatLED } from '@henningkerstan/heartbeat-led-pi'
and then create an instance of that class for each heartbeat LED you require. Have a look at the source code of the standalone application and the documentation of the HeartbeatLED class to see how it works in detail.
4. Contributing
Contact the main author (Henning Kerstan) if you want to contribute. More details will be available here soon.
This project uses semantic versioning.
5. Version history
Please have a look at the git commit log for a version history.
6. License
Copyright 2021 Henning Kerstan
SPDX-License-Identifier: Apache-2.0