esphome / esphome/esp-web-tools
Troubleshoot popup isn't reliable: please, show it whenever a failure occurs
- 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.