Keebio Documentation
  • Website
  • docs
    • 3D-Printed Case Parts Installation
    • adding-rgb-underglow
    • BAMFK-1 Build Guide
    • bdn9-build-guide
    • bdn9-rev1.3-build-guide
    • bdn9-rev2-build-guide
    • BFO-9000
    • Breeze Rev. 1.3 Build Guide
    • case-files
    • Cepstrum Hotswap
    • Chiri CE
    • choc-stabs
    • chocopad-build-guide
    • Convolution Build Guide
    • Default Keymaps
    • dfu-on-pro-micro
    • dilly-build-guide
    • Elite-Pi Usage Guide
    • VIA Firmware Upgrade Procedure
    • Flashing Firmware
    • FoldKB
    • fourier-build-guide
    • glossary
    • Switch Installation for Pre-Built Hotswap Keyboards
    • Iris Aluminum Case Build Guide
    • Iris CE
    • iris-choc-build-guide
    • Iris Keyboard
    • iris-led-fix
    • Iris LM
    • iris-middle-layer
    • iris-rev2-build-guide
    • Iris Rev. 3-5
    • Iris Rev. 6-8 Hotswap
    • Enabling Iris Rev. 6 VIA RGB Controls & Encoder Mapping
    • Iris SE
    • laplace-build-log
    • Levinson Rev. 3
    • Lighting Options
    • Build Guide Info
    • nyquist-build-guide
    • nyquist-rev3-build-guide
    • Quefrency Rev. 4-6 Hotswap Build Guide
    • quefrency-rev1-build-guide
    • Quefrency/Sinc/KBO-5000 (Solder Version)
    • Remapping/Reprogramming your Keyboard
    • Reprogramming Encoders
    • Resetting/Clearing EEPROM
    • schematics
    • Sinc Rev. 3-4 Hotswap Build Guide
    • Recommended Soldering Tools
    • Stampy Usage Guide
    • standard-for-build-guides
    • stick-build-guide
    • Tenting Bolts Setup for Acrylic Middle Layer
    • Testing Your PCB
    • troubleshooting
    • VIA and QMK Firmware
    • VIA Usage Guide
    • viterbi-rev2-build-guide
    • Waterfowl Build Guide
    • WTF60
    • faq
      • Contact Info
      • Recommended Keycaps
      • main
      • miscellaneous
      • ordering
      • Products
      • Shipping
      • Switches and Sockets
      • Technical/Build Info
Powered by GitBook
On this page
  • What is the Elite-Pi?
  • Features
  • Advantages over Pro Micro/Elite-C
  • Pinout
  • Usage Information
  • Additional Info
  1. docs

Elite-Pi Usage Guide

Previousdilly-build-guideNextVIA Firmware Upgrade Procedure

Last updated 10 months ago

What is the Elite-Pi?

The Elite-Pi is an RP2040-based controller with a Pro Micro/Elite-C compatible pinout that's primarily intended for use with keyboards.

You can purchase them at your favorite keyboard store:

Features

  • Microcontroller: RP2040

  • Flash Memory: 16Mbit (W25Q16JVUXIQ)

  • Pinout: Pro Micro-compatible

  • Number of available pins: Up to 25 I/O pins

  • Firmware Support: , ,

  • Mid-mount USB-C to keep low-profile

  • Availability:

Advantages over Pro Micro/Elite-C

In comparison to the Pro Micro or Elite-C, the Elite-Pi provides a few advantages over them:

  • Flash memory: Lots of space to compile in various QMK features without worry, as the Elite-Pi has much more flash memory

  • Price: Since the RP2040 microcontroller costs less than the ATmega32u4, we can provide it at a lower price than the Elite-C

  • Flashing: Instead of using QMK Toolbox, you can just copy a complied .uf2 file to the Elite-Pi to update the firmware

Pinout

Usage Information

QMK Firmware

Converters

Examples:

Using QMK CLI:

qmk compile -c -kb keebio/levinson/rev3 -km default -e CONVERT_TO=elite_pi

Using make:

make keebio/levinson/rev3:default CONVERT_TO=elite_pi

Without Converter

Reset/Boot

In the future, we plan on reducing the Elite-Pi to have just one button to perform Run and Boot.

Flashing

To repeat the information there, here's the steps:

  1. Enter bootloader mode (use one of the following methods):

    • For a new Elite-Pi out of the packaging, it will already start in bootloader mode when plugged into the computer

    • Double-tap the Run/Reset button (if flashed and was compiled with RP2040_BOOTLOADER_DOUBLE_TAP_RESET option)

    • Hold the Boot button (the left button) down, press the Run button (the right button), and release both buttons

    • Hold the Boot button (the left button) down, while pluging in the USB-C cable

    • Press the QK_BOOT keycode (if present on a flashed keyboard)

  2. Wait for OS to detect the Elite-Pi

    • It will show up as a USB mass-storage device named RPI-RP2

  3. Copy the .uf2 file to the RPI-RP2 USB drive

If you have the Elite-Pi installed with the back facing towards you, and you need to press Boot, take a wire and connect the Boot pad on the back and a GND pad, as shown below:

Additional Info

Can I use this on just one half of a split keyboard and use a Pro Micro on the other half?

No, you can not mix the Elite-Pi with a non-RP2040 controller like the Pro Micro or Elite-C.

However, another RP2040 controller can be used with it.

Accessing D10/D11 via side pads

If you would like to access D10 and/or D11 via the pads on the side of the Elite-Pi, you will need to cut the traces connecting GND to the those pads, as by default, the side pads are connected to GND to match the normal Pro Micro pinout. After cutting the traces, add solder as shown below to jump D10/D11.

CircuitPython

The recommended way to use the Elite-Pi is using a converter in QMK. Note that you will not be able to take a .hex file compiled for a Pro Micro (ATmega32u4) and rename it as a .uf2 file, it just doesn't work that way. In either usage case, you will need a .

If you are using the Elite-Pi on a Pro Micro-compatible board, then you can use a in QMK to map the pins correctly to the PCB.

To use the converter, see the instructions here:

Alternatively, if you are creating a keyboard from scratch, you can use it as a RP2040 board as described here: .

At the moment with V1 of the Elite-Pi, there are two buttons on it for Run/Reset and Boot, unlike the Elite-C, where there is only one button needed for Reset. The left button is for Boot, and the right button is for Run. You will mainly be interested in getting the Elite-Pi into bootloader mode, so please see the for doing this.

The directions to flash the Elite-Pi can be found in the .

If you used the mentioned above, it will have this option enabled

The Elite-Pi can be used with CircuitPython, and since the hardware is the same as that of the Raspberry Pi Pico, you can use CircuitPython build for it:

Elite-Pi at Keebio
QMK
KMK
CircuitPython
Elite-Pi at Keebio
QMK build environment setup
converter
QMK converter usage
QMK - RP2040 Info
QMK Documentation in the Flashing section
CircuitPython for Raspberry Pi Pico
directions below
converter