Getting Started

BlueMicro Youtube Channel

See a number of tutorials, builds and other keyboard related videos on the BlueMicro Youtube Channel.

NEW: BlueMicro Builder

A very easy way to get setup with your own firmware and compile it without installing anything on your computer1!

More documentation to come... Find the builder here and follow the instructions in the readme.

Getting Started: in 4 simple steps

Getting started with flashing your nRF52 board is as simple as installing the Arduino IDE for your operating system, adding the board support packages and compiling the firmware.

Step 1: Option 1 - Install Arduino IDE

Watch the video above to see how to install the Arduino IDE and get the library needed (it's all manual).

These are the steps followed in the video (Original Instructions by Adafruit):

Board Manager

  • Open the Boards Manager option from the Tools -> Board menu and install Adafruit nRF52 by Adafruit (see image below) Board Manager

It will take up to a few minutes to finish installing the cross-compiling toolchain and tools associated with this BSP.

The delay during the installation stage shown in the image below is normal, please be patient and let the installation terminate normally: Board Manager install progress

Once the Adafruit BSP is installed, click anywhere in the "Community Add on Adafruit nrf52 boards" box, and click "Install". This is a smaller installation and will happen much faster.

Community Add-on to Adafruit nRF52 Boards

Once the two BSP are installed, select the relevant board from the Tools -> Board menu, which will update your system config to use the right compiler and settings for your nRF52 board: Board Selection

Step 1: Option 2 - Install Arduino CLI (Windows script)

Watch the video above to see how to install the Arduino CLI and automatically get the library needed (it's in the script).
The script follows these steps:

  • Download the arduino-cli using the steps outlined here
  • Review the version installed arduino-cli version
  • Add the configuration file arduino-cli.yaml to the same folder where you have installed the executable binary for the arduino-cli. This file contains the additional Boards Manager URLs. It's located in the utils folder of the firmware.
  • Updates the index of cores from the added Boards Manager URLs: arduino-cli core update-index
  • Upgrade all installed platforms to the latest version: arduino-cli core upgrade
  • Make sure that the nRF52 Board Support Packages can be found: arduino-cli core search nrf52
  • Install the Adafruit nRF52 Board Support Package by running: arduino-cli core install adafruit:nrf52
  • Install the Community nRF52 Board Support Package by running: arduino-cli core install community_nrf52:nrf52
  • Verify that the nRF52 boards were installed: arduino-cli board listall

Step 2: Download BlueMicro_BLE Firmware

To get a copy of the firmware, you have 3 options:

  • Download the zip file of the master branch of the repository.
  • Clone the repository localy git clone
  • Fork the repo and clone locally. If you want to save your changes and contribute back to the project, you will need to opt for this method.

Simplest is just to download the zip file. In the video, I show the first 2 methods.

Step 3: Edit 4 Keyboard Files

Open the firmware in the IDE or your favorite editor, edit the following 4 files:

  • hardware_config.h: for the GPIO definition of your keyboard. This file will vary depending on the controller you select.
  • keyboard_config.h: for the BLE definition of your keyboard
  • keymap.cpp: for the keymaps definitions
  • keymap.h: to support the keymaps definitions

For more details on configuring your keyboard, look here...

Step 4: Compile and Upload

Video presents the Arduino-cli method.

If you use the Arduino IDE, follow these steps:

  • Select appropriate "Board" in the "Tools" menu
  • Compile
  • Connect your keyboard with USB cable
  • Select apropriate serial "Port" in the "Tools" menu
  • Upload - Depending on your hardware/firmware, you may need to double-press reset to put it in DFU mode
  • Go to your computer's Bluetooth connections and "add device"
  • You should be able to pair your keyboard

  1. nRF52840 Only. With nRF52832, you still need software to flash.โ†ฉ