Skip to main content

One post tagged with "CircuitPython2022"

View All Tags

ยท 17 min read
Pierre Constantineau

A BlueMicro Review of 2021โ€‹

2021 was an eventful year in the word of wireless mechanical keyboards and BlueMicro.

Wireless Hardwareโ€‹

Although BlueMicro was the precursor to many breakout boards now used as controllers for keyboard builds, the nice!nano is now the most popular in the mechanical keyboard community, followed by the nRF52840 feather express for handwired builds and the nrfmicro for more adventurous builders. The BlueMicro840 is still an option but as my time is limited and they are manually assembled, their supply was limited, even before the chip shortage hit the needed modules (more to come on that...). For more GPIOs, there is the BlueMacro840 which makes available more GPIOs.

The first all-in-one keyboards I designed in 2021 was the BlueHand. A simple 8-keys hand-sized wireless mechanical keyboard that's been designed for; a one-handed keyboard typing system that uses chording for registering keypresses.

The chip shortage has affected the supply of processors for many projects. The nrf52840 modules used for the Bluemicro840, BlueHand and nrfmicro became scarce and the few modules that could be found went for 6x their original prices; making the modules even more expensive than a Nice!Nano.

This has prompted me to create the BlueMicro833, based on the now available nrf52833 modules which are almost identical to the 840 modules at a similar price as the original nRF52840 modules a year ago. The most important differences are RAM and Flash sizes. Unfortunately, firmware support is lacking. A BlueMicro833 was sent to the ZMK team for testing and it tested fine with ZMK.

Is new hardware even possible with the chip shortage?โ€‹

In early 2021, Raspberry Pi introduced the RP2040. The RP2040 is a dual core ARM Cortex M0+ chip with interesting peripherals and is very cheap. It's only wired - no BLE with this chip. Because the RP2040 is the first microcontroller from Raspberry Pi, it had no pre-existing users (for example, car manufacturers), it saw really good availability, even JLCPCB has it for PCBA. Circuitpython was available relatively quickly. A few videos are on Youtube on how to design a rp2040 board made the task quite simple. Raspberry PI even provided a reference design. As such, I introduced PyKey, a suite of mechanical keyboards with a RP2040 as the processor, starting with PyKey60, a 60% keyboard based on the GH60 form factor (More sizes are now available: Numpad, TKL, 44-keys Ergo).

Wireless Firmwareโ€‹

QMK has retained the dominant firmware for mechanical keyboards but ZMK became the dominant choice for newcomers to wireless DIY mechanical keyboards. Based on the Zephyr project, it has a good follower base. Just like QMK, it focuses on a readily available firmware and not on basic troubleshooting tools that can help the DIY builder troubleshooting their hardware troubles. Additionnaly, as ZMK uses the Zephyr BLE stack and not the Nordic SoftDevice, some users have faced issues pairing with some devices (Apple mostly). Some of these users have gone to BlueMicro_BLE and their pairing troubles were resolved.

Bluemicro_BLE being based on the Arduino nRF52 board support package from Adafruit, is much more friendly in case the user needs to create their own code to troubleshoot their hardware.

Since Adafruit will only include boards that they sell within their nRF52 Arduino Board support package, I created a fork of the BSP (and disconnected it) and created the Community Add-On nRF52 Board Support Package to which changes were made; most importantly, the addition of many nRF52 boards and keyboards available to the community. My decision to split the code base from the source repository was mainly based on the desire remove the problematic code causing high current consumption, but also to keep a fork for me to be able to contribute to the main repository while having a separate repo for the Community boards. Unfortunately, this decision came to bite me when many positive changes were pushed to the Adafruit nRF52 Arduino Board Support Package.

In order to make more options available for users, support for CircuitPython was added for the BlueMicro840. Circuitpython adds a new framework by which one can code their keyboards and even troubleshoot their hardware. You can go to the PyKey project to see lots of keyboard troubleshooting tips with CircuitPython.

CircuitPython also makes KMK an option for BlueMicro840 users. I even designed an ultra-portable wireless keyboard that uses 44 Kailh Thin keys that saw KMK as the first firmware to run on it. I year ago, I never coded any Python. Today, I can count a few of my keyboards within the KMK repo; all Python code I wrote...

Firmware for nRF52833โ€‹

Unfortunately, support for the Nordic nRF52833 in the Arduino IDE is non-existent. There were a few PRs but none were included in the Adafruit nRF52 Arduino Board Support Package. An issue was raised to ask if the nRF52833 Dev Kit from Nordic would be merged in if a PR would be made (even if on a not-supported basis). No clear response yet. Without Arduino support for ths chip, BlueMicro_BLE firmware won't be able to run on it. In the meantime, try CircuitPython,KMK or ZMK!


2021 started great for BlueMicro_BLE with the addition of a few great features:

  • USB and BLE switching - Wireless and Wired on the same keyboard - switched automatically!
  • Mutiple BLE Profiles - making it possible to choose which computer to connect it to
  • Combos/chording: a new keycode-based chording engine that replaces keycodes when two or more keycodes are detected. (press multiple keys, send something else...). Unlike other firmwares, the engine is not key based but keycode-based.
  • BlueMicro_Builder: Inspired by the simple build process of ZMK, a new BlueMicro_Builder repository template has made available the option for nRF52840 users to have their firmware built by GitHub Actions. Check out the video to see how it works!

With new features, new bugs and issues always come to haunt us, along with more feature requests... 2022 will look at resolving some of the more fundamental problems, bringing 1.3.0 BSP support all while enabling easier future improvements.

What's coming in 2022 for BlueMicro?โ€‹

Update to Latest Adafruit nRF52 Arduino BSP.โ€‹

With all the major changes to TinyUSB completed and rolled into the adafruit nRF52 board support package, as well as the support for multiple Bluetooth profiles from the Adafruit BSP itself, there are no core changes in the Community Board Support pachages that are needed, except for the additional boards. As such, a staged approach will be taken to update both the BlueMicro_BLE firmware and the Community Add-On nRF52 Board Support Package to the latest BSP.

Unifying the interface for USB and BLE HIDโ€‹

In 2021, I started the effort to unify the BLE and USB calls into a single library, starting from thr ground up using the HID_Composite examples. After countless hours of unsuccessful and hair-pulling code streams, I finally have something working.

I am planning to make a common HID library that handles both BLE on the nRF52 chips and USB on boards with TinyUSB support. This would be publised as an Arduino Library. By migrating to this library, this means that Bluemicro_BLE will be able to support the nrf52 chips, the RP2040 and the SAMD21 and SAMD51 chips; at least from a single keyboard point of view. Split keyboards would be next. The prototype code already runs on multiple Adafruit Feathers (nrf52832, nrf52840, RP2040, SAMD21, SAMD51).

Making Mousekeys work (and make sense)โ€‹

Since the unified library described above is based on the HID_Composite examples, the library would enable parallel keyboard/mouse/consumer keyscodes to be sent (as opposed to only one of the 3). This would enable refactoring the code to simplify how the different HID messages are handled.

What else?โ€‹

What are you looking for as improvements to your keyboard firmware and hardware?

Here are some of the ideas I have received:

CircuitPython 2022โ€‹

Since BlueMicro has a focus on keyboards and other HID/Input devices, this will obviously have a keyboard focus; either to help generic firmware, KMK or enable users develop more complex keyboards from a common set of building blocks. As I am not a Python developer, I don't expect to be able to make significant contributions to libraries but I can contribute to new boards reviews, minor core additions and commenting on use of specific libraries I might use.

Keypad extensionsโ€‹

The keypad core module defines a simple interface by which keypress/keyrelease events are provided to the user for acting upon. Using this common interface for detecting key presses is currently a Work in Progress in KMK.

Expanding the use of the keypad API to non-board GPIOs would be a natural extension.

To enable flexibility in how people design their keyboards, the following GPIO expanders should be included as part of an add-on keypad library (or family of libraries).

The add-on library would make I2C devices available with the same API as the core keypad module. This way, people could use the same code regardless where their keys and keypads are connected to.

A great example of a split keyboard that uses multiple GPIO expanders is Zack Freedman's MiRage keyboard. Check out his video and his repo.

Hide your ghostsโ€‹

Another possible extension but to the core keypad module would be to enable key matrices that do not have anti-ghosting diodes. One of the BlueMicro_BLE contributors has an example where ghost key detection and filtering is done so that ghost keys are not included as part of the key state transitions. Adding diodes is not always possible as this code is used as part of a Model M keyboard Wireless retrofit. Other keyboards might not have the room for diodes - check out this Tiny Pico Keyboard for an idea how small one can go. I have my own wireless one that's based on the BlueMicro840 but has the footprint of a Raspberry Pi Zero.

Make your own SeeSawโ€‹

Adafruit has led an interesting I2C revolution with the introduction of multiple SeeSaw input devices:

Split keyboards could be designed with the secondary side being a custom SeeSaw device, while the primary side would be standard CircuitPython or Arduino code.

There is an Arduino Library for creating your own seesawPeripheral, however, it seems that it's only supported by the megaTinyCore (AVR) chips (although the library properties seems to indicate otherwise). It would be very useful to be able to create your own SeeSaw device using CircuitPython. Take a KB2040, a Raspberry Pi Pico, a Feather M4 or a small SAMD21 board and re-purpose it as a SeeSaw co-processor for handling remote input/output devices. If CircuitPython can't be used due to size limitations, an Arduino library for use with the SAMD21 would be useful. I believe porting the I2C peripheral module to other chips would be the starting point.

Split keyboards and the KB2040 (and Pro Micro RP2040):โ€‹

To understand the potential issues with the RP2040 on a board with the form factor of the Pro Micro, we need to see a brief history of split keyboards and how communications was handled between the halves.

A recent history of split keyboardsโ€‹

The table below presents a brief list of split keyboards, starting with the Original Ergodox from 2013. The Let's Split V2 is the board that truely kicked-off the DIY Split keyboard explosion of options. It's inspired from the Planck but divided into two halves.

A number of commercial keyboards have not been included due to their closed source PCBs. Nevertheless, this list is very small. Have a look here is you want to see a large database of split boards...

BoardDatePCB RepoBuild GuideSerial PinI2C
ErgoDox OriginalJuly 2013PCB-n/a
ErgoDox IODec 2016PCB-n/aMCP23018
Let's Split V2April 2017PCB RepoBuild GuideD0D1/D0
MinidoxAugust 2017PCBGuideD0n/a
HelixFebruary 2018PCBGuideD0 (V1), D2 (V2)Oled
ErgoTravelJune 2018PCBGuideD0D1/D0
Lily58October 2018PCBD2Oled
SofleSept 2019PCBGuideD2Oled
CorneOctober 2019PCBGuideD2Oled

On the Pro Micro, D0/D1 are SCL/SDA and D2/D3 are RX/TX.

As you can see from the table, the design of the Let's Split opted for making the selection of I2C an option by using the SCL line as a serial line between the two boards. This freed a data line for users to add RGB data between the two halves. Most builds that used the Let's Split as a template used D0 with software serial. Some kept the option for I2C, others dropped it.

However, with the addition of I2C OLED screens on the Helix, serial communications between the two halves was relocated to be on D2 (See differences between V1 and V2). Since D2 is RX, on one side hardware UART can be used but software UART has to be used on the other side. This allows for 1-way communications. 2-way comms would need to use software serial with some software handshaking to handle direction changes (and perhaps a resistor to limit current in case of TX on both sides at the same time); 2-way serial is probably not generally implemented on a single line due to the additional complexity.

The problem with the RP2040 and hardware UARTโ€‹

Unlike the nRF52 where any GPIO can be used for I2C and UART, the RP2040 has some restrictions on what functions are available for each GPIO. If one wants to use non-standard (i.e. not in the table of page 13-14 of the datasheet), you have to use the PIO to create your own UART RX or TX (Datasheet Page 373) peripherals. Since most pro-micro keyboards that used I2C, relied on hardware for I2C. However, to keep build flexibility and cost of PCB designs low, the same I2C pins were re-used but for serial. Serial communications were slao setup with a single line to leave a line free for "RGB Data". Using the same data pin on each side allowed for mirrored builds and for the possibility of setting up both sides identically and automatically detecting which side is primary or secondary by monitoring whether USB is connected; hence detecting the desired data direction on the serial line.

This means that serial connection of many (if not most) split keyboards will rely on "non-standard" RX/TX pins definition compared to the default Arduino Pro Micro definitions.

For existing split keyboards to work, we need software UART (or PIO UART) in CircuitPython.

I2CPeripheral for other chips (RP2040, SAMD21, nRF52, etc)โ€‹

To enable I2C communications between keyboard halves or to build your own seesaw board using CircuitPython, I2CPeripheral on the RP2040 and other chips is needed. Once available, a seesaw_peripheral library will be possible. Possibly leveraging the adafruit_register.i2c_struct.Struct function, perhaps in a bi-directional way: define the same registers on both sides of the communication channel and let the I2C "magic" do its thing...

Very Deep Sleep on the nRF52โ€‹

I have an article that compares ZMK, BlueMicro_BLE and CircuitPython running and sleep current on the same device. Unlike the other two, CircuitPython isn't a compiled language. As such, power consumption when running will never be able to reach the level of designed-for-purpose compiled code. Nevertheless, when going in deep sleep, the chip shouldn't be running and one would expect a comparable current. Unfortonately, how deep sleep is implemented in CircuitPython is more of a "nap" than a sleep. The chip regularly wakes up to check the state of alarm pins, then goes back napping until the next check.

As such, there is the possibility for an even deeper sleep for the nRF52 chips running CircuitPython. I don't know what it should be called as "deep sleep" is already taken. The article mentionned above highlights how it's done and how it behaves (full reboot on wake-up). This "Very Deep Sleep" needs an external pin to be toggled for the wake-up to occur. For keyboards, a simple keeypress does the job.


Detailed testing of the Bluemicro 833 with Circuitpython and KMK is needed to see how much useful room is available, both for Ram and Flash space. Having half the flash and ram as the nRF52840, I suspect that we may run into similar issues as the SAMD21. The SAMD21 has so little ram that it runs out of it pretty quickly. The nRF52833 has more, however as this is chip is meant for BLE functions and that the Softdevice consumes a chunk of space already, what's left to the user for Python code will be limited. Testing and Time will tell... Improvementsโ€‹

I would like to recommend a few minor improvements to the download page of, especially when it gets to filtering by chip family/chip type. With 269 boards, and going up regularly, filtering will become more important to find a board of choice for your next project.

The Atmel-Samd Processor Family includes SAMD21 and SAMD51 boards (ARM M0/M4) while the nRF52 Family is non-existant but nRF52840 is present instead of having nRF52833 and nRF52840 as separate chips.

A filter hierarchy similar to the tree below would enable users to search for boards with a specific processor.

  • Atmel-Samd
    • SAMD21
    • SAMD51
  • Broadcom
  • Cxd56
  • Espressif
    • Esp32c3
    • Esp32s2
    • Esp32s3
  • Litex
  • Mimxrt10xx
  • nRF52
    • nRF52833
    • nRF52840
  • Raspberry Pi
    • RP2040
  • STM
    • F4
    • H7
    • F7
    • L4

Some people might be interested in filtering by the core type as follows:

  • ARM Cortex M0
  • ARM Cortex M4
  • RISC-V
  • ARM Cortex-A7
  • ARM Cortex-A53

However, as you can already filter by the processor family, I doubt this will provide much value; only those asking "Does it run on RISC-V?" will get an answer...

Awesome CircuitPython Improvementsโ€‹

It would be neat to add a section/page/subpage to Awesome CircuitPython called Popular Projects Enabled by CircuitPython

This could include: