Added placeholder installation instructions

README.md

@@ -13,6 +13,10 @@ Added support for the following features:
 - Automatically poll AVR for source names - no longer need to manually code them in your config any more if your AVR supports their retrieval.
 - Create devices and populate with model, software version and MAC address queried from AVR (if supported) when configured via the UI.
 
+## Installation
+
+This custom integration can be installed via HACS by adding this repository manually (documentation to come).
+
 ## Configuration
 
 This integration may be configured via the UI (`Configuration > Integrations > Add Integration`) or via `configuration.yaml`. It is recommended that all AVRs are configured using the same configuration method.
@@ -28,7 +32,7 @@ Configure these settings under `media_player`:
 | `name` | string | `Pioneer AVR` | The friendly name that you would like to give to the receiver.
 | `host` | string | **Required** | The DNS name or IP of the Pioneer device, eg., `192.168.0.10`.
 | `port` | integer | `8102` | The port on which the Pioneer device listens. This may be `23` if your AVR doesn't respond on port `8102`.
-| `scan_interval` | time_period | `60s` | Idle period between full polls of the AVR. Any response from the AVR (eg. to signal a power, volume or source change) will reset the idle timer. Some AVRs also send empty responses every 30 seconds, these also reset the idle timer and prevent a full poll from being performed.
+| `scan_interval` | time_period | `60s` | Idle period between full polls of the AVR. Any response from the AVR (eg. to signal a power, volume or source change) will reset the idle timer. Some AVRs also send empty responses every 30 seconds, these also reset the idle timer and prevent a full poll from being performed. Set this to `0` to disable polling.
 | `timeout` | float | `2.0` | Number of seconds to wait for the initial connection and for responses to commands. Also used to set the TCP connection idle timeout.
 | `sources` | list | `{}` | A mapping of source friendly-names to AVR source IDs, see [AVR sources](#avr-sources) below. To remove custom sources in the UI and query them from the AVR instead, enter `{}`.
 | `params` | object | `{}` | A mapping of parameters to pass to the Pioneer AVR API to modify its functionality, see [`params` object](#params-object) below.
@@ -53,23 +57,25 @@ The default parameters listed below are for AVR models that do not match any cus
 
 | Name | Type | Default | Description
 | ---- | ---- | ------- | -----------
-| `ignored_zones` | list | `[]` | List of zones to ignore even if they are auto-discovered.
-| `command_delay` | float | `0.1` | Insert a delay between sequential commands that are sent to the AVR. This appears to make the AVR behave more reliably during status polls.
+| `ignored_zones` | list | `[]` | List of zones to ignore even if they are auto-discovered. Specify Zone IDs as strings: "1", "2", "3" and "Z".
+| `command_delay` | float | `0.1` | Insert a delay between sequential commands that are sent to the AVR. This appears to make the AVR behave more reliably during status polls. Increase this value if debug logging shows that your AVR times out between commands.
 | `max_source_id` | int | `60` | Maximum source ID that the source discovery queries. Reduce this if your AVR returns errors.
 | `max_volume` | int | `185` | Maximum volume for the Main Zone.
 | `max_volume_zonex` | int | `185` | Maximum volume for zones other than the Main Zone.
 | `power_on_volume_bounce` | bool | `false` | On some AVRs (eg. VSX-930) where a power-on is set, the initial volume is not reported by the AVR correctly until a volume change is made. This option enables a workaround that sends a volume up and down command to the AVR on power-on to correct the reported volume without affecting the power-on volume.
 | `volume_step_only` | bool | `false` | On some AVRs (eg. VSX-S510), setting the volume level is not supported natively by the API. This option emulates setting the volume level using volume up and down commands.
-| `volume_step_delta` | int | `1` | The number of units that each volume up/down commands changes the volume by. Used when `volume_step_only` is `true`.
+| `volume_step_delta` | int | `1` | _Deprecated in 0.5._ The number of units that each volume up/down commands changes the volume by. Used when `volume_step_only` is `true`.
 | `debug_listener` | bool | `false` | Enables additional debug logging for the listener task. See [Enabling debugging](#enabling-debugging) for details.
 | `debug_responder` | bool | `false` | Enables additional debug logging for the responder task. See [Enabling debugging](#enabling-debugging) for details.
 | `debug_updater` | bool | `false` | Enables additional debug logging for the updater task. See [Enabling debugging](#enabling-debugging) for details.
 | `debug_command` | bool | `false` | Enables additional debug logging for commands sent and responses received. See [Enabling debugging](#enabling-debugging) for details.
 
-**NOTE:** It is currently not possible to manually specify `ignore_zones` when the integration is added via the UI.
+**NOTE**: Changing ignored zones via UI options does not add entities for new zones or fully remove entities for removed zones until the integration is restarted.
 
 ## Breaking changes
 
+- **0.5**\
+  `volume_step_only` logic has been rewritten to step the volume until the actual volume reaches (or exceeds) the desired volume. It will stop stepping and log a warning if after the step command the volume does not change or changes in the wrong direction.
 - **0.4**\
   The AVR source query no longer skips source names that have not been renamed. This will result in additional sources being selectable. Specify sources manually to only allow certain sources to be selected.
 - **0.3**\