#led-strip #applications #control #chip #kinds #color #home

app new-home-ws281x

This application will control all kinds of LED strips based on the ws281x chip

5 stable releases

1.0.4 Jun 1, 2020
1.0.3 May 24, 2020
1.0.2 May 23, 2020

#483 in Images

MIT license

55KB
1K SLoC

Rust 1K SLoC JavaScript 145 SLoC // 0.2% comments

Pipeline Status creates.io

New Home WS 281x

This application will control all kinds of LED strips based on the ws281x chip.

Features (Planed)

Feature Status
Static color done
Gradient done
LED Rainbow done
Random, glowing, fading Lights next
Pre-Programmed light sequence next

Functional features

Feature Status
Gamma Correction done
Shader-Like rendering done
Fixed rendering TPS done
Set bind-address and port from arguments/config file next
Concurrent rendering future

Supported Chips

  • WS2811
  • WS2812(b)
  • SK6812RGB(W)
  • More WS281X chips could be supported with the WS2812 and WS2811 engines but I cannot guarantee any compatibility

Install and setup

Install

To install the application you have to run the (sudo) make install command in the project folder as the root user. This will install all necessary files where they are needed.

Configuration and resources of the application can be found in the /etc/new-home-ws281x directory.

Setup

For the setup I assume, that you can, by yourself, connect and troubleshoot your LED Strip/Matrix to the Raspberry PI.

For this application to work you need some things:

The default port on which the application runs is the 4232, and it listens an all IPv4 and IPv6 interfaces/addresses on the Raspberry PI.

Setup is as easy as for all applications. Add a new application in the Applications view in the UI, enter a name for the application, and the IP:PORT for the Raspberry PI. Now you can add devices to rooms, which are running on the PI. If you need help with the required channel, you can take a look into the settings of the application, where you can find a channel builder.

Uninstall

To uninstall this application you can just run (sudo) make uninstall. This will remove the application and all its configuration permanently.

Channel builder

To use the channel builder, you just click on the registered application in the applications view. There you will find 3 combo-boxes which show you the supported controller types, GPIO pins and RGB/BGR etc. mode, which you can perform on a pin.

The shown numbers represent the GPIO pins by their BCM number. For more information on which pin has which number, you can check out https://pinout.xyz/.

Footnote

Although the underlying framework (new-home-application and new-home-core) is not yet considered "stable" by the meaning of "api will not change" and "works without any crashes", this application, as it is, is considered stable under this term.

Dependencies

~4–7MB
~167K SLoC