Những bo mạch nào
Bo mạch thường Raspberry Pi Pico chạy CircuitPython, và Arduino Nano RP2040 Connectcũng vậy, với bản build riêng của CircuitPython cho nó: cùng chip RP2040, với board.LED trên D13 (GPIO 6) và board.I2C() trên A4 và A5. Xem
Nano RP2040 Connect. Bo mạch Raspberry Pi Pico W chạy bản build riêng, với chip radio CYW43439 được mô phỏng, nên
board.LED đèn LED và WiFi hoạt động trên mạng mô phỏng của Mokxi (xem
WiFi trên Pico W). Bo mạch 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; WiFi không được mô phỏng dưới CircuitPython ở đó. Pico cũng chạy MicroPython; xem Pico.
Điều chạy bên trong là CircuitPython 10.3.1 cho Raspberry Pi Pico, firmware chính thức của Adafruit, nguyên vẹn từng byte một như circuitpython.org công bố, trên con RP2040 được mô phỏng của Mokxi. Không có gì trong trang này diễn giải Python của bạn.
Chọn nó trong bảng Firmware
- Đặt một Raspberry Pi Pico, Pico W, Arduino Nano RP2040 Connect hoặc ESP32-S3-DevKitC-1 lên khung vẽ.
- Mở bảng Firmware của bo mạch và chọn CircuitPython (code.py).
- Các tệp của bo mạch trở thành một
code.py. Nếu chúng chứa sản phẩm của riêng bạn, bạn sẽ được hỏi trước. Viết chương trình vào đó rồi nhấn Chạy.
Một bo mạch có tệp code.py và không có tệp .ino sẽ chạy CircuitPython. Một sketch Arduino hay một dự án MicroPython trên cùng bo mạch vẫn chạy như trước, và không có gì của CircuitPython được nạp cho nó.
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ữ lại nó cho mọi lần Chạy sau. Một sketch Arduino không bao giờ tải nó.
Ổ đĩa CIRCUITPY và code.py
CircuitPython giữ các tệp của mình trên một ổ đĩa tên là CIRCUITPY, trong flash của bo mạch. Khi Chạy, Mokxi ghi ổ đĩa đó trước khi bo mạch khởi động: tệp boot_out.txt của chính firmware, các thư viện Adafruit mà chương trình của bạn import vào dưới lib/, và mọi thẻ .py, .txt, .json, .csv và .toml trừ code.py.
Sau đó, máy tính ở đầu dây USB được mô phỏng của Pico mở cổng serial của bo mạch và lưu code.py vào ổ đĩa qua USB, giống như máy tính của bạn vẫn làm khi bạn lưu tệp từ trình soạn code. CircuitPython thấy bản lưu và nạp lại, như trên bàn thật, rồi chạy code.py với Serial Monitor được kết nối, nên mọi dòng nó in ra đều hiển thị.
code.py in ra sau khoảng hai giây kể từ lúc Chạy. Phần lớn thời gian đó là của chính CircuitPython: khoảng một giây chờ safe-mode lúc khởi động, khi LED trên GP25 nhấp nháy, và khoảng chờ sau khi lưu trước khi nạp lại.
microcontroller.reset() và watchdog giữ nguyên ổ đĩa, nên code.py chạy lại; những gì nó in trước khi cổng serial mở lại sẽ mất, như trên bàn thật. Chạy lại thì bắt đầu từ một ổ đĩa được ghi mới hoàn toàn.
Thư viện
Mokxi đọc các dòng import của bạn và tự đặ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, giống như circup vẫn làm. Đó là các tệp .mpy đã biên dịch của chính Adafruit từ bộ CircuitPython 10.x của họ, không thay đổi:
adafruit_bme280adafruit_display_text(kèmadafruit_ticks)adafruit_displayio_ssd1306adafruit_framebuf(kèm tệpfont5x8.binở gốc ổ đĩa)adafruit_hcsr04adafruit_requests(kèmadafruit_connection_manager)adafruit_ssd1306neopixel
Mỗi thư viện chỉ được tải về khi một chương trình import nó. Một thẻ có tên trùng với thư viện, ví dụ neopixel.py, là của chính bạn và được dùng thay thế. Các module có sẵn trong firmware (board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus và các module khác) không cần gì thêm.
Serial Monitor và REPL
Serial Monitor là cổng serial USB của bo mạch, hai chiều: những gì code.py in ra, các traceback của nó, và Code done running. khi nó kết thúc.
- Ctrl-C dừng
code.pyvới mộtKeyboardInterrupt. - Phím bất kỳ sau đó vào REPL, và
>>>trả lời ở đó. - Ctrl-D nạp lại và chạy
code.pylần nữa.
Khi một chương trình dừng vì lỗi, CircuitPython in ra một traceback. Mokxi đọc nó, đánh dấu dòng trong tệp của bạn, và nói lỗi đó thường nghĩa là gì theo cách CircuitPython: một module MicroPython 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ó (dùng busio.I2C(board.GP5, board.GP4)).
Cái gì chạy được, và cái gì không
digitalio, analogio, pwmio, busio.I2C và busio.UART hoạt động được, nên adafruit_bme280, adafruit_ssd1306 và displayio với adafruit_display_text có thể giao tiếp với các linh kiện trên khung vẽ.
PIO cũng chạy, nên neopixel_write và thư viện neopixel làm sáng một dải WS2812, và pulseio.PulseIn đọc tín hiệu echo mà adafruit_hcsr04 dùng để đo thời gian với HC-SR04.
Không được mô phỏng: lõi thứ hai; audiobusio, audiopwmio và picodvi; và việc đọc ổ đĩa từ máy tính, vốn chỉ lưu vào đó.
WiFi trên Pico W
wifi.radio.connect() kết 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à các thuộc tính WiFi của bo mạch, mặc định là Mokxi-Lab và breadboard. socketpool và adafruit_requests (trình soạn code đặt trong lib/ cùng với adafruit_connection_manager mà nó cần) truy cập được các trang web giả định .mokxi, ví dụ http://weather.mokxi/:
import wifi, socketpool, adafruit_requests
wifi.radio.connect("Mokxi-Lab", "breadboard")
print("Connected, IP address", wifi.radio.ipv4_address)
requests = adafruit_requests.Session(socketpool.SocketPool(wifi.radio))
print(requests.get("http://weather.mokxi/").json())
Tên nào khác thì không tìm thấy, và https:// không có nơi nào để đến. Không được mô phỏng: Bluetooth, các client của chế độ điểm truy cập và chế độ tiết kiệm pin. wifi.radio.ap_info ném ra NotImplementedError, vì bản CircuitPython cho Pico W chưa hiện thực nó.
Nhập từ Wokwi
Một dự án Wokwi cho Pico, Pico W, Nano RP2040 Connect hoặc ESP32-S3-DevKitC-1 có một code.py được nhập vào với bo mạch đặt thành CircuitPython, và chạy. Trên bo mạch khác, tệp
code.py được giữ lại như văn bản, và thông báo nhập vào nói rõ lý do. Wokwi có thể đã dùng một phiên bản CircuitPython khác; báo cáo nhập vào cho biết phiên bản nào chạy ở đây. Xem
Chuyển từ Wokwi sang.
Trên bo mạch thật
Một bo mạch CircuitPython không cần biên dịch. Cài CircuitPython lên Pico (giữ BOOTSEL khi cắm vào, rồi kéo tệp .uf2 từ circuitpython.org/board/raspberry_pi_pico vào ổ RPI-RP2), sau đó lưu code.py vào ổ CIRCUITPY xuất hiện, và sao chép mọi thư viện mà nó import vào CIRCUITPY/lib (circup install làm giúp bạn).
Trên Pico W, thay vào đó kéo tệp .uf2 từ circuitpython.org/board/raspberry_pi_pico_w, và đặt tên và mật khẩu mạng của riêng bạn vào code.py. Trên Nano RP2040 Connect, cắm dây REC vào GND khi cắm bo mạch, rồi kéo tệp .uf2 từ circuitpython.org/board/arduino_nano_rp2040_connect. Trên ESP32-S3-DevKitC-1, cắm cổng USB của nó (cổng ghi USB, không phải UART) và dùng trình cài đặt tại circuitpython.org/board/espressif_esp32s3_devkitc_1_n8.
Bài khởi động
Các bài khởi đầu trên Pico, mỗi bài một trang riêng: blink, một nút nhấn, cầu vồng NeoPixel, một BME280 và chữ trên màn hình OLED SSD1306. Trình mô phỏng CircuitPython đi qua từng bài.
Ở nơi khác
- Các bo mạch: Raspberry Pi Pico, Pico W, Nano RP2040 Connect và ESP32-S3-DevKitC-1
- Các trang bo mạch: /boards/pico và /boards/pico-w
- Hợp đồng Arduino của chip: mô hình Raspberry Pi Pico
- MicroPython trên ESP32: MicroPython trên ESP32