May Pad Macropad with the KB2040, KMK, and CircuitPython

Build this entirely through-hole macropad with CircuitPython

published February 01, 2022, last edited January 21, 2025

posted in Microcontrollers CircuitPython Programming/ MicroPython / CircuitPython

Beginner

Project guide

Setting Up KMK

After having installed KMK on the previous page, you're going to want to click 'Download Project Bundle' on the file below. Unzip the file, copy kb.py to your CIRCUITPY drive and rename main.py to code.py and copy it to the CIRCUITPY drive as well.

Download Project Bundle

Copy Code

# SPDX-FileCopyrightText: 2022 Eva Herrada for Adafruit Industries
# SPDX-License-Identifier: MIT

import board

from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
from kmk.matrix import DiodeOrientation


class KMKKeyboard(_KMKKeyboard):
    row_pins = (board.D5, board.D6, board.D7, board.D8, board.D9)
    col_pins = (
        board.A1,
        board.A0,
        board.SCK,
        board.MISO,
    )
    diode_orientation = DiodeOrientation.COLUMNS
    i2c = board.I2C

# SPDX-FileCopyrightText: 2022 Eva Herrada for Adafruit Industries
# SPDX-License-Identifier: MIT

import board

from kmk.kmk_keyboard import KMKKeyboard as _KMKKeyboard
from kmk.matrix import DiodeOrientation


class KMKKeyboard(_KMKKeyboard):
    row_pins = (board.D5, board.D6, board.D7, board.D8, board.D9)
    col_pins = (
        board.A1,
        board.A0,
        board.SCK,
        board.MISO,
    )
    diode_orientation = DiodeOrientation.COLUMNS
    i2c = board.I2C

View on GitHub

Change line from kmk.matrix import DiodeOrientation to kmk.scanners import DiodeOrientation per latest documentation

After you've copied everything over, your CIRCUITPY drive should look something like this.

Key Mapping

The default keymap for this macropad is the numpad keymap.

At this point, the keyboard should just work when you hit the keys. Feel free to mess around with the key maps. KMK has some good documentation on this process.