Skip to content

Connecting to Home Assistant

Your Satellite1 arrives pre-flashed with all the necessary firmware to get you up and running quickly. You have 2 choices:

I want to set up via my iPhone or Android device with Bluetooth. (Recommended)

Open the Home Assistant Companion App on your Android or iPhone. Make sure Bluetooth on your phone is on and that you're nearby the Sat1!

  1. Tap "Settings":
    Tap "Settings":

  2. Tap "Devices & Services":
    Tap "Devices & Services":

  3. Tap "Add" next to your Sat1 device (contains last 6 of device MAC address):
    Tap "Add" next to your Sat1 device (contains last 6 of device MAC address):

  4. Type in your 2.4 Ghz WiFI credentials:

5 GHz Wi-Fi is not supported! Use only 2.4 GHz Wi-Fi.


Type in your 2.4ghz network credentials:

  1. On the Sat1 HAT, press the right "Action button" to give authorization:
    On the Sat1 HAT, press the right "Action button" to give authorization:

    Click action buttons

  2. Tap "Continue" after successful Wifi connection:
    Tap "Continue" after successfull Wifi connection:

  3. Tap "Ok" to begin setting up ESPHome:
    Tap "Ok" to begin setting up ESPHome:

  4. Tap the name of your Sat1 device and then tap the "Submit" button:
    Tap the name if your Sat1 device and then tap the "Submit" button:

  5. The Wizard will pull down the most recent Sat1 Firmware:
    The Wizard will pull down the most recent Sat1 Firmware:

  6. The Wizard will ask you to say the Wake Word twice:
    The Wizard will ask you to say the Wake Word twice:

  7. Type the Area this Sat1 falls in:
    Type the Area this Sat1 falls in:

  8. Stick with the default or change the wake word, conversation agent, and voice:
    Stick with the default or change the wake word, conversation agent, and voice:

  9. After completing the Wizard, do NOT click to add the Sat1 to ESPHome again. Simply refresh and this will go away.
    After completing the Wizard, do NOT click to add the Sat1 to ESPHome again.  Simply refresh and this will go away.

Congrats. You're done!

I want to set up via my computer & USB-C cable. (Advanced)

Plug your Sat1 directly into your computer with a USB-C cable that supports a data connection.

  1. Click the connect button below and select the JTAG device in the browser's notification:



    Select JTAG

  2. Click "Install":
    Image title

  3. Optionally erase the device, then click "Next" and then "Install":
    Image title

    Image title

  4. Installation will complete. Click "Next":
    Image title

  5. Type in your 2.4ghz WiFi network and click "Connect". Your device will begin sparkling blue while attempting to connect.
    Image title

  6. Congrats you're now connected to your Wifi. Your device will now begin sparkling red. This means it needs to be connected to ESPHome in your Home Assistant instance.
    Image title

  7. Inside Home Assistant, go to "Settings -> Devices & Services" and notice you have a Discovered `Satellite1 xxxxxx' device. Click add and follow the onboarding steps.
    Image title

Congrats. You're done!

ESPHome User Interface

Once your Sat1 is connected to Home Assistant you should familiarize yourself with all the server-side settings you may want to change:

  1. Inside your Home Assistant, head over to "Settings -> Devices & Services -> ESPHome" and click on your Sat1 device:
    esphome device list

  2. Understand all the features of your Sat1 device:
    top esphome device

    top esphome device