feat: add support for AK001-ZJ21413 (0xB6) Surplife outdoor lighting

[asxzy]

Summary

• Adds support for AK001-ZJ21413 (0xB6) - Surplife outdoor permanent LED lighting with RGBW LEDs
• Introduces new PROTOCOL_LEDENET_EXTENDED_CUSTOM protocol for devices that only respond with extended state format (0xEA 0x81)
• Implements extended custom effect commands (0xE1 0x21/0x22) supporting 24 unique animated patterns with customizable colors, speed, density, and direction

New Features

Device Support:

• Surplife outdoor permanent lighting (model 0xB6) with single white LED channel

Extended Custom Effects (0xE1 0x21):

• 24 animated patterns: wave, meteor, streamer, chase, breathe, strobe, fireworks, comet, rainbow bridge, and more
• Configurable parameters: up to 8 colors, speed (0-100), density (0-100), direction (L→R/R→L)
• 2 static patterns: static gradient and static fill

Segment Colors (0xE1 0x22):

• Set individual colors for each of 20 segments on the light strip

New API Methods:

• async_set_extended_custom_effect(pattern_id, colors, speed, density, direction, option)
• async_set_custom_segment_colors(segments)

Technical Changes

• New ProtocolLEDENETExtendedCustom class extending ProtocolLEDENET25Byte
• Uses HSV+W color format internally: [H/2, S, V, 0x00, W] (5 bytes per color)
• Fixed state message processing to check extended state format before standard format
• Added extract_model_version_from_state() helper for consistent model/version extraction
• construct_levels_change() uses STATIC_FILL pattern (0x66) for solid RGBW colors

Test plan

• Unit tests for 0xB6 device state parsing and protocol detection
• Tests for extended custom effect command construction
• Tests for segment color command construction
• Tests for RGBW level changes via STATIC_FILL pattern
• Manual testing with physical Surplife device

[codecov]

Codecov Report

❌ Patch coverage is 69.03226% with 192 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
flux_led/fluxled.py	23.11%	148 Missing and 15 partials ⚠️
flux_led/timer.py	90.66%	6 Missing and 8 partials ⚠️
flux_led/aiodevice.py	74.07%	6 Missing and 1 partial ⚠️
flux_led/protocol.py	95.27%	6 Missing ⚠️
flux_led/base_device.py	95.74%	1 Missing and 1 partial ⚠️

Files with missing lines	Coverage Δ
flux_led/const.py	100.00% <100.00%> (ø)
flux_led/device.py	73.46% <100.00%> (+0.98%)	⬆️
flux_led/models_db.py	98.98% <100.00%> (+0.08%)	⬆️
flux_led/pattern.py	100.00% <100.00%> (ø)
flux_led/base_device.py	95.62% <95.74%> (-0.01%)	⬇️
flux_led/protocol.py	98.61% <95.27%> (-0.53%)	⬇️
flux_led/aiodevice.py	94.94% <74.07%> (-1.31%)	⬇️
flux_led/timer.py	81.77% <90.66%> (+20.13%)	⬆️
flux_led/fluxled.py	22.66% <23.11%> (+22.66%)	⬆️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[asxzy]

Hi codeowners,

I have a outdoor light by Surplife installed few days ago. The controller is not supported by the project -- "Cannot determine protocol" . The protocol is supported, but the device is not mapped in. I did most of the code via AI, and the feature is verified manually.

Let me know if anything is missing before merging it in. Once it is in, I can request change to integrate this with home assistant.

Yi

[Copilot]

Pull request overview

This PR adds support for the Surplife outdoor permanent LED lighting system (model 0xB6, AK001-ZJ21413). The device exclusively uses the extended state format (0xEA 0x81) introduced in PR #428, requiring modifications to message handling priority and protocol determination logic to support devices that only respond with this format.

Changes:

• Modified message processing order to check extended state format before regular state format to support extended-state-only devices
• Enhanced protocol determination to extract model and version information from extended state messages
• Added byte position constants for parsing state messages to improve code maintainability
• Added complete model and hardware definitions for the 0xB6 device with RGB+CCT color modes

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
flux_led/aiodevice.py	Reordered message processing to prioritize extended state format and added protocol determination support for extended state responses
flux_led/base_device.py	Enhanced _set_protocol_from_msg() to handle both standard and extended state formats using byte position constants
flux_led/protocol.py	Added byte position constants and extended state validation methods to base protocol classes
flux_led/models_db.py	Added model definition for 0xB6 Surplife device and hardware configuration entry
tests/test_sync.py	Added sync API test for 0xB6 device identification and protocol validation
tests/test_aio.py	Added async API tests covering extended state setup and protocol validation

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[asxzy]

Hi @bdraco , I originally thought I can add the device in with existing protocol and call it a day. The existing protocol can perform on/off solid color change well, but the app is providing more features that is not use by other devices. When I doing more package capturing and analysis, I found this device is taking more command that change the pattern and segments. I think it will be cleaner to start a new protocol instead. Will update this PR later.

[asxzy]

@bdraco codecov failed and I can't see the detailed message. Let me know if anything need to be adjusted.

[asxzy]

flux_led/fluxled.py does not have unit test and it is out of scope of this PR. I will skip it for now.

[asxzy]

@bdraco let me know if anything is missing.

[bdraco]

I just came back to have a look at this and it looks like its nearly doubled in size. Its too large to review now. I only have a few time blocks to do reviews for large PRs (which is why its taken me so long to get back tot his), and the size makes it impossible to find a time block to review this all in one pass.

[bdraco]

Thanks for the work here; this PR has grown quite large (about 3600 additions across 11 files), which makes it hard to review in one pass. Could you split it into a few stacked PRs? A rough suggestion: one PR for the models_db and const entry for 0xB6, one for the new ProtocolLEDENETExtendedCustom class and the extended state parse reorder, one for the extended custom effect and segment color APIs, one for the fluxled CLI additions, and one for the timer.py changes (or drop those if they are unrelated). Smaller PRs are easier to review carefully and easier to revert if something regresses downstream.