Notices by Gergely Nagy 🐁 (algernon@trunk.mad-scientist.club), page 24

@wezm Yep, bugs will be filed today. Had to go to sleep last night. :)

A short recap of what I've been up to in #Kaleidoscope land lately: https://asylum.madhouse-project.org/blog/2017/12/02/kaleidoscope-progress-report/.

Includes topics such as suspend/resume, boot protocol support in #keyboard #firmware, mouse keys and #FreeBSD. And a few other things too.

So here I am, writing up a blog post, about this topic among others. As part of that, I reviewed the diff, and despaired. I finally understood why the new descriptors work, and why the old ones did not, even though the report ended up being the same.

All this work, all this diving deep into the spec, was all for naught, for the real fix is changing two lines.

See if you can spot what I saw: https://github.com/keyboardio/KeyboardioHID/pull/19/files#diff-482271719524cbe1a76840487519b299

At the end of the day, with only three pull requests, most of them reasonably simple and straightforward, we are at a stage where we can build a sketch that will work on FreeBSD without any manual settings post-compile. The factory firmware still doesn't work, because we still have keyboard + mouse on the same node.

I'll experiment with moving it to another node next. Though, it would be nicer if we could prod #FreeBSD so it would accept our keyboard half. Accept the first descriptor, perhaps?

@kel No, I don't think I did. That'd probably unearth a bunch of more strange things, I imagine. =)

Once I'm done with this boot keyboard support work, I'll write a blog post about this, suspend/resume, and USB HID descriptors. Because these were either interesting, or challenging, or both.

The good news is that most of this can be fixed, and workarounds put in place. Worst case, one will need to manually force boot mode on FreeBSD, but the keyboard will still work with factory firmware, once put into boot mode (likely with a key combo).

- FreeBSD does not support keyboard + mouse on the same node, and prefers the mouse. The Model01 factory firmware comes with keyboard + mouse on the same node, thus, doesn't work.
- This unearthed a bug in #Kaleidoscope, wherein disabling mouse keys would still create the device nodes, preventing the building of a FreeBSD-compatible firmware.

I tried the #Keyboardio Model01 under #FreeBSD, turns out, this is a terrific OS for finding corner cases, and strange implementation choices.

- FreeBSD only supports the boot keyboard report protocol, not NKRO.
- Despite this, it does not send `SET_PROTOCOL` to tell the keyboard to go into boot report mode. USB spec says keyboards should start in report mode, and only switch to boot when requested. FreeBSD assumes that if the device has the boot subclass, it will report as such, too.

@lmorchard If you find any new music like that, please share! :)

Not sure where I saw this a bit earlier (here, or on birdsite, or elsewhere), but I fell in love with Sentimental Versioning in an instant.

http://sentimentalversioning.org/

#SentimentalVersioning

@kensanata https://witches.town/@Ulfra_Wolfe/98940421558721241, if you haven't found it yet. :(

Time flies so fast! Joined the Keyboardio forums one year ago today. So much great content has been written there since...