Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch và Mô hình Raspberry Pi Pico (mọi thanh ghi).
Đây là gì
Raspberry Pi Pico, một RP2040 chạy trên core Cortex-M của chính chúng tôi theo cấu hình ARMv6-M. Firmware là một Thumb ELF giao tiếp với các địa chỉ RP2040 thật, nên cùng một tệp chạy được trên phần cứng thật.
Xung nhịp hệ thống là 125 MHz ngay từ lúc reset, vì cây xung nhịp không được mô phỏng nên không có gì cần khởi tạo.
Các chân
Header 40 chân, theo thứ tự trên bo mạch.
Cột trái, chân 1 đến 20: GP0, GP1, GND, GP2 đến GP5, GNDb, GP6 đến GP9, GNDc, GP10 đến GP13, GNDd, GP14, GP15.
Cột phải, các chân từ 40 đến 21: VBUS, VSYS, GNDe, 3V3_EN, 3V3, ADC_VREF, GP28, AGND, GP27, GP26, RUN, GP22, GNDf, GP21, GP20, GP19, GP18, GNDg, GP17, GP16.
Trên bo mạch thật, cả bảy chân đất đều in GND; ở đây chúng mang chữ cái để mỗi tên là duy nhất. Các điểm đo và header SWD không phải là chân.
Đây là bo mạch 3.3 volt và các chân của nó không chịu được 5 V. 3V3 cấp 3.3 V, VBUS cấp 5 V và VSYS cấp 4.7 V, tức 5 V đi qua diode Schottky ngay trên bo mạch.
GP23, GP24 và GP25 có trong mô hình nhưng không nằm trên header, như bo mạch thật. GP25 là LED trên bo, đó là lý do LED_BUILTIN bằng 25.
What is modeled
SIO GPIO, TIMER 64 bit, UART0, UART1, PWM và ADC. Mỗi slice PWM điều khiển kênh A trên một chân chẵn và kênh B trên một chân lẻ, nhờ vậy LED trên bo mạch ở chân GP25 mới có thể điều chỉnh được độ sáng.
Serial (và Serial1, cùng một cổng) là UART0, tức là serial monitor. Serial2 là UART1, như trong arduino-pico, và các byte của nó đi ra trên các chân chứ không phải trên monitor: TX trên GP4 và RX trên GP5, hoặc một cặp UART1 khác (GP8 và GP9, GP20 và GP21) được chọn bằng Serial2.setTX() và Serial2.setRX() trước begin(). Một module GPS, một HC-05 hay một bo mạch thứ hai nối ở đó sẽ nhận được từng bit một, tại tốc độ baud mà bộ chia thực sự tạo ra.
ADC là bộ chuyển đổi mười hai bit của RP2040. GP26, GP27 và GP28 là A0 đến A2, và analogRead() trên một trong số chúng đọc điện áp trên đường nối so với 3.3 V: mười bit theo mặc định, như trong arduino-pico, hoặc mười hai bit sau analogReadResolution(12). analogReadTemp() đọc cảm biến nhiệt trên chip, vốn ở 27 C ở đây. Bộ chuyển đổi không có nhiễu và không có sai số, còn FIFO, DMA và ngắt của nó không được mô phỏng.
Đó là bộ hàm mà pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, Serial, Serial2 và attachInterrupt cần, ở địa chỉ thật của chúng.
Những gì không có
Danh sách dài, và đáng đọc trước khi bạn lên kế hoạch cho một dự án xung quanh một trong số chúng: PIO, DMA, SPI, I2C, USB, RTC, cây đồng hồ, giao diện QSPI flash, lõi thứ hai, ROM trên chip và các bộ nội suy. Watchdog được mô phỏng: watchdog_enable() và rp2040.wdt_begin() sẽ khởi động lại sketch khi nó ngừng cấp tín hiệu giữ cho chúng hoạt động.
Các khối địa chỉ của chúng không được ánh xạ, nên chạm vào một khối gây lỗi bus thay vì im lặng trả về số không. Điều đó là chủ ý: một chương trình lặng lẽ không đọc được gì thì khó gỡ lỗi hơn một chương trình dừng lại.
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
Chạy firmware có sẵn), và PIO cũng chạy ở đó. Lõi thứ hai dừng một chương trình như vậy kèm một câu thông báo như vậy.
SPI.h và Wire.h vẫn hoạt động, bằng phần mềm trên các chân thường (phía dưới), nên việc thiếu các khối SPI và I2C chỉ ảnh hưởng đến code ghi trực tiếp vào thanh ghi của chúng. Một Pico chạy MicroPython hay firmware có sẵn là ngoại lệ: nó khởi động như silicon thật, và các khối I2C, SPI, DMA và PIO có mặt cho
machine.I2C, machine.SPI và rp2.StateMachine (xem MicroPython trên Pico).
Hai xấp xỉ cũng đáng để biết. Lõi chạy theo các đoạn 1.024 us thay vì từng lệnh một, vì một trình thông dịch Cortex-M không đủ sức xử lý ở 125 MHz: báo động bộ đếm thời gian, các sườn PWM và các byte UART rơi đúng chu kỳ của chúng, nhưng một thay đổi chân do phần mềm tạo ra có thể trễ đến một microgiây. Và đồng hồ hệ thống luôn là 125 MHz, dù sketch lập trình thế nào, vì cây đồng hồ không được mô phỏng.
Danh sách đầy đủ, và cách phân loại ở mục 8 giữa số liệu trong datasheet và số xấp xỉ, nằm trong mô hình Raspberry Pi Pico.
Thư viện Arduino có sẵn
Một bài hướng dẫn có dùng Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h cùng Adafruit_SSD1306.h và DHT.h sẽ biên dịch được nguyên vẹn ở đây. Mỗi cái là header riêng của Mokxi dưới tên thượng nguồn, viết trên các driver cho linh kiện trong hộp, và không dùng mã của thư viện thượng nguồn.
Wire.begin()đưa bus I2C lênGP4(SDA) vàGP5(SCL).EEPROM.hhoạt động, nhưng mô hình của bo mạch này không có EEPROM hay flash ghi được, nên các byte nằm trong 4 KB RAM: chúng đọc lại được trong một lần Chạy và biến mất khi reset.Adafruit_NeoPixel.hđiều khiển dải WS2812. Pico thật gửi các bit từ PIO, vốn không được mô phỏng, nên ở đây lõi định thời từng bit trên SysTick, nằm trong các khoảng thời gian quy định của data sheet, với ngắt bị tắt trong suốt khung.
Trình soạn code và biên dịch liệt kê mỗi thư viện hỗ trợ những gì và khác gì so với thư viện thượng nguồn.
MicroPython
Pico có thể chạy Python thay cho sketch. Trong bảng firmware của bo mạch, chọn MicroPython (main.py): các tệp của bo mạch trở thành một main.py, và Chạy sẽ khởi động nó. Thứ chạy là MicroPython v1.29.0, firmware Pico chính thức từ micropython.org, trên RP2040 được mô phỏng. Chạy sao chép các tệp .py của bạn lên bo mạch theo cách Thonny thực hiện, rồi bo mạch tự chạy main.py. print() hiển thị trên Serial Monitor, và REPL trả lời ở đó khi main.py kết thúc hoặc khi bạn dừng nó bằng Ctrl-C.
machine.Pin, machine.PWM, machine.ADC, machine.UART(1), machine.I2C, machine.SPI, SoftI2C và SoftSPI hoạt động, nên các driver như ssd1306.py của micropython-lib giao tiếp với linh kiện trên khung vẽ. Một traceback đánh dấu dòng trong tệp của bạn, giống như lỗi biên dịch.
PIO cũng hoạt động: rp2.PIO và rp2.StateMachine chạy chương trình của chúng trên các khối PIO được mô phỏng, nên ví dụ WS2812 trong tài liệu MicroPython thắp sáng dải NeoPixel. Không được mô phỏng: lõi thứ hai (_thread dừng bo mạch kèm thông báo), chế độ I2C target và chế độ SPI slave. CPU giữ nguyên 125 MHz bất kể machine.freq() nói gì.
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). Để bắt đầu, xem
MicroPython trên Pico.
CircuitPython
Chọn CircuitPython (code.py) trong bảng firmware của bo mạch thay vào đó, và Chạy sẽ khởi động firmware CircuitPython 10.3.1 chính thức cho Pico. Tệp của bạn code.py
được lưu lên ổ CIRCUITPY của bo mạch qua USB và chạy, còn các thư viện Adafruit mà nó import sẽ vào lib/ của ổ. Xem
CircuitPython trên Pico.
Một chương trình Pico SDK
Một chương trình được build bằng Raspberry Pi Pico SDK chạy từ bản build của nó: trong bảng firmware của bo mạch, chọn Nạp firmware (.uf2, .elf) và chọn
.uf2 hoặc .elf từ thư mục build/ thư mục. Pico khởi động nó qua boot ROM, như khi sao chép nó lên ổ của bo mạch, và Serial Monitor hiển thị cả UART0 lẫn USB serial. PIO hoạt động; lõi thứ hai không được mô phỏng. Các bước nằm trong Chạy một firmware có sẵn.
Assembly
Bảng Firmware còn cung cấp Assembly (không dùng Arduino): một Blink, một Button to LED, một UART hello và một ngắt Timer bằng hợp ngữ ARM Thumb cho Cortex-M0+. Các tệp của bo mạch trở thành một main.S, và không liên kết gì ngoài tệp đó, nên nó tự mang bảng vector của riêng mình: .word _stack_top, rồi
Reset_Handler, rồi các handler của nó. Các chương trình mẫu lấy IO_BANK0 và
PADS_BANK0 ra khỏi RESETS, điều khiển GPIO25 qua SIO và tự định thời trên
TIMERAWL. A .S tab bên cạnh một sketch thường cũng hoạt động. Pico W không có chương trình mẫu, vì LED của nó nằm trên chip radio. Xem
Viết assembly.
Các ví dụ
Blink, Button, Serial, Fade và Chaser, cùng các ví dụ tay cầm chơi game: bốn bước làm Fight stick, Fight stick, Leverless controller, Mixbox-style controller và Stop the light.
Ở nơi khác
- Trang bo mạch: /boards/pico
- Tài liệu đặc tả: mô hình Raspberry Pi Pico
- Lộ trình học: Nhúng trên Raspberry Pi Pico, tại /learn
- Cùng một chip với WiFi: Pico W
- Cùng một chip trên các bo mạch nhỏ hơn: XIAO RP2040, RP2040-Zero và Nano RP2040 Connect