Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
igorsantos07 opened this issue Oct 19, 2024 · 0 comments

Comments

@igorsantos07
Copy link

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. 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.

missing-troubleshoot.mp4

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.

troubleshoot-on-cancel.mp4

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.

igorsantos07 added a commit to igorsantos07/home-assistant.io that referenced this issue Oct 19, 2024
The correct steps were found by accident, and reported on the original project at esphome/esp-web-tools#520.

However, considering this is not just "a problem" some users might have, but actually something everyone not used to ESP will need to comply as a setup step, I tried adding it directly to the setup steps.

Not sure if this is necessary for Mac users as well?
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant