How to Use Adafruit KB2040 Kee Boar Driver: Examples, Pinouts, and Specs

The Adafruit KB2040 Kee Boar Driver is a compact and versatile microcontroller board designed specifically for keyboard and input device applications. Powered by the RP2040 chip, it offers robust performance, USB-C connectivity, and compatibility with a wide range of input devices. Its small form factor and advanced features make it an excellent choice for custom keyboard projects, macro pads, and other human interface device (HID) applications.

• Custom mechanical keyboards
• Macro pads for productivity or gaming
• MIDI controllers and other musical input devices
• DIY human interface devices (HID)
• Prototyping and educational projects involving input/output devices

The Adafruit KB2040 Kee Boar Driver is built around the RP2040 microcontroller and includes several features tailored for keyboard and input device applications.

The KB2040 features 20 GPIO pins, which are accessible via solder pads. These pins can be used for digital I/O, analog input, and other functions. Below is the pinout description:

1. Powering the Board: Connect the KB2040 to a USB-C power source. The board operates at 5V input and regulates it to 3.3V for internal use.
2. Connecting Peripherals: Use the GPIO pins to connect switches, LEDs, or other input/output devices. Ensure that all connected devices operate at 3.3V logic levels to avoid damage.
3. Programming the Board: The KB2040 supports CircuitPython, MicroPython, and Arduino IDE. To upload code:
   • Hold the BOOTSEL button while connecting the board to your computer via USB-C.
   • The board will appear as a USB mass storage device.
   • Drag and drop the firmware file (e.g., CircuitPython UF2) onto the drive.

• Voltage Levels: Ensure all connected peripherals operate at 3.3V logic levels. Use level shifters if interfacing with 5V devices.
• Debouncing: For keyboard switches, implement software or hardware debouncing to avoid multiple signals from a single press.
• Pin Usage: Avoid exceeding the current limits of GPIO pins (maximum 12mA per pin).
• ESD Protection: Handle the board with care to prevent electrostatic discharge damage.

Below is an example of how to use the KB2040 to read a button press and toggle the built-in LED:

// Define pin numbers
const int buttonPin = 2;  // Button connected to GPIO D2
const int ledPin = 13;    // Built-in LED connected to GPIO D13

void setup() {
  pinMode(buttonPin, INPUT_PULLUP); // Set button pin as input with pull-up
  pinMode(ledPin, OUTPUT);          // Set LED pin as output
}

void loop() {
  // Read the button state
  int buttonState = digitalRead(buttonPin);

  // If button is pressed, toggle the LED
  if (buttonState == LOW) { // Button pressed (active low)
    digitalWrite(ledPin, HIGH); // Turn on LED
  } else {
    digitalWrite(ledPin, LOW);  // Turn off LED
  }
}

1. Board Not Recognized by Computer:

   • Ensure the USB-C cable is data-capable (not charge-only).
   • Hold the BOOTSEL button while connecting the board to force it into bootloader mode.

2. GPIO Pins Not Responding:

   • Verify that the pins are correctly configured in your code.
   • Check for shorts or incorrect wiring.

3. CircuitPython Code Not Running:

   • Ensure the code.py file is present on the board's storage.
   • Check for syntax errors in the code.

4. Overheating or Power Issues:

   • Avoid drawing excessive current from the GPIO pins.
   • Ensure peripherals are within the board's voltage and current limits.

Q: Can I use the KB2040 with 5V peripherals?
A: The KB2040 operates at 3.3V logic levels. Use level shifters to interface with 5V devices.

Q: What programming languages are supported?
A: The KB2040 supports CircuitPython, MicroPython, and Arduino IDE.

Q: How do I reset the board?
A: Press the RESET button on the board. To enter bootloader mode, hold the BOOTSEL button while resetting.

Q: Can I use the KB2040 for non-keyboard projects?
A: Yes, the KB2040 is a general-purpose microcontroller and can be used for various applications beyond keyboards.