Belajar

Simulator CircuitPython: firmware resmi di Pico, online

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Raspberry Pi Pico: CircuitPython membuat LED berkediplive0.000 s 0.00x
Klik untuk membukanya di editor
Tekan Jalankan. Firmware resmi CircuitPython melakukan boot, code.py disimpan ke drive CIRCUITPY, dan kedua LED berkedip.

Mokxi menjalankan CircuitPython di Raspberry Pi Pico, Pico W, Arduino Nano RP2040 Connect, dan ESP32-S3-DevKitC-1. Taruh sebuah Pico di kanvas, pilih CircuitPython (code.py) di panel Firmware-nya, tulis code.py, dan tekan Jalankan. Yang dijalankan adalah firmware resmi dari Adafruit, CircuitPython 10.3.1 untuk Raspberry Pi Pico, byte demi byte persis seperti yang dipublikasikan circuitpython.org, di atas RP2040 level instruksi milik Mokxi. Tidak ada satu pun di halaman ini yang menafsirkan Python-mu.

Board-nya menyala seperti board sungguhan: CircuitPython me-mount drive CIRCUITPY miliknya, melewati jeda safe mode satu detiknya sementara LED di GP25 berkedip, lalu memulai USB. Komputer di ujung kabel USB simulasi board itu kemudian membuka port serialnya dan menyimpan code.py ke drive tersebut, seperti komputermu sendiri saat kamu menyimpan dari editor, dan auto-reload CircuitPython menjalankannya.

Rangkaian di atas adalah yang pertama dari starter di bawah ini: board.LED membuat LED bawaan Pico dan sebuah LED merah di GP15 berkedip, dan Serial Monitor menampilkan on dan off.

Bagaimana code.py sampai di board

CircuitPython menyimpan file-file-nya di sebuah drive bernama CIRCUITPY, di flash Pico. Saat Jalankan, Mokxi menulis drive itu sebelum board dinyalakan: boot_out.txt milik firmware itu sendiri, library-library Adafruit yang diimpor programmu di bawah lib/, dan setiap tab .py, .txt, .json, .csv, dan .toml kecuali code.py.

code.py sendiri disimpan lewat USB, blok demi blok, seperti cara sistem operasi menulis file ke drive USB. CircuitPython memasukkan simpanan itu ke flash-nya dan melakukan reload, lalu code.py berjalan dengan Serial Monitor tersambung, jadi setiap baris yang dicetaknya tampil. Hasilnya muncul sekitar dua detik setelah Jalankan, sebagian besar dari jeda safe mode CircuitPython sendiri dan waktu tunggu setelah simpan sebelum reload.

Kedip dengan digitalio

digitalio.DigitalInOut(board.LED) adalah LED bawaan Pico di GP25, dan board.GP15 menggerakkan sebuah LED merah lewat 220 ohm ke ground. Keduanya menyala bersamaan, dan Serial Monitor mencetak on dan off setelah baris output code.py: milik CircuitPython.

code.py: membuat LED berkedip
# 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)

Tombol dengan pull-up pin

Tombol dari GP14 ke ground, dengan switch_to_input(pull=digitalio.Pull.UP): pin terbaca True sampai tombol ditekan, dan False selama tombol ditahan. Program mencetak Press the button, menyalakan LED board selama kamu menahannya, dan menghitung setiap tekanan sekali saja.

code.py: tombol menyalakan 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)

Pelangi NeoPixel dengan library neopixel

Delapan LED WS2812 di GP16. Library neopixel milik Adafruit masuk ke lib/ dengan sendirinya, dan mengirim bit strip dari salah satu mesin state PIO Pico, seperti di Pico sungguhan. Warna-warnanya berputar di sepanjang strip, dan setiap 64 langkah program mencetak langkahnya dan warna piksel pertama, dimulai dari step 64 first pixel.

code.py: pelangi 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)

BME280 dengan adafruit_bme280

busio.I2C(board.GP5, board.GP4) adalah I2C0 milik Pico, SCL dulu lalu SDA. Library adafruit_bme280 milik Adafruit membaca sensornya; kamu tidak perlu menambahkannya di mana pun, karena editor memasukkannya ke folder lib/ di drive saat code.py mengimpornya. Dengan komponen diatur ke 22.5 C dan 45%, program mencetak 22.5 C 45.0 % humidity dan tekanannya setiap dua detik, dan saat kamu mengubah suhu di komponen, pembacaan berikutnya mengikutinya.

code.py: BME280 ke 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)

Teks di OLED SSD1306 dengan displayio

displayio menggambar di OLED lewat adafruit_displayio_ssd1306, dan adafruit_display_text membuat label-labelnya, dengan font terminalio bawaan firmware. Kedua library itu, plus adafruit_ticks yang dibutuhkan adafruit_display_text, masuk ke lib/ dengan sendirinya. Program menulis judul dan penghitung yang naik sekali per detik, serta mencetak count 0, count 1, dan seterusnya.

code.py: teks pada 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 di Pico W

Pico W menjalankan build CircuitPython miliknya sendiri, dengan chip radio CYW43439 yang dimodelkan dari pin-pinnya: board.LED adalah LED pada chip radio, dan wifi.radio.connect() bergabung ke access point simulasi Mokxi. Nama dan kata sandinya ada di properti WiFi board, yang awalnya Mokxi-Lab dan breadboard. socketpool dan adafruit_requests milik Adafruit, beserta adafruit_connection_manager yang dibutuhkannya, semuanya sudah ditaruh di lib/ untukmu, lalu mengambil situs .mokxi buatan dari jaringan simulasi, seperti http://weather.mokxi/.

Jaringannya disimulasikan: nama di luar .mokxi tidak ditemukan, dan https:// tidak punya tujuan. Bluetooth, klien mode access point, dan power save tidak disimulasikan, dan wifi.radio.ap_info memunculkan NotImplementedError, karena port CircuitPython untuk Pico W memang tidak mengimplementasikannya.

Library yang masuk ke lib/ dengan sendirinya

Mokxi membaca setiap baris import dan memasukkan library Adafruit yang ditemukannya ke folder lib/ pada drive, beserta yang diimportnya lagi, seperti yang dilakukan circup. Semuanya adalah file .mpy hasil kompilasi resmi Adafruit dari bundle CircuitPython 10.x mereka, tanpa perubahan: adafruit_bme280, adafruit_display_text (dengan adafruit_ticks), adafruit_displayio_ssd1306, adafruit_framebuf (dengan font5x8.bin di bagian atas drive), adafruit_hcsr04, adafruit_requests (dengan adafruit_connection_manager), adafruit_ssd1306 dan neopixel. Tab dengan nama sebuah library, misalnya neopixel.py, adalah milikmu sendiri dan dipakai sebagai gantinya.

Modul bawaan firmware tidak butuh apa pun: board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus dan lainnya.

REPL

Serial Monitor adalah port serial USB Pico, dua arah: apa yang dicetak code.py, traceback-nya, dan Code done running. saat selesai. Ctrl-C menghentikan code.py dengan KeyboardInterrupt, tombol apa pun lalu masuk ke REPL, tempat >>> menjawab, dan Ctrl-D memuat ulang dan menjalankan code.py lagi.

Saat program berhenti karena error, Mokxi menandai barisnya di file-mu dan menjelaskan arti error itu dengan kata-kata CircuitPython: modul MicroPython seperti machine di program CircuitPython, pull-up yang hilang, pin yang sedang dipakai, atau board.I2C(), yang tidak dimiliki Pico.

Apa yang berfungsi, dan apa yang tidak

Yang berfungsi: digitalio, analogio, pwmio, busio.I2C dan busio.UART, bersama komponen di kanvas; adafruit_bme280, adafruit_ssd1306 dengan adafruit_framebuf, dan displayio dengan adafruit_display_text. PIO juga berjalan, jadi neopixel_write dan library neopixel menyalakan strip WS2812, dan pulseio.PulseIn membaca gema yang dihitung waktunya oleh adafruit_hcsr04 untuk HC-SR04. Reset dari dalam, dengan microcontroller.reset() atau watchdog, tetap menyimpan drive, jadi code.py berjalan lagi.

Belum disimulasi: core kedua; audiobusio, audiopwmio dan picodvi; dan membaca drive dari komputer, yang hanya bisa menyimpan ke sana. ESP32-S3-DevKitC-1 juga menjalankan CircuitPython, dengan build tersendiri dan REPL serta drive-nya di USB native S3, tetapi WiFi tidak disimulasikan di bawah CircuitPython di sana.

Mengimpor dari Wokwi

Proyek Wokwi untuk Pico, Pico W, Nano RP2040 Connect atau ESP32-S3-DevKitC-1 dengan code.py diimpor dengan board disetel ke CircuitPython, lalu berjalan. Di board lain code.py disimpan sebagai teks, dan laporan impor menjelaskan alasannya. Wokwi mungkin memakai versi CircuitPython lain; laporan impor menyebutkan versi mana yang berjalan di sini.

Kode yang sama di Pico sungguhan

Board CircuitPython tidak butuh build. Pasang CircuitPython di Pico (tahan BOOTSEL saat mencolokkannya, lalu seret .uf2 dari circuitpython.org/board/raspberry_pi_pico ke drive RPI-RP2), lalu simpan code.py ke drive CIRCUITPY yang muncul, dan salin library yang diimportnya ke CIRCUITPY/lib (circup install melakukannya untukmu).

Buka rangkaian ini di editor. Raspberry Pi Pico: CircuitPython menyalakan LED, dirangkai seperti yang dijalankan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apakah ini CircuitPython sungguhan?

Ya. Board menjalankan firmware resmi CircuitPython 10.3.1 untuk Raspberry Pi Pico, .uf2 yang sama dengan yang dirilis circuitpython.org, byte demi byte, pada RP2040 simulasi. Tidak ada kode di halaman web yang menafsirkan Python-mu.

Board mana saja yang menjalankan CircuitPython?

Raspberry Pi Pico; Pico W, dengan WiFi di jaringan simulasi; Arduino Nano RP2040 Connect dengan build CircuitPython miliknya sendiri, di mana `board.LED` adalah LED pada D13 dan `board.I2C()` ada di A4 dan A5; serta ESP32-S3-DevKitC-1. Pilih CircuitPython (code.py) di panel Firmware board. Pico yang sama bisa menjalankan MicroPython (main.py) atau sketch Arduino.

Apakah aku perlu memasang library?

Tidak. Library Adafruit yang diimport sebuah program, dari yang Mokxi punya, masuk ke folder lib/ pada drive saat Jalankan dengan sendirinya, beserta yang mereka butuhkan, seperti circup melakukannya.

Apakah ini mengunduh sesuatu?

Jalankan pertama proyek CircuitPython mengunduh firmware, dan browser menyimpannya untuk setiap Jalankan berikutnya. Setiap library hanya diunduh saat sebuah program mengimportnya. Sketch Arduino tidak pernah mengunduh keduanya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.