All paths

CircuitPython on the Pico

Python on real hardware, from your first code.py: LEDs and buttons, knobs and PWM, NeoPixels, I2C sensors and an OLED with displayio, all on Adafruit’s official firmware, ending in a mood light you design.

Raspberry Pi PicoFree7 lessons5 h4 chapters1,675 XPEmbedded engineering · Beginner+100 XP

0 of 7 done

What you will build

3 projects, built step by step

7 lessons in 4 chapters, about 5 hours on a simulated Raspberry Pi Pico. Free, in your browser, every step checked by the simulator.

Chapter 1 project

digitalio

Pins that are on or off: an LED as an output, a button as an input with a pull-up, blinking without sleep() so the button is never missed, and counting presses.

Open it in the simulator
Chapter 2 project

NeoPixels

Eight color LEDs on one wire: colors as (red, green, blue) tuples, fill and single pixels, show() to send them all, brightness, and a chase in your own color.

Open it in the simulator
Chapter 3 project

displayio basics

Text on a 128 x 64 OLED with displayio: a display, a Group of Labels, the built-in terminal font, scale, and a counter that redraws itself when its text changes.

Open it in the simulator
The map

Chapter by chapter

Each lesson opens when the one before it is done, and each chapter ends in a project.

Chapter 1

First steps

code.py, and pins that are on or off.

  1. Open175 XP

    code.py

    Your first CircuitPython program: print, a variable, a loop, and what happens when code.py ends. How the CIRCUITPY drive and auto-reload make every save a new run.

    0 of 6 steps

  2. ProjectLocked350 XP

    digitalio

    Pins that are on or off: an LED as an output, a button as an input with a pull-up, blinking without sleep() so the button is never missed, and counting presses.

    0 of 6 steps

4 questions, graded as you go.
Chapter 2

Knobs and light

Analog readings, PWM and NeoPixels.

  1. Locked150 XP

    analogio and pwmio

    Between on and off: read a knob as a number from 0 to 65535 with analogio, turn it into volts, and dim an LED with pwmio by switching it on and off a thousand times a second.

    0 of 5 steps

  2. ProjectLocked300 XP

    NeoPixels

    Eight color LEDs on one wire: colors as (red, green, blue) tuples, fill and single pixels, show() to send them all, brightness, and a chase in your own color.

    0 of 5 steps

4 questions, graded as you go.
Chapter 3

Sense and show

An I2C sensor and a screen.

  1. Locked175 XP

    I2C sensors

    Two wires, many chips: scan the I2C bus for addresses, read temperature, humidity and pressure from a BME280 with Adafruit’s library, and turn Celsius into Fahrenheit.

    0 of 6 steps

  2. ProjectLocked300 XP

    displayio basics

    Text on a 128 x 64 OLED with displayio: a display, a Group of Labels, the built-in terminal font, scale, and a counter that redraws itself when its text changes.

    0 of 5 steps

4 questions, graded as you go.
Chapter 4

Project

A mood light built from the whole course.

  1. Locked225 XP

    Project: a mood light

    Everything together: a knob picks the color, a button steps through glow, breathe, rainbow and off, the BME280 turns it warm red when the room is hot, and the OLED says what it is doing.

    0 of 8 steps

3 questions, graded as you go.
Syllabus

Every lesson in the course

All 7 lessons, in order, each with what it covers. Any of them opens in the editor right away.

Chapter 1

First steps

  1. code.pyYour first CircuitPython program: print, a variable, a loop, and what happens when code.py ends. How the CIRCUITPY drive and auto-reload make every save a new run.
  2. digitalioPins that are on or off: an LED as an output, a button as an input with a pull-up, blinking without sleep() so the button is never missed, and counting presses.
Chapter 2

Knobs and light

  1. analogio and pwmioBetween on and off: read a knob as a number from 0 to 65535 with analogio, turn it into volts, and dim an LED with pwmio by switching it on and off a thousand times a second.
  2. NeoPixelsEight color LEDs on one wire: colors as (red, green, blue) tuples, fill and single pixels, show() to send them all, brightness, and a chase in your own color.
Chapter 3

Sense and show

  1. I2C sensorsTwo wires, many chips: scan the I2C bus for addresses, read temperature, humidity and pressure from a BME280 with Adafruit’s library, and turn Celsius into Fahrenheit.
  2. displayio basicsText on a 128 x 64 OLED with displayio: a display, a Group of Labels, the built-in terminal font, scale, and a counter that redraws itself when its text changes.
Chapter 4

Project

  1. Project: a mood lightEverything together: a knob picks the color, a button steps through glow, breathe, rainbow and off, the BME280 turns it warm red when the room is hot, and the OLED says what it is doing.
Kits

Build it on your bench too

Every lesson runs in the simulator with nothing to buy. When you want the real thing, these kits have the parts.

Have a kit already?

Find your kit

Pick the starter kit you own and run every lesson in its manual with the same parts on the same pins.

See every kit
Questions

About CircuitPython on the Pico

Is CircuitPython on the Pico free?

Yes. All 7 lessons of CircuitPython on the Pico are free and run in your browser, with nothing to install and no parts to buy before you start.

Do I need a real Raspberry Pi Pico?

No. Every lesson runs on a simulated Raspberry Pi Pico with its parts on the canvas, and the simulator checks each step as you go. When you want to build it for real, the same wiring and code work on a real board.

How long does CircuitPython on the Pico take?

About 5 hours: 7 lessons in 4 chapters, each one a few short steps. Your progress is kept, so you can stop after any lesson and pick up where you left off.

What will I build?

Each chapter ends in a project that puts it together: digitalio, NeoPixels and displayio basics.

Where do I start?

With "code.py", and each lesson builds on the one before it. New to circuits? Electronics basics is the course that starts from zero.