Merge pull request #878 from fabaff/usb-c

Various updates

Author: tannewt

_blinka/adafruit_feather_rp2040.md

@@ -9,52 +9,52 @@ board_image: "adafruit_feather_rp2040.jpg"
 download_instructions: "https://learn.adafruit.com/circuitpython-libraries-on-any-computer-with-raspberry-pi-pico"
 date_added: 2021-12-6
 features:
+  - USB-C
   - Feather-Compatible
   - STEMMA QT/QWIIC
 ---
 
-A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the **RP2040**, and all niceties you know and love about Feather
-* Measures 2.0" x 0.9" x 0.28" (50.8mm x 22.8mm x 7mm) without headers soldered in
+A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the **RP2040**, and all niceties you know and love about Feather.
+
+## Technical details
+
+* Measures 2.0" x 0.9" x 0.28" (50.8 mm x 22.8 mm x 7 mm) without headers soldered in
 * Light as a (large?) feather - 5 grams
-* RP2040 32-bit Cortex M0+ dual core running at ~125 MHz @ 3.3V logic and power
+* RP2040 32-bit Cortex M0+ dual core running at ~125 MHz @ 3.3 V logic and power
 * 264 KB RAM
 * **8 MB SPI FLASH** chip for storing files and CircuitPython/MicroPython code storage. No EEPROM
-* **Tons of GPIO! 21 x GPIO pins with following capabilities:**
+* **21 GPIO pins with following capabilities:**
   * **Four** 12 bit ADCs (one more than Pico)
   * Two I2C, Two SPI and two UART peripherals, we label one for the 'main' interface in standard Feather locations
-  * 16 x PWM outputs - for servos, LEDs, etc
+  * 16 PWM outputs - for servos, LEDs, etc
   * The 8 digital 'non-ADC/non-peripheral' GPIO are consecutive for maximum PIO compatibility
-* **Built in 200mA lipoly charger** with charging status indicator LED
+* **Built in 200 mA lipoly charger** with charging status indicator LED
 * **Pin #13 red LED** for general purpose blinking
 * **RGB NeoPixel** with power pin on GPIO so you can depower it for low power usages.
 * On-board **STEMMA QT connector** that lets you quickly connect any Qwiic, STEMMA QT or Grove I2C devices with no soldering!
 * **Both Reset button and Bootloader select button for quick restarts (no unplugging-replugging to relaunch code)**
-* 3.3V Power/enable pin
+* 3.3 V Power/enable pin
 * [Optional SWD debug port can be soldered in for debug access](https://www.adafruit.com/product/752)
 * 4 mounting holes
 * 24 MHz crystal for perfect timing.
-* 3.3V regulator with 500mA peak current output
-* **USB Type C connector** lets you access built-in ROM USB bootloader and serial port debugging
-
+* 3.3 V regulator with 500 mA peak current output
+* **USB-C connector** lets you access built-in ROM USB bootloader and serial port debugging
 
 **Inside the RP2040 is a 'permanent ROM' USB UF2 bootloader.** What that means is when you want to program new firmware, you can hold down the BOOTSEL button while plugging it into USB (or pulling down the RUN/Reset pin to ground) and it will appear as a USB disk drive you can drag the firmware onto. Folks who have been using Adafruit products will find this very familiar - we use the technique on all our native-USB boards. Just note you don't double-click reset, instead hold down BOOTSEL during boot to enter the bootloader!
 
-
 The RP2040 is a powerful chip, which has the clock speed of our M4 (SAMD51), and two cores that are equivalent to our M0 (SAMD1). Since it is an M0 chip, it does not have a floating point unit, or DSP hardware support - so if you're doing something with heavy floating-point math, it will be done in software and thus not as fast as an M4. For many other computational tasks, you'll get close-to-M4 speeds!
 
-
 For peripherals, there are two I2C controllers, two SPI controllers, and two UARTs that are multiplexed across the GPIO - check the pinout for what pins can be set to which. There are 16 PWM channels, each pin has a channel it can be set to (ditto on the pinout).
 
-
 You'll note there's no I2S peripheral, or SDIO, or camera, what's up with that? Well instead of having specific hardware support for serial-data-like peripherals like these, the RP2040 comes with the PIO state machine system which is a unique and powerful way to create custom hardware logic and data processing blocks that run on their own without taking up a CPU. For example, NeoPixels - often we bitbang the timing-specific protocol for these LEDs. For the RP2040, we instead use PIO object that reads in the data buffer and clocks out the right bitstream with perfect accuracy. Same with I2S audio in or out, LED matrix displays, 8-bit or SPI based TFTs, even VGA! In MicroPython and CircuitPython you can create PIO control commands to script the peripheral and load it in at runtime. There are 2 PIO peripherals with 4 state machines each.
 
 **At the time of launch, there is no Arduino core support for this board. There is great [C/C++ support](https://github.com/raspberrypi/pico-sdk), an official [MicroPython port](https://github.com/raspberrypi/micropython), and a [CircuitPython port](/downloads)!** We of course [recommend CircuitPython because we think it's the easiest way to get started](https://learn.adafruit.com/welcome-to-circuitpython) and it has support with most of our drivers, displays, sensors, and more, supported out of the box so you can follow along with our CircuitPython projects and tutorials.
 
-While the RP2040 has lots of onboard RAM (264KB), it does not have built-in FLASH memory. Instead, that is provided by the external QSPI flash chip. **On this board there is 8 MB**, which is shared between the program it's running and any file storage used by MicroPython or CircuitPython. When using C/C++ you get the whole flash memory, if using Python you will have about 7 MB remaining for code, files, images, fonts, etc.
+While the RP2040 has lots of onboard RAM (264 KB), it does not have built-in FLASH memory. Instead, that is provided by the external QSPI flash chip. **On this board there is 8 MB**, which is shared between the program it's running and any file storage used by MicroPython or CircuitPython. When using C/C++ you get the whole flash memory, if using Python you will have about 7 MB remaining for code, files, images, fonts, etc.
 
 **RP2040 Chip features:**
-* Dual ARM Cortex-M0+ @ 133MHz
-* 264kB on-chip SRAM in six independent banks
+* Dual ARM Cortex-M0+ @ 133 MHz
+* 264 kB on-chip SRAM in six independent banks
 * Support for up to 16MB of off-chip Flash memory via dedicated QSPI bus
 * DMA controller
 * Fully-connected AHB crossbar

_blinka/adafruit_itsybitsy_rp2040.md

@@ -12,27 +12,29 @@ features:
 
 ---
 
-A new chip means a new ItsyBitsy, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the ItsyBitsy teensy-weensy Treatment" and so we did! This Itsy' features the RP2040, [and all niceties you know and love about the ItsyBitsy family](https://www.adafruit.com/category/1008)
+A new chip means a new ItsyBitsy, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the ItsyBitsy teensy-weensy Treatment" and so we did! This Itsy' features the RP2040, and all niceties you know and love about the [ItsyBitsy family](https://www.adafruit.com/category/1008).
 
-What's smaller than a Feather but larger than a Trinket? It's an Adafruit ItsyBitsy RP2040 featuring the Raspberry Pi RP2040! Small, powerful, with a ultra fast duel Cortex M0+ processor running at 125 MHz - this microcontroller board is perfect when you want something very compact, with lots of horsepower and a bunch of pins. This Itsy has sports car speed, but SUV roominess with 4 MB of FLASH and 264KB of SRAM.
+What's smaller than a Feather but larger than a Trinket? It's an Adafruit ItsyBitsy RP2040 featuring the Raspberry Pi RP2040! Small, powerful, with a ultra fast duel Cortex M0+ processor running at 125 MHz - this microcontroller board is perfect when you want something very compact, with lots of horsepower and a bunch of pins. This Itsy has sports car speed, but SUV roominess with 4 MB of FLASH and 264 KB of SRAM.
 
 ItsyBitsy RP2040 is only 1.4" long by 0.7" wide, but has 6 power pins, 23 digital GPIO pins (4 of which can be analog in and 16 x PWM out). It's the same chip as the [Feather RP2040](https://www.adafruit.com/products/4884) and [Raspberry Pi Pico](https://www.adafruit.com/products/4883) *but really really small*. So it's great once you've finished up a prototype, and want to make the project much smaller. It even comes with 4MB of SPI Flash built in, for data logging, file storage, or CircuitPython/MicroPython code
 
-- [Same size and form-factor as the rest of the ItsyBitsy family](https://www.adafruit.com/category/1008) and nearly-identical pinout
-- Measures 1.4" x 0.7" x 0.2" (36mm x 18mm x 4mm) without headers soldered in
+## Technical details
+
+- Same size and form-factor as the rest of the [ItsyBitsy family](https://www.adafruit.com/category/1008) and nearly-identical pinout
+- Measures 1.4" x 0.7" x 0.2" (36 mm x 18 mm x 4 mm) without headers soldered in
 - RP2040 32-bit Cortex M0+ dual core running at ~125 MHz @ 3.3V logic and power
 - 264 KB RAM
 - **4 MB SPI FLASH** chip for storing files and CircuitPython/MicroPython code storage. No EEPROM
-- Tons of GPIO! 23 x GPIO pins with following capabilities:
-  - **Four** 12 bit ADCs (one more than Pico)
-  - Two I2C, Two SPI and two UART peripherals, we label one for the 'main' interface in standard ItsyBitsy locations
-  - 16 x PWM outputs - for servos, LEDs, etc
+- 23 GPIO pins with following capabilities:
+  - 4 12-bit ADCs (one more than Pico)
+  - 2 I2C, 2 SPI and 2 UART peripherals, we label one for the 'main' interface in standard ItsyBitsy locations
+  - 16 PWM outputs - for servos, LEDs, etc
   - The 10 digital 'non-ADC/non-peripheral' GPIO are consecutive for maximum PIO compatibility
 - **Pin #13 red LED** for general purpose blinking
 - **RGB NeoPixel** with power pin on GPIO so you can depower it for low power usages.
 - **Both Reset button and Bootloader select button for quick restarts (no unplugging-replugging to relaunch code)**
-- 3.3V regulator with 500mA peak current output
-- 3.3V Power/enable pin
+- 3.3 V regulator with 500mA peak current output
+- 3.3 V Power/enable pin
 - Power with either USB or external output (such as a battery) - it'll automatically switch over
 - Broken-out SWD pins for debug access
 - 24 MHz crystal for perfect timing.

_blinka/adafruit_macropad_rp2040.md

@@ -24,7 +24,7 @@ Want to add more hardware? No worries - [a STEMMA QT port on the side lets you c
 
  **Please note, the RP2040 chip does not currently have QMK support** - this macropad is designed to be programmed in Arduino or CircuitPython! If QMK eventually does add RP2040 as a supported chipset (no ETA and no plans that we know of), we'll update this page.
 
- TL;DR?
+## Technical details
 
 - **Raspberry Pi RP2040 Chip + 8MB Flash memory** - Dual core Cortex M0+ at ~130MHz with 264KB or RAM. Runs CircuitPython, Arduino or MicroPython with ease and lots of space for development code and files
 - **USB C Connector for Power/Data** - of course this can act as an HID device but also can be MIDI, UART, etc.

_blinka/adafruit_qt2040_trinkey.md

@@ -9,6 +9,7 @@ board_image: "adafruit_qt2040_trinkey.jpg"
 download_instructions: "https://learn.adafruit.com/circuitpython-libraries-on-any-computer-with-raspberry-pi-pico"
 date_added: 2021-12-6
 features:
+  - STEMMA QT/QWIIC
 
 ---
 
@@ -20,6 +21,21 @@ With the body of the board being 1.0" x 0.7" and four mounting holes, you can at
 
 The board comes with 8 MB of QSPI flash memory so you can put *all* of our CircuitPython drivers on the disk!
 
+## Technical details
+
+* Main body is same size/mounting holes as most of our Stemma QT boards (1.0" x 0.7" with M2.5 holes)
+* USB Type A connector with extra-thick PCB to fit into a USB host port
+* RP2040 32-bit Cortex M0+ dual-core running at ~125 MHz @ 3.3 V logic and power
+* 264 KB RAM
+* 8 MB SPI FLASH chip for storing files and CircuitPython/MicroPython code storage. No EEPROM
+* Native USB supported by every OS - can be used as USB serial console, MIDI, Keyboard/Mouse HID, even a little disk drive for storing Python scripts.
+* Built-in RGB NeoPixel LED
+* STEMMA QT/Qwiic port for I2C connectivity
+* 3.3 V regulator with 600 mA peak output
+* 12 MHz crystal
+* Both Reset button and Bootloader select buttons for quick restarts (no unplugging-replugging to relaunch code)
+* Bootloader button can also be safely used in 'user' code
+
 ## Purchase
 
 * [Adafruit](https://www.adafruit.com/product/5056)

_blinka/adafruit_qtpy_rp2040.md

@@ -10,6 +10,7 @@ download_instructions: "https://learn.adafruit.com/circuitpython-libraries-on-an
 date_added: 2021-12-6
 features:
   - STEMMA QT/QWIIC
+  - USB-C
 ---
 
 What a cutie pie! Or is it... a QT Py? This diminutive dev board comes with one of our new favorite chip, the RP2040. It's been made famous in the new [Raspberry Pi Pico](https://www.adafruit.com/pico) *and* our [Feather RP2040](http://www.adafruit.com/product/4884) and [ItsyBitsy RP2040](http://www.adafruit.com/product/4888), but what if we wanted something really *smol?*
@@ -24,13 +25,13 @@ Use any [SparkFun Qwiic](http://www.sparkfun.com/qwiic) boards! [Seeed Grove I2C
 
 **At the time of launch, there is no Arduino core support for the chip on this board. There is great [C/C++ support](https://github.com/raspberrypi/pico-sdk), an official [MicroPython port](https://github.com/raspberrypi/micropython), and a [CircuitPython port](https://circuitpython.org/downloads)!** We of course [recommend CircuitPython because we think it's the easiest way to get started](https://learn.adafruit.com/welcome-to-circuitpython) and it has support with most of our drivers, displays, sensors, and more, supported out of the box so you can follow along with our CircuitPython projects and tutorials.
 
-Pinout and shape is [Seeed Xiao](https://wiki.seeedstudio.com/Seeeduino-XIAO/) compatible, with castellated pads so you can solder it to a PCB with a cut out to allow the bottom components some breathing room. In addition to the QT connector, we also added an **RGB NeoPixel** (with a controllable power pin to allow for ultra-low-power usage), **and both boot-mode and reset buttons** (great for restarting your program or entering the bootloader). This QT Py comes with loose 0.1" headers you can solder in for breadboard use
+Pinout and shape is [Seeed Xiao](https://wiki.seeedstudio.com/Seeeduino-XIAO/) compatible, with castellated pads so you can solder it to a PCB with a cut out to allow the bottom components some breathing room. In addition to the QT connector, we also added an **RGB NeoPixel** (with a controllable power pin to allow for ultra-low-power usage), **and both boot-mode and reset buttons** (great for restarting your program or entering the bootloader). This QT Py comes with loose 0.1" headers you can solder in for breadboard use.
 
-While the RP2040 has lots of onboard RAM (264KB), it does not have built-in FLASH memory. Instead, that is provided by the external QSPI flash chip. On this board there is 4MB, which is shared between the program it's running and any file storage used by MicroPython or CircuitPython. When using C/C++ you get the whole flash memory, if using Python you will have about 3 MB remaining for code, files, images, fonts, etc.
+While the RP2040 has lots of onboard RAM (264 KB), it does not have built-in FLASH memory. Instead, that is provided by the external QSPI flash chip. On this board there is 4MB, which is shared between the program it's running and any file storage used by MicroPython or CircuitPython. When using C/C++ you get the whole flash memory, if using Python you will have about 3 MB remaining for code, files, images, fonts, etc.
 
 - Same size, form-factor, and pin-out as [our SAMD-based QT Py](https://www.adafruit.com/product/4600)
-- **USB Type C connector** - [If you have only Micro B cables, this adapter will come in handy](https://www.adafruit.com/product/4299)!
-- **RP2040 32-bit Cortex M0+** dual-core running at ~125 MHz @ 3.3V logic and power
+- **USB-C connector** - [If you have only Micro B cables, this adapter will come in handy](https://www.adafruit.com/product/4299)!
+- **RP2040 32-bit Cortex M0+** dual-core running at ~125 MHz @ 3.3 V logic and power
 - 264 KB RAM
 - **8 MB SPI FLASH** chip for storing files and CircuitPython/MicroPython code storage. No EEPROM
 - Native USB supported by every OS - can be used in Arduino or CircuitPython as USB serial console, MIDI, Keyboard/Mouse HID, even a little disk drive for storing Python scripts.
@@ -42,7 +43,7 @@ While the RP2040 has lots of onboard RAM (264KB), it does not have built-in FLAS
   - SPI and UART peripherals, in standard QT Py locations,
   - PWM outputs on every IO pin - for servos, LEDs, etc
   - There are 6 GPIO in consecutive order for PIO compatibility
-- 3.3V regulator with [**600mA peak output**](https://www.diodes.com/assets/Datasheets/AP2112.pdf)
+- 3.3 V regulator with [**600 mA peak output**](https://www.diodes.com/assets/Datasheets/AP2112.pdf)
 - **Both Reset button and Bootloader select buttons** for quick restarts (no unplugging-replugging to relaunch code)
 - **Really really small**
 

_blinka/google_coral.md

@@ -20,24 +20,27 @@ features:
 
 A development board to quickly prototype on-device ML products. Scale from prototype to production with a removable system-on-module (SOM).
 
-Edge TPU Module
-- CPU	NXP i.MX 8M SOC (quad Cortex-A53, Cortex-M4F)
-- GPU	Integrated GC7000 Lite Graphics
-- ML accelerator	Google Edge TPU coprocessor
-- RAM	1 GB LPDDR4
-- Flash memory	8 GB eMMC
-- Wireless	Wi-Fi 2x2 MIMO (802.11b/g/n/ac 2.4/5GHz) Bluetooth 4.1
-- Dimensions	48mm x 40mm x 5mm
+### Edge TPU Module
 
-Baseboard
-- Flash memory	MicroSD slot
-- USB	Type-C OTG Type-C power Type-A 3.0 host Micro-B serial console
-- LAN	Gigabit Ethernet port
-- Audio	3.5mm audio jack (CTIA compliant) Digital PDM microphone (x2) 2.54mm 4-pin terminal for stereo speakers
-- Video	HDMI 2.0a (full size) 39-pin FFC connector for MIPI-DSI display (4-lane) 24-pin FFC connector for MIPI-CSI2 camera (4-lane)
-- GPIO	3.3V power rail 40 - 255 ohms programmable impedance ~82 mA max current
-- Power	5V DC (USB Type-C)
-- Dimensions	88 mm x 60 mm x 24mm
+- CPU: NXP i.MX 8M SOC (quad Cortex-A53, Cortex-M4F)
+- GPU: Integrated GC7000 Lite Graphics
+- ML accelerator: Google Edge TPU coprocessor
+- RAM: 1 GB LPDDR4
+- Flash memory: 8 GB eMMC
+- Wireless: Wi-Fi 2x2 MIMO (802.11b/g/n/ac 2.4/5 GHz) Bluetooth 4.1
+- Dimensions: 48 mm x 40 mm x 5 mm
+
+### Baseboard
+
+- Flash memory MicroSD slot
+- USB: USB-C OTG, USB-C power, Type-A 3.0 host,  Micro-B serial console
+- LAN: Gigabit Ethernet port
+- Audio: 3.5 mm audio jack (CTIA compliant) Digital PDM microphone (x2) 2.54 mm 4-pin terminal for stereo speakers
+- Video: HDMI 2.0a (full size) 39-pin FFC connector for MIPI-DSI display (4-lane) 24-pin FFC connector for MIPI-CSI2 camera (4-lane)
+- GPIO: 3.3 V power rail 40 - 255 ohm programmable impedance ~82 mA max current
+- Power: 5 V DC (USB-C)
+- Dimensions:	88 mm x 60 mm x 24mm
 
 ## Purchase
+
 * [Google](https://coral.withgoogle.com/products/dev-board)

_blinka/orange_pi_zero2.md

@@ -22,22 +22,22 @@ Orange Pi Zero2 is for anyone who wants to start creating with technology – no
 - Allwinner H616 64-bit high-performance Quad-core Cortex-A53 processor
 - Mali G31 MP2
 - Supports OpenGL ES 1.0/2.0/3.2, OpenCL 2.0
-- 512MB/1GB DDR3 (Shared with GPU)
+- 512 MB/1 GB DDR3 (Shared with GPU)
 - TF card slot
-- 2MB SPI Flash
+- 2 MB SPI Flash
 - Support 1000M/100M/10M Ethernet
 - Onboard Wifi + Bluetooth
 - AW859A Chip
 - Support IEEE 802.11 a/b/g/n/ac
 - Support BT5.0
-- Type-C interface 5V2A input
+- USB-C interface 5 V/2 A input
 - 3*USB 2.0 HOST (Two of them are via 13pin interface board)
 - UART-TX, UART-RX and GND
 - Power Button(SW602)
 - 26pin header with I2C, SPI, UART and multiple GPIO ports
 - 13pin header with 2*USB Host, IR pin, Tv-out, AUDIO (no MIC) and 3 GPIO ports
 - Power led & Status led
-- Android4.4, Lubuntu, Debian, Armbian Image
+- Android 4.4, Lubuntu, Debian, Armbian Image
 
 ## Purchase
 * [Amazon](https://www.amazon.com/dp/B08M9MWZCQ)