Source: https://mokxi.com/learn/path/circuitpython-from-zero
Updated: 2026-11-20

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 Pico Free 7 lessons 5 h 4 chapters 1,675 XP Embedded engineering · Beginner +100 XP

0 of 7 done

Start the course free code.py Lesson plan for teachers

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.

Open 175 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

Start What is in it

Project Locked 350 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.

Locked 150 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

Project Locked 300 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.

Locked 175 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

Project Locked 300 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.

Locked 225 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

- 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.
- 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.

Chapter 2

### Knobs and light

- 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.
- 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.

Chapter 3

### Sense and show

- 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.
- 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.

Chapter 4

### Project

- 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.

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.
