gitbot/qmk_firmware
0
0
Fork 0
mirror of https://github.com/qmk/qmk_firmware.git synced 2024-12-04 17:05:17 +00:00
Code Issues Packages Projects Releases Wiki Activity
97547ac762
qmk_firmware/docs/compatible_microcontrollers.md

87 lines
5.3 KiB
Markdown
Raw Normal View History

[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
# Compatible Microcontrollers
Adding notes about ARM processors
2017-04-11 13:55:24 +00:00
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
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.
Adding notes about ARM processors
2017-04-11 13:55:24 +00:00
Inform people that things may not work. (#17391)
2022-06-14 10:15:01 +00:00
Features within QMK may or may not be compatible with every microcontroller.
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
## Atmel AVR
Updated Compatible Microcontrollers (markdown)
2013-11-18 00:39:10 +00:00
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
The following use [LUFA](https://www.fourwalledcubicle.com/LUFA.php) as the USB stack:
Created page. Initial list is the ATmega32U4 from the Teensy.
2013-11-17 19:47:36 +00:00
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
* [ATmega16U2](https://www.microchip.com/wwwproducts/en/ATmega16U2) / [ATmega32U2](https://www.microchip.com/wwwproducts/en/ATmega32U2)
* [ATmega16U4](https://www.microchip.com/wwwproducts/en/ATmega16U4) / [ATmega32U4](https://www.microchip.com/wwwproducts/en/ATmega32U4)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* SparkFun Pro Micro (and clones)
* PJRC Teensy 2.0
* Adafruit Feather 32U4
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
* [AT90USB64](https://www.microchip.com/wwwproducts/en/AT90USB646) / [AT90USB128](https://www.microchip.com/wwwproducts/en/AT90USB1286)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* PJRC Teensy++ 2.0
Adds AT90USB162 support (#11570) * at90usb162 support * fix missing bracket * Apply suggestions from code review Co-authored-by: Ryan <fauxpark@gmail.com> Co-authored-by: Ryan <fauxpark@gmail.com>
2021-01-30 03:53:56 +00:00
* [AT90USB162](https://www.microchip.com/wwwproducts/en/AT90USB162)
Adding notes about ARM processors
2017-04-11 13:55:24 +00:00
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
Certain MCUs which do not have native USB will use [V-USB](https://www.obdev.at/products/vusb/index.html) instead:
Adding notes about ARM processors
2017-04-11 13:55:24 +00:00
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
* [ATmega32A](https://www.microchip.com/wwwproducts/en/ATmega32A)
* [ATmega328P](https://www.microchip.com/wwwproducts/en/ATmega328P)
adds support for the atmega328 (#9043) Co-authored-by: Ryan <fauxpark@gmail.com>
2020-06-10 21:23:11 +00:00
* [ATmega328](https://www.microchip.com/wwwproducts/en/ATmega328)
Adding notes about ARM processors
2017-04-11 13:55:24 +00:00
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
## ARM
[Docs] Use HTTPS for images and links where possible (#11695)
2021-01-30 11:00:56 +00:00
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:
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
### STMicroelectronics (STM32)
* [STM32F0x2](https://www.st.com/en/microcontrollers-microprocessors/stm32f0x2.html)
* [STM32F103](https://www.st.com/en/microcontrollers-microprocessors/stm32f103.html)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* Bluepill (with STM32duino bootloader)
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
* [STM32F303](https://www.st.com/en/microcontrollers-microprocessors/stm32f303.html)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* QMK Proton-C
Add STM32G431 and STM32G474 board definitions. (#11793) * Add STM32G431 and STM32G474 board definitions. * Add docs.
2021-02-06 00:27:46 +00:00
* [STM32F401](https://www.st.com/en/microcontrollers-microprocessors/stm32f401.html)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* WeAct Blackpill
Initial pass of F405 support (#14584) * Initial pass of F405 support * remove some conf files * docs * clang
2021-09-24 23:19:41 +00:00
* [STM32F405](https://www.st.com/en/microcontrollers-microprocessors/stm32f405-415.html)
Add support for STM32F407x MCUs. (#13718) * Add support for STM32F407x MCUs. * Removing STMF407 MCU variation * Update quantum/mcu_selection.mk Remove options for dfu flashing Co-authored-by: Ryan <fauxpark@gmail.com> * DISABLE STM32_USB_USE_OTG1 * Update platforms/chibios/GENERIC_STM32_F407XE/configs/mcuconf.h Co-authored-by: Drashna Jaelre <drashna@live.com> * Update platforms/chibios/GENERIC_STM32_F407XE/configs/mcuconf.h Co-authored-by: thomas.pollak <thomas.pollak@dynatrace.com> Co-authored-by: Ryan <fauxpark@gmail.com> Co-authored-by: Drashna Jaelre <drashna@live.com> Co-authored-by: Nick Brassel <nick@tzarc.org>
2021-08-08 20:52:13 +00:00
* [STM32F407](https://www.st.com/en/microcontrollers-microprocessors/stm32f407-417.html)
Add STM32G431 and STM32G474 board definitions. (#11793) * Add STM32G431 and STM32G474 board definitions. * Add docs.
2021-02-06 00:27:46 +00:00
* [STM32F411](https://www.st.com/en/microcontrollers-microprocessors/stm32f411.html)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* WeAct Blackpill
Add support for MCU = STM32F446 (#12619) * Add support for MCU = STM32F446 * Update platforms/chibios/GENERIC_STM32_F446XE/configs/config.h Co-authored-by: Nick Brassel <nick@tzarc.org> * Restore mcuconf.h to the one used by RT-STM32F446RE-NUCLEO64 * stm32f446: update mcuconf.h and board.h for 16MHz operation, with USB enabled, and other peripherals disabled. Co-authored-by: Nick Brassel <nick@tzarc.org>
2021-04-25 08:59:25 +00:00
* [STM32F446](https://www.st.com/en/microcontrollers-microprocessors/stm32f446.html)
Add STM32G431 and STM32G474 board definitions. (#11793) * Add STM32G431 and STM32G474 board definitions. * Add docs.
2021-02-06 00:27:46 +00:00
* [STM32G431](https://www.st.com/en/microcontrollers-microprocessors/stm32g4x1.html)
* [STM32G474](https://www.st.com/en/microcontrollers-microprocessors/stm32g4x4.html)
STM32H723 support (#21352)
2023-06-28 03:07:14 +00:00
* [STM32H723](https://www.st.com/en/microcontrollers-microprocessors/stm32h723-733.html)
* [STM32H733](https://www.st.com/en/microcontrollers-microprocessors/stm32h723-733.html)
Adds support for STM32L412xB, STM32L422xB. (#13383) * Adds support for STM32L412xB, STM32L422xB. * Add to list of supported MCUs. * Disable SPI1 by default.
2021-06-30 00:07:40 +00:00
* [STM32L412](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html)
* [STM32L422](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html)
Add L432, L442. (#16016)
2022-01-23 21:49:36 +00:00
* [STM32L432](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html)
Add STM32L433 and L443 support (#12063) * initial L433 commit * change to XC * fix L433 * disable all peripherals * update system and peripheral clocks * 433 change * use its own board files * revert its own board files * l433 specific change * fix stm32l432xx define * remove duplicate #define * fix bootloader jump * move to L443xx and add i2c2, spi2, usart3 to mcuconf.h * move to L443 * move to L443 * fix sdmmc in mcuconf.h * include STM32L443 * add L443 * Include L443 in compatible microcontrollers Co-authored-by: Nick Brassel <nick@tzarc.org> * Include L443 in compatible microcontrollers Co-authored-by: Nick Brassel <nick@tzarc.org> * Update config bootloader jump description Co-authored-by: Nick Brassel <nick@tzarc.org> * Update ChibiOS define reasoning Co-authored-by: Nick Brassel <nick@tzarc.org> * Update quantum/mcu_selection.mk Co-authored-by: Nick Brassel <nick@tzarc.org> * fix git conflict Co-authored-by: Nick Brassel <nick@tzarc.org>
2021-04-26 03:07:15 +00:00
* [STM32L433](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x3.html)
Add L432, L442. (#16016)
2022-01-23 21:49:36 +00:00
* [STM32L442](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x2.html)
Add STM32L433 and L443 support (#12063) * initial L433 commit * change to XC * fix L433 * disable all peripherals * update system and peripheral clocks * 433 change * use its own board files * revert its own board files * l433 specific change * fix stm32l432xx define * remove duplicate #define * fix bootloader jump * move to L443xx and add i2c2, spi2, usart3 to mcuconf.h * move to L443 * move to L443 * fix sdmmc in mcuconf.h * include STM32L443 * add L443 * Include L443 in compatible microcontrollers Co-authored-by: Nick Brassel <nick@tzarc.org> * Include L443 in compatible microcontrollers Co-authored-by: Nick Brassel <nick@tzarc.org> * Update config bootloader jump description Co-authored-by: Nick Brassel <nick@tzarc.org> * Update ChibiOS define reasoning Co-authored-by: Nick Brassel <nick@tzarc.org> * Update quantum/mcu_selection.mk Co-authored-by: Nick Brassel <nick@tzarc.org> * fix git conflict Co-authored-by: Nick Brassel <nick@tzarc.org>
2021-04-26 03:07:15 +00:00
* [STM32L443](https://www.st.com/en/microcontrollers-microprocessors/stm32l4x3.html)
[Docs] Fix Header formatting in compatible mcu doc (#15438)
2021-12-09 03:49:10 +00:00
### WestBerryTech (WB32)
Westberrytech pr (#14422) * Added support for WB32 MCU * Modified eeprom_wb32.c * Remove the eeprom_wb32-related code
2021-11-26 22:28:18 +00:00
* [WB32F3G71xx](http://www.westberrytech.com)
Added support for Wb32fq95 (#16871)
2022-05-23 05:57:24 +00:00
* [WB32FQ95xx](http://www.westberrytech.com)
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
Added MCU support for ArteryTek AT32F415 (#23445)
2024-11-21 06:28:28 +00:00
### Artery (AT32)
* [AT32F415](https://www.arterychip.com/en/product/AT32F415.jsp)
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
### NXP (Kinetis)
* [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)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* PJRC Teensy LC
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
* [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)
* [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)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* PJRC Teensy 3.2
Tentative Teensy 3.5 support (#14420) * Tentative Teensy 3.5 support * Set firmware format to .hex for ARM Teensys * Got to "device descriptor failed" by comparing with Teensy 3.6 code * Drop down to 96MHz... * Bump back up to 120MHz
2022-07-02 14:12:45 +00:00
* [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)
* PJRC Teensy 3.5
Change `MK66F18` -> `MK66FX1M0` (#14659)
2021-09-30 22:14:37 +00:00
* [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)
Add example implementations for compatible MCUs list (#15935) * Add example implementations for compatible MCUs list * Update docs/compatible_microcontrollers.md Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-01-19 09:34:59 +00:00
* PJRC Teensy 3.6
[Doc] Tidy up compatible MCUs docs (#7295) * Tidy up compatible MCUs docs * ARM chips should have USB * 32KB soft lower limit applies to ARM as well * NXP is the manufacturer name, not Kinetis * Units
2019-11-09 02:34:25 +00:00
[Core] Add Raspberry Pi RP2040 support (#14877) * Disable RESET keycode because of naming conflicts * Add Pico SDK as submodule * Add RP2040 build support to QMK * Adjust USB endpoint structs for RP2040 * Add RP2040 bootloader and double-tap reset routine * Add generic and pro micro RP2040 boards * Add RP2040 onekey keyboard * Add WS2812 PIO DMA enabled driver and documentation Supports regular and open-drain output configuration. RP2040 GPIOs are sadly not 5V tolerant, so this is a bit use-less or needs extra hardware or you take the risk to fry your hardware. * Adjust SIO Driver for RP2040 * Adjust I2C Driver for RP2040 * Adjust SPI Driver for RP2040 * Add PIO serial driver and documentation * Add general RP2040 documentation * Apply suggestions from code review Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-06-30 11:19:27 +00:00
### Raspberry Pi
* [RP2040](https://www.raspberrypi.com/documentation/microcontrollers/rp2040.html)
Vitepress conversion of docs. (#23795)
2024-05-30 02:00:41 +00:00
For a detailed overview about the RP2040 support by QMK see the [dedicated RP2040 page](platformdev_rp2040).
[Core] Add Raspberry Pi RP2040 support (#14877) * Disable RESET keycode because of naming conflicts * Add Pico SDK as submodule * Add RP2040 build support to QMK * Adjust USB endpoint structs for RP2040 * Add RP2040 bootloader and double-tap reset routine * Add generic and pro micro RP2040 boards * Add RP2040 onekey keyboard * Add WS2812 PIO DMA enabled driver and documentation Supports regular and open-drain output configuration. RP2040 GPIOs are sadly not 5V tolerant, so this is a bit use-less or needs extra hardware or you take the risk to fry your hardware. * Adjust SIO Driver for RP2040 * Adjust I2C Driver for RP2040 * Adjust SPI Driver for RP2040 * Add PIO serial driver and documentation * Add general RP2040 documentation * Apply suggestions from code review Co-authored-by: Nick Brassel <nick@tzarc.org> Co-authored-by: Nick Brassel <nick@tzarc.org>
2022-06-30 11:19:27 +00:00
[Core] Add support for RISC-V builds and GD32VF103 MCU (#12508) * Add support for RISC-V builds and GD32VF103 MCU * Add toolchain selection in chibios.mk based on the mcu selected in mcu_selection.mk * Reorder and added comments to chibios.mk to have a streamlined makefile * Add GD32VF103 mcu to possible targets for QMK. * Add STM32 compatibility for GD32VF103 MCU, this is hacky but more efficent then rewriting every driver. * Add GigaDevice DFU bootloader as flash target, please note that dfu-util of at least version 0.10 is needed. * Add analog driver compatibility * Add apa102 bitbang driver compatibility * Add ws2812 bitbang driver compatibility * Add eeprom in flash emulation compatibility * Allow faster re-builds with ccache * Add SiPeed Longan Nano to platform files * Add SiPeed Longan Nano Onekeys * Make quine compatible with other bootloaders * Support builds with picolibc * Add risc-v toolchain to arch and debian/ubuntu scripts
2021-10-18 05:23:20 +00:00
## RISC-V
### GigaDevice
[Docs] Fix Header formatting in compatible mcu doc (#15438)
2021-12-09 03:49:10 +00:00
[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.
Reference in New Issue Copy Permalink