feat(aura): support Dynamic Lighting sysfs interface with hidraw fallback

[scardracs]

Description

This draft introduces support for the Linux kernel Dynamic Lighting LED class interface (/sys/class/leds/aura:*) across asusctl, prioritizing the standardized sysfs interface while maintaining seamless fallback to legacy USB hidraw for backward compatibility with older kernels. It is based on that draft and as such NOT suitable for daily usage.

NOTE: due to heavy work on both here and linux the text on that OP can or cannot be accurate

Key Changes:

1. rog-platform (DynamicLed):
   • Implemented DynamicLed sysfs abstraction for interacting with /sys/class/leds/<device>/.
   • Added support for reading/writing effect, effect_index, speed, speed_range, direction, direction_index, effects_palette (#RRGGBB format), direct_buffer, brightness, and power_states.
   • Added unit tests validating palette string formatting and parsing.
2. rog-aura:
   • Implemented bidirectional conversions between ROG Aura enums (AuraModeNum, Speed, Direction, AuraEffect) and Dynamic Lighting sysfs strings/palettes.
   • Added unit tests covering all effect, speed, direction, and RGB palette conversions.
3. asusd (3-Device Multi-Zone Dynamic Lighting & Fallback):
   • Probes for aura:global, aura:keyboard, and aura:lightbar during Aura laptop initialization.
   • Independent Zone Routing:
     • Global requests (AuraZone::None) route to aura:global (firmware AURA_ZONE_ALL) for atomic aggregate updates across all zones.
     • Keyboard requests (AuraZone::Key1..4) route to aura:keyboard without interrupting lightbar animations.
     • Lightbar requests (AuraZone::BarLeft / BarRight) route to aura:lightbar without disturbing keyboard lighting.
   • Fallback: Preserves the legacy hidraw handle and transparently falls back to direct HID reports if Dynamic Lighting is unsupported on older kernels.
   • Cleanup: Removed legacy commented-out AniMe HIDRAW probe code in maybe_anime_hid.
4. asusctl:
   • Fixed clippy::manual_slice_fill in examples/anime-diag.rs.

---

Tested Hardware & Environment

• ASUS Laptop Model: ROG Strix G16 (G614PR)
• Linux Distribution: Arch Linux / OpenGamingCollective
• Kernel Version: 7.3.0-rc1+ (with Dynamic Lighting patch series)

---

Verification and testing:

• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My code follows the style guidelines of this project (cargo fmt --all -- --check)
• My changes generate no new warnings (cargo clippy --all -- -D warnings/cargo check --all-targets)
• New and existing unit tests pass locally with my changes (cargo test --all)
• Cranky with 0 warning (cargo cranky)

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}