esphome / esphome/esp-web-tools

Troubleshoot popup isn't reliable: please, show it whenever a failure occurs

Open
#520 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
686
Forks
192
Avg merge
1h 1m
Merged PRs (30d)
1

Description

As a first-time user of ESP and all of that, I bought an ESP32-S3-BOX-3 and went to the [HA setup tutorial](https://www.home-assistant.io/voice_control/s3_box_voice_assistant/). Long story short, the [Connect] button showed the list of entries, but anything I did only caused a warning stating `Failed to execute 'open' on 'SerialPort': Failed to open serial port.`. And that was it. Nothing else ever showed up. I obviously tried numerous things, rebooting the device, plugging three different cables on different ports, etc, as the tutorial had little information about troubleshooting on that scenario.

https://github.com/user-attachments/assets/94a4be88-7751-4fae-a2e0-fd056bbb7b85

After even some reboots, I noticed one of the browser windows was showing a troubleshooting popup with actual information! It stated I needed the missing `dialout` group on my Linux user, and that indeed solved the issue.
Trying to reproduce it, so I could report it properly here, it looks like that popup only shows up when the user cancels the port selection.

https://github.com/user-attachments/assets/83e900de-b99b-44c3-b985-192e7f8cf338

Thus, please: make that popup more reliable, by showing it as soon as any failure happens. I'll also open a separate issue with the tutorial itself so it's not reliant on the popup to help Linux users.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.