2022-01-26 10:40:22 +00:00
# Pimoroni Pico Libraries and Examples <!-- omit in toc -->
2021-01-22 08:08:04 +00:00
2022-01-26 10:40:22 +00:00
Welcome to the brave new world of Pico!
2021-01-22 08:08:04 +00:00
2022-01-31 14:26:48 +00:00
This repository contains the C/C++ and MicroPython libraries for our range of RP2040-based boards, Raspberry Pi Pico addons & [supported Breakout Garden sensors ](#breakouts ).
2021-01-22 08:08:04 +00:00
2023-01-17 11:18:53 +00:00
[![CMake Build Status ](https://img.shields.io/github/actions/workflow/status/pimoroni/pimoroni-pico/cmake.yml?branch=main&label=CMake )](https://github.com/pimoroni/pimoroni-pico/actions/workflows/cmake.yml)
[![MicroPython Build Status ](https://img.shields.io/github/actions/workflow/status/pimoroni/pimoroni-pico/micropython.yml?branch=main&label=MicroPython )](https://github.com/pimoroni/pimoroni-pico/actions/workflows/micropython.yml)
[![MicroPython PicoW Build Status ](https://img.shields.io/github/actions/workflow/status/pimoroni/pimoroni-pico/micropython-picow.yml?branch=main&label=MicroPython%20PicoW )](https://github.com/pimoroni/pimoroni-pico/actions/workflows/micropython-picow.yml)
2022-01-26 10:40:22 +00:00
[![GitHub release (latest by date) ](https://img.shields.io/github/v/release/pimoroni/pimoroni-pico )](https://github.com/pimoroni/pimoroni-pico/releases/latest/)
2021-01-22 08:08:04 +00:00
2022-01-26 10:40:22 +00:00
- [MicroPython ](#micropython )
- [MicroPython Examples ](#micropython-examples )
- [C/C++ ](#cc )
- [C++ Examples ](#c-examples )
- [Boilerplate for C++ Projects ](#boilerplate-for-c-projects )
2022-01-31 14:26:48 +00:00
- [Supported Products ](#supported-products )
2022-10-20 15:11:05 +00:00
- [Packs and Bases ](#packs-and-bases )
- [SHIMs ](#shims )
- [RP2040 Boards ](#rp2040-boards )
- [Pico W Aboard ](#pico-w-aboard )
- [Breakouts ](#breakouts )
2022-11-01 16:53:47 +00:00
- [Kits ](#kits )
- [Tutorials and Guides ](#tutorials-and-guides )
2021-01-22 08:08:04 +00:00
2022-01-26 10:40:22 +00:00
# MicroPython
2021-01-22 08:08:04 +00:00
2022-01-26 10:40:22 +00:00
The easiest way to get started. If you're new to Pico, we recommend you read our [getting started with Pico ](https://learn.pimoroni.com/article/getting-started-with-pico ) tutorial.
2021-01-22 08:08:04 +00:00
2022-01-31 14:29:27 +00:00
:warning: All of our MicroPython libraries are baked into a batteries-included, custom version of MicroPython which you can grab from releases: [https://github.com/pimoroni/pimoroni-pico/releases/latest/ ](https://github.com/pimoroni/pimoroni-pico/releases/latest/ )
2021-01-22 08:08:04 +00:00
2022-01-31 14:26:48 +00:00
New releases are issued regularly with new libraries, bug fixes to our existing libraries and new features inherited from MicroPython upstream. Be sure to check back!
2021-01-22 08:08:04 +00:00
2022-11-01 16:53:47 +00:00
* :link: [Learn: Getting started with Pico ](https://learn.pimoroni.com/article/getting-started-with-pico )
2022-10-20 15:11:05 +00:00
* [Readme: Instructions for installing MicroPython ](setting-up-micropython.md )
* [Readme: Frequently Asked Questions ](faqs-micropython.md )
2022-01-26 10:40:22 +00:00
* [Pimoroni Pico MicroPython + Drivers Releases ](https://github.com/pimoroni/pimoroni-pico/releases )
2022-07-11 14:01:07 +00:00
* [Readme: PicoGraphics ](micropython/modules/picographics )
2022-01-26 10:40:22 +00:00
## MicroPython Examples
You can find MicroPython examples for supported sensors, packs and bases in the "micropython/examples" directory:
2022-01-31 14:26:48 +00:00
* [MicroPython Examples ](micropython/examples )
2022-01-26 10:40:22 +00:00
2024-03-11 15:04:18 +00:00
You can also install MicroPython stubs into Visual Studio Code to give you auto-complete, see:
* [MicroPython Stubs ](https://github.com/pimoroni/pimoroni-pico-stubs )
2022-01-26 10:40:22 +00:00
# C/C++
2022-11-01 16:53:47 +00:00
Advanced users that want to unleash the full power of Pico can use our C++ libraries. If you know what you're doing and want to build your own Pimoroni Pico project then start with the [Pimoroni Pico SDK Boilerplate ](https://github.com/pimoroni/pico-boilerplate ).
2022-01-26 10:40:22 +00:00
2022-11-01 16:53:47 +00:00
* :link: [Learn: Pico C++ Development on Windows ](https://learn.pimoroni.com/article/pico-development-using-wsl )
2022-01-26 10:40:22 +00:00
* [Readme: Instructions for setting up the C/C++ SDK ](setting-up-the-pico-sdk.md )
## C++ Examples
You can find examples for supported sensors, packs and bases in the "examples" directory:
2022-01-31 14:26:48 +00:00
* [C++ Examples ](examples )
2022-01-26 10:40:22 +00:00
## Boilerplate for C++ Projects
We also maintain a C++/CMake boilerplate with GitHub workflows configured for testing and a basic skeleton project.
* [Pimoroni Pico SDK Boilerplate ](https://github.com/pimoroni/pico-boilerplate )
2022-01-31 14:26:48 +00:00
# Supported Products
## Packs and Bases
* Pico Display Pack - https://shop.pimoroni.com/products/pico-display-pack
* Pico Scroll Pack - https://shop.pimoroni.com/products/pico-scroll-pack
* Pico Explorer Base - https://shop.pimoroni.com/products/pico-explorer-base
* Pico RGB Keypad Base - https://shop.pimoroni.com/products/pico-rgb-keypad-base
* Pico Unicorn Pack - https://shop.pimoroni.com/products/pico-unicorn-pack
* Pico Audio Pack (C++ only) - https://shop.pimoroni.com/products/pico-audio-pack
* Pico Wireless Pack - https://shop.pimoroni.com/products/pico-wireless-pack
* Pico Display 2.0 - https://shop.pimoroni.com/products/pico-display-pack-2-0
2022-07-11 13:59:22 +00:00
* Pico Enviro+ Pack - https://shop.pimoroni.com/products/pico-enviro-pack
* Pico Inky Pack - https://shop.pimoroni.com/products/pico-inky-pack
2022-11-09 13:19:53 +00:00
* Pico GFX Pack - https://shop.pimoroni.com/products/pico-gfx-pack
2022-01-31 14:26:48 +00:00
## SHIMs
2022-06-21 10:19:20 +00:00
2022-05-16 14:22:01 +00:00
* LiPo SHIM for Pico - https://shop.pimoroni.com/products/pico-lipo-shim
* Motor SHIM for Pico - https://shop.pimoroni.com/products/motor-shim-for-pico
2022-01-31 14:26:48 +00:00
## RP2040 Boards
2022-02-28 16:41:45 +00:00
* Plasma 2040 (LED strip driver) - https://shop.pimoroni.com/products/plasma-2040
2023-01-18 17:27:35 +00:00
* Interstate 75 (HUB75 matrix driver) - https://shop.pimoroni.com/products/interstate-75
2022-02-28 16:41:45 +00:00
* Badger 2040 (E Ink badge) - https://shop.pimoroni.com/products/badger-2040
2022-06-21 10:19:20 +00:00
* Servo 2040 (18 Channel Servo Controller) - https://shop.pimoroni.com/products/servo-2040
* Motor 2040 (Quad Motor+Encoder Controller) - https://shop.pimoroni.com/products/motor-2040
* Tufty 2040 (LCD badge) - https://shop.pimoroni.com/products/tufty-2040
2022-01-31 14:26:48 +00:00
2022-07-11 13:59:22 +00:00
## Pico W Aboard
* Automation 2040 W (inputs, outputs and relays, 6-40V compatible) - https://shop.pimoroni.com/products/automation-2040-w
* Inventor 2040 W (motors, servos, noise) - https://shop.pimoroni.com/products/inventor-2040-w
2022-07-29 14:48:27 +00:00
* Inky Frame 5.7" (7-colour E Ink) - https://shop.pimoroni.com/products/inky-frame-5-7
2022-11-01 16:53:47 +00:00
* Automation 2040 W Mini (inputs, outputs and a relay, 6-40V compatible) - https://shop.pimoroni.com/products/automation-2040-w-mini
* Plasma Stick 2040 W (bijou LED strip controller) - https://shop.pimoroni.com/products/plasma-stick-2040-w
2023-02-27 15:01:20 +00:00
* Galactic Unicorn (53 x 11 LED matrix) - https://shop.pimoroni.com/products/galactic-unicorn
2023-01-18 17:27:35 +00:00
* Interstate 75 W (HUB75 matrix driver) - https://shop.pimoroni.com/products/interstate-75-w
* Inky Frame 4.0" (7-colour E Ink) - https://shop.pimoroni.com/products/inky-frame-4
2023-02-17 15:56:29 +00:00
* Badger 2040 W (E Ink badge) - https://shop.pimoroni.com/products/badger-2040-w
2023-02-27 15:01:20 +00:00
* Cosmic Unicorn (32 x 32 LED matrix) - https://shop.pimoroni.com/products/cosmic-unicorn
2023-03-13 17:12:29 +00:00
* Inky Frame 7.3" (7-colour E Ink) - https://shop.pimoroni.com/products/inky-frame-7-3
2022-07-11 13:59:22 +00:00
2022-01-31 14:26:48 +00:00
## Breakouts
2022-01-26 10:40:22 +00:00
* AS7262 - 6-channel Spectral Sensor - https://shop.pimoroni.com/products/as7262-6-channel-spectral-sensor-spectrometer-breakout
* MSA301 - 3DoF Motion Sensor - https://shop.pimoroni.com/products/msa301-3dof-motion-sensor-breakout
* MICS6814 - Gas Sensor - https://shop.pimoroni.com/products/mics6814-gas-sensor-breakout
* RGB Potentiometer - https://shop.pimoroni.com/products/rgb-potentiometer-breakout
* RGB Encoder - https://shop.pimoroni.com/products/rgb-encoder-breakout
2023-05-10 15:08:51 +00:00
* RGB Encoder Wheel - https://shop.pimoroni.com/products/rgb-encoder-wheel-breakout
2022-01-26 10:40:22 +00:00
* IO Expander - https://shop.pimoroni.com/products/io-expander
2022-01-31 14:26:48 +00:00
* RV3028 - Real-Time Clock (RTC) - https://shop.pimoroni.com/products/rv3028-real-time-clock-rtc-breakout
2022-01-26 10:40:22 +00:00
* ST7735 - 0.96" LCD - https://shop.pimoroni.com/products/0-96-spi-colour-lcd-160x80-breakout
2022-01-31 14:26:48 +00:00
* IS31FL3730 - dual LTP-305 LED matrices - https://shop.pimoroni.com/products/led-dot-matrix-breakout
2022-01-26 10:40:22 +00:00
* LTR559 - Proximity/Presence/Light Sensor - https://shop.pimoroni.com/products/ltr-559-light-proximity-sensor-breakout
* IS31FL3731 - 11x7 and 5x5 matrix displays
- https://shop.pimoroni.com/products/11x7-led-matrix-breakout
- https://shop.pimoroni.com/products/5x5-rgb-matrix-breakout
2022-01-31 14:26:48 +00:00
* Trackball - https://shop.pimoroni.com/products/trackball-breakout
2022-01-26 10:40:22 +00:00
* SGP30 - Air Quality Sensor - https://shop.pimoroni.com/products/sgp30-air-quality-sensor-breakout
* ST7789 - 1.3" LCD, 1.54" LCD and 1.3" round LCD
- https://shop.pimoroni.com/products/1-3-spi-colour-lcd-240x240-breakout
- https://shop.pimoroni.com/products/1-3-spi-colour-round-lcd-240x240-breakout
- https://shop.pimoroni.com/products/1-54-spi-colour-square-lcd-240x240-breakout
* BME680 - Temperature, Pressure, Humidity & Gas Sensor - https://shop.pimoroni.com/products/bme680-breakout
* BME688 - Temperature, Pressure, Humidity & Gas Sensor - https://shop.pimoroni.com/products/bme688-breakout
* BH1745 - Luminance & Colour Sensor - https://shop.pimoroni.com/products/bh1745-luminance-and-colour-sensor-breakout
* BME280 - Temperature, Pressure & Humidity Sensor - https://shop.pimoroni.com/products/bme280-breakout
* BMP280 - Temperature & Pressure Sensor - https://shop.pimoroni.com/products/bmp280-breakout-temperature-pressure-altitude-sensor
* PWM3901/PAA5100JE - Near Optical Flow Sensor - https://shop.pimoroni.com/products/paa5100je-optical-tracking-spi-breakout
* ICP10125 - High Accuracy Pressure / Altitude / Temperature Sensor - https://shop.pimoroni.com/products/icp10125-air-pressure-breakout
2022-01-31 14:26:48 +00:00
* SCD41 CO2 Sensor (Carbon Dioxide / Temperature / Humidity) - https://shop.pimoroni.com/products/scd41-co2-sensor-breakout
2022-06-21 10:19:20 +00:00
* VL53L5CX 8x8 Time of Flight Array Sensor - https://shop.pimoroni.com/products/vl53l5cx-time-of-flight-tof-sensor-breakout
2023-05-17 13:04:16 +00:00
* RGB Encoder Wheel - https://shop.pimoroni.com/products/rgb-encoder-wheel-breakout
2022-01-26 10:40:22 +00:00
2022-11-01 16:53:47 +00:00
## Kits
2022-01-26 10:40:22 +00:00
2022-11-01 16:53:47 +00:00
* Wireless Plasma Kit (Plasma Stick + LED wire + bottle!) - https://shop.pimoroni.com/products/wireless-plasma-kit
2022-01-26 10:40:22 +00:00
2022-11-01 16:53:47 +00:00
# Tutorials and Guides
- :link: [Getting Started with (MicroPython on) Pico ](https://learn.pimoroni.com/article/getting-started-with-pico )
- :link: [Pico C/C++ Development on Windows / WSL ](https://learn.pimoroni.com/article/pico-development-using-wsl )
2023-02-17 15:56:29 +00:00
- :link: [Getting Started with Interstate 75 (and W) ](https://learn.pimoroni.com/article/getting-started-with-interstate-75 )
2022-01-26 10:40:22 +00:00
- :link: [Getting Started with Plasma 2040 ](https://learn.pimoroni.com/article/plasma-2040 )
2022-01-31 14:26:48 +00:00
- :link: [Assembling Keybow 2040 ](https://learn.pimoroni.com/article/assembling-keybow-2040 )
2022-06-21 10:19:20 +00:00
- :link: [Getting Started with Badger 2040 ](https://learn.pimoroni.com/article/getting-started-with-badger-2040 )
- :link: [MicroPython and VL53L5CX ](https://learn.pimoroni.com/article/micropython-and-vl53l5cx )
- :link: [Getting Started with Tufty 2040 ](https://learn.pimoroni.com/article/getting-started-with-tufty-2040 )
2022-11-01 16:53:47 +00:00
- :link: [Getting Started with Inky Frame ](https://learn.pimoroni.com/article/getting-started-with-inky-frame )
- :link: [Getting Started with Automation 2040 W (and Mini) ](https://learn.pimoroni.com/article/getting-started-with-automation-2040-w )
- :link: [Assembling Wireless Plasma Kit ](https://learn.pimoroni.com/article/assembling-wireless-plasma-kit )
2023-02-17 15:56:29 +00:00
- :link: [Getting Started with Badger 2040 W ](https://learn.pimoroni.com/article/getting-started-with-badger-2040-w )