0.10.0

[crowbarz]

Major refactoring has been completed on the aiopioneer library that underpin this HA integration. For HA integration users, the main impact of the refactoring is that the integration disconnects from the AVR only when the network connection drops, and no longer when an AVR command times out or when a code error causes an exception to be thrown. The order of query commands sent to the AVR has also changed, though this is not expected to cause any issues. The full list of changes to aiopioneer are listed in the release notes.

A new option always_poll has been added to always poll the AVR every scan interval. Enable this option, optionally along with disable_auto_query to reduce the number of queries sent during each poll, on AVRs where power and volume are not updated in HA in real time when they are changed directly on the AVR via the front panel and/or the remote.

Breaking Changes

• From 0.10.0 onwards, it will no longer be possible to downgrade the integration to a version that uses an older config entry major version (currently 4). If this is encountered, the integration will refuse to start with a config entry migration error. You will need to either restore your HA configuration from a backup, or remove and re-add all instances of the integration to create a new config entry
• The HA integration debug options have changed - the free-form debug_config has been deprecated and replaced with discrete debug options for integration load/unload, config flow and actions that are configurable from the UI. The deprecated debug config is not migrated
• The recently introduced config_entry warning that appears when you reconfigure an integration instance has been fixed, but the fix may break reconfiguration on HA versions older than 2024.12

Major Changes

• Use PioneerAVR.query_device_model on initial connect by @crowbarz in Use PioneerAVR.query_device_model on initial connect #55
• Access params and AVR properties via new classes by @crowbarz in Access params and AVR properties via new classes #56
• Add config flow option for command queue debug by @crowbarz in Add config flow option for command queue debug #57
• Use discrete debug options by @crowbarz in Use discrete debug options #59
• Support PARAM_ALWAYS_POLL aiopioneer parameter by @crowbarz in Support PARAM_ALWAYS_POLL aiopioneer parameter #60

All Changes

• Add note to enable network standby on the AVR 512e42e
• Use param properties 56e23c6
• Use PioneerAVR.query_device_model on initial connect 37bc298 Use PioneerAVR.query_device_model on initial connect #55
• Access AVR params via pioneer.params and properties via pioneer.properties efbae03 Access params and AVR properties via new classes #56
• Use repr to show exception types and contents 5d85756
• Add config flow option for command queue debug de3c8c0 Add config flow option for command queue debug #57
• Refuse to downgrade config entry version 52fc5bb
• Support config entry minor_version 52fc5bb
• Add AM frequency step to FM and AM frequency number unrecorded attributes d64d493
• Move initial_refresh public property to system param PARAM_ZONES_INITIAL_REFRESH 96b2420
• Add System sensor 0845c6c
• Move zones_initial_refresh property to PioneerAVRParams 44fc05c
• Use cached source_name in PioneerAVRProperties 0a6d277
• Rename PioneerAVRProperties.source -> source_id 7081d85
• Rename aiopioneer.const.Zones class to Zone 7855d3d
• Simplify zone name creation afcd6a2
• Rename aiopioneer module param to params 48d8d19
• Refresh only relevant zone on update e2af9ad
• Use discrete debug options Use discrete debug options #59
  Use discrete debug bools to enable specific debug options instead of a JSON dict. Support enabling/disabling these from the UI. This is more discoverable as all possible debug options are now visible in the UI.
• Don't set config_entry in options flow subclass, fix warning from 2024.12 a5a0aea
  https://developers.home-assistant.io/blog/2024/11/12/options-flow/
• Rename DEBUG_SERVICE to DEBUG_ACTION to reflect HA terminology change d4c1094
• Support PARAM_ALWAYS_POLL aiopioneer parameter 2e217af Support PARAM_ALWAYS_POLL aiopioneer parameter #60
  • Add options flow UI for PARAM_ALWAYS_POLL parameter
  • Move config entry version IDs to consts
  • Bump config entry version to 4.2
• Change Zone.full_name to property b9b13eb
• Support sound mode only when zone is on and listening modes are available 048f19e
• Fail integration config flow and startup if model or main zone not detected 2cc57f5
• Enable speaker system, amp, dsp, video parameters and audio parameters global property groups by default 98cdf75
• Enable channel level zone property group by default 98cdf75
• 0.10 documentation updates f000106

Full Changelog: 0.9.2...0.10.0

---

This discussion was created from the release 0.10.0.