Skip to content

Custom Integration for ISY994 with Home Assistant (for use with HACS)

Notifications You must be signed in to change notification settings

shbatm/hacs-isy994

Repository files navigation

hacs_badge

Buy Me A Coffee

⚠️ This integration is for beta testing new features for the ISY/IoX integration

Description

This Custom Component is to update the Home Assistant Core ISY994 component with new functionality that is currently being tested before migrating to the main integration.

Version 4.x.x uses the beta version of PyISY, in which the communications with the ISY have been completely rewritten (again); ideally making the ISY controls much more responsive when controlling from Home Assistant.

Differences between this version and Home Assistant Core

See the CHANGELOG for the specific differences and improvements in this version over the Home Assistant Core Integration.

Looking to Help Make This Integration Better?

The long-term goal is that these will be integrated into Home Assistant. Testing and feedback is encouraged to flush out any bugs now before a merge.

Please report any issues or feature requests.

Local Development

A VSCode DevContainer is also available to provide a consistent development environment.

Assuming you have the pre-requisites installed from the link above (VSCode, Docker, & Remote-Containers Extension), to get started:

  1. Fork the repository.
  2. Clone the repository to your computer.
  3. Open the repository using Visual Studio code.
  4. PyISY Co-Development:
    • If you are simultaneously making changes to PyISY, this container will mount your local PyISY folder inside this devcontainer. Assuming you have ./hacs-isy994 and ./PyISY at the same root folder on your computer, they will be mounted at /workspaces/hacs-isy994 and /workspaces/PyISY in the container. Install your local pyisy instance with pip3 install -e /workspaces/PyISY.
    • If you are not making changes to PyISY or do not have the structure above, remove the "mounts" section from .devcontainer/devcontainer.json.
  5. When you open this repository with Visual Studio code you are asked to "Reopen in Container", this will start the build of the container.
    • If you don't see this notification, open the command palette and select Remote-Containers: Reopen Folder in Container.

Installation

This repo is meant to be installed with HACS

Refer to the built-in component's integration page for more details on configuration.