qmk / qmk/qmk_toolbox

Bad Atmel Behaviour

Open
#433 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
3.1k
Forks
561
PR merge metrics
No merged PRs in 30d

Description

An annoying barrier to entry for new users is QMK Toolbox's behaviour with Atmel chips. I know unlike other MCUs they must be selected manually, but this is quite a typical event when dealing with IBM Model F controllers:

!

Note:

  • QMK Toolbox correctly identifies the device as 32u2
  • But tries to flash it as a 32u4 because that's the default value in the non-obvious MCU pulldown menu up at the top right
  • QMK Toolbox reports the error and gives up

The user is left baffled.

May I suggest two ideas:

  • If the MCU identifies itself, as this one did—I believe most or perhaps all Xwhatsit-based 32u2 controllers include the text 32u2 in this string—try flashing as that MCU
  • Exhaustively try the various Atmel MCUs in the pulldown, until one works, as an "Auto" mode which should be the default; unless overridden manually by an advanced user

Sure, a failure like the screenshot above is no surprise to an experienced user, but it's a poor experience and in this common case an easily avoided failure.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No source file or test is named. Start by tracing QMK Toolbox’s MCU selection pulldown and flashing path, then determine how device identification and failed Atmel attempts are handled. Done means the default behavior avoids the reported 32u2-versus-32u4 failure while still allowing manual MCU selection.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
embedded-iot, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.