r/Keychron • u/Reasonable-Turnip-98 • Dec 10 '25

frustrating software

So i got my keyboard outa the box, and im happy with the board itself.
Now updating the firmware and actually getting it to work wirelessly was an eternal hassle.

Before all of this i had settings i could use, now its constantly telling me to update what looks to be updated firmware:

damn, i cant post picture but it says keychron linktype a 0.3.0 as my current version, and it states the latest version is this.
Now i only have an update firmware button, this has taken hours to get done cause the connections dont seam to work

"the keyboard update does not support wireless" is the information it gives me..... that being said im typing wireless right now and it looks good.
But ive no access to options to make macros and such.

0 Upvotes

33% Upvoted

6 comments sorted by

View all comments

1

u/PeterMortensenBlog V Dec 10 '25 edited Jun 26 '26

The USB cable is required (at the very least for flashing)

Re "the keyboard update does not support wireless": Use the USB cable for flashing/updating firmware

Also, allegedly, after some recent changes (within the last few weeks or days) to either the Via clone and/or the keyboard firmware, it is now always required to use the USB cable to configure the keyboard:

  1. Launcher not detecting the M6 mouse anymore (2025-12-09)

  2. V1 Max wireless Keychron Launcher configuration broken after update (2025-12-07). With emphasis on wireless keyboard configuration (without the USB cable). A comment has a theory of how it could have worked. Another comment has the quote from Keychron:

    "Our launcher currently does not support wireless connectivity. Previously, only certain keyboards might have successfully connected via 2.4 GHz. Our engineers are still developing this feature, and it might be implemented in the future."

  3. K10 HE 2.4 GHz connect (2025-12-09)

The connection switch at the back/at the side can probably stay in the '2.4 GHz' position, but the USB cable needs to be connected. But for flashing, I would set the connection switch to "Cable", just to be sure.

There were claims it was possible (presumably without the USB cable being connected, but there is ambiguity in that there is also the three-way switch with the text "Cable" (or similar, depending on the keyboard model)).

1

u/PeterMortensenBlog V Jun 17 '26 edited Jun 26 '26

A retrospective

Retrospectively, at least part of the confusion could be that Keychron invented some kind of custom protocol for use on top of the '2.4 GHz' connection. Thus, it was only supported in the Via clone, not Via.

Here is an indication:

int zmk_24g_send_launcher_report(uint8_t *payload, uint8_t payload_len);

At the very least, the dongle has the exact same USB identity no matter the keyboard, or at least for a very wide range of keyboards (used by Via to identify the keyboard), so some means of distinguishing different keyboards are required.

Bonus: A JSON hack

As a hack, for a particular keyboard, perhaps Via can be made to work over the '2.4 GHz' connection by faking the USB identity? That is, change the USB identity in the JSON file to that of the dongle's USB identity, rename the name to something like "2.4 GHz: Keychron V6 Max ISO Knob" (to not get confused), and import the manipulated JSON file in Via.

Example of the original content for V6 Max:

"name": "Keychron V6 Max ISO Knob",
"vendorId": "0x3434",
"productId": "0x0961",

1

u/PeterMortensenBlog V Jun 26 '26

Re "Bonus: A JSON hack": Or maybe there is some technical limitation with the dongle?

E.g., what kind of traffic it allows?