Pico 2 W WiFi Scanner with OLED Display

A WiFi network scanner for the Raspberry Pi Pico 2 W that displays results on an OLED screen.

Built on rpi-pico2w-freertos-hwdebug-1. See that project for environment setup, toolchain installation, VSCode debugging, and hardware debugging details.

Hardware Setup

• Raspberry Pi Pico 2 W
• Adafruit FeatherWing OLED 128x32
• Raspberry Pi Debug Probe

Wiring

Function	FeatherWing Pin	Pico 2 W Pin
I2C Data	SDA	GP0 (pin 1)
I2C Clock	SCL	GP1 (pin 2)
Display Reset	RST	GP2 (pin 4)
Prev Button	A	GP20 (pin 26)
Next Button	C	GP22 (pin 29)
Ground	GND	GND (pin 38)
5V Power	Vin	VBUS (pin 40)

Pinout references:

• Pico 2 W Pinout (docs)
• FeatherWing OLED Pinout (docs)

Note: The FeatherWing requires 5V power. Connect Vin to VBUS (USB 5V), not 3V3 OUT.

Build and Flash

just setup    # First time: install SDK, FreeRTOS, OpenOCD, udev rules
just run      # Build and flash

Usage

The display shows WiFi networks sorted by signal strength. Networks auto-cycle every 2 seconds. Use Buttons A and C on the FeatherWing to navigate manually (pauses auto-cycle for 10 seconds).

Command	Description
just run	Build and flash
just flash	Flash only
just rtt-read	View debug output via RTT
just serial-read	View debug output via USB serial

Tools Used

Claude Code was used interactively throughout this project to:

• Explore FreeRTOS project setup and configuration options
• Build and troubleshoot the Nix-based toolchain and justfile commands
• Write and refine documentation
• Write C++ code and debug OLED interaction and i2c bus problems interactively

I was pleasantly suprised with how well Claude Opus 4.5 helped accelerate this project.