Control4 WLED CCT Driver

A Control4 DriverWorks driver for WLED devices with native tunable-white (CCT) support. One driver instance per WLED segment, using the Lightv2 proxy for native color-wheel / brightness controls in Composer Pro and Navigator.

Status: v1.0.0.

Why this driver

Commercial WLED drivers for Control4 (Chowmain, Aircoookie WLED Project, Innovo) either cost money, require dealer relationships, or only expose WLED presets as discrete scenes without a native CCT slider. This driver gives Control4 direct CCT control for discrete warm-white + cool-white PWM LED strips driven by controllers like the QuinLED-An-Penta-Plus.

Scope (v1)

• Tunable white (CCT) segments: color temperature slider 2700K-6500K + brightness
• Brightness-only segments (single-channel white): brightness slider only
• Activate any saved WLED preset from Control4 programming (dynamic dropdown)
• HTTP polling with graceful offline handling

Out of scope (v1)

• RGB / RGBW control
• Multi-device auto-discovery
• Effect / animation control from C4
• Audio-reactive features
• DriverCentral cloud licensing

Docs

• Design spec -- architecture, components, data flow, testing

Local development

1. Copy .env.example to .env.local (gitignored) and set WLED_TEST_IP to a reachable WLED device.
2. scripts/build.sh -- produces build/wled_cct.c4z via the official drivers-driverpackager.
3. lua tests/run_tests.lua -- runs unit tests.

See docs/dev-notes.md for ongoing development notes.

License

MIT -- see LICENSE.