Ten tutorials · one careful path

Learn PyBLE

Start with the exact firmware for your board, prove the BLE coding loop without hardware, then add files, reviewed source, Blocks, and physical components one boundary at a time.

Beginner progression

Follow the path in order.

Lessons are complete static pages: no sign-in, analytics, remote media, or client-side tutorial fetch is required. Allow about two hours for the full path, plus time for careful wiring reviews.

Beginner · 20 min

Setup

Install the app, provision the right firmware, and connect.

Open tutorial 1

Beginner · 10 min

First program

Create, save, and run a first MicroPython program.

Open tutorial 2

Beginner · 15 min

Files

Manage board files without risking protected agent files.

Open tutorial 3

Beginner · 15 min

GitHub import

Review and import examples from a public GitHub repository.

Open tutorial 4

Beginner · 20 min

Blocks

Build a program visually and inspect the generated Python.

Open tutorial 5

Beginner · 15 min

Examples catalog

Explore all 32 development examples without overstating evidence.

Open tutorial 6

Beginner hardware · 15 min

Hardware safety

Check electrical and profile assumptions before wiring.

Open tutorial 7

Beginner hardware · 30 min

Configured hardware

Configure external GPIO, analog, bus, and pixel hardware.

Open tutorial 8

Beginner hardware · 15 min

Pico 2 W

Use the exact Pico 2 W onboard LED surface.

Open tutorial 9

Beginner hardware · 25 min

Waveshare LCD 1.47B

Draw on the exact B-version display and use its onboard pixel.

Open tutorial 10

Read claims precisely

Compatibility and evidence are separate.

Qualified firmware
A firmware-release state backed by the project's release and hardware gates. Confirm it on the current installer.
Designed for this profile
The lesson or example was authored for that profile. This is not evidence that a physical run passed.
Exact board only
A documented carrier-board surface is required; a matching chip family is not enough.
Development example — physical validation not recorded
Source exists in the reviewed development snapshot, but no HIL record or examples release promotes it.
Not applicable
The lesson intentionally does not target that profile.

Immutable review points

Know what these pages were checked against.

Five firmware profiles

The lessons preserve this order and never infer a carrier pin map from a generic chip profile.

esp32-4mb · esp32-s3-n16r8 · waveshare-esp32-s3-lcd-147b · esp32-c3-4mb · rpi-pico2-w

A step does not match your screen?

Stop before writing or wiring anything else. Record the exact board profile and versions, then use the support and recovery checklist.