jgatto1 931fee1280
updating Knocki docs (#34654)
* Knocki docs

* fix: removed troubleshooting from this PR

* Remove automtion steps, move some of the steps into prereqs

* Apply suggestions from code review

* feat: automation example and troubleshooting section

* fix: coderabbit suggestions

* fix: remove troubleshooting

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
2024-11-06 07:34:21 +01:00

2.1 KiB
Raw Blame History

title description ha_category ha_config_flow ha_release ha_iot_class ha_codeowners ha_domain ha_platforms ha_integration_type
Knocki Instructions on how to setup Knocki devices in Home Assistant.
Event
true 2024.7 Cloud Push
@joostlek
@jgatto1
@JakeBosh
knocki
event
hub

The Knocki {% term integration %} allows you to trigger your favorite automations simply by tapping custom patterns (such as triple taps) on ordinary surfaces.

Prerequisites

  • You must have a Knocki device.

  • Completed the setup process in the Knocki mobile app, as described in steps 1-7 below.

  1. Open the Knocki Mobile App. Its a free download on iOS and Android.
  2. Using the app, log-in or create a new Knocki account.
  3. From the apps home screen, select a Knocki or add a Knocki.
  4. On the apps device screen, select a gesture or add a gesture.
  5. Next, select the add a task option.
  6. Scroll down the task menu and select Home Assistant.
  7. Follow the in-app instructions to add the Home Assistant task.

{% include integrations/config_flow.md %}

Automation example

  1. Go to {% my automations title="Settings > Automations & scenes" %} and in the lower right corner, select Create Automation.
  2. Select Create new automation.
  3. Select Add Trigger, select Entity as the trigger type.
    • Search for the name of the task (as you named it in the Knocki app). Select the entity with that name appended to it.
    • Select State as the type of entity change.
  4. Select Add action and choose whatever action(s) youd like the automation to trigger.
  5. Finally, test the action by tapping the associated gesture pattern.