La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la Raspberry Pi Pico (todos los registros).
Qué es
La Raspberry Pi Pico, un RP2040 corriendo sobre nuestro propio núcleo Cortex-M en su perfil ARMv6-M. El firmware es un ELF Thumb que habla con las direcciones reales del RP2040, así que la misma imagen corre en hardware real.
El reloj del sistema es de 125 MHz desde el reset, porque el árbol de reloj no está modelado y no hay nada que configurar.
Los pines
El header de 40 pines, en el orden de la placa.
Columna izquierda, pines 1 a 20: GP0, GP1, GND, GP2 a GP5, GNDb, GP6 a GP9, GNDc, GP10 a GP13, GNDd, GP14, GP15.
Columna derecha, pines 40 a 21: VBUS, VSYS, GNDe, 3V3_EN, 3V3, ADC_VREF, GP28, AGND, GP27, GP26, RUN, GP22, GNDf, GP21, GP20, GP19, GP18, GNDg, GP17, GP16.
La serigrafía de la placa marca GND en las siete tierras; aquí llevan letras para que cada nombre sea único. Los puntos de prueba y el header SWD no son pines.
Esta es una placa de 3.3 voltios y sus pines no toleran 5 V. 3V3 entrega 3.3 V, VBUS entrega 5 V y VSYS entrega 4.7 V, que es 5 V a través del diodo Schottky de la propia placa.
GP23, GP24 y GP25 existen en el modelo pero no están en el header, igual que en la placa real. GP25 es el LED integrado, por eso LED_BUILTIN es 25.
What is modeled
GPIO por SIO, el TIMER de 64 bits, UART0, UART1, PWM y el ADC. Cada slice de PWM maneja el canal A en un pin par y el canal B en uno impar, y así es como se puede desvanecer el LED integrado en GP25.
Serial (y Serial1, el mismo puerto) es UART0, que es el monitor serie. Serial2 es UART1, como en arduino-pico, y sus bytes salen por sus pines en lugar del monitor: TX en GP4 y RX en GP5, u otro par de UART1 (GP8 y GP9, GP20 y GP21) elegido con Serial2.setTX() y Serial2.setRX() antes de begin(). Un módulo GPS, un HC-05 o una segunda placa conectada ahí lo escucha bit a bit, a la velocidad en baudios que el divisor realmente produce.
El ADC es el convertidor de doce bits del RP2040. GP26, GP27 y GP28 son A0 a A2, y analogRead() en uno de ellos lee el voltaje de la red contra 3.3 V: diez bits de forma predeterminada, como en arduino-pico, o doce después de analogReadResolution(12). analogReadTemp() lee el sensor de temperatura del chip, que aquí está a 27 C. El convertidor no tiene ruido ni error, y su FIFO, DMA e interrupción no están modelados.
Ese es el conjunto que pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, Serial, Serial2 y attachInterrupt necesitan, en sus direcciones reales.
Lo que no está
Una lista larga, y vale la pena leerla antes de planear un proyecto alrededor de una de ellas: PIO, DMA, SPI, I2C, USB, el RTC, el árbol de relojes, la interfaz de flash QSPI, el segundo núcleo, la ROM del chip y los interpoladores. El watchdog sí está modelado: watchdog_enable() y rp2040.wdt_begin() reinician un sketch que deja de alimentarlos.
Sus bloques de direcciones no están mapeados, así que tocar uno produce un fallo de bus en lugar de un cero silencioso. Eso es deliberado: un programa que lee silenciosamente nada es más difícil de depurar que uno que se detiene.
A Pico SDK program is not built in the editor, but its prebuilt .uf2 or
.elf runs: the Pico boots it through its boot ROM, with the clocks, I2C, SPI,
DMA and USB blocks there as for MicroPython (see
Ejecutar un firmware precompilado), y PIO también funciona ahí. El segundo núcleo detiene ese programa con una oración que lo dice.
SPI.h y Wire.h siguen funcionando, en software sobre pines comunes (abajo), así que los bloques de SPI e I2C que faltan solo importan al código que escribe sus registros. Una Pico con MicroPython o un firmware precompilado es la excepción: arranca como lo hace el silicio, y los bloques de I2C, SPI, DMA y PIO están ahí para
machine.I2C, machine.SPI y rp2.StateMachine (ver MicroPython en la Pico).
Dos aproximaciones también vale la pena conocer. El núcleo se ejecuta en trozos de 1.024 us en lugar de una instrucción a la vez, porque un intérprete de Cortex-M no tiene margen a 125 MHz: las alarmas del temporizador, los flancos de PWM y los bytes de UART caen en su ciclo exacto, pero un cambio de pin hecho por software puede tardar hasta un microsegundo. Y el reloj del sistema siempre es de 125 MHz, sin importar lo que programe un sketch, porque el árbol de relojes no está ahí.
La lista completa, y la clasificación de la sección 8 sobre qué es un número de la hoja de datos y qué es una aproximación, está en el modelo de Raspberry Pi Pico.
Bibliotecas estándar de Arduino
Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h y DHT.h se compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es código de la biblioteca original.
Wire.begin()pone el bus I2C enGP4(SDA) yGP5(SCL).EEPROM.hfunciona, pero el modelo de esta placa no tiene EEPROM ni flash escribible, así que los bytes viven en 4 KB de RAM: se leen dentro de una ejecución y desaparecen al reiniciar.Adafruit_NeoPixel.hmaneja una tira de WS2812. Una Pico real envía los bits desde PIO, que no está modelado, así que aquí el núcleo cronometra cada uno con SysTick, dentro de las ventanas de la hoja de datos, con las interrupciones apagadas durante el frame.
El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.
MicroPython
Una Pico puede ejecutar Python en lugar de un sketch. En el panel Firmware de la placa, elige MicroPython (main.py): los archivos de la placa se convierten en un main.py, y Ejecutar lo inicia. Lo que corre es MicroPython v1.29.0, el firmware oficial para Pico de micropython.org, sobre el RP2040 simulado. Ejecutar copia tus archivos .py a la placa como lo hace Thonny, y luego la placa ejecuta main.py por sí misma. print() va al monitor serie, y el REPL responde ahí cuando main.py termina o lo detienes con Ctrl-C.
machine.Pin, machine.PWM, machine.ADC, machine.UART(1), machine.I2C, machine.SPI, SoftI2C y SoftSPI funcionan, así que bibliotecas como ssd1306.py de micropython-lib hablan con los componentes del lienzo. Un traceback marca la línea de tu archivo, igual que un error de compilación.
PIO también funciona: rp2.PIO y rp2.StateMachine ejecutan sus programas en los bloques PIO simulados, así que el ejemplo de WS2812 de la documentación de MicroPython enciende una tira de NeoPixel. No simulado: el segundo núcleo (_thread detiene la placa con un mensaje), el modo objetivo de I2C y el modo esclavo de SPI. La CPU se queda a 125 MHz sin importar lo que diga machine.freq().
The Pico W runs MicroPython too, with its own build: its CYW43439 radio chip
is modeled, so Pin("LED") lights and network.WLAN joins Mokxi's simulated
network (see la Pico W). Para empezar, ver
MicroPython en la Pico.
CircuitPython
Elige CircuitPython (code.py) en el panel Firmware de la placa y Ejecutar arranca el firmware oficial de CircuitPython 10.3.1 para la Pico. Tu code.py
se guarda en la unidad CIRCUITPY de la placa por USB y se ejecuta, y las bibliotecas de Adafruit que importa entran solas en la carpeta lib/ de la unidad. Ver
CircuitPython en la Pico.
Un programa del Pico SDK
Un programa compilado con el Raspberry Pi Pico SDK corre desde su build: en el panel Firmware de la placa elige Subir firmware (.uf2, .elf) y elige el
.uf2 o .elf de tu carpeta build/ . La Pico lo arranca a través de su boot ROM, como después de copiarlo a la unidad de la placa, y el monitor serie muestra UART0 y el serie USB. PIO funciona; el segundo núcleo no está simulado. Los pasos están en Ejecutar un firmware ya compilado.
Ensamblador
El panel Firmware también ofrece Ensamblador (sin Arduino): un Blink, un botón a LED, un saludo por UART y una interrupción de temporizador en ensamblador ARM Thumb para el Cortex-M0+. Los archivos de la placa se convierten en uno main.S, y no se enlaza nada más que ese archivo, así que lleva su propia tabla de vectores: .word _stack_top, luego
Reset_Handler, y luego sus manejadores. Los ejemplos iniciales sacan IO_BANK0 y
PADS_BANK0 de RESETS, manejan GPIO25 a través de SIO y se cronometran con
TIMERAWL. A .S La pestaña junto a un sketch normal también funciona. La Pico W no tiene ejemplos iniciales, porque su LED está en el chip de radio. Ver
Escribir en ensamblador.
Los ejemplos
Blink, Button, Serial, Fade y Chaser, y los ejemplos de controles de juego: los cuatro pasos del Fight stick, Fight stick, Leverless controller, controlador estilo Mixbox y Stop the light.
En otras partes
- La página de la placa: /boards/pico
- El documento del contrato: el modelo de Raspberry Pi Pico
- La ruta de aprendizaje: Embebidos en la Raspberry Pi Pico, en /learn
- El mismo chip con WiFi: la Pico W
- El mismo chip en placas más pequeñas: la XIAO RP2040, la RP2040-Zero y la Nano RP2040 Connect