A visão geral, com exemplos rodando, está na página da placa e O modelo da Raspberry Pi Pico (todos os registradores).
O que é
A Raspberry Pi Pico, um RP2040 rodando no nosso próprio núcleo Cortex-M no perfil ARMv6-M. O firmware é um ELF Thumb conversando com os endereços reais do RP2040, então a mesma imagem roda em hardware real.
O clock do sistema é 125 MHz desde o reset, porque a árvore de clock não é modelada e não há nada para subir.
Os pinos
O cabeçalho de 40 pinos, na ordem em que a placa o tem.
Coluna esquerda, pinos 1 a 20: GP0, GP1, GND, GP2 a GP5, GNDb, GP6 a GP9, GNDc, GP10 a GP13, GNDd, GP14, GP15.
Coluna direita, pinos 40 até 21: VBUS, VSYS, GNDe, 3V3_EN, 3V3, ADC_VREF, GP28, AGND, GP27, GP26, RUN, GP22, GNDf, GP21, GP20, GP19, GP18, GNDg, GP17, GP16.
A serigrafia da placa marca GND nos sete terras; aqui eles levam letras para que cada nome seja único. Os pontos de teste e o cabeçalho SWD não são pinos.
Esta é uma placa de 3,3 volts e seus pinos não toleram 5 V. O 3V3 fornece 3,3 V, o VBUS fornece 5 V e o VSYS fornece 4,7 V, que é 5 V através do próprio diodo Schottky da placa.
Os GP23, GP24 e GP25 existem no modelo mas não estão no cabeçalho, como na placa real. O GP25 é o LED da placa, e é por isso que LED_BUILTIN é 25.
What is modeled
GPIO do SIO, o TIMER de 64 bits, UART0, UART1, PWM e o ADC. Cada fatia de PWM aciona o canal A num pino par e o canal B num ímpar, e é por isso que o LED da placa no GP25 pode ter fade.
Serial (e Serial1, a mesma porta) é a UART0, que é o monitor serial. Serial2 é a UART1, como no arduino-pico, e seus bytes vão para os pinos em vez do monitor: TX no GP4 e RX no GP5, ou outro par de UART1 (GP8 e GP9, GP20 e GP21) escolhido com Serial2.setTX() e Serial2.setRX() antes de begin(). Um módulo GPS, um HC-05 ou uma segunda placa ligada ali ouve tudo bit a bit, na taxa de baud que o divisor realmente fornece.
O ADC é o conversor de doze bits do RP2040. GP26, GP27 e GP28 são A0 a A2, e analogRead() em um deles lê a tensão no nó em relação a 3,3 V: dez bits por padrão, como no arduino-pico, ou doze após analogReadResolution(12). analogReadTemp() lê o sensor de temperatura do chip, que aqui fica a 27 C. O conversor não tem ruído nem erro, e sua FIFO, DMA e interrupção não são modelados.
Esse é o conjunto de que pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, Serial, Serial2 e attachInterrupt precisam, em seus endereços reais.
O que não é
Uma lista longa, e vale a pena ler antes de planejar um projeto em torno de um deles: PIO, DMA, SPI, I2C, USB, o RTC, a árvore de clock, a interface de flash QSPI, o segundo núcleo, a ROM do chip e os interpoladores. O watchdog é modelado: watchdog_enable() e rp2040.wdt_begin() reiniciam um sketch que para de alimentá-los.
Os blocos de endereço deles não estão mapeados, então tocá-los causa uma falha de barramento em vez de um zero silencioso. Isso é de propósito: um programa que lê silenciosamente nada é mais difícil de depurar do que um que para.
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
Rodar um firmware pré-compilado), e o PIO também funciona lá. O segundo núcleo interrompe tal programa com uma frase dizendo isso.
SPI.h e Wire.h continuam funcionando, em software em pinos comuns (abaixo), então os blocos de SPI e I2C ausentes só importam para código que escreve em seus registradores. Um Pico rodando MicroPython ou um firmware pré-compilado é a exceção: ele inicializa como o silício faz, e os blocos de I2C, SPI, DMA e PIO estão lá para
machine.I2C, machine.SPI e rp2.StateMachine (veja MicroPython no Pico).
Duas aproximações valem a pena conhecer também. O núcleo roda em blocos de 1,024 us em vez de uma instrução por vez, porque um interpretador de Cortex-M não tem folga a 125 MHz: alarmes de timer, bordas de PWM e bytes de UART caem no ciclo exato, mas uma mudança de pino feita por software pode atrasar até um microssegundo. E o clock do sistema é sempre 125 MHz, seja lá o que o sketch programar, porque a árvore de clock não existe no modelo.
A lista completa, e a separação da seção 8 entre o que é número do data sheet e o que é aproximação, está em o modelo do Raspberry Pi Pico.
Bibliotecas do Arduino
Um tutorial que inclua Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h com Adafruit_SSD1306.h e DHT.h compila aqui como está. Cada uma é um cabeçalho próprio do Mokxi sob o nome upstream, escrito sobre os drivers dos componentes da caixa de componentes, e nada disso é o código da biblioteca upstream.
Wire.begin()coloca o barramento I2C emGP4(SDA) eGP5(SCL).EEPROM.hfunciona, mas o modelo desta placa não tem EEPROM nem flash gravável, então os bytes vivem em 4 KB de RAM: eles são lidos de volta dentro de uma execução e somem num reset.Adafruit_NeoPixel.hcontrola uma fita WS2812. Um Pico real envia os bits pelo PIO, que não é modelado, então aqui o núcleo cronometra cada um no SysTick, dentro das janelas do data sheet, com interrupções desligadas pelo quadro.
O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.
MicroPython
Um Pico pode rodar Python em vez de um sketch. No painel Firmware da placa, escolha MicroPython (main.py): os arquivos da placa viram um main.py, e Rodar o inicia. O que roda é MicroPython v1.29.0, o firmware oficial do Pico de micropython.org, no RP2040 simulado. Rodar copia seus arquivos .py para a placa como o Thonny faz, e então a placa roda o main.py por conta própria. print() vai para o Monitor Serial, e o REPL responde lá quando o main.py termina ou quando você o interrompe com Ctrl-C.
machine.Pin, machine.PWM, machine.ADC, machine.UART(1), machine.I2C, machine.SPI, SoftI2C e SoftSPI funcionam, então bibliotecas como a ssd1306.py da micropython-lib conversam com os componentes no canvas. Um traceback marca a linha no seu arquivo, como um erro de compilação faz.
O PIO também funciona: rp2.PIO e rp2.StateMachine rodam seus programas nos blocos PIO simulados, então o exemplo de WS2812 da documentação do MicroPython acende uma fita de NeoPixel. Não simulado: o segundo núcleo (_thread para a placa com uma mensagem), o modo target de I2C e o modo slave de SPI. A CPU fica a 125 MHz seja lá o que machine.freq() disser.
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 o Pico W). Para começar, veja
MicroPython no Pico.
CircuitPython
Escolha CircuitPython (code.py) no painel Firmware da placa em vez disso, e Rodar inicializa o firmware oficial do CircuitPython 10.3.1 para o Pico. Seu code.py
é salvo na unidade CIRCUITPY da placa via USB e roda, e as bibliotecas da Adafruit que ele importa vão sozinhas para a pasta lib/ da unidade. Veja
CircuitPython no Pico.
Um programa do Pico SDK
Um programa compilado com o Raspberry Pi Pico SDK roda a partir da sua compilação: no painel Firmware da placa, escolha Enviar firmware (.uf2, .elf) e escolha o
.uf2 ou .elf da sua pasta build/ . O Pico o inicializa pela sua boot ROM, como após copiá-lo para a unidade da placa, e o Monitor Serial mostra tanto a UART0 quanto a serial USB. O PIO funciona; o segundo núcleo não é simulado. Os passos estão em Rodar um firmware pronto.
Assembly
O painel Firmware também oferece Assembly (sem Arduino): um Blink, um Botão para LED, um UART hello e uma interrupção de Timer em assembly ARM Thumb para o Cortex-M0+. Os arquivos da placa viram um main.S, e nada além desse arquivo é linkado, então ele carrega sua própria tabela de vetores: .word _stack_top, depois
Reset_Handler, e depois seus handlers. Os projetos iniciais tiram IO_BANK0 e
PADS_BANK0 de RESETS, controlam o GPIO25 pelo SIO e se cronometram em
TIMERAWL. A .S a aba ao lado de um sketch comum também funciona. O Pico W não tem projetos iniciais, porque seu LED fica no chip de rádio. Veja
Escrevendo em assembly.
Os exemplos
Blink, Button, Serial, Fade e Chaser, e os exemplos de controle de jogo: as quatro etapas do Fight stick, Fight stick, Leverless controller, controle estilo Mixbox e Stop the light.
Em outros lugares
- A página da placa: /boards/pico
- O documento do contrato: o modelo do Raspberry Pi Pico
- A trilha de aprendizado: Embarcados no Raspberry Pi Pico, em /learn
- O mesmo chip com WiFi: o Pico W
- O mesmo chip em placas menores: o XIAO RP2040, o RP2040-Zero e o Nano RP2040 Connect