Add speaker settings: volume management, hardware controls, and LED controls

[danielpetrovic]

This PR adds 48 new methods (24 sync + 24 async) covering three related areas of speaker configuration that are currently missing from the library. All methods have been tested on LSX II, LSX II LT, and XIO hardware.

Volume Management (9 sync + 9 async)

Per-source default volumes and global volume settings:

• get_default_volume(input_source) / set_default_volume(input_source, volume) — per-source startup volume (wifi, bluetooth, optical, coaxial, usb, analogue, tv)
• get_all_default_volumes() — retrieve default volumes for all sources at once
• get_volume_settings() / set_volume_settings(max_volume, step, limit) — max volume cap, step size, and limit
• get_standby_volume_behavior() / set_standby_volume_behavior(use_global) — whether standby resumes at global or per-source volume
• get_startup_volume_enabled() / set_startup_volume_enabled(enabled) — startup volume override

Hardware Settings (11 sync + 11 async)

Speaker behaviour and connectivity settings:

• get_standby_mode() / set_standby_mode(mode) — standby timeout (off/20min/60min)
• get_startup_tone() / set_startup_tone(enabled) — power-on chime
• get_auto_switch_hdmi() / set_auto_switch_hdmi(enabled) — HDMI auto-source switching
• get_cable_mode() / set_cable_mode(mode) — wired connection mode
• get_master_channel() / set_master_channel(channel) — left/right master assignment
• get_wake_source() / set_wake_source(source) — which input wakes the speaker
• get_subwoofer_wake_on_startup() / set_subwoofer_wake_on_startup(enabled) — subwoofer auto-wake
• get_kw1_wake_on_startup() / set_kw1_wake_on_startup(enabled) — KW1 wireless sub auto-wake
• get_usb_charging() / set_usb_charging(enabled) — USB port charging
• get_fixed_volume_mode() / set_fixed_volume_mode(volume) — fixed output level for AV receivers
• set_request(path, roles, value) — generic write counterpart to the existing get_request()

LED Controls (5 sync + 5 async)

Visual indicator management:

• get_front_led() / set_front_led(enabled) — front logo LED
• get_standby_led() / set_standby_led(enabled) — standby indicator LED
• get_top_panel_enabled() / set_top_panel_enabled(enabled) — top touch panel
• get_top_panel_led() / set_top_panel_led(enabled) — top panel LED in active state
• get_top_panel_standby_led() / set_top_panel_standby_led(enabled) — top panel LED in standby

Notes

• All methods follow the same pattern as existing code (sync uses requests, async uses aiohttp)
• Input validation and clear error messages included throughout
• set_request() mirrors the existing get_request() signature for consistency

What's Coming Next

This is the first in a series of focused PRs. The full set of new endpoints was discovered by decompiling the KEF Connect Android APK (v1.26.1) using JADX, which gave us a definitive list of all 209 KEF API paths from ApiPath.java. Subsequent PRs will cover:

• EQ & DSP — get_eq_profile / set_eq_profile, desk mode, wall mode, bass extension, treble, balance, phase correction
• XIO features — room calibration, BLE subwoofer firmware updates, dialogue mode, sound profiles
• Device information — serial number, hardware version, KEF ID, full device info
• Firmware updates — check, download, and install speaker firmware
• Network diagnostics — internet ping, speed test, network stability
• Privacy & streaming — analytics settings, streaming quality, UI language
• Alerts & timers — alarm sounds, sleep timers

The goal is to eventually have complete API coverage in pykefcontrol, which will enable a much richer hass-kef-connector integration with full speaker configuration from Home Assistant.

[danielpetrovic]

Update — rebased onto latest main + firmware v4.0/3.0/2.0 fixes included

This branch has been rebased onto upstream main (which includes your 530a7d1 LS50WII POST fix). We have extended that approach with a firmware-version-based _set_data() helper that covers all models, since different models crossed to POST at different firmware versions:

Model	POST threshold	Status
LS50W II	>= V4000 (fw 4.0)	Released
LSX II LT	>= V2000 (fw 2.0)	Released
LSX II	>= V3000 (fw 3.0)	Released
LS60 Wireless	>= V3000 (fw 3.0)	Upcoming

The _set_data() helper auto-detects the model and firmware version on first write (lazy, cached), then routes to POST or GET accordingly. This supersedes the _POST_MODELS set approach and requires no manual configuration.

All setter methods in this PR use _set_data() and will automatically use POST or GET based on the detected firmware.

[danielpetrovic]

Update — rebased onto 0.9.1 (LSX II LT fix)

Rebased again onto your latest 421ae33 commit which adds LSX II LT to _POST_MODELS. The firmware-version-based _set_data() already covered this case (LSXIILT threshold >= V2000), so no changes were needed — the rebase just ensures the branch stays current with upstream.

[danielpetrovic]

Update — branch rebased and expanded

This branch has been rebased onto the latest upstream main (includes your LSXIILT fw2.0 fix from 421ae33). One additional commit has been added on top of the original speaker settings work:

Add LSXII fw3.0 POST support, LSX2 alias, and raise_for_status

• LSXII fw3.0 — Added "LSXII" to _POST_MODELS so setData calls use POST on fw3.0 (GET returns 405). This supersedes and closes PR Fix LSXII FW3.0 support #16.
• LSX2 alias — Added "LSX2" → "LSXII" to _MODEL_ALIASES so older firmware or API responses using the legacy name still resolve correctly.
• raise_for_status() — Added before every response.json() call (both sync and async) so HTTP errors surface instead of being silently swallowed. This incorporates and supersedes PR Correctly raise exceptions for HTTP errors #15 by @leccelecce — full credit to them for identifying the issue.

[danielpetrovic]

Update — rebased onto 0.9.3 + LS60Wireless alias

Rebased onto upstream main (0.9.3), which already includes LS60 in _POST_MODELS. One new commit on top:

• Added "LS60Wireless": "LS60" to _MODEL_ALIASES — hass-kef-connector (PR #17) uses "LS60Wireless" as the model key (matching the product name). Without this alias, LS60 owners on that integration would fall back to GET-based setData and hit 405 errors with firmware 4.0+.

[danielpetrovic]

Update — XIO and LS60W POST support added

Following up on the LS60Wireless alias added in the previous update:

• Added "XIO" to _POST_MODELS — XIO firmware 1.4.135 switched setData to POST. Verified working on XIO fw1.4.135.
• Replaced "LS60" with "LS60W" in _POST_MODELS — LS60 firmware renamed the model ID (reported in issue #18). Added "LS60": "LS60W" alias for backward compat with older firmware.

These same fixes are also available as a standalone PR (#19) if a faster targeted merge is preferred.