mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-30 14:56:50 +00:00
1833c32a2c
* Sets front matter defaults * Removes default front matter from section templates/pages * Removes default front matter from addon pages * Removes default front matter from integration pages * Removes default front matter from posts * Removes default front matter from docs pages * Removes default front matter from other pages * Fixes blog category pages
68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
---
|
|
title: "Hook Switch"
|
|
description: "Instructions on how to integrate the Hook Smart Home Hub into Home Assistant."
|
|
logo: hook.png
|
|
ha_category:
|
|
- Switch
|
|
ha_iot_class: Assumed State
|
|
ha_release: 0.34
|
|
redirect_from:
|
|
- /components/switch.hook/
|
|
---
|
|
|
|
The `hook` integration allows you to control the [Hook Smart Home Hub](http://www.hooksmarthome.com/) from within Home Assistant.
|
|
|
|
Hook allows you to control cheap mains electrical outlets, like these ones at [Amazon](https://amzn.to/2WVZdGG).
|
|
|
|
In short, Hook is an RF to Wi-Fi bridge, controlling devices that receive commands at 315MHz and 433MHz. Unfortunately, this does not allow Hook to determine if the command was successful, so the state is assumed.
|
|
|
|
Hook provides a simple [REST API](https://app.swaggerhub.com/api/rahilj/GetHook_RestAPI/v1). This Home Assistant integration reads in devices that have been set up in the official app.
|
|
|
|
## Configuration
|
|
|
|
Configure with either your username/password or your API token for the official app.
|
|
|
|
To enable this platform in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
switch:
|
|
- platform: hook
|
|
username: YOUR_E_MAIL_ADDRESS
|
|
password: YOUR_HOOK
|
|
```
|
|
|
|
Or
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
switch:
|
|
- platform: hook
|
|
token: YOUR_API_TOKEN
|
|
```
|
|
|
|
{% configuration %}
|
|
username:
|
|
description: The email address associated with your Hook Smart Home Hub.
|
|
required: true
|
|
type: string
|
|
password:
|
|
description: The password for your Hook Smart Home Hub.
|
|
required: true
|
|
type: string
|
|
token:
|
|
description: The API token for your Hook Smart Home Hub.
|
|
required: true
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
Extra debug logging is available, if you need it.
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
logger:
|
|
default: error
|
|
logs:
|
|
homeassistant.components.switch.hook: debug
|
|
```
|