Skip to content

Home

Jump to bottom
Robert McKenzie edited this page Mar 17, 2026 · 1 revision

Unleashed Creativity Lights Wiki

Welcome to the Unleashed Creativity Lights wiki.

This package is a VESC Express lighting accessory package for CAN-based lighting nodes, designed to work with Refloat. It supports a Master/Slave node model, configuration push from the master, targeted LED outputs per CAN node, and multiple riding and status display modes.

What this package does

Unleashed Creativity Lights gives you:

  • Refloat-driven light state and highbeam control
  • A two-role node model: Master and Slave
  • CAN-based peer discovery and config sync
  • Front, rear, and status LED outputs
  • LED target assignment using SELF (-1) or a peer CAN-ID
  • Main lighting modes:
    • White/Red
    • Battery Meter
    • Cylon
    • Rainbow Chase
  • Separate Idle, Startup, and Status behaviors
  • Optional Mall Grab and Brake Light behavior
  • Battery state-of-charge estimation from pack voltage and a selected discharge curve

Wiki pages

Important behavior to understand first

  • Refloat is authoritative for LED on/off and highbeam state. Manual on/off and highbeam toggles are intentionally disabled in the UI.
  • Master is the source of configuration. Slaves follow the master and store pushed configuration.
  • Default role is Slave. A fresh node is expected to join an existing master unless you explicitly make it the master.
  • The package is for VESC Express hardware. The code exits with an error if it is not running on hw-express.
  • Firmware 6.05 or later is required, and the source explicitly checks this during startup.

Recommended onboarding path

If you are setting up a new system, use this order:

  1. Install the package on every lighting node.
  2. Pick one node to become the Master.
  3. Leave all other nodes as Slave.
  4. Verify CAN IDs and set each slave's Master CAN-ID.
  5. Configure front, rear, and status strips on the master.
  6. Assign each strip target to SELF (-1) or a remote CAN-ID.
  7. Save the config from the master and confirm the slaves follow it.
  8. Test ride states, reverse behavior, idle mode, and brake light.

UI tabs at a glance

The package exposes these main tabs in the UI:

  • Config
  • Settings
  • Node Slave
  • About

On a slave node, the UI intentionally becomes simpler and shows that the node follows the master.

Clone this wiki locally