A Node.js implementation of rvl based on Web Assembly. For a fully functioning example, take a look at the Home Lights server I wrote.
Install using npm:
npm install rvl-nodeThe below code instantiates an RVL instance in controller mode, and then sets the animation pattern to be displayed on all other RVL devices listening on channel 1.
import { createManager } from 'rvl-node';
import { createWaveParameters, createSolidColorWave } from 'rvl-node-animations';
async function run() {
const manager = await createManager();
const controller = await manager.createController({
channel: 1
});
controller.setWaveParameters(createWaveParameters(
createSolidColorWave(0, 255, 255) // Set the LED animation to solid red in the HSV space
));
}
run();Note: the signatures below use the TypeScript definitions for clarity. The types are not enforced in pure JavaScript, so in theory you can mix and match, but honestly I never tested that scenario and have no idea what will happen.
If you're not familiar with TypeScript syntax, there are basically three things you need to know:
- A variables type is specified after the variable name, and separated by a
:. For example,x: numbermeans we have a variable namedx, and it's a number. - A
?after the variable name and before the:means that the variable is optional. For example,{ x?: number }means thexproperty in this object can be left out.
Gets the list of available network interfaces that RVL Node can use. To be considered valid, it must have an IPv4 address, and the name must start with en, eth, wlan, Wi-Fi, or Ethernet.
Signature:
function getAvailableInterfaces(): string[]Arguments: none.
Returns: a list of interface names that can be used with RVL Node
Gets the default network interface that RVL Node will use, if no value is supplied for networkInterface in a call to createManager.
Signature:
function getDefaultInterface(): string | undefinedArguments: none.
Returns: The name of the interface that will be used, or undefined if there is no suitable interface.
Instantiates a new RVL manager, which can be used to create controllers.
Signature:
interface IRVLManagerOptions {
networkInterface?: string;
port?: number;
}
function createManager(options?: IRVLManagerOptions): Promise<RVLManager>Arguments:
| Argument | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| options | Object | The options to instantiate the RVL manager with | |||||||||
|
|||||||||||
Returns: a promise that resolves to the manager once the manager has been initialized.
This read-only property returns the network interface the manager is bound to.
This read-only property returns the IP address of the network interface the manager is bound to.
This read-only property returns the port the manager is bound to.
This read-only property returns the device ID that this manager will appear as to other RVL nodes. As of this writing, this is the last octet of the IP address.
Sets the wave parameters for the system. These parameters will be synced to any other RVL devices on this channel within 2 seconds at most. You can craft animation parameters by hand, but it's recommended to use the rvl-node-animations helper libraries instead. Crafting parameters by hand is a pain.
This method can only be called when the device is in controller mode, and cannot be called until the initialized event is emitted.
Signature:
interface IRVLControllerOptions {
channel: number;
logLevel?: LogLevel;
}
function createController(controllerOptions: IRVLControllerOptions): Promise<RVLController>Arguments:
| Argument | Type | Description |
|---|---|---|
| channel | number | The channel number to bind this controller to. |
| logLevel | LogLevel | The minimum log level to log. RVL controllers can log a lot of debug information if you want to see what it's doing. Default is Debug |
Returns: a promise that resolves to the controller once the controller has been initialized.
This read-only property returns the channel the controller is bound to
This read-only property returns the log level the controller was initialized with
Sets the wave parameters for the system. These parameters will be synced to any other RVL devices on this channel within 2 seconds at most. You can craft animation parameters by hand, but it's recommended to use the rvl-node-animations helper libraries instead. Crafting parameters by hand is a pain.
This method can only be called when the device is in controller mode, and cannot be called until the initialized event is emitted.
Signature:
setWaveParameters(parameters: IWaveParameters): voidArguments:
| Argument | Type | Description |
|---|---|---|
| parameters | IWaveParameters | The wave parameters to set in the system. |
Note: for details on IWaveParameters, please see the documentation for rvl-node-types.
Returns: none.
Sets the power state for the controller. This is a handy way to turn off lights instead of setting the color to black.
Signature:
setPowerState(newPowerState: boolean): voidArguments: The power state, with true meaning "on" and false meaning "off."
Returns: none
Sets the brightness for the controller, between 0 and 255. This value sets the overall brightness on top of whatever the existing color is. If an existing HSV color is set to a value of 128 and then brightness is also set to 128, the output color will have a combined brightness of 64.
Signature:
setBrightness(newBrightness: number): voidArguments: The brightness, between 0 and 255
Returns: none
Copyright (c) Bryan Hughes bryan@nebri.us
This file is part of RVL Node.
RVL Node is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
RVL Node is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with RVL Node. If not, see http://www.gnu.org/licenses/.