MicroPython trên Raspberry Pi Pico, không cần cài đặt gì
Cơ bản
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
Mokxi chạy MicroPython trên Raspberry Pi Pico của mình. Bạn đặt một Pico lên khung vẽ, chọn MicroPython (main.py) trong bảng Firmware của nó, viết main.py và nhấn Chạy. Cái chạy bên dưới là firmware MicroPython v1.29.0 chính thức cho Pico, đúng file bạn sẽ kéo vào một bo mạch thật, trên con RP2040 mô phỏng của Mokxi, từng lệnh một.
Khi bạn nhấn Chạy, bo mạch khởi động firmware đó, và máy tính ở đầu dây USB mô phỏng chép các file .py của bạn vào hệ thống file của bo mạch giống như Thonny làm, rồi soft-reboot nó. MicroPython in ra MPY: soft reboot và chạy main.py. Mọi thứ print() nói đều hiện trong Serial Monitor, và khi main.py kết thúc thì REPL trả lời: gõ 6*7 và nó nói 42.
Mạch phía trên là một biến trở trên GP26 và một LED trên GP15. Xoay núm thì LED tối và sáng lên, còn Serial Monitor hiển thị vị trí núm theo phần trăm.
Chương trình: ADC vào, PWM ra
ADC(26) là ngõ vào tương tự của RP2040 trên GP26, và read_u16() cho 0 tại 0 V và 65535 tại mức tham chiếu 3.3 V. Bản thân bộ chuyển đổi có 12 bit, nên giá trị nhảy theo bậc khoảng 16. PWM(Pin(15)) là khối PWM phía sau GP15, và duty_u16() nhận cùng dải 0 đến 65535, nên giá trị đọc từ núm có thể đưa thẳng vào làm hệ số nhiệm vụ.
Với điểm giữa ở 1.1 V, tức một phần ba chiều xoay, read_u16() in ra 21845 mỗi lần ở đây: 1365 trên 4095 bậc, mà MicroPython kéo dãn lên 16 bit bằng cách dịch lên bốn bit và lặp lại bốn bit cao nhất của nó bên dưới, giống trên Pico thật. Ở hệ số nhiệm vụ 32768, chân LED đo được cao trong 50.0% mỗi chu kỳ 1 ms.
# MicroPython on a Raspberry Pi Pico: a knob dims an LED.
# The potentiometer's wiper is on GP26 (ADC0), the LED on GP15 is driven by PWM.
from machine import ADC, Pin, PWM
import time
knob = ADC(26) # read_u16(): 0 at 0 V, 65535 at 3.3 V
led = PWM(Pin(15))
led.freq(1000) # 1 kHz, far too fast to see it flicker
last = -1
while True:
value = knob.read_u16()
led.duty_u16(value) # the knob's position is the LED's duty cycle
percent = value * 100 // 65535
if percent != last:
print("knob", percent, "%")
last = percent
time.sleep_ms(50)
Nhấp nháy với machine.Pin, và một sleep thật sự kéo dài bao lâu
LED trên bo mạch của Pico là GP25. Chương trình dưới đây đảo trạng thái nó mỗi 100 ms. Đo ngay trên chân của bo mạch, mỗi chu kỳ ở đây là 200 ms với sai số dưới một phần nghìn giây, vì time.sleep_ms() chờ theo chính bộ đếm thời gian micro giây của RP2040.
utime.ticks_us() cũng đọc bộ đếm thời gian đó. Bốn lệnh sleep_ms(250) liên tiếp đo được trong khoảng nửa phần nghìn giây so với 1000000 micro giây mỗi lần ở đây. machine.freq() nói 125000000, tức 125 MHz của Pico.
from machine import Pin
import time
led = Pin(25, Pin.OUT) # the Pico's green LED
while True:
led.toggle()
time.sleep_ms(100)
Nút nhấn với interrupt
Pin.irq() chạy một hàm khi chân đổi trạng thái, mà vòng lặp chính không cần theo dõi. Ở đây một nút nhấn từ GP14 xuống mass dùng điện trở kéo lên bên trong của chân, nên chân đọc là 1 cho tới khi nhấn nút, và IRQ_FALLING chạy hàm xử lý một lần mỗi lần nhấn. Giữ hàm xử lý ngắn gọn: tăng một biến đếm, đặt một cờ, rồi để vòng lặp chính lo việc in.
from machine import Pin
import time
presses = 0
def pressed(pin):
global presses
presses += 1
button = Pin(14, Pin.IN, Pin.PULL_UP)
button.irq(trigger=Pin.IRQ_FALLING, handler=pressed)
last = 0
while True:
if presses != last:
last = presses
print("presses", presses)
time.sleep_ms(5)
Chuyển sketch Arduino sang MicroPython
Phần lớn sketch Arduino có một dòng MicroPython tương đương. Không có setup() và loop(): phần đầu main.py chạy một lần, và vòng lặp while True: ở cuối chạy mãi mãi. Chân là các đối tượng tạo từ module machine, còn thời gian lấy từ module time.
Hai thứ đổi cỡ. analogRead() trên Uno cho 0 đến 1023, còn read_u16() cho 0 đến 65535 bất kể độ phân giải của bộ chuyển đổi. Và hiệu thời gian lấy bằng time.ticks_diff(), vẫn đúng khi bộ đếm tràn số, thay vì trừ trực tiếp.
Dưới đây là ví dụ Arduino AnalogReadSerial đã chuyển, trên mạch chỉnh độ sáng LED bằng biến trở. Với núm ở giữa, nó in 0 ms 32743 1.65 V, rồi cùng giá trị đó ở 500 ms, 1000 ms và tiếp tục: 32743 là 2046 trên 4095 bậc, kéo dãn lên 16 bit.
| Arduino | MicroPython |
|---|---|
| pinMode(15, OUTPUT); digitalWrite(15, HIGH); | led = Pin(15, Pin.OUT); led.value(1) |
| pinMode(14, INPUT_PULLUP); digitalRead(14) | button = Pin(14, Pin.IN, Pin.PULL_UP); button.value() |
| analogRead(A0), 0 đến 1023 | ADC(26).read_u16(), 0 đến 65535 |
| analogWrite(15, 128), 0 đến 255 | PWM(Pin(15)).duty_u16(32768), 0 đến 65535 |
| delay(500) | time.sleep_ms(500) |
| millis() | time.ticks_ms() |
| Serial.println(x) | print(x) |
| attachInterrupt(..., FALLING) | Pin.irq(trigger=Pin.IRQ_FALLING, handler=...) |
# Arduino's AnalogReadSerial, ported to MicroPython
from machine import ADC
import time
pot = ADC(26) # analogRead(A0) becomes ADC(26)
start = time.ticks_ms() # millis() becomes time.ticks_ms()
while True:
value = pot.read_u16() # 0 to 65535, not 0 to 1023
volts = value * 3.3 / 65535
print(time.ticks_diff(time.ticks_ms(), start), "ms", value, "%.2f V" % volts)
time.sleep_ms(500) # delay(500) becomes time.sleep_ms(500)
I2C: màn hình OLED và BME280 với machine.I2C
machine.I2C(0) và machine.I2C(1) là hai khối I2C của RP2040, và các linh kiện trên một bus sẽ phản hồi tại địa chỉ của chúng: ở đây màn hình OLED SSD1306 nằm trên I2C0 (GP4 và GP5) và scan() tìm thấy nó tại 0x3C (60), còn BME280 nằm trên I2C1 (GP6 và GP7) tại 0x76 (118). Cả hai cũng có thể dùng chung một bus vì chúng có địa chỉ khác nhau. Thêm các driver dưới dạng các tab, ssd1306.py từ micropython-lib và một driver BME280, và chúng sẽ được sao chép lên bo mạch cùng với main.py, giống như Thonny sao chép chúng.
Bus chạy theo đồng hồ mô phỏng với tốc độ mà khối thật sự tạo ra: yêu cầu 400 kHz thì trên dây là 376 kHz, và oled.show(), 1 KB hình ảnh, mất 25.4 ms. Hỏi một địa chỉ không ai trả lời thì lệnh gọi ném OSError: [Errno 5] EIO, giống trên Pico thật. machine.SPI hoạt động cùng cách, cả DMA nữa, còn SoftI2C và SoftSPI chạy trên bất kỳ chân nào.
# MicroPython on a Raspberry Pi Pico: a BME280 and an SSD1306 OLED on I2C.
# The OLED is on I2C0: SDA on GP4 (pin 6), SCL on GP5 (pin 7).
# The BME280 is on I2C1: SDA on GP6 (pin 9), SCL on GP7 (pin 10).
# Both run from 3V3 (pin 36). ssd1306.py and bme280.py are in their own tabs.
from machine import I2C, Pin
import time
import ssd1306
import bme280
i2c0 = I2C(0, scl=Pin(5), sda=Pin(4), freq=400000)
i2c1 = I2C(1, scl=Pin(7), sda=Pin(6), freq=400000)
print("I2C0:", [hex(a) for a in i2c0.scan()]) # 0x3c, the OLED
print("I2C1:", [hex(a) for a in i2c1.scan()]) # 0x76, the BME280
oled = ssd1306.SSD1306_I2C(128, 64, i2c0)
sensor = bme280.BME280(i2c=i2c1)
while True:
t, p, h = sensor.read_compensated_data() # C, Pa, %RH
oled.fill(0)
oled.text("Pico weather", 0, 0)
oled.text("%.1f C" % t, 0, 20)
oled.text("%.1f hPa" % (p / 100), 0, 34)
oled.text("%.1f %%RH" % h, 0, 48)
oled.show()
print("%.2f C %.2f hPa %.2f %%" % (t, p / 100, h))
time.sleep(2)
Khi chương trình dừng vì một lỗi
MicroPython dừng một chương trình gặp lỗi và in ra traceback: tệp, dòng và lỗi. Mokxi đọc từ cổng serial, đánh dấu dòng trong trình soạn code và nói ý nghĩa thường gặp của lỗi. NameError là một tên được dùng trước khi được gán giá trị hoặc import (tên trong Python phân biệt chữ hoa chữ thường); SyntaxError là một dòng không phải Python hợp lệ, thường là thiếu dấu hai chấm ở cuối dòng if, for, while hoặc def; ImportError với RPi.GPIO hoặc gpiozero nghĩa là code viết cho máy tính Raspberry Pi, không phải Pico.
Sau traceback, REPL vẫn trả lời, nên bạn có thể thử lại dòng đó bằng tay trước khi sửa main.py.
Điều gì được mô phỏng, và điều gì không
Được mô phỏng: nhân Cortex-M0+ của RP2040 cùng boot ROM của nó, bootloader tầng hai, chip flash và hệ thống tệp littlefs trên đó, các bộ tạo xung nhịp, cổng USB, các chân GPIO với điện trở kéo lên và ngắt, PWM, ADC kèm cảm biến nhiệt độ, các khối I2C và SPI cùng DMA, bộ timer, RTC và watchdog.
Chưa được mô phỏng: nhân thứ hai, nên _thread sẽ dừng bo mạch kèm thông báo như vậy; khối I2C ở vai trò mục tiêu (machine.I2CTarget); và xung nhịp CPU, luôn ở 125 MHz dù bạn đặt machine.freq() thế nào, tuy nhiên timer và mọi phép đo thời gian vẫn chính xác. Các khối PIO vẫn chạy, nên rp2.PIO và rp2.StateMachine điều khiển chân của chúng. Pico W chạy bản MicroPython riêng, với chip CYW43439 được mô phỏng từ các chân của nó: Pin("LED") sáng LED trên bo mạch và network.WLAN tham gia mạng mô phỏng của Mokxi.
Mở mạch này trong trình soạn thảo. Raspberry Pi Pico: MicroPython chỉnh độ sáng LED bằng một chiết áp, nối dây như khi nó chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại.
Mở mạchCâu hỏi
Đây là MicroPython thật hay bản mô phỏng nhái lại?
Thật. Bo mạch chạy firmware MicroPython v1.29.0 chính thức cho Raspberry Pi Pico, đúng tệp .uf2 mà micropython.org công bố, trên một RP2040 được mô phỏng. Không có gì trong trang web diễn giải code Python của bạn: firmware biên dịch và chạy nó trên chip mô phỏng.
main.py được đưa lên bo mạch thế nào?
Theo cách Thonny và mpremote làm. Khi chạy, máy tính mô phỏng trên cổng USB của Pico mở cổng serial của nó, vào raw REPL, ghi từng thẻ .py vào hệ thống tệp littlefs của bo mạch bằng một đoạn script ngắn, rồi soft-reboot bo mạch, sau đó bo mạch chạy main.py.
Mình có thể thêm module riêng hoặc một thư viện không?
Có. Thêm một thẻ với tệp .py của module, ví dụ ssd1306.py, rồi import nó từ main.py. Mọi thẻ .py đều được chép vào bo mạch cùng main.py.
Có cần tải gì xuống không?
Lần Chạy đầu tiên của một dự án MicroPython sẽ tải firmware xuống, 229 KB, và trình duyệt giữ lại cho mọi lần Chạy sau. Dự án Arduino thì không bao giờ tải nó.
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.