Kartlar

Pico'da CircuitPython

Bir Pico üzerinde resmi CircuitPython firmware'i ile code.py dosyasını çalıştır: Firmware paneli, CIRCUITPY sürücüsü, kütüphaneler, REPL ve Wokwi içe aktarmaları.

Hangi kartlar

Düz Raspberry Pi Pico CircuitPython çalıştırır, aynı şekilde Arduino Nano RP2040 Connect, CircuitPython'un ona özel derlemesiyle: aynı RP2040, şununla birlikte: board.LED üzerinde D13 (GPIO 6) ve board.I2C() üzerinde A4 ve A5. Bkz. Nano RP2040 Connect. O Raspberry Pi Pico W kendi derlemesini çalıştırır, CYW43439 radyo çipi modellendiği için board.LED LED'i yanar ve WiFi, Mokxi'nin simüle edilmiş ağında çalışır (bkz. Pico W'de WiFi). O ESP32-S3-DevKitC-1 da CircuitPython çalıştırır, kendi derlemesiyle ve REPL ile sürücüsü S3'ün yerel USB'sinde; orada CircuitPython altında WiFi simüle edilmez. Pico MicroPython da çalıştırır; bkz. Pico.

Çalışan şey, Raspberry Pi Pico için CircuitPython 10.3.1'dir: resmi Adafruit firmware'i, circuitpython.org'un yayınladığıyla bayt bayt aynı, Mokxi'nin simüle edilmiş RP2040'sında. Sayfadaki hiçbir şey Python kodunu yorumlamaz.

Firmware panelinde seçmek

  1. Tuvale bir Raspberry Pi Pico, bir Pico W, bir Arduino Nano RP2040 Connect veya bir ESP32-S3-DevKitC-1 koy.
  2. Kartın Firmware panelini aç ve CircuitPython (code.py) seçeneğini seç.
  3. Kartın dosyaları bir code.py olur. Kendi çalışman varsa önce sana sorulur. Programını oraya yaz ve Çalıştır'a bas.

Dosyalarında code.py olan ve .ino olmayan bir kart CircuitPython çalıştırır. Aynı karttaki bir Arduino kodu veya MicroPython projesi önceki gibi çalışır ve onun için CircuitPython'dan hiçbir şey yüklenmez.

Bir CircuitPython projesinin ilk Çalıştır'ı firmware'i indirir ve tarayıcı onu sonraki her Çalıştır için saklar. Bir Arduino kodu onu asla indirmez.

CIRCUITPY sürücüsü ve code.py

CircuitPython dosyalarını, kartın flash belleğindeki CIRCUITPY adlı bir sürücüde tutar. Çalıştır'da Mokxi, kart açılmadan önce o sürücüyü yazar: firmware'in kendi boot_out.txt dosyası, programının lib/ altına import ettiğin Adafruit kütüphaneleri ve code.py dışındaki tüm .py, .txt, .json, .csv ve .toml sekmeleri.

Sonra Pico'nun simüle edilmiş USB kablosunun ucundaki bilgisayar kartın seri portunu açar ve code.py dosyasını kendi bilgisayarının düzenleyiciden kaydederken yaptığı gibi USB üzerinden sürücüye kaydeder. CircuitPython kaydı görür, masada yaptığı gibi yeniden yüklenir ve code.py dosyasını Seri Monitör bağlıyken çalıştırır, böylece bastığı her satır görünür.

code.py, Çalıştır'dan yaklaşık iki saniye sonra yazdırır. Bunun çoğu CircuitPython'un kendisidir: önyüklemede GP25'teki LED yanıp sönerken bir saniyelik güvenli mod penceresi ve yeniden yüklemeden önceki kayıt sonrası bekleme.

microcontroller.reset() ve watchdog sürücüyü korur, böylece code.py yeniden çalışır; seri port yeniden açılmadan önce yazdırdıkları, masada olduğu gibi kaybolur. Yeniden çalıştır, yeni yazılmış bir sürücüyle başlar.

Kütüphaneler

Mokxi import satırlarını okur ve bulduğu Adafruit kütüphanelerini, circup yapacağı gibi, onların da import ettiği şeylerle birlikte kendi başına sürücünün lib/ klasörüne koyar. Bunlar Adafruit'in kendi CircuitPython 10.x paketinden derlenmiş, değiştirilmemiş .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
  • neopixel

Her biri yalnızca bir program onu import ettiğinde indirilir. Bir kütüphanenin adını taşıyan sekme, örneğin neopixel.py, senindir ve onun yerine kullanılır. Firmware'e hazır modüller (board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus ve diğerleri) hiçbir şey gerektirmez.

Seri monitör ve REPL

Seri Monitör, kartın USB seri portudur, iki yönlü: code.py dosyasının yazdırdıkları, traceback'leri ve bitince Code done running. mesajı.

  • Ctrl-C, code.py dosyasını bir KeyboardInterrupt ile durdurur.
  • Herhangi bir tuş REPL'e girer ve orada >>> yanıtlar.
  • Ctrl-D yeniden yükler ve code.py dosyasını tekrar çalıştırır.

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

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

digitalio, analogio, pwmio, busio.I2C ve busio.UART çalışır, böylece adafruit_bme280, adafruit_ssd1306 ve adafruit_display_text ile birlikte displayio, tuvaldeki parçalarla iletişim kurabilir.

PIO da çalışır, yani neopixel_write ve neopixel kütüphanesi bir WS2812 şeridini yakar ve pulseio.PulseIn, adafruit_hcsr04 ile bir HC-SR04'ün ölçtüğü echo'yu okur.

Simüle edilmedi: ikinci çekirdek; audiobusio, audiopwmio ve picodvi; ve bilgisayardan sürücüyü okumak, bilgisayar sadece ona kaydeder.

Pico W'de WiFi

wifi.radio.connect(), Mokxi'nin simüle edilmiş erişim noktasına bağlanır. Adı ve parolası, kartın WiFi özellikleridir ve başlangıçta Mokxi-Lab ve breadboard'dur. socketpool ve adafruit_requests (düzenleyicinin ihtiyaç duyduğu adafruit_connection_manager ile lib/ içine koyduğu), uydurma .mokxi sitelerine, örneğin http://weather.mokxi/ adresine ulaşır:

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())

Başka herhangi bir ad bulunamaz ve https:// gidecek bir yer bulamaz. Simüle edilmedi: Bluetooth, erişim noktası modunun istemcileri ve güç tasarrufu. wifi.radio.ap_info, NotImplementedError yükseltir çünkü CircuitPython'un Pico W portu onu uygulamaz.

Wokwi'den içe aktarma

Wokwi'den bir Pico, Pico W, Nano RP2040 Connect veya ESP32-S3-DevKitC-1 projesi, şunu içeriyorsa: code.py kartı CircuitPython'a ayarlıyken import edilir ve çalışır. Başka bir kartta ise code.py metin olarak saklanır ve import nedenini söyler. Wokwi başka bir CircuitPython sürümü kullanmış olabilir; import raporu burada hangisinin çalıştığını söyler. Bak: Wokwi'den geliyorsun.

Gerçek bir kartta

Bir CircuitPython kartı derleme gerektirmez. Pico'ya CircuitPython'u koy (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), sonra code.py dosyasını beliren CIRCUITPY sürücüsüne kaydet ve import ettiği kütüphaneleri CIRCUITPY/lib içine kopyala (circup install bunu senin için yapar).

Bir Pico W'de bunun yerine circuitpython.org/board/raspberry_pi_pico_w adresindeki .uf2 dosyasını sürükle ve code.py içine kendi ağının adını ve parolasını koy. Bir Nano RP2040 Connect'te takarken REC'yi GND'ye köprüle ve circuitpython.org/board/arduino_nano_rp2040_connect adresindeki .uf2 dosyasını sürükle. ESP32-S3-DevKitC-1'de USB portunu tak (UART değil, USB yazan) ve circuitpython.org/board/espressif_esp32s3_devkitc_1_n8 adresindeki yükleyiciyi kullan.

Başlangıç projeleri

Pico'daki başlangıç projeleri, her biri kendi sayfasında: blink, bir buton, bir NeoPixel gökkuşağı, bir BME280 ve bir SSD1306 OLED'de yazı. CircuitPython simülatörü onların üzerinden geçer.

Başka yerlerde