This is a custom component to integrate with Home Assistant for the Busch Jaeger/ABB Free@Home system over the local api server.
The primary goal of this repository is to provide initial testing for the integration into Home Assistant. The ultimate goal of this integration is to be merged into the Home Assistant code as a built-in integration.
Because of this, the integration will adhere to the strict styling and code guidelines provided by Home Assistant.
This is a new repo written from the ground up in tandem with the PyPi Package local-abbfreeathome in order to communicate with the ABB Free@Home System over the local api. The initial list of supported devices is 1 (Switch/Actuator).
The initial goal is to thoroughly test the integration (and by proxy the PyPi package) to ensure there are no bugs within the code. It's also to ensure it's feature and code complete (e.g. ZeroConf, UnitTests).
Once this is feature and code complete it should provide a solid base as to which new devices can be integrated into. I (kingsleyadam) don't have access to the number of different ABB devices and would rely on others to either provide configurations, or contribute code directly in order to add additional device support. It'll be much easier long-term if the core code is stable.
If you need support for additional devices I'd strongly reccomend you check out the repo here. That repo has been around for a long time and provides support for a number of devices.
If you would like your device supported in this integration, please start by opening a GitHub issue with the device configuration.
The easiest way to add this custom integration is via HACS which the repo has been setup to support. With HACS setup on your Home Assistant installation you'll need to add this repo it as a custom repository.
Once added you'll be able to find it by searching for "Busch Jaeger/ABB Free@Home (Local API)".
custom_components/abbfreeathome_ci to your Home Assistant directory ./config/custom_components/abbfreeathome_ciBefore you can setup this integration you must turn on the local API on your ABB Free@Home SysAP. More information about the local api can be found on the ABB site here.
Navigate to: SysAP Configuration > Settings > free@home - Settings > Local API > Activate Local API
Copy the username listed within that window (usually installer) to be used when invoking the api. The password will be your personally set password to login to the app and web interface.
In most installations the integration will find your Free@Home SysAP automatically on the network. After you've installed the integration and restarted Home Assistant you should see your SysAP as a new device to be setup. You just need to enter your api username and password to confirm the setup.
If the SysAP is not found automatically you can add it manually. Add this integration by searching for and clicking on Busch Jaeger/ABB Free@Home (Local API).
When adding the integration manually you'll be prompted for the Hostname, Username, and Password. The hostname must be the fully resolvable hostname with protocol (e.g. http). Adding the integration will fail if you just provide the IP address or hostname.
http://192.168.1.100installer<password>Note: Support for SSL is not provided yet. For a valid SSL connection a cert pulled from the SysAP must be provided, research to be done to know if Home Assistant supports such a scenario.
When adding the integration it'll automatically add devices to different Areas in Home Assistant. The areas will be pulled from your ABB Free@Home Configuration/Floorplan. When prompted to add the devices double check the area for each.
The Switch Sensors can be deceiving. These are additional On/Off sensors associated with a switching device. If you physically toggle the switch sensor (On or Off), the status of the switch sensor will be updated in Home Assistant accordingly.
However, if you turn off the light using Home Assistant, the Free@Home app, or any other non-physical method, the switch sensor will not be updated to reflect the light's status.
This discrepancy can cause issues when automating a light. If the light is already turned off via Home Assistant, but the switch sensor still indicates an On state, you won't be able to turn the light on using the switch sensor.
It is best to associate a switch directly with a light in the Free@Home configuration whenever possible. For example, if you have a Philips Hue bulb, it's advisable to set up Philips Hue lights within Free@Home and associate a switch with it directly. This approach avoids using Home Assistant entirely, making the setup much more straightforward and responsive.
If you want to control a device or a set of devices using the switch sensor in Home Assistant, it's best to use emitted events. The SwitchSensor class will emit an event when pressed.
These will be visible as events within the devices that support it. Using these events you can create automations to control devices accordingly.
alias: Test Trigger Sensor Event
description: This will turn off/on a light based on the Switch Sensor event.
triggers:
- trigger: state
entity_id:
- event.study_area_rocker_switch_event
to: "Off"
attribute: event_type
id: study_area_event_off
- trigger: state
entity_id:
- event.study_area_rocker_switch_event
attribute: event_type
to: "On"
id: study_area_event_on
conditions: []
actions:
- choose:
- conditions:
- condition: trigger
id:
- study_area_event_off
sequence:
- action: switch.turn_off
target:
device_id:
- 615bdcd2980a3a2a341488f50b7d8aea
- conditions:
- condition: trigger
id:
- study_area_event_on
sequence:
- action: switch.turn_on
target:
device_id: 615bdcd2980a3a2a341488f50b7d8aea
mode: singleIf you're having issues with the integration, maybe not all devices are showing up, or entities are not responding as you'd expect, you can do two things to help debug.
You can enable more verbose logging within your Home Assistant installation just for this integration by adding the following to your Home Assistant configuration.yaml file.
By default the Home Assistant default logger is warning, this configuration won't change that. But it'll create additional logs for both this integration and the PyPi module running a number of calls to the SysAP.
logger:
default: warning
logs:
abbfreeathome: debug
custom_components.abbfreeathome_ci: debugIf you request help via GitHub Discussions you will likely be asked to share the integration diagnostics.
The diagnostics will share some information about your Home Assistant installation and this integration's installation.
To pull the diagnostics about this integration navigate to the integration under Settings --> Devices & Services --> Busch Jaeger/ABB Free@Home (Local API). Click the 3 dots next to the integration entity and click Download Diagnostics. Private information should be redacted from the download, but it's always good to double check the output before sending.
Along with the home_assistant and integration_manifest you should also see data which includes your SysAP configuration and devices.