PHAL Home Assistant
NOTE: this plugin is a placeholder, it will be deprecated / refactored once the CommonIOT framework is developed
Listens to
Message Type | Message Data | Description | Emitted Response Type | Handled by |
---|---|---|---|---|
ovos.phal.plugin.homeassistant.get.devices |
Requests the list of devices from Home Assistant. | ovos.phal.plugin.homeassistant.get.devices.response |
handle_get_devices | |
ovos.phal.plugin.homeassistant.get.device |
'device_id': str | Requests information about a specific device. | ovos.phal.plugin.homeassistant.get.device.response |
handle_get_device |
ovos.phal.plugin.homeassistant.device.turn_on |
'device_id': str | Sends a command to turn on a specific device. | ovos.phal.plugin.homeassistant.device.turn_on.response |
handle_turn_on |
ovos.phal.plugin.homeassistant.device.turn_off |
'device_id': str | Sends a command to turn off a specific device. | ovos.phal.plugin.homeassistant.device.turn_off.response |
handle_turn_off |
ovos.phal.plugin.homeassistant.get.device.display.model |
'device_id': str | Requests the display model of a specific device. | ovos.phal.plugin.homeassistant.get.device.display.model.response |
handle_get_device_display_model |
ovos.phal.plugin.homeassistant.get.device.display.list.model |
Requests a list of display models for all devices. | ovos.phal.plugin.homeassistant.get.device.display.list.model.response |
handle_get_device_display_list_model | |
ovos.phal.plugin.homeassistant.call.supported.function |
'device_id': str 'function_name': str 'function_args': dict |
Calls a supported function on a device. | ovos.phal.plugin.homeassistant.call.supported.function.response |
handle_call_supported_function |
ovos.phal.plugin.homeassistant.start.oauth.flow |
'instance': str | Initiates the OAuth flow for a specific Home Assistant instance. | oauth.get.app.host.info oauth.generate.qr.request oauth.token.response |
handle_start_oauth_flow |
ovos.phal.plugin.homeassistant.assist.intent |
'command': str | Passes an assist message to Home Assistant's Assist API. | ovos.phal.plugin.homeassistant.assist.intent.response |
handle_assist_message |
ovos.phal.plugin.homeassistant.get.light.brightness |
'device_id': str | Requests the brightness level of a light device. | ovos.phal.plugin.homeassistant.get.light.brightness.response |
handle_get_light_brightness |
ovos.phal.plugin.homeassistant.set.light.brightness |
'device_id': str 'brightness': int |
Sets the brightness level of a light device. | ovos.phal.plugin.homeassistant.set.light.brightness.response |
handle_set_light_brightness |
ovos.phal.plugin.homeassistant.increase.light.brightness |
'device_id': str | Increases the brightness of a light device. | ovos.phal.plugin.homeassistant.increase.light.brightness.response |
handle_increase_light_brightness |
ovos.phal.plugin.homeassistant.decrease.light.brightness |
'device_id': str | Decreases the brightness of a light device. | ovos.phal.plugin.homeassistant.decrease.light.brightness.response |
handle_decrease_light_brightness |
ovos.phal.plugin.homeassistant.get.light.color |
'device_id': str | Requests the color of a light device. | ovos.phal.plugin.homeassistant.get.light.color.response |
handle_get_light_color |
ovos.phal.plugin.homeassistant.set.light.color |
'device_id': str 'color': str |
Sets the color of a light device. | ovos.phal.plugin.homeassistant.set.light.color.response |
handle_set_light_color |
ovos.phal.plugin.homeassistant.check_connected |
'connected': bool | Is the PHAL plugin is currently connected to Home Assistant? | ovos.phal.plugin.homeasssistant.check_connected.response |
handle_check_connected |
ovos.phal.plugin.homeassistant.integration.query_media |
'phrase': str | Queries the media player for the requested media. | ovos.phal.plugin.homeassistant.integration.query_media.result |
handle_query_media |
ovos-PHAL-plugin-homeassistant.home |
Handles the show dashboard message. | N/A | handle_show_dashboard | |
ovos-PHAL-plugin-homeassistant.close |
Closes the Home Assistant dashboard in the GUI. | N/A | handle_close_dashboard | |
ovos.phal.plugin.homeassistant.show.device.dashboard |
'device_type': str | Shows the dashboard for a specific device. | ovos.phal.plugin.homeassistant.change.dashboard (GUI bus) |
handle_show_device_dashboard |
ovos.phal.plugin.homeassistant.show.area.dashboard |
'area': str | Shows the dashboard for a specific area. | ovos.phal.plugin.homeassistant.change.dashboard (GUI bus) |
handle_show_area_dashboard |
ovos.phal.plugin.homeassistant.update.device.dashboard |
'device_type': str | Updates the dashboard for a specific device. | ovos.phal.plugin.homeassistant.update.device.dashboard |
handle_update_device_dashboard |
ovos.phal.plugin.homeassistant.update.area.dashboard |
'area_type': str | Updates the dashboard for a specific area. | N/A | handle_update_area_dashboard |
ovos.phal.plugin.homeassistant.set.group.display.settings |
'use_group_display': bool | Sets the group display settings. | N/A | handle_set_group_display_settings |
ovos.phal.plugin.homeassistant.setup.instance |
'url': str 'api_key': str 'assist_only': bool |
Sets up a new Home Assistant instance. | ovos-PHAL-plugin-homeassistant.home |
setup_configuration |
configuration.updated |
See ovos.phal.plugin.homeassistant.setup.instance |
Responds to changes to configuration by re-initializing HA | See ovos.phal.plugin.homeassistant.setup.instance |
init_configuration |
configuration.patch |
See ovos.phal.plugin.homeassistant.setup.instance |
Responds to changes to configuration by re-initializing HA | See ovos.phal.plugin.homeassistant.setup.instance |
init_configuration |
Emits
Emits all of the messages that it listens to, plus the following:
Message Type | Message Data | Description | Trigger Message Type | Handled by |
---|---|---|---|---|
ovos.phal.plugin.homeassistant.ready |
Signals that the Home Assistant plugin is ready. | ovos.phal.plugin.homeassistant.setup.instance |
init_configuration | |
ovos.phal.plugin.homeassistant.device.updated |
'device_id': str | Signals that a device has been updated, requesting a new display model. | ovos.phal.plugin.homeassistant.device.state.updated |
device_updated |
oauth.get.app.host.info |
Requests host information for OAuth registration. | oauth.get.app.host.info.response |
request_host_info_from_oauth | |
oauth.generate.qr.request |
'app_id': str 'skill_id': str |
Requests QR code for OAuth registration. | oauth.generate.qr.response |
start_oauth_flow |
oauth.token.response.munged_id |
'access_token': str | Receives the OAuth token response. | handle_token_oauth_response |