Học

Trình mô phỏng CircuitPython: firmware chính thức trên Pico, trực tuyến

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
Raspberry Pi Pico: CircuitPython nhấp nháy một LEDtrực tiếp0.000 s 0.00x
Nhấp để mở trong trình soạn thảo
Bấm Chạy. Firmware CircuitPython chính thức khởi động, code.py được lưu vào ổ đĩa CIRCUITPY, và cả hai LED nhấp nháy.

Mokxi chạy CircuitPython trên Raspberry Pi Pico, Pico W, Arduino Nano RP2040 Connect và ESP32-S3-DevKitC-1. Hãy đặt một Pico lên khung vẽ, chọn CircuitPython (code.py) trong panel Firmware của nó, viết code.py và bấm Chạy. Chạy bên dưới là firmware chính thức của Adafruit, CircuitPython 10.3.1 cho Raspberry Pi Pico, từng byte một như circuitpython.org phát hành, trên RP2040 mô phỏng cấp từng lệnh của Mokxi. Không có gì trong trang diễn giải Python của bạn.

Bo mạch khởi động như một bo mạch thật: CircuitPython gắn ổ đĩa CIRCUITPY, chờ hết cửa sổ safe-mode một giây trong khi LED trên GP25 nhấp nháy, rồi khởi động USB. Máy tính ở đầu dây USB mô phỏng của bo mạch sau đó mở cổng serial và lưu code.py vào ổ đĩa, như máy tính của bạn làm khi bạn lưu từ trình soạn code, và auto-reload của CircuitPython chạy nó.

Mạch phía trên là mẫu đầu tiên trong số các mẫu dưới đây: board.LED nhấp nháy chính LED của Pico và một LED đỏ trên GP15, và Serial Monitor in on và off.

code.py lên bo mạch bằng cách nào

CircuitPython giữ file trên một ổ đĩa tên CIRCUITPY, trong flash của Pico. Khi bấm Chạy, Mokxi ghi ổ đĩa đó trước khi bo mạch bật nguồn: boot_out.txt của chính firmware, các thư viện Adafruit mà chương trình import vào lib/, và mọi tab .py, .txt, .json, .csv và .toml trừ code.py.

Riêng code.py được lưu qua USB, từng khối một, như hệ điều hành ghi một file vào ổ USB. CircuitPython nhận bản ghi vào flash rồi nạp lại, và code.py chạy với Serial Monitor được nối, nên mọi dòng nó in đều hiển thị. Nó in khoảng hai giây sau khi bấm Chạy, phần lớn thời gian đó là cửa sổ safe-mode của CircuitPython và khoảng chờ sau khi lưu trước khi nạp lại.

Nhấp nháy với digitalio

digitalio.DigitalInOut(board.LED) là chính LED của Pico trên GP25, còn board.GP15 dẫn một LED đỏ qua điện trở 220 ohm xuống mass. Hai LED sáng cùng nhau, và Serial Monitor in on và off sau dòng code.py output: của CircuitPython.

code.py: nhấp nháy một LED
# CircuitPython on a Raspberry Pi Pico: blink an LED.
# board.LED is the Pico's own LED (GP25); the red LED on GP15 through
# 220 ohms blinks with it.
import board
import digitalio
import time

onboard = digitalio.DigitalInOut(board.LED)
onboard.direction = digitalio.Direction.OUTPUT
led = digitalio.DigitalInOut(board.GP15)
led.direction = digitalio.Direction.OUTPUT

while True:
    onboard.value = led.value = True
    print("on")
    time.sleep(0.5)
    onboard.value = led.value = False
    print("off")
    time.sleep(0.5)

Một nút nhấn với pull-up của chân

Nút nhấn từ GP14 xuống mass, với switch_to_input(pull=digitalio.Pull.UP): chân đọc True cho đến khi nút được nhấn, và False khi nút được giữ. Chương trình in Press the button, sáng LED của bo mạch khi bạn giữ nút, và đếm mỗi lần nhấn đúng một lần.

code.py: một nút nhấn sáng LED
# CircuitPython on a Raspberry Pi Pico: a button lights the LED.
# The button joins GP14 to ground. The pin's own pull-up holds it True, so
# a press reads False.
import board
import digitalio
import time

led = digitalio.DigitalInOut(board.LED)
led.direction = digitalio.Direction.OUTPUT
button = digitalio.DigitalInOut(board.GP14)
button.switch_to_input(pull=digitalio.Pull.UP)

print("Press the button")
presses = 0
was_pressed = False
while True:
    pressed = not button.value
    led.value = pressed
    if pressed and not was_pressed:
        presses += 1
        print("pressed", presses)
    was_pressed = pressed
    time.sleep(0.01)

Cầu vồng NeoPixel với thư viện neopixel

Tám LED WS2812 trên GP16. Thư viện neopixel của Adafruit tự vào lib/, và nó gửi các bit của dải LED từ một máy trạng thái PIO của Pico, như trên Pico thật. Các màu quay quanh dải LED, và cứ sau 64 bước chương trình in bước và màu của pixel đầu tiên, bắt đầu bằng step 64 first pixel.

code.py: cầu vồng NeoPixel
# CircuitPython on a Raspberry Pi Pico: a NeoPixel rainbow.
# Eight WS2812 LEDs on GP16, driven by Adafruit's neopixel library (which
# the editor puts in lib/ for you) through the Pico's PIO.
import board
import neopixel
import time

pixels = neopixel.NeoPixel(board.GP16, 8, brightness=0.3, auto_write=False)

def wheel(pos):
    # 0 to 255 around the color wheel: red, green, blue and back to red.
    if pos < 85:
        return (255 - pos * 3, pos * 3, 0)
    if pos < 170:
        pos -= 85
        return (0, 255 - pos * 3, pos * 3)
    pos -= 170
    return (pos * 3, 0, 255 - pos * 3)

print("Rainbow on 8 NeoPixels")
step = 0
while True:
    for i in range(8):
        pixels[i] = wheel((i * 32 + step) % 256)
    pixels.show()
    if step % 64 == 0:
        print("step", step, "first pixel", pixels[0])
    step = (step + 4) % 256
    time.sleep(0.02)

Một BME280 với adafruit_bme280

busio.I2C(board.GP5, board.GP4) là I2C0 của Pico, SCL trước rồi SDA. Thư viện adafruit_bme280 của Adafruit đọc cảm biến; bạn không phải thêm nó ở đâu cả, vì trình soạn code tự đặt nó vào thư mục lib/ của ổ đĩa khi code.py import nó. Với linh kiện đặt ở 22.5 C và 45% nó in 22.5 C 45.0 % humidity và áp suất mỗi hai giây, và khi bạn đổi nhiệt độ trên linh kiện thì lần đo kế tiếp cũng thay đổi theo.

code.py: một BME280 ra Serial Monitor
# CircuitPython on a Raspberry Pi Pico: a BME280 to the Serial Monitor.
# I2C0 on GP5 (SCL) and GP4 (SDA); Adafruit's adafruit_bme280 library goes
# into lib/ for you.
import board
import busio
import time
from adafruit_bme280 import basic as adafruit_bme280

i2c = busio.I2C(board.GP5, board.GP4)
bme = adafruit_bme280.Adafruit_BME280_I2C(i2c, address=0x76)

while True:
    print("%.1f C  %.1f %% humidity  %.1f hPa" % (bme.temperature, bme.relative_humidity, bme.pressure))
    time.sleep(2)

Chữ trên OLED SSD1306 với displayio

displayio vẽ lên màn hình OLED thông qua adafruit_displayio_ssd1306, còn adafruit_display_text tạo các nhãn, dùng chính font terminalio của firmware. Cả hai thư viện, cùng với adafruit_ticks mà adafruit_display_text cần, đều tự vào lib/. Chương trình viết một tiêu đề và một bộ đếm tăng lên mỗi giây một lần, rồi in ra count 0, count 1 và tiếp tục như vậy.

code.py: chữ trên OLED SSD1306
# CircuitPython on a Raspberry Pi Pico: text on an SSD1306 OLED.
# I2C0 on GP5 (SCL) and GP4 (SDA). displayio draws a label with the built-in
# terminalio font; adafruit_displayio_ssd1306 and adafruit_display_text go
# into lib/ for you.
import board
import busio
import displayio
import i2cdisplaybus
import terminalio
import time
import adafruit_displayio_ssd1306
from adafruit_display_text import label

displayio.release_displays()
i2c = busio.I2C(board.GP5, board.GP4)
bus = i2cdisplaybus.I2CDisplayBus(i2c, device_address=0x3C)
display = adafruit_displayio_ssd1306.SSD1306(bus, width=128, height=64)

group = displayio.Group()
title = label.Label(terminalio.FONT, text="Hello, Pico!", x=4, y=8)
counter = label.Label(terminalio.FONT, text="", x=4, y=32, scale=2)
group.append(title)
group.append(counter)
display.root_group = group

n = 0
while True:
    counter.text = str(n)
    print("count", n)
    n += 1
    time.sleep(1)

WiFi trên Pico W

Pico W chạy bản build CircuitPython riêng cho nó, với chip radio CYW43439 được mô phỏng từ các chân của nó: board.LED là LED trên chip radio, và wifi.radio.connect() nối vào điểm truy cập được mô phỏng của Mokxi. Tên và mật khẩu của nó là thuộc tính WiFi của bo mạch, ban đầu là Mokxi-Lab và breadboard. socketpool và adafruit_requests của Adafruit, cùng với adafruit_connection_manager mà nó cần, đã được đặt sẵn vào lib/ cho bạn, để rồi tải các trang .mokxi hư cấu của mạng mô phỏng, ví dụ http://weather.mokxi/.

Mạng được mô phỏng: tên ngoài .mokxi sẽ không tìm thấy, và https:// không đi tới đâu. Bluetooth, các client của chế độ điểm truy cập và chế độ tiết kiệm điện không được mô phỏng, và wifi.radio.ap_info ném ra NotImplementedError, vì bản CircuitPython cho Pico W cũng không triển khai nó.

Các thư viện tự vào lib/

Mokxi đọc từng dòng import và đặt các thư viện Adafruit mà nó tìm thấy vào thư mục lib/ của ổ đĩa, cùng với những gì chúng import lại, như circup vẫn làm. Đó là các file .mpy đã biên dịch của chính Adafruit từ bộ CircuitPython 10.x của họ, không thay đổi: adafruit_bme280, adafruit_display_text (kèm adafruit_ticks), adafruit_displayio_ssd1306, adafruit_framebuf (kèm font5x8.bin ở gốc ổ đĩa), adafruit_hcsr04, adafruit_requests (kèm adafruit_connection_manager), adafruit_ssd1306 và neopixel. Một tab trùng tên với thư viện, ví dụ neopixel.py, là của riêng bạn và sẽ được dùng thay thế.

Các module được tích hợp sẵn trong firmware không cần thêm gì: board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus và các module khác.

REPL

Serial Monitor chính là cổng USB serial của Pico, theo cả hai chiều: những gì code.py in ra, traceback của nó, và Code done running. khi nó kết thúc. Ctrl-C dừng code.py với KeyboardInterrupt, nhấn phím bất kỳ để vào REPL, nơi >>> trả lời, và Ctrl-D tải lại và chạy code.py một lần nữa.

Khi chương trình dừng vì lỗi, Mokxi đánh dấu dòng lỗi trong file của bạn và nói lỗi đó thường có nghĩa là gì theo lời của CircuitPython: một module MicroPython như machine trong chương trình CircuitPython, thiếu điện trở kéo lên, một chân đang được dùng, hoặc board.I2C(), thứ mà Pico không có.

Cái gì chạy được, và cái gì không

Đang hoạt động: digitalio, analogio, pwmio, busio.I2C và busio.UART, cùng các linh kiện trên khung vẽ; adafruit_bme280, adafruit_ssd1306 với adafruit_framebuf, và displayio với adafruit_display_text. PIO cũng chạy, nên neopixel_write và thư viện neopixel làm sáng dải WS2812, còn pulseio.PulseIn đọc tín hiệu echo mà adafruit_hcsr04 dùng để đo thời gian của HC-SR04. Reset từ bên trong, bằng microcontroller.reset() hoặc watchdog, vẫn giữ nguyên ổ đĩa, nên code.py chạy lại.

Chưa mô phỏng: lõi thứ hai; audiobusio, audiopwmio và picodvi; và việc đọc ổ đĩa từ máy tính, chỉ có thể lưu vào nó. ESP32-S3-DevKitC-1 cũng chạy CircuitPython, với bản build riêng và REPL cùng ổ đĩa trên USB gốc của S3, nhưng WiFi không được mô phỏng dưới CircuitPython trên đó.

Nhập từ Wokwi

Một dự án Wokwi cho Pico, Pico W, Nano RP2040 Connect hoặc ESP32-S3-DevKitC-1 có code.py sẽ được nhập với bo mạch đặt thành CircuitPython, và chạy. Trên bo mạch khác, code.py được giữ lại như văn bản, và thông báo nhập giải thích lý do. Wokwi có thể đã dùng phiên bản CircuitPython khác; báo cáo nhập cho biết phiên bản nào chạy ở đây.

Cùng code trên Pico thật

Một bo mạch CircuitPython không cần build nào. Cài CircuitPython lên Pico (giữ BOOTSEL khi cắm, rồi kéo file .uf2 từ circuitpython.org/board/raspberry_pi_pico vào ổ RPI-RP2), sau đó lưu code.py vào ổ CIRCUITPY hiện ra, và chép các thư viện mà nó import vào CIRCUITPY/lib (circup install làm giúp bạn).

Mở mạch này trong trình soạn thảo. Raspberry Pi Pico: CircuitPython nhấp nháy một LED, 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ạch

Câu hỏi

Đây có phải CircuitPython thật không?

Có. Bo mạch chạy firmware CircuitPython 10.3.1 chính thức cho Raspberry Pi Pico, đúng file .uf2 mà circuitpython.org công bố, từng byte một, trên một RP2040 được mô phỏng. Không có gì trong trang web diễn giải Python của bạn.

Những bo mạch nào chạy CircuitPython?

Raspberry Pi Pico; Pico W, với WiFi trên mạng mô phỏng; Arduino Nano RP2040 Connect với bản build CircuitPython riêng cho nó, nơi `board.LED` là LED trên D13 và `board.I2C()` nằm trên A4 và A5; và ESP32-S3-DevKitC-1. Chọn CircuitPython (code.py) trong bảng firmware của bo mạch. Cùng một Pico có thể chạy MicroPython (main.py) hoặc một sketch Arduino thay thế.

Tôi có cần cài thư viện không?

Không. Các thư viện Adafruit mà chương trình import, trong số những gì Mokxi có, tự vào thư mục lib/ của ổ đĩa khi Chạy, cùng với những gì chúng cần, như circup vẫn làm.

Có cần tải gì xuống không?

Lần Chạy đầu tiên của một dự án CircuitPython sẽ tải firmware về, và trình duyệt giữ nó cho mọi lần Chạy sau. Mỗi thư viện chỉ được tải khi một chương trình import nó. Một sketch Arduino thì không tải gì cả.

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.