Add Device and Integration Services to ISY994

[shbatm]

Proposed change

This is the 9th PR in a series (~10 total) to include migration to PyISYv2 and "modernization" of the isy994 integration based on testing done over the past year in the HACS custom component.

Full migration plan is captured in PR #35212

This PR adds several integration and entity services to expose commands and controls that are not available through other Home Assistant means, without calling custom REST commands and adding additional workarounds. This also allows a user to control devices that do not have full compatibility yet in Home Assistant (many Z-Wave device, like RGB bulbs). These services will also support future Device commands for being sent from the Frontend.

Services have been split into two categories--those that are called on entities that Home Assistant knows about are added as entity services, and those that call other ISY functions have been added at the integration level.

The following services are available:

• isy994.send_raw_node_command: Send a "raw" ISY REST Device Command to a Node using its Home Assistant Entity ID.
• isy994.send_node_command: Send a command to an ISY Device using its Home Assistant entity ID. Valid commands are: beep, brighten, dim, disable, enable, fade_down, fade_stop, fade_up, fast_off, fast_on, and query.
• isy994.set_on_level: Send an ISY set_on_level command to a Node.
• isy994.set_ramp_rate: Send an ISY set_ramp_rate command to a Node.
• isy994.system_query: Request the ISY Query the connected devices.
• isy994.set_variable: Set an ISY variable's current or initial value. Variables can be set by either type/address or by name.
• isy994.send_program_command: Send a command to control an ISY program or folder. Valid commands are run, run_then, run_else, stop, enable, disable, enable_run_at_startup, and disable_run_at_startup.
• isy994.run_network_resource: Run a network resource on the ISY.
• isy994.reload: Reload the ISY994 connection(s) without restarting Home Assistant. Use to pick up new devices that have been added or changed on the ISY.
• isy994.cleanup_entities: Cleanup old entities no longer used by the ISY994 integrations. Useful if you've removed devices from the ISY or changed the filter string options in the configuration to exclude additional items and they were not properly removed by Home Assistant.

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing integration)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Example entry for configuration.yaml:

# Example configuration.yaml

Additional information

• This PR fixes or closes issue: fixes #
• This PR is related to issue: ISY994 migration to PyISY v2 (Structure Changes to enable upgrade, Part 1) #35212
• Link to documentation pull request: Add Services to ISY994 home-assistant.io#13390

Checklist

• The code change is tested and works locally.
• Local tests pass. Your PR cannot be merged unless tests pass
• There is no commented out code in this PR.
• I have followed the development checklist
• The code has been formatted using Black (black --fast homeassistant tests)
• Tests have been added to verify that the new code works.

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

• The manifest file has all fields filled out correctly.
  Updated and included derived files by running: python3 -m script.hassfest.
• New or updated dependencies have been added to requirements_all.txt.
  Updated by running python3 -m script.gen_requirements_all.
• Untested files have been added to .coveragerc.

The integration reached or maintains the following Integration Quality Scale:

• No score or internal
• 🥈 Silver
• 🥇 Gold
• 🏆 Platinum

Tag: @bdraco @OverloadUT

[probot-home-assistant]

Hey there @bdraco, mind taking a look at this pull request as its been labeled with a integration (isy994) you are listed as a codeowner for? Thanks!
_{^{(message by CodeOwnersMention)}}

[shbatm]

Docs added.

[bdraco]

Looks good. @shbatm I want to at give @MartinHjelmare a chance to read your feedback in #35467 (comment) before merging

[bdraco]

Looks good. Thanks for the fixes as well