compatible_microcontrollers.md (5442B)
1 # Compatible Microcontrollers 2 3 QMK runs on any USB-capable AVR or ARM microcontroller with enough flash space - generally 32kB+ for AVR, and 64kB+ for ARM. With significant disabling of features, QMK may *just* squeeze into 16kB AVR MCUs. 4 5 Features within QMK may or may not be compatible with every microcontroller. 6 7 ## Atmel AVR 8 9 The following use [LUFA](https://www.fourwalledcubicle.com/LUFA.php) as the USB stack: 10 11 * [ATmega16U2](https://www.microchip.com/wwwproducts/en/ATmega16U2) / [ATmega32U2](https://www.microchip.com/wwwproducts/en/ATmega32U2) 12 * [ATmega16U4](https://www.microchip.com/wwwproducts/en/ATmega16U4) / [ATmega32U4](https://www.microchip.com/wwwproducts/en/ATmega32U4) 13 * SparkFun Pro Micro (and clones) 14 * PJRC Teensy 2.0 15 * Adafruit Feather 32U4 16 * [AT90USB64](https://www.microchip.com/wwwproducts/en/AT90USB646) / [AT90USB128](https://www.microchip.com/wwwproducts/en/AT90USB1286) 17 * PJRC Teensy++ 2.0 18 * [AT90USB162](https://www.microchip.com/wwwproducts/en/AT90USB162) 19 20 Certain MCUs which do not have native USB will use [V-USB](https://www.obdev.at/products/vusb/index.html) instead: 21 22 * [ATmega32A](https://www.microchip.com/wwwproducts/en/ATmega32A) 23 * [ATmega328P](https://www.microchip.com/wwwproducts/en/ATmega328P) 24 * [ATmega328](https://www.microchip.com/wwwproducts/en/ATmega328) 25 26 ## ARM 27 28 You can also use any ARM chip with USB that [ChibiOS](https://www.chibios.org) supports. Most have plenty of flash. Known to work are: 29 30 ### STMicroelectronics (STM32) 31 32 * [STM32F0x2](https://www.st.com/en/microcontrollers-microprocessors/stm32f0x2.html) 33 * [STM32F103](https://www.st.com/en/microcontrollers-microprocessors/stm32f103.html) 34 * Bluepill (with STM32duino bootloader) 35 * [STM32F303](https://www.st.com/en/microcontrollers-microprocessors/stm32f303.html) 36 * QMK Proton-C 37 * [STM32F401](https://www.st.com/en/microcontrollers-microprocessors/stm32f401.html) 38 * WeAct Blackpill 39 * [STM32F405](https://www.st.com/en/microcontrollers-microprocessors/stm32f405-415.html) 40 * [STM32F407](https://www.st.com/en/microcontrollers-microprocessors/stm32f407-417.html) 41 * [STM32F411](https://www.st.com/en/microcontrollers-microprocessors/stm32f411.html) 42 * WeAct Blackpill 43 * [STM32F446](https://www.st.com/en/microcontrollers-microprocessors/stm32f446.html) 44 * [STM32G431](https://www.st.com/en/microcontrollers-microprocessors/stm32g4x1.html) 45 * [STM32G474](https://www.st.com/en/microcontrollers-microprocessors/stm32g4x4.html) 46 * [STM32H723](https://www.st.com/en/microcontrollers-microprocessors/stm32h723-733.html) 47 * [STM32H733](https://www.st.com/en/microcontrollers-microprocessors/stm32h723-733.html) 48 * [STM32L412](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html) 49 * [STM32L422](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html) 50 * [STM32L432](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html) 51 * [STM32L433](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x3.html) 52 * [STM32L442](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html) 53 * [STM32L443](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x3.html) 54 55 ### WestBerryTech (WB32) 56 57 * [WB32F3G71xx](http://www.westberrytech.com) 58 * [WB32FQ95xx](http://www.westberrytech.com) 59 60 ### Artery (AT32) 61 62 * [AT32F415](https://www.arterychip.com/en/product/AT32F415.jsp) 63 64 ### NXP (Kinetis) 65 66 * [MKL26Z64](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/kl-series-cortex-m0-plus/kinetis-kl2x-72-96-mhz-usb-ultra-low-power-microcontrollers-mcus-based-on-arm-cortex-m0-plus-core:KL2x) 67 * PJRC Teensy LC 68 * [MK20DX128](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/k-series-cortex-m4/k2x-usb/kinetis-k20-50-mhz-full-speed-usb-mixed-signal-integration-microcontrollers-based-on-arm-cortex-m4-core:K20_50) 69 * [MK20DX256](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/k-series-cortex-m4/k2x-usb/kinetis-k20-72-mhz-full-speed-usb-mixed-signal-integration-microcontrollers-mcus-based-on-arm-cortex-m4-core:K20_72) 70 * PJRC Teensy 3.2 71 * [MK64FX512](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/k-series-cortex-m4/k6x-ethernet/kinetis-k64-120-mhz-256-kb-sram-microcontrollers-mcus-based-on-arm-cortex-m4-core:K64_120) 72 * PJRC Teensy 3.5 73 * [MK66FX1M0](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/k-series-cortex-m4/k6x-ethernet/kinetis-k66-180-mhz-dual-high-speed-full-speed-usbs-2mb-flash-microcontrollers-mcus-based-on-arm-cortex-m4-core:K66_180) 74 * PJRC Teensy 3.6 75 76 ### Raspberry Pi 77 78 * [RP2040](https://www.raspberrypi.com/documentation/microcontrollers/rp2040.html) 79 80 For a detailed overview about the RP2040 support by QMK see the [dedicated RP2040 page](platformdev_rp2040). 81 82 ## RISC-V 83 84 ### GigaDevice 85 86 [ChibiOS-Contrib](https://github.com/ChibiOS/ChibiOS-Contrib) has support for the GigaDevice [GD32VF103 series](https://www.gigadevice.com/products/microcontrollers/gd32/risc-v/mainstream-line/gd32vf103-series/) microcontrollers and provides configurations for the [SiPeed Longan Nano](https://longan.sipeed.com/en/) development board that uses this microcontroller. It is largely pin and feature compatible with STM32F103 and STM32F303 microcontrollers.