wokwi-pi-pico Reference
Raspberry Pi Pico, an RP2040 microcontroller board with dual-core ARM Cortex-M0+ processor, 264k of internal RAM, and flexible Programmable I/O (PIO) feature.
Pin names
Pins GP0 to GP22 are digital GPIO pins. Pins GP26, GP27, and GP28 are digital GPIO pins with analog input function.
Name | Description | Analog input channel |
---|---|---|
GP0 … GP22 | Digital GPIO pins (0 to 22) | |
GP26 | Digital GPIO pin 26 | 0 |
GP27 | Digital GPIO pin 27 | 1 |
GP28 | Digital GPIO pin 28 | 2 |
GND.1 … GND.8 | Ground pins * | |
VSYS, VBUS, 3V3 | Positive power supply | |
TP4 † | Digital GPIO pin 23 | |
TP5 † | Digital GPIO pin 25 + LED |
* The physical pin numbers of the ground pins are 3, 8, 13, 18, 23, 28, 33, and 38.
† These pins do not appear in the visual diagram editor, but you can use them in your diagram.json file.
Pins 3V3_EN / RUN / ADC_VREF are not available in the simulation and are therefore omitted from the table.
Onboard LED
The Raspberry Pi Pico has an onboard LED, attached to GPIO PIN 25. The LED is lit when the pin is driven high.
You can also use the LED_BUILTIN
constant to reference the LED in your Arduino code:
pinMode(LED_BUILTIN, OUTPUT);
digitalWrite(LED_BUILTIN, HIGH);
See Blink for a complete code example.
Simulation features
The Raspberry Pi Pico is simulated using the RP2040js Library.
This table summarizes the status of the simulation features:
Peripheral | Status | Notes |
---|---|---|
Processor core | ✔️ | Only a single core is simulated |
GPIO | ✔️ | |
PIO | ✔️ | PIO Debugger available |
USB | 🟡 | USB CDC (Serial) supported, see Serial Monitor below |
UART | ✔️ | |
I2C | ✔️ | Master mode only |
SPI | ✔️ | Master mode only |
PWM | ✔️ | |
DMA | ✔️ | Only for the PIO peripheral |
Timer | ✔️ | Pausing the timer not implemented yet |
ARM SysTick Timer | ✔️ | |
Watchdog | ✔️ | |
RTC | ✔️ | |
ADC + Temp sensor | ✔️ | Temperature sensor always reads 0 |
SSI | 🟡 | Just the minimum to make the bootloader happy |
GDB Debugging | ✔️ | See the GDB Debugging guide |
Legend:
✔️ Simulated
🟡 Partial implementation/work in progress
❌ Not implemented
Arduino core
The Arduino core provides the built-in Arduino functions, such as pinMode()
and digitalRead()
, as well as a set of standard Arduino libraries, such as Servo, Wire and SPI.
When compiling your code for the Raspberry Pi Pico and for the Raspberry Pi Pico W, Wokwi uses the Arduino-Pico core, built on top of the Pi Pico SDK.
In the past, Wokwi also supported the RP2040-mbed Arduino core, but it has been deprecated in favor of the Arduino-Pico core.
Serial Monitor
You can use the Serial Monitor to receive information from the code running on the Pi Pico, such as debug prints. By default, the Serial Monitor communicates with the Pi Pico over USB.
Setting up the USB connection can take some time, and any messages printed during
the USB setup time will be lost. Therefore, it's recommended to tell setup()
to wait for the Serial Monitor connection before printing anything:
void setup() {
Serial.begin(115200);
while (!Serial) {
delay(10); // wait for serial port to connect. Needed for native USB
}
// Now you can safely print message:
Serial.println("Hello, Serial Monitor!");
}
Serial Monitor over UART
The Serial Monitor can also communicate with the Pi Pico over the physical UART interface. To configure the UART communication between the Raspberry Pi Pico and the Serial Monitor, add the following connections to your diagram.json file:
"connections": [
[ "$serialMonitor:RX", "pico:GP0", "", [] ],
[ "$serialMonitor:TX", "pico:GP1", "", [] ],
…
]
The example assumes that the Pi Pico was defined with an id of "pico", e.g.
"parts": [
{
"type": "wokwi-pi-pico",
"id": "pico",
…
},
…
]
The use the Serial1
object in your code: initialize the port using Serial1.begin(115200)
, and then print messages with Serial1.println()
. For example:
void setup() {
Serial1.begin(115200);
Serial1.println("Hello, world!");
}
void loop() { }
For a complete example, check out the Pi Pico Serial Monitor over UART Example.