BlueMicro Firmware 
WARNING: Do not upgrade Adafruit nRF52 to release 0.22.0 or 0.22.1!
On May 19, 2021, Adafruit released version 0.22.0 of their nRF52 Arduino board support package without fixing the high power consumption issue reported in November 2020.
This release makes significant changes in how Bluetooth pairing is handled and uses the ARM CryptoCell CC310. This component increases current consumption by a constant 6mA.
A fix to this high current consumption has been merged into the HEAD of the repository but has not been released yet. See the PR here
The Fix has been tested and successfully fixes the issue. Updated current consumption has been documented on the issue
We will be updating this note once the fix is released and tested with the BlueMicro_BLE firmware.
Adafruit 0.23.0 has been released with the cryptocell high current consumption fix. There were many other changes with 0.22 and 0.23 releases and haven't been tested yet with BlueMicro_BLE firmware.
Adafruit has released Adafruit_nRF52_Arduino 0.24.0 as well as Adafruit_nRF52_Arduino 1.0.0.
They haven't been tested with BlueMicro_BLE yet but appear to work fine as none of the USB HID functionality is enabled by BlueMicro_BLE when compiled with the Adafruit Board Support Package. Work has started to refactor and merge the USB HID examples for use with the Adafruit_nRF52_Arduino.
A Keyboard Firmware for nRF52832 and nRF52840 Boards
BlueMicro_BLE is a keyboard firmware that builds on top the Adafruit nRF52 board support package (BSP) for their line of Adafruit nRF52 Feather Boards.
By starting with the simple hid_keyboard.ino example provided with the Arduino board support package, we expanded it to a full blown Keyboard firmware with lots of features.
Build Status
| Branch | Github Actions - Docker (Adafruit BSP) | Github Actions - Docker (Community BSP) | Github Actions - Ubuntu (Community BSP) | Jenkins - Windows |
|---|---|---|---|---|
| Master |  |
 |
 |
|
| Develop |  |
 |
 |
Documentation
See the pages Here
You can contribute to the documentation by editing the markdown files located in the docs folder of the repository.
Video Documentation - BlueMicro Youtube Channel
See a number of tutorials, builds and other keyboard related videos on the BlueMicro Youtube Channel.
Compatible Hardware
Any nRF52832 or nRF52840 boards that support either of the following 2 Arduino Board Support Packages:
- Arduino Core for Adafruit Bluefruit nRF52 Boards
- Community Add-on to the Adafruit_nRF52_Arduino Board Support Package
If you use the Adafruit nRF52 Boards in the Arduino IDE, you should select either of the following:
| Chip | Default Board Selection |
|---|---|
| nRF52832 | Adafruit Feather nRF52832 |
| nRF52840 | Nordic nRF52840DK (PCA10056) |
If your board needs a special bootloader or a configuration that's not compatible with the above boards, you should consider adding your board to the Community Add-on to the Adafruit_nRF52_Arduino Board Support Package. This will make it simpler for others to re-use your special configuration and flashing the bootloader.
Contributing
We're very happy to have your contributions in BlueMicro_BLE Firmware
Contributing New Features: First, make sure you've run a full set of builds for all boards if adding new functionality (./build.ps1 all). This will ensure that the new functionality doesn't break the build of other keyboards. Then, make a pull request to this repo. Thanks!
Adding a new keyboard: First, add your new keyboard to the folder structure. You will need to create the apropriate folders and place the 4 necessary keyboard files. Then, make sure you've run a build for all keymaps applicable to your keyboard (./build.ps1 keyboardname). This will ensure that your keymap can support future hardware configurations. Then, make a pull request to this repo. Thanks!
Adding your keymaps: First, make sure you've run a build for all keymaps applicable to your keyboard (./build.ps1 keyboardname). This will ensure that your keymap can support other hardware configurations. Then, make a pull request to this repo. Thanks!
Looking for a feature: Lots of features are already available; however, not everything is documented yet. Join in on the Discord server and ask if it's already available, or if anyone is working on what you are looking for. If you are willing to help adding or testing a new feature, join the team!
Filing an issue: Submit issues to the GitHub Issues page.
Want to help: take one of issues in the list here where you think you could help. Comment on it as you start work and join in on the Discord server for a live discussion.
Credits
The firmware uses the same Arduino Board Support Package as the Adafruit nRF52 Feather Boards
BlueMicro_BLE uses the following projects, each are licensed separately.
| Project | Details | Release |
|---|---|---|
| Arduino IDE | Development Platform |  |
| Arduino CLI | Alternate platform |  |
| Community nRF52 Arduino | Board Support Package |  |
| Adafruit nRF52 Arduino | Board Support Package |  |
| Adafruit nRF52 Bootloader | Bootloader |  |
| Adafruit Neopixel | RGB LED Library |  |
| Adafruit TinyUSB Arduino | USB Library for nRF52840 |  |
| Hathach TinyUSB | USB Library for nRF52840 |  |
| Adafruit SSD1306 | Monochrome OLEDs Library based on SSD1306 drivers |  |
| Adafruit GFX Library | core graphics library |  |
| Adafruit_BusIO | helper libary to abstract away I2C & SPI transactions and registers |  |
| Olikraus U8g2 | U8g2: Library for monochrome displays, version 2 |  |