Placas

A Raspberry Pi Pico

Um RP2040 no nosso núcleo Cortex-M0+: um núcleo, GPIO do SIO, o TIMER, UART0, PWM e o ADC.

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 em GP4 (SDA) e GP5 (SCL).
  • EEPROM.h funciona, 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.h controla 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