inkVisioninkVision

Guide

Set up inkVision Voice

Connect it to Wi-Fi from the Home Assistant app over Bluetooth and add it to Home Assistant.

Before You Start

inkVision Voice joins Home Assistant through the standard ESPHome integration. You give it your Wi-Fi from the Home Assistant app over Bluetooth, so there is no password or code to type from the device.

  • Home Assistant with a voice assistant set up under Settings > Voice assistants.
  • The Home Assistant app on a phone with Bluetooth turned on, signed in to your Home Assistant.
  • The name and password of a 2.4 GHz Wi-Fi network. Networks that offer only 5 GHz do not work.
  • A USB-C power supply with 5 V and at least 1 A.
  • Setup is open for 30 minutes after you plug the device in. If the time runs out, unplug it and plug it back in.

Step 1: Power On The Device

  1. Connect inkVision Voice to the USB-C power supply.
  2. Wait until the LED ring pulses purple. The device is now waiting for setup.
  3. If the ring pulses amber instead, the device is looking for a Wi-Fi network it already knows. After 90 seconds it turns purple and can be set up again.

Step 2: Connect It To Wi-Fi

  1. Open the Home Assistant app on your phone and go to Settings > Devices & services.
  2. Under Discovered, select the new device, shown as inkvision-voi-XXXXXX, and choose Configure.
  3. When the app asks you to authorize, press the play button in the middle of the device. You have 1 minute.
  4. Choose your Wi-Fi network and enter its password.
  5. Wait until the ring stops pulsing. The device joins your Wi-Fi and restarts once by itself about 15 seconds later.

Step 3: Add It To Home Assistant

  1. Home Assistant now discovers inkVision Voice XXXXXX through ESPHome. Select Configure, then Submit.
  2. Home Assistant creates the device's own encryption key and sends it to the device. There is nothing to type.
  3. Follow the voice assistant wizard that opens next.

If the wizard says Entity not found right after you add the device, close it, open the device page and select Set up voice assistant.

Step 4: Choose The Wake Word And Assistant

  • Wake word: Hey Vizzy, Okay Nabu, Hey Jarvis or Hey Mycroft.
  • Assistant: any voice assistant you have set up in Home Assistant, local or cloud.
  • You can change both later on the device page under Settings > Devices & services > ESPHome.
  • Try it: say “Hey Vizzy, what time is it?”. The ring turns blue while it listens and pulses green while it answers.

Set Up Wi-Fi Over USB Instead

Use this if your phone has no Bluetooth or the app does not find the device.

  1. Connect the device to a computer with a USB-C data cable.
  2. Open https://web.esphome.io in Chrome or Edge and select Connect.
  3. Pick the device's serial port, select Configure Wi-Fi and enter your network.
  4. Continue with Step 3.

Troubleshooting

  • The ring is dim purple: the 30-minute setup window has closed. Unplug the device, plug it back in and start again.
  • The app does not show the device: allow Bluetooth and location access for the Home Assistant app, stay within a few metres of the device and wait up to a minute. Or use the USB method.
  • The ring keeps pulsing amber: the device cannot join Wi-Fi. Check that the network is 2.4 GHz and the password is right. After 90 seconds the ring turns purple and you can enter the Wi-Fi again.
  • The ring stays dim amber: the device is on Wi-Fi but cannot reach Home Assistant. Check that Home Assistant is running and on the same network.
  • After a factory reset, Home Assistant asks you to confirm that encryption was removed. Confirm it, and Home Assistant sends the device its key again.
  • Still stuck? Write to info@homebrainz.eu.