Board

Raspberry Pi Pico

RP2040 pada core Cortex-M0+ kita: satu core, SIO GPIO, TIMER, UART0, PWM dan ADC.

Tinjauannya, dengan contoh yang berjalan, ada di halaman board dan Model Raspberry Pi Pico (semua register).

Apa ini

Raspberry Pi Pico, RP2040 yang berjalan pada core Cortex-M buatan sendiri dalam profil ARMv6-M. Firmware adalah ELF Thumb yang berbicara ke alamat RP2040 asli, jadi image yang sama bisa jalan di hardware asli.

Clock sistem 125 MHz sejak reset, karena clock tree tidak dimodelkan dan tidak ada yang perlu disiapkan.

Pin-pin-nya

Header 40 pin, dalam urutan yang dimiliki board.

Kolom kiri, pin 1 sampai 20: GP0, GP1, GND, GP2 sampai GP5, GNDb, GP6 sampai GP9, GNDc, GP10 sampai GP13, GNDd, GP14, GP15.

Kolom kanan, pin 40 turun ke 21: VBUS, VSYS, GNDe, 3V3_EN, 3V3, ADC_VREF, GP28, AGND, GP27, GP26, RUN, GP22, GNDf, GP21, GP20, GP19, GP18, GNDg, GP17, GP16.

Silkscreen board menuliskan GND pada ketujuh ground; di sini masing-masing diberi huruf agar setiap nama unik. Test point dan header SWD bukan pin.

Ini adalah board 3.3 volt dan pin-pinnya tidak toleran terhadap 5 V. 3V3 menyuplai 3,3 V, VBUS menyuplai 5 V dan VSYS menyuplai 4,7 V, yaitu 5 V yang melewati dioda Schottky milik board sendiri.

GP23, GP24 dan GP25 ada di model tapi tidak di header, seperti pada board asli. GP25 adalah LED on-board, itulah kenapa LED_BUILTIN bernilai 25.

What is modeled

SIO GPIO, TIMER 64 bit, UART0, UART1, PWM dan ADC. Setiap slice PWM menggerakkan channel A di pin genap dan channel B di pin ganjil, itulah cara LED on-board di GP25 bisa di-fade.

Serial (dan Serial1, port yang sama) adalah UART0, yaitu serial monitor. Serial2 adalah UART1, seperti di arduino-pico, dan byte-nya keluar lewat pin-nya, bukan lewat monitor: TX di GP4 dan RX di GP5, atau pasangan UART1 lain (GP8 dan GP9, GP20 dan GP21) yang dipilih dengan Serial2.setTX() dan Serial2.setRX() sebelum begin(). Modul GPS, HC-05, atau board kedua yang terhubung di sana mendengarnya bit demi bit, pada baud rate yang benar-benar diberikan pembaginya.

ADC adalah konverter dua belas bit milik RP2040. GP26, GP27 dan GP28 adalah A0 sampai A2, dan analogRead() pada salah satunya membaca tegangan di net terhadap 3,3 V: sepuluh bit secara bawaan, seperti di arduino-pico, atau dua belas bit setelah analogReadResolution(12). analogReadTemp() membaca sensor suhu di chip, yang di sini berada di 27 C. Konverter ini tidak punya noise maupun error, dan FIFO, DMA serta interupsinya tidak dimodelkan.

Itu adalah set yang dibutuhkan pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, Serial, Serial2 dan attachInterrupt, di alamat aslinya.

Yang tidak

Daftar panjang, dan sebaiknya kamu baca sebelum merencanakan proyek di sekitar salah satunya: PIO, DMA, SPI, I2C, USB, RTC, clock tree, antarmuka QSPI flash, core kedua, ROM di chip, dan interpolator. Watchdog dimodelkan: watchdog_enable() dan rp2040.wdt_begin() me-reboot sketch yang berhenti memberi makan mereka.

Blok alamat mereka tidak dipetakan, jadi menyentuh salah satunya menyebabkan bus fault, bukan nol yang diam-diam. Itu disengaja: program yang diam-diam tidak membaca apa pun lebih sulit di-debug daripada program yang berhenti.

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 Menjalankan firmware yang sudah jadi), dan begitu juga PIO di sana. Core kedua menghentikan program seperti itu dengan sebuah kalimat yang mengatakannya.

SPI.h dan Wire.h tetap bekerja, dalam software pada pin biasa (di bawah), jadi hilangnya blok SPI dan I2C hanya berpengaruh pada kode yang menulis register mereka. Pico yang menjalankan MicroPython atau firmware yang sudah jadi adalah pengecualian: ia boot seperti layaknya silicon, dan blok I2C, SPI, DMA dan PIO ada di sana untuk machine.I2C, machine.SPI dan rp2.StateMachine (lihat MicroPython di Pico).

Ada dua pendekatan yang perlu kamu tahu. Core berjalan dalam potongan 1.024 us bukan satu instruksi pada satu waktu, karena interpreter Cortex-M tidak punya ruang sisa pada 125 MHz: alarm timer, tepi PWM dan byte UART mendarat tepat pada siklusnya, tapi perubahan pin oleh software bisa telat sampai satu mikrodetik. Dan clock sistem selalu 125 MHz, apa pun yang diprogram sketch, karena clock tree-nya tidak ada.

Daftar lengkapnya, beserta pengelompokan di bagian 8 mana yang angka data sheet dan mana yang pendekatan, ada di model Raspberry Pi Pico.

Library Arduino bawaan

Tutorial yang memuat Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h dengan Adafruit_SSD1306.h dan DHT.h dikompilasi di sini apa adanya. Masing-masing adalah header buatan Mokxi sendiri dengan nama upstream, ditulis di atas driver untuk komponen di kotak komponen, dan tidak ada satu pun kode dari library upstream.

  • Wire.begin() menaruh bus I2C di GP4 (SDA) dan GP5 (SCL).
  • EEPROM.h bekerja, tapi model board ini tidak punya EEPROM atau flash yang bisa ditulis, jadi byte-nya tinggal di RAM sebesar 4 KB: byte itu terbaca kembali selama satu Run dan hilang saat reset.
  • Adafruit_NeoPixel.h menggerakkan strip WS2812. Pico sungguhan mengirim bit dari PIO, yang tidak dimodelkan, jadi di sini core mengatur waktu tiap bit di SysTick, di dalam jendela data sheet, dengan interupsi mati selama satu frame.

Editor kode dan kompilasi mencantumkan apa yang dicakup masing-masing dan bagaimana bedanya dengan library upstream.

MicroPython

Pico bisa menjalankan Python alih-alih sketch. Di panel Firmware board, pilih MicroPython (main.py): file board berubah menjadi main.py, dan Jalankan memulainya. Yang berjalan adalah MicroPython v1.29.0, firmware Pico resmi dari micropython.org, di atas RP2040 yang disimulasikan. Jalankan menyalin file .py milikmu ke board seperti cara Thonny, lalu board menjalankan main.py sendiri. print() menuju Serial Monitor, dan REPL menjawab di sana begitu main.py selesai atau kamu menghentikannya dengan Ctrl-C.

machine.Pin, machine.PWM, machine.ADC, machine.UART(1), machine.I2C, machine.SPI, SoftI2C dan SoftSPI bekerja, jadi driver seperti ssd1306.py dari micropython-lib bisa bicara dengan komponen di kanvas. Traceback menandai baris di file-mu, seperti halnya error kompilasi.

PIO juga bekerja: rp2.PIO dan rp2.StateMachine menjalankan programnya di blok PIO yang disimulasikan, jadi contoh WS2812 dari dokumentasi MicroPython menyalakan strip NeoPixel. Tidak disimulasikan: core kedua (_thread menghentikan board dengan pesan), mode target I2C dan mode slave SPI. CPU tetap di 125 MHz apa pun kata 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 Pico W). Untuk mulai, lihat MicroPython di Pico.

CircuitPython

Pilih CircuitPython (code.py) di panel Firmware board sebagai gantinya dan Jalankan mem-boot firmware CircuitPython 10.3.1 resmi untuk Pico. File code.py milikmu disimpan ke drive CIRCUITPY board lewat USB dan dijalankan, dan library Adafruit yang diimpornya masuk sendiri ke lib/ folder di drive. Lihat CircuitPython di Pico.

Program Pico SDK

Program yang dibangun dengan Raspberry Pi Pico SDK berjalan dari build-nya: di panel Firmware board pilih Unggah firmware (.uf2, .elf) dan pilih .uf2 atau .elf dari build/ folder-mu. Pico mem-boot-nya lewat boot ROM-nya, seperti setelah menyalinnya ke drive board, dan Serial Monitor menampilkan UART0 dan USB serial sekaligus. PIO bekerja; core kedua tidak disimulasikan. Langkahnya ada di Menjalankan firmware yang sudah jadi.

Assembly

Panel Firmware juga menawarkan Assembly (tanpa Arduino): sebuah Blink, tombol ke LED, hello lewat UART dan interupsi Timer dalam assembly ARM Thumb untuk Cortex-M0+. File board menjadi satu main.S, dan tidak ada selain file itu yang di-link, jadi ia membawa vector table sendiri: .word _stack_top, lalu Reset_Handler, lalu handler-nya. Starter menggunakan IO_BANK0 dan PADS_BANK0 dari RESETS, menggerakkan GPIO25 lewat SIO dan mengatur waktu di TIMERAWL. A .S tab di samping sketch biasa juga bekerja. Pico W tidak punya starter, karena LED-nya ada di chip radio. Lihat Menulis assembly.

Contoh-contoh

Blink, Button, Serial, Fade dan Chaser, serta contoh game controller: empat langkah Fight stick, Fight stick, Leverless controller, Mixbox-style controller dan Stop the light.

Di tempat lain