kmk_firmware/docs/Officially_Supported_Microcontrollers.md

# Officially supported microcontrollers
While most Circuitpython devices are great for hand wired keyboards, most 
keyboards are designed to accept a Pro Micro. The boards listed below either 
are, or can be adapted to that pinout to use common keyboards already on the market.

## Nice!Nano
Features include
- Pro Micro pinout
- Both USB HID and Bluetooth support
- Can do bluetooth split keyboards with no wires at all
- Has battery support including charging

Downsides
- $25 USD per microcontroller at most retailers

### Pre-compiling KMK for Nice!Nano
Nice!Nano has limited flash memory which does not fit CircuitPython, adafruit-ble, and KMK by default. You will need to use pre-compiled KMK to get it to fit. Grab [compatible mpy-cross](https://adafruit-circuit-python.s3.amazonaws.com/index.html?prefix=bin/mpy-cross/) and run `make compile` to generate `.mpy` version of KMK files before copying them over. 


Common Retailers
[Boardsource](https://boardsource.xyz/store/5f4a1733bbaa5c635b83ed67)
[NiceKeyboards](https://nicekeyboards.com/collections/group-buy/products/nice-nano-v1-0).

## ItsyBitsy M4 Express
Features include
- Affordable at $15 USD
- Can run most features of KMK including RGB

Downsides
- Needs adapted to work with Pro Micro pinout keyboards. Adapter can be found 
[HERE](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)

Common Retailers
[Adafruit](https://www.adafruit.com/product/3800)

## RP2040
Features include
- Very affordable
- Very powerful for the price

Downsides
- Little support for keyboard kits

Common Retailers
[Adafruit](https://www.adafruit.com/pico?src=raspberrypi)
[Sparkfun](https://www.sparkfun.com/products/17829?src=raspberrypi)

## Adafruit ItsyBitsy nRF52840 Express
Features include
- Both USB HID and Bluetooth support
- More affordable than the Nice!Nano at only $18

Downsides
- Needs adapted to work with Pro Micro pinout keyboards. Adapter can be found
[HERE](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)
- No battery support without addon board found 
[HERE](https://www.adafruit.com/product/2124) 

Common Retailers
[Adafruit](https://www.adafruit.com/product/4481)

## Other microcontrollers
What you'll need to have at minimum
- CircuitPython
- 256KB of flash storage
- HID over USB and/or Bluetooth.
feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`# Officially supported microcontrollers`
			`While most Circuitpython devices are great for hand wired keyboards, most`
			`keyboards are designed to accept a Pro Micro. The boards listed below either`
			`are, or can be adapted to that pinout to use common keyboards already on the market.`

			`## Nice!Nano`
			`Features include`
			`- Pro Micro pinout`
			`- Both USB HID and Bluetooth support`
			`- Can do bluetooth split keyboards with no wires at all`
			`- Has battery support including charging`

			`Downsides`
			`- $25 USD per microcontroller at most retailers`

Update Officially_Supported_Microcontrollers.md 2022-04-12 17:33:58 +02:00			`### Pre-compiling KMK for Nice!Nano`
nice!nano compile instructions 2022-04-12 17:33:16 +02:00			Nice!Nano has limited flash memory which does not fit CircuitPython, adafruit-ble, and KMK by default. You will need to use pre-compiled KMK to get it to fit. Grab [compatible mpy-cross](https://adafruit-circuit-python.s3.amazonaws.com/index.html?prefix=bin/mpy-cross/) and run `make compile` to generate `.mpy` version of KMK files before copying them over.


docs and typos 2021-06-25 19:53:58 +02:00			`Common Retailers`
feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`[Boardsource](https://boardsource.xyz/store/5f4a1733bbaa5c635b83ed67)`
			`[NiceKeyboards](https://nicekeyboards.com/collections/group-buy/products/nice-nano-v1-0).`

			`## ItsyBitsy M4 Express`
			`Features include`
			`- Affordable at $15 USD`
			`- Can run most features of KMK including RGB`

			`Downsides`
			`- Needs adapted to work with Pro Micro pinout keyboards. Adapter can be found`
			`[HERE](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)`

docs and typos 2021-06-25 19:53:58 +02:00			`Common Retailers`
feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`[Adafruit](https://www.adafruit.com/product/3800)`

docs and typos 2021-06-25 19:53:58 +02:00			`## RP2040`
			`Features include`
			`- Very affordable`
			`- Very powerful for the price`

			`Downsides`
			`- Little support for keyboard kits`

			`Common Retailers`
			`[Adafruit](https://www.adafruit.com/pico?src=raspberrypi)`
			`[Sparkfun](https://www.sparkfun.com/products/17829?src=raspberrypi)`

feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`## Adafruit ItsyBitsy nRF52840 Express`
			`Features include`
			`- Both USB HID and Bluetooth support`
			`- More affordable than the Nice!Nano at only $18`

			`Downsides`
			`- Needs adapted to work with Pro Micro pinout keyboards. Adapter can be found`
			`[HERE](https://github.com/KMKfw/kmk_firmware/tree/master/hardware)`
			`- No battery support without addon board found`
			`[HERE](https://www.adafruit.com/product/2124)`

docs and typos 2021-06-25 19:53:58 +02:00			`Common Retailers`
			`[Adafruit](https://www.adafruit.com/product/4481)`

feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`## Other microcontrollers`
			`What you'll need to have at minimum`
Remove KMKpython reference 2022-02-27 20:05:11 +01:00			`- CircuitPython`
feat(extensions): most of the extensions implementation, by kdb424 2020-10-21 21:19:42 +02:00			`- 256KB of flash storage`
			`- HID over USB and/or Bluetooth.`