Öğren

CircuitPython simülatörü: Pico üzerinde resmi firmware, çevrimiçi

Başlangıç

Ya da tüm dersleri gör.

  • 526parça tezgahta
  • 46kart şu an çalışıyor
  • 1.00xgerçek zamanlı, her kartta
Raspberry Pi Pico: CircuitPython bir LED yakıp söndürürcanlı0.000 s 0.00x
Düzenleyicide açmak için tıkla
Çalıştır'a basın. Resmi CircuitPython firmware'i önyükleme yapar, code.py CIRCUITPY sürücüsüne kaydedilir ve iki LED de yanıp söner.

Mokxi, CircuitPython'ı Raspberry Pi Pico, Pico W, Arduino Nano RP2040 Connect ve ESP32-S3-DevKitC-1 üzerinde çalıştırır. Tuvale bir Pico koyun, Firmware panelinden CircuitPython (code.py) seçin, code.py yazın ve Çalıştır'a basın. Çalışan şey, Mokxi'nin komut düzeyindeki RP2040'ı üzerinde, circuitpython.org'un yayınladığının birebir aynısı olan resmi Adafruit firmware'idir, Raspberry Pi Pico için CircuitPython 10.3.1. Sayfadaki hiçbir şey Python kodunuzu yorumlamaz.

Kart, gerçek bir kart gibi önyükleme yapar: CircuitPython CIRCUITPY sürücüsünü bağlar, GP25'teki LED yanıp sönerken bir saniyelik güvenli mod penceresini bekler ve USB'yi başlatır. Kartın simüle edilen USB kablosunun ucundaki bilgisayar daha sonra seri bağlantı noktasını açar ve code.py dosyasını sürücüye kaydeder, tıpkı düzenleyicinizden kaydederken kendi bilgisayarınızın yaptığı gibi, ve CircuitPython'un otomatik yeniden yüklemesi onu çalıştırır.

Yukarıdaki devre, aşağıdaki başlangıç projelerinin ilkidir: board.LED, Pico'nun kendi LED'ini ve GP15'teki kırmızı bir LED'i yakıp söndürür, seri monitör de on ve off yazar.

code.py karta nasıl gider

CircuitPython dosyalarını CIRCUITPY adlı bir sürücüde, Pico'nun flash belleğinde tutar. Çalıştır'da Mokxi, kart güç almadan önce o sürücüyü yazar: firmware'in kendi boot_out.txt dosyası, programınızın içe aktardığı lib/ altındaki Adafruit kütüphaneleri ve code.py dışındaki tüm .py, .txt, .json, .csv ve .toml sekmeleri.

code.py'nin kendisi, bir işletim sisteminin bir USB sürücüye dosya yazdığı gibi, USB üzerinden blok blok kaydedilir. CircuitPython kaydı flash belleğine alır ve yeniden yüklenir, code.py de seri monitör bağlıyken çalışır, böylece bastığı her satır görünür. Çalıştır'dan yaklaşık iki saniye sonra yazdırmaya başlar; bunun çoğu CircuitPython'un kendi güvenli mod penceresi ile kayıttan sonra yeniden yüklemeden önceki beklemedir.

digitalio ile blink

digitalio.DigitalInOut(board.LED) GP25'teki Pico'nun kendi LED'idir, board.GP15 ise toprağa giden 220 ohm üzerinden kırmızı bir LED'i sürer. İkisi birlikte yanar ve seri monitör, CircuitPython'un code.py output: satırından sonra on ve off yazar.

code.py: bir LED yakıp söndür
# 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)

Pin'in çekme (pull-up) direnciyle bir buton

GP14'ten toprağa bir buton, switch_to_input(pull=digitalio.Pull.UP) ile: pin, buton basılana kadar True, basılı tutulurken False okur. Program Press the button yazar, butonu tutarken kartın LED'ini yakar ve her basmayı bir kez sayar.

code.py: bir buton LED'i yakar
# 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)

neopixel kütüphanesiyle bir NeoPixel gökkuşağı

GP16'da sekiz WS2812 LED. Adafruit'in neopixel kütüphanesi kendi başına lib/ içine girer ve şeridin bitlerini, gerçek bir Pico'da olduğu gibi Pico'nun PIO durum makinelerinden birinden gönderir. Renkler şerit üzerinde döner ve her 64 adımda program, step 64 first pixel ile başlayarak adımı ve ilk pikselin rengini yazar.

code.py: bir NeoPixel gökkuşağı
# 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)

adafruit_bme280 ile bir BME280

busio.I2C(board.GP5, board.GP4) Pico'nun I2C0'ıdır, önce SCL sonra SDA. Adafruit'in adafruit_bme280 kütüphanesi sensörü okur; code.py içe aktardığında düzenleyici onu sürücünün lib/ klasörüne koyduğu için onu hiçbir yere eklemen gerekmez. Parça 22.5 C ve %45 olarak ayarlıyken 22.5 C 45.0 % humidity ve basıncı iki saniyede bir yazar, parçadaki sıcaklığı değiştirdiğinde ise bir sonraki okuma onu izler.

code.py: BME280'den seri monitöre
# 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)

displayio ile bir SSD1306 OLED'de metin

displayio, OLED üzerine adafruit_displayio_ssd1306 üzerinden çizim yapar, adafruit_display_text ise etiketleri firmware'in kendi terminalio yazı tipiyle oluşturur. İki kütüphane ve adafruit_display_text'in gerektirdiği adafruit_ticks kendi başlarına lib/ içine girer. Program bir başlık ve saniyede bir artan bir sayaç yazar, ayrıca count 0, count 1 diye yazdırır.

code.py: bir SSD1306 OLED üzerinde metin
# 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)

Pico W'de WiFi

Pico W, CircuitPython'ın ona özel derlemesini çalıştırır; CYW43439 radyo çipi pinlerinden modellenmiştir: board.LED radyo çipindeki LED'dir ve wifi.radio.connect() Mokxi'nin simüle edilmiş erişim noktasına bağlanır. Adı ve parolası kartın WiFi özellikleridir; bunlar başlangıçta Mokxi-Lab ve breadboard olur. socketpool ve Adafruit'in adafruit_requests kütüphanesi, gerektirdiği adafruit_connection_manager ile birlikte senin için lib/ içine yerleştirilir, sonra simüle edilmiş ağın uydurma .mokxi siteleri, örneğin http://weather.mokxi/, alınır.

Ağ simüle edilir: .mokxi dışındaki adlar bulunamaz ve https:// hiçbir yere gitmez. Bluetooth, erişim noktası modunun istemcileri ve güç tasarrufu simüle edilmez; ayrıca wifi.radio.ap_info, CircuitPython'ın Pico W portu onu uygulamadığı için NotImplementedError yükseltir.

lib/ içine kendi kendine giden kütüphaneler

Mokxi her import satırını okur ve bulduğu Adafruit kütüphanelerini, circup'in yapacağı gibi, onların da içe aktardıklarıyla birlikte sürücünün lib/ klasörüne koyar. Bunlar CircuitPython 10.x paketinden alınan, değiştirilmemiş Adafruit'in kendi derlenmiş .mpy dosyalarıdır: adafruit_bme280, adafruit_display_text (adafruit_ticks ile), adafruit_displayio_ssd1306, adafruit_framebuf (font5x8.bin dosyası sürücünün en üstünde), adafruit_hcsr04, adafruit_requests (adafruit_connection_manager ile), adafruit_ssd1306 ve neopixel. Bir kütüphanenin adını taşıyan sekme, örneğin neopixel.py, senin kendi dosyandır ve onun yerine kullanılır.

Firmware'e hazır olarak gömülü modüller hiçbir şey gerektirmez: board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus ve diğerleri.

REPL

Seri monitör, Pico'nun USB seri portudur, iki yönlü: code.py'nin yazdırdıkları, geri izlemeleri ve bittiğinde Code done running. mesajı. Ctrl+C, code.py'yi bir KeyboardInterrupt ile durdurur; ardından herhangi bir tuş REPL'e girer, orada >>> yanıt verir ve Ctrl+D code.py'yi yeniden yükleyip tekrar çalıştırır.

Bir program hatayla durduğunda Mokxi, dosyandaki satırı işaretler ve hatanın genelde ne anlama geldiğini CircuitPython'ın sözleriyle söyler: CircuitPython programında machine gibi bir MicroPython modülü, eksik bir pull-up, kullanımda olan bir pin ya da Pico'da bulunmayan board.I2C().

Neler çalışır, neler çalışmaz

Çalışıyor: tuvaldeki parçalarla digitalio, analogio, pwmio, busio.I2C ve busio.UART; adafruit_bme280, adafruit_framebuf ile adafruit_ssd1306 ve adafruit_display_text ile displayio. PIO da çalışıyor, bu yüzden neopixel_write ve neopixel kütüphanesi bir WS2812 şeridini yakıyor ve pulseio.PulseIn, adafruit_hcsr04'ün bir HC-SR04 ile zamanladığı yankıyı okuyor. İçeriden yapılan bir sıfırlama, microcontroller.reset() veya watchdog ile, sürücüyü koruyor, böylece code.py yeniden çalışıyor.

Henüz simüle edilmeyenler: ikinci çekirdek; audiobusio, audiopwmio ve picodvi; ve bilgisayardan sürücüyü okuma; bilgisayar sürücüye yalnızca kaydeder. ESP32-S3-DevKitC-1 de CircuitPython çalıştırır, kendi derlemesiyle ve S3'ün yerel USB'sindeki REPL ve sürücüsüyle, ancak orada CircuitPython altında WiFi simüle edilmez.

Wokwi'den içe aktarma

Pico, Pico W, Nano RP2040 Connect veya ESP32-S3-DevKitC-1 için bir Wokwi projesi, içindeki bir code.py'yi kartı CircuitPython'a ayarlı olarak içe aktarır ve çalıştırır. Başka bir kartta code.py metin olarak saklanır ve içe aktarma nedenini söyler. Wokwi başka bir CircuitPython sürümü kullanmış olabilir; içe aktarma raporu burada hangisinin çalıştığını söyler.

Gerçek bir Pico'da aynı kod

Bir CircuitPython kartı derleme gerektirmez. Pico'ya CircuitPython'u yükle (takarken BOOTSEL'i basılı tut, sonra circuitpython.org/board/raspberry_pi_pico adresindeki .uf2 dosyasını RPI-RP2 sürücüsüne sürükle), ardından beliren CIRCUITPY sürücüsüne code.py dosyasını kaydet ve içe aktardığı kütüphaneleri CIRCUITPY/lib içine kopyala (circup install bunu senin için yapar).

Bu devreyi düzenleyicide aç. Raspberry Pi Pico: CircuitPython bu sayfanın üstünde çalıştığı gibi kablolanan bir LED'i yakıp söndürür. Bir parçayı veya değeri değiştir ve yeniden çalıştır.

Devreyi aç

Sorular

Bu gerçek CircuitPython mı?

Evet. Kart, simüle edilmiş bir RP2040 üzerinde, Raspberry Pi Pico için resmi CircuitPython 10.3.1 firmware'ini, circuitpython.org'un yayınladığı .uf2 dosyasının aynısını, bayt bayt aynı şekilde çalıştırır. Web sayfasında Python'unu yorumlayan hiçbir şey yoktur.

Hangi kartlar CircuitPython çalıştırır?

Raspberry Pi Pico; simüle edilmiş ağda WiFi'li Pico W; CircuitPython'ın ona özel derlemesiyle Arduino Nano RP2040 Connect, burada `board.LED` D13'teki LED'dir ve `board.I2C()` A4 ve A5'tedir; ve ESP32-S3-DevKitC-1. Kartın Firmware panelinde CircuitPython (code.py) seçeneğini seç. Aynı Pico, yerine MicroPython (main.py) veya bir Arduino kodu da çalıştırabilir.

Kütüphane yüklemem gerekir mi?

Hayır. Bir programın içe aktardığı, Mokxi'de bulunan Adafruit kütüphaneleri, sırayla gereksinim duyduklarıyla birlikte, circup'un koyacağı gibi Çalıştır'da kendi kendine sürücünün lib/ klasörüne gider.

Bir şey indiriyor mu?

Bir CircuitPython projesinin ilk Çalıştır'ı firmware'i indirir ve tarayıcı onu sonraki her Çalıştır için saklar. Her kütüphane yalnızca bir program onu içe aktardığında indirilir. Bir Arduino kodu hiçbirini indirmez.

Bunu gerçekten kur

Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.