Pimoroni Pico Libraries and Examples

Welcome to the brave new world of Pico!

This repository contains the C/C++ and MicroPython libraries for our range of RP2040-based boards, Raspberry Pi Pico addons & supported Breakout Garden sensors.

• MicroPython
  • MicroPython Examples
• C/C++
  • C++ Examples
  • Boilerplate for C++ Projects
• Supported Products
  • Packs and Bases
  • SHIMs
  • RP2040 Boards
  • Pico W Aboard
  • Breakouts
• Tutorials and Guides

MicroPython

⚠️ This repository contains MicroPython builds for RP2040 based products only. If you're looking for RP2350 compatible MicroPython builds see here: https://github.com/pimoroni/pimoroni-pico-rp2350 . Many of our own RP2040 and RP2350 products now have their own repos with MicroPython firmware and examples - these will be linked on the relevant shop pages.

We think MicroPython is the easiest way to get started! If you're new to Pico, we recommend you read our getting started with Pico tutorial.

We supply a batteries-included, custom version of MicroPython which you can grab from releases: https://github.com/pimoroni/pimoroni-pico/releases/latest/. This contains built-in drivers for working with our displays, breakouts and other hardware.

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!

• 🔗 Learn: Getting started with Pico
• Readme: Instructions for installing MicroPython
• Readme: Frequently Asked Questions
• Pimoroni Pico MicroPython + Drivers Releases
• Readme: PicoGraphics

MicroPython Examples

You can find MicroPython examples for supported sensors, packs and bases in the "micropython/examples" directory:

• MicroPython Examples

You can also install MicroPython stubs into Visual Studio Code to give you auto-complete, see:

• MicroPython Stubs

C/C++

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.

• 🔗 Learn: Pico C++ Development on Windows
• Readme: Instructions for setting up the C/C++ SDK

C++ Examples

You can find examples for supported sensors, packs and bases in the "examples" directory:

• C++ Examples

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

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
• Pico Enviro+ Pack - https://shop.pimoroni.com/products/pico-enviro-pack
• Pico Inky Pack - https://shop.pimoroni.com/products/pico-inky-pack
• Pico GFX Pack - https://shop.pimoroni.com/products/pico-gfx-pack
• Pico Display 2.8" - https://shop.pimoroni.com/products/pico-display-pack-2-8

SHIMs

• 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

RP2040 Boards

• 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

Pico W Aboard

• Automation 2040 W (inputs, outputs and relays, 6-40V compatible) - https://shop.pimoroni.com/products/automation-2040-w
• Automation 2040 W Mini (inputs, outputs and a relay, 6-40V compatible) - https://shop.pimoroni.com/products/automation-2040-w-mini

Breakouts

• 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
• RGB Encoder Wheel - https://shop.pimoroni.com/products/rgb-encoder-wheel-breakout
• IO Expander - https://shop.pimoroni.com/products/io-expander
• RV3028 - Real-Time Clock (RTC) - https://shop.pimoroni.com/products/rv3028-real-time-clock-rtc-breakout
• ST7735 - 0.96" LCD - https://shop.pimoroni.com/products/0-96-spi-colour-lcd-160x80-breakout
• IS31FL3730 - dual LTP-305 LED matrices - https://shop.pimoroni.com/products/led-dot-matrix-breakout
• 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
• Trackball - https://shop.pimoroni.com/products/trackball-breakout
• 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
• SCD41 CO2 Sensor (Carbon Dioxide / Temperature / Humidity) - https://shop.pimoroni.com/products/scd41-co2-sensor-breakout
• VL53L5CX 8x8 Time of Flight Array Sensor - https://shop.pimoroni.com/products/vl53l5cx-time-of-flight-tof-sensor-breakout
• RGB Encoder Wheel - https://shop.pimoroni.com/products/rgb-encoder-wheel-breakout
• AS7343 14-Channel Multi-Spectral Sensor Breakout - https://shop.pimoroni.com/products/as7343-breakout
• BME690 - Temperature, Pressure, Humidity & Gas Sensor - https://shop.pimoroni.com/products/bme690-breakout

Tutorials and Guides

• 🔗 Getting Started with (MicroPython on) Pico
• 🔗 Pico C/C++ Development on Windows / WSL
• 🔗 Getting Started with Interstate 75 (and W)
• 🔗 Getting Started with Plasma 2040
• 🔗 Assembling Keybow 2040
• 🔗 Getting Started with Badger 2040
• 🔗 MicroPython and VL53L5CX
• 🔗 Getting Started with Tufty 2040
• 🔗 Getting Started with Inky Frame
• 🔗 Getting Started with Automation 2040 W (and Mini)
• 🔗 Assembling Wireless Plasma Kit
• 🔗 Getting Started with Badger 2040 W