This project used for installing on Raspberry Pi.
LED Strip is connected to Raspberry Pi GPIO pins.
This program opens TCP server on port 3384 and waits for plain TCP packets, created as described below.
If builded with libwebsockets library and with DWITH_WS=ON flag, PiLED opens 3385 port as WebSocket server and waits for "RED,GREEN,BLUE,DURATION" data.
If builded with microhttpd library and with DWITH_HTML=ON flag, PiLED opens 3386 port as HTML server and waits for ?R={red}&G={green}&B={blue}&DURATION={dur} GET request.
Note that HTML and WS servers skips all security checks, so make sure to not expose these ports to WAN and create additional layer of security by network side if used.

• Basic color change
• Smooth color change from current color to desired with given timing
• Fade and Pulse animations
• OpenRGB SDK support (refer to OpenRGB section)
• WebSocket support for simpler controlling.

LED PROTOCOL v4 Simply contains HEADER + HMAC-SHA-256 + PAYLOAD
Currently max buffer size: 8+8+1+1+32+1+1+1+1+1 = 55 bytes.

Must be generated with SHA-256 algorithm with using shared_secret which writed in both client and server and data must be used header+payload: HMAC(SHA-256, shared_secret, header + payload)

Request size: 55 bytes (HEADER + HMAC + PAYLOAD)
Response size: 0 bytes (no response)
Sets up RGB color, defined in PAYLOAD to GPIO pins.

Request size: 50 bytes (HEADER + HMAC without PAYLOAD)
Response size: 0 bytes (no response).
Triggers SYS_COLOR_CHANGED call, which will send current color.

Request size: 55 bytes (HEADER + HMAC + PAYLOAD)
Response size: 0 bytes (no response)
Starts FADE animation. To PAYLOAD must be added Speed field as described at PAYLOAD Structure

Request size: 55 bytes (HEADER + HMAC + PAYLOAD)
Response size: 0 bytes (no response)
Start PULSE animation. In PAYLOAD must be provided color fields and Duration.

Request size: 55 bytes (HEADER + HMAC + PAYLOAD)
Response size: 0 bytes (no response).
Toggles Suspend mode.
While suspended, it will turn off all lights and ignore all commands but SYS_TOGGLE_SUSPEND. On suspend off will set given color from payload.

Request size: 0 bytes (no response).
Response size: 55 bytes. (HEADER + HMAC + PAYLOAD)
Sends info about new color to all clients.

1. Generate Timestamp and Nonce
   • Timestamp: Use Unix time (seconds since January 1, 1970). (64-bit)
   • Nonce: Generate a random number to ensure each request is unique. (64-bit)
2. Prepare the Payload
   • The payload contains the actual data to be sent to the server, such as the color value.
3. Generate the HMAC
4. Pack package and send to server

1. Receive and Parse the Request
   • Receive the header, HMAC, and payload.
2. Verify Timestamp and Nonce
   • Ensure the timestamp is recent and the nonce hasn’t been used before.
3. Recompute the HMAC
   • Data to HMAC: Concatenate the header and payload.
   • HMAC Calculation: Recompute the HMAC using the shared secret.
   • Compare the recomputed HMAC with the received HMAC. If they match, proceed; if not, reject the request.
4. Process the Request
   • Process the color value from the payload.

• RPi with running pigpiod
• libssl-dev
• libconfig
• libwebsockets (optional, for WS server support for trusted networks)
• libmicrohttpd-dev (optional, for HTML server support for trusted networks).

• git clone --recursive https://github.com/PolisanTheEasyNick/PiLED
• cd PiLED
• mkdir build
• cd build
• cmake -DWITH_HTML=ON -DWITH_WS=ON .. (flags are optional.)
• make
• ./piled

You can also install piled to your system using:
sudo make install
which will copy executable to ${CMAKE_INSTALL_BINDIR}, which often refers to /usr/local/bin/piled along with config file copy at /etc/piled/piled.conf and systemd service file at /etc/systemd/system/piled.service.

For WebSockets support you need to install libwebsockets library.
Unfortunately, on Raspbian it needs manual building:

• git clone https://libwebsockets.org/repo/libwebsockets
• cd libwebsockets
• mkdir build
• cd build
• cmake ..
• make
• sudo make install After this steps you can remake piled with -DWITH_WS=ON flag and it will be builed with WebSockets support.

For HTML server support, you need to install libmicrohttpd-dev package and rebuild with -DWITH_HTML=ON CMake flag.

You can configure PiLED by editing config file /etc/piled/piled.conf or by copying him into ~/.config/piled.conf and editing at home dir.
Note that systemd service is not running as any user so it may not find your home directory by $HOME.
If you want OpenRGB device changing too, do not forget to define OPENRGB_SERVER at config file and run openrgb_configurator as described at OpenRGB section.

PiLED supports connecting to OpenRGB server for setting current color to PC's controllers.
For configuring OpenRGB you need to specify OpenRGB server IP and port.
Then you need to run openrgb_configurator executable with root perms, which is built along with piled.
Root is needed because configurator will create file with your picked PC's controllers at /etc/piled/openrgb_config (and later will be read by systemd service, for example).
After OpenRGB is set, any requests for changing color to PiLED would be automatically retranslated to OpenRGB server and your PC will be in-sync with PiLED.