Skip to content

Updated bootloader dialog to include images and forcing platform choice#762

Merged
enyanil merged 4 commits intomasterfrom
enya/cold-boot-doc-updates
Oct 29, 2025
Merged

Updated bootloader dialog to include images and forcing platform choice#762
enyanil merged 4 commits intomasterfrom
enya/cold-boot-doc-updates

Conversation

@enyanil
Copy link
Copy Markdown
Member

@enyanil enyanil commented Oct 28, 2025

We have noticed that users sometimes accidentally flash the wrong firmware to their device. To help prevent this problem this PR has updated the bootloader dialog to include pictures that help the user notice the choice and choose the right platform as well as forcing the users to make a choice when they first open the dialog (no default choice).

Feedback in the form of tooltips have also been added to show the users what they might have missed doing in the dialog to be able to press the program button.

dialog_first_open Dialog when it is first opened, not connected and no chosen platform (program button disabled). tooltip_connect_device Tooltip pointing to connecting your device. tooltip_choose_platform Tooltip pointing to choosing a platform. dialog_done Dialog with connected device and chosen platform.

@ArisMorgens
Copy link
Copy Markdown
Member

Great addition!
One small comment: The available downloads field should be aware of the "mini" firmware releases. Right now it displays 2025.09 both for 2025.09 and for 2025.09.01.

@gemenerik gemenerik requested a review from Copilot October 28, 2025 15:58
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances the bootloader dialog to prevent users from accidentally flashing incorrect firmware by adding visual platform identification aids and enforcing explicit platform selection. The changes improve user guidance through the flashing process by making platform choice mandatory and providing contextual feedback.

Key changes:

  • Added platform identification images to help users visually distinguish between device types
  • Removed default platform selection (previously 'cf2'), requiring users to explicitly choose their platform
  • Implemented tooltip feedback system to guide users on required actions before programming

Reviewed Changes

Copilot reviewed 2 out of 7 changed files in this pull request and generated 3 comments.

File Description
src/cfclient/ui/dialogs/bootloader.ui Added image placeholders for 5 platform types and updated Qt enum syntax to use fully qualified names
src/cfclient/ui/dialogs/bootloader.py Implemented image loading logic, removed default platform selection, and added program button state management with tooltips

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/cfclient/ui/dialogs/bootloader.py Outdated
Comment thread src/cfclient/ui/dialogs/bootloader.py Outdated
Comment thread src/cfclient/ui/dialogs/bootloader.py Outdated
Copy link
Copy Markdown
Member

@gemenerik gemenerik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really nice addition.

I have some small notes on the images.

You talked about a warning before when you try to program without having selected a platform. I'm not seeing that here but maybe you decided against it? I think it is pretty clear as is anyways.

Comment thread docs/images/bl_no_bg.png Outdated
Comment thread docs/images/flapper_no_bg.png Outdated
@enyanil enyanil merged commit 633a029 into master Oct 29, 2025
1 check passed
@enyanil enyanil deleted the enya/cold-boot-doc-updates branch October 29, 2025 14:10
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

Successfully merging this pull request may close these issues.

4 participants