Skip to content

Troubleshooting

Inspecting Sat1 ESP32 Logs

I want to see Sat1 ESP32 logs via a USB-C cable.

(NOTE: If you need lower level DEBUG logs then you're going to need to adopt the Sat1 to your ESPHome Dashboard and set log level from there.)

  1. Connect the Sat1 to your computer using a USB-C cable.
  2. Click the connect button below and select the correct JTAG device.
  3. Choose Logs & Console:


Logs Console

If you click on "Reset Device" you should see a whole bunch of useful messages and information. Scroll back up and take a look.


Troubleshooting Logs

Scroll to the bottom and issue a command "Hey Jarvis, what time is it?"


Troubleshooting Hey Jarvis

I want to see Sat1 ESP32 logs via my Wi-Fi network (Over the Air)

These instructions will come soon. It's complicated depending on your environment.

Debugging your Voice Pipeline

Curious why your Sat1 is doing something different than what you'd expect? Use Home Assistant pipeline debugging tools.


Debugging a Voice Pipeline

  1. Determine what pipeline your Sat1 is using by retracing these steps: Assign a Voice Pipeline & Wake Word to your Satellite1
  2. In Home Assistant, go to Settings -> Voice Assistants and select the 3 dots next to that pipeline.
  3. Read here: Debugging a Voice Pipeline

Inspect Sat1 Audio Recording Files

Follow these steps to store a copy of your audio recordings in your Home Assistant server for inspection.

  1. Modify your configuration.yaml file and add the following:
assist_pipeline:
  debug_recording_dir: /share/assist_pipeline
  1. Now go to that path in your Home Assistant (recommend using Studio Code Server) and listen to the files there.
  2. Don't leave this on forever, it will clog up your server with audio recordings.

Resetting to Factory Settings

  1. Press and hold the RIGHT (Action) button for approximately 22 seconds until the red LEDs complete their clockwise circle. When the LEDs glow blue you can release the action button and wait as the XMOS chip is erased. This process may take a few minutes before the Satelllite1 finally reboots to the factory firmware. Upon first boot you will see the blue LEDs complete another clockwise circle indicating the XMOS is being flashed with the facory embedded firmware.

  2. In your Home Assistant, go to Settings -> Devices and Services -> ESPHome and click the 3 dots next to the Satellite1 and select "Delete".

  3. Follow the steps to Add your Satellite1 to Home Assistant

Start the Device in "Boot" mode:

  1. Unplug the Sat1 from power.

  2. Press and hold the Core board's "Boot" button. (NOTE: If the HAT is attached you can use the "Action" button.)

  3. Apply power to the Sat1 and let go of the "Boot" button after 3 seconds.

  4. Follow the steps to Add your Satellite1 to Home Assistant via a USB-C cable)

Need More Help?

While we hope this documentation will answer all your questions, but we realize support is sometimes needed. The FutureProofHomes team will do their best to keep up with support requests, but we also lean on our community to help all of us. See the links below and decide which method of support is best for your needs.

Have a general question and need quick help from the community?

Chat with the Community on Discord

Discord too chatty and you want a record of your general question?

Start a Discussion on Github

Do you have a feature request you'd love to see?

Look through our existing Feature Requests first, then open a new request if necessary:
Request a New Feature on Github

Have you found a reproducible issue with the hardware or software?

Report a Bug on Github