Board mana saja
Biasa Raspberry Pi Pico menjalankan CircuitPython, begitu juga Arduino Nano RP2040 Connect, dengan build CircuitPython sendiri untuknya: RP2040 yang sama, dengan board.LED di D13 (GPIO 6) dan board.I2C() di A4 dan A5. Lihat
Nano RP2040 Connect. The Raspberry Pi Pico W menjalankan build-nya sendiri, dengan chip radio CYW43439 yang dimodelkan, jadi
board.LED lampu dan WiFi berfungsi di jaringan simulasi Mokxi (lihat
WiFi di Pico W). The ESP32-S3-DevKitC-1 juga menjalankan CircuitPython, dengan build sendiri serta REPL dan drive-nya di USB native S3; WiFi tidak disimulasikan di bawah CircuitPython di sana. Pico juga menjalankan MicroPython; lihat Pico.
Yang berjalan adalah CircuitPython 10.3.1 untuk Raspberry Pi Pico, firmware resmi dari Adafruit, byte demi byte persis seperti yang diterbitkan circuitpython.org, di RP2040 simulasi Mokxi. Tidak ada apa pun di halaman ini yang menginterpretasi Python-mu.
Memilihnya di panel Firmware
- Letakkan sebuah Raspberry Pi Pico, Pico W, Arduino Nano RP2040 Connect, atau ESP32-S3-DevKitC-1 di kanvas.
- Buka panel Firmware-nya dan pilih CircuitPython (code.py).
- File di board menjadi
code.py. Jika berisi karyamu sendiri, kamu akan ditanya dulu. Tulis programmu di sana dan tekan Jalankan.
Board yang filenya berisi code.py dan tanpa .ino menjalankan CircuitPython. Sketch Arduino atau proyek MicroPython di board yang sama berjalan seperti biasa, dan tidak ada bagian CircuitPython yang dimuat untuk itu.
Pertama kali menjalankan proyek CircuitPython, firmware-nya diunduh, dan browser menyimpannya untuk setiap Run berikutnya. Sketch Arduino tidak pernah mengunduhnya.
Drive CIRCUITPY dan code.py
CircuitPython menyimpan file-filenya di sebuah drive bernama CIRCUITPY, di flash board. Saat Jalankan, Mokxi menulis drive tersebut sebelum board menyala: boot_out.txt milik firmware, library Adafruit yang diimpor program kamu di bawah lib/, dan setiap tab .py, .txt, .json, .csv, dan .toml kecuali code.py.
Lalu komputer di ujung kabel USB simulasi Pico membuka port serial board dan menyimpan code.py ke drive melalui USB, seperti komputermu sendiri saat kamu menyimpannya dari editor. CircuitPython melihat penyimpanan itu dan memuat ulang, seperti di meja kerja sungguhan, lalu menjalankan code.py dengan Serial Monitor terhubung, sehingga setiap baris yang dicetaknya ditampilkan.
code.py mencetak sekitar dua detik setelah Jalankan. Sebagian besar itu karena CircuitPython sendiri: jendela safe mode satu detik saat boot, saat LED di GP25 berkedip, dan jeda setelah disimpan sebelum dimuat ulang.
microcontroller.reset() dan watchdog mempertahankan drive, jadi code.py berjalan lagi; apa yang dicetaknya sebelum port serial terbuka kembali hilang, seperti di meja kerja sungguhan. Jalankan lagi memulai dari drive yang baru ditulis.
Library
Mokxi membaca baris import-mu dan memasukkan library Adafruit yang ditemukannya ke folder lib/ di drive itu sendiri, bersama apa yang mereka impor pada gilirannya, seperti circup melakukannya. Itu adalah file .mpy hasil kompilasi Adafruit dari bundle CircuitPython 10.x mereka, tanpa perubahan:
adafruit_bme280adafruit_display_text(denganadafruit_ticks)adafruit_displayio_ssd1306adafruit_framebuf(denganfont5x8.bin-nya di paling atas drive)adafruit_hcsr04adafruit_requests(denganadafruit_connection_manager)adafruit_ssd1306neopixel
Masing-masing hanya diunduh saat sebuah program mengimpornya. Tab yang dinamai seperti sebuah library, misalnya neopixel.py, adalah milikmu sendiri dan dipakai sebagai gantinya. Modul bawaan firmware (board, digitalio, analogio, pwmio, busio, time, displayio, terminalio, i2cdisplaybus dan lainnya) tidak butuh apa-apa.
Serial Monitor dan REPL
Serial Monitor adalah port serial USB board, dua arah: apa yang dicetak code.py, traceback-nya, dan Code done running. saat selesai.
- Ctrl-C menghentikan
code.pydenganKeyboardInterrupt. - Tombol apa pun lalu masuk ke REPL, dan
>>>menjawab di sana. - Ctrl-D memuat ulang dan menjalankan
code.pylagi.
Saat sebuah program berhenti karena error, CircuitPython mencetak sebuah traceback. Mokxi membacanya, menandai barisnya di file-mu, dan menjelaskan arti error itu dengan kata-kata CircuitPython: modul MicroPython di program CircuitPython, pull-up yang hilang, pin yang sudah dipakai, atau board.I2C(), yang tidak dimiliki Pico (pakai busio.I2C(board.GP5, board.GP4)).
Apa yang berfungsi, dan apa yang tidak
digitalio, analogio, pwmio, busio.I2C dan busio.UART berfungsi, jadi adafruit_bme280, adafruit_ssd1306 dan displayio dengan adafruit_display_text bisa berkomunikasi dengan komponen di kanvas.
PIO juga berjalan, jadi neopixel_write dan library neopixel menyalakan strip WS2812, dan pulseio.PulseIn membaca echo yang dihitung waktunya oleh adafruit_hcsr04 untuk sebuah HC-SR04.
Tidak disimulasikan: inti kedua; audiobusio, audiopwmio, dan picodvi; serta membaca drive dari komputer, yang hanya bisa menyimpan ke sana.
WiFi di Pico W
wifi.radio.connect() bergabung dengan access point simulasi Mokxi. Nama dan kata sandinya adalah properti WiFi board, yang awalnya Mokxi-Lab dan breadboard. socketpool dan adafruit_requests (yang ditaruh editor di lib/ bersama adafruit_connection_manager yang dibutuhkannya) dapat mengakses situs .mokxi buatan, seperti 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())
Nama lain tidak ditemukan, dan https:// tidak punya tujuan. Tidak disimulasikan: Bluetooth, klien mode access point, dan penghematan daya. wifi.radio.ap_info memunculkan NotImplementedError, karena port CircuitPython untuk Pico W tidak mengimplementasikannya.
Mengimpor dari Wokwi
Proyek Wokwi untuk Pico, Pico W, Nano RP2040 Connect, atau ESP32-S3-DevKitC-1 dengan code.py diimpor dengan boardnya diatur ke CircuitPython, dan berjalan. Di board lain
code.py disimpan sebagai teks, dan proses impor menjelaskan alasannya. Wokwi mungkin memakai versi CircuitPython lain; laporan impor menyebutkan versi mana yang berjalan di sini. Lihat
Pindah dari Wokwi.
Di board sungguhan
Board CircuitPython tidak perlu build. Pasang CircuitPython di Pico (tahan BOOTSEL saat kamu mencolokkannya, lalu seret .uf2 dari circuitpython.org/board/raspberry_pi_pico ke drive RPI-RP2), kemudian simpan code.py ke drive CIRCUITPY yang muncul, dan salin library yang diimpornya ke CIRCUITPY/lib (circup install melakukannya untukmu).
Di Pico W, seret .uf2 dari circuitpython.org/board/raspberry_pi_pico_w sebagai gantinya, dan masukkan nama serta kata sandi jaringanmu sendiri di code.py. Di Nano RP2040 Connect, hubungkan REC ke GND dengan jumper saat mencolokkannya, lalu seret .uf2 dari circuitpython.org/board/arduino_nano_rp2040_connect. Di ESP32-S3-DevKitC-1, colokkan port USB-nya (yang bertanda USB, bukan UART) dan gunakan installer di circuitpython.org/board/espressif_esp32s3_devkitc_1_n8.
Pemula
Proyek awal di Pico, masing-masing di halamannya sendiri: blink, sebuah tombol, pelangi NeoPixel, sebuah BME280 dan teks di OLED SSD1306. Simulator CircuitPython menuntunmu melaluinya.
Di tempat lain
- Board-nya: Raspberry Pi Pico, Pico W, Nano RP2040 Connect dan ESP32-S3-DevKitC-1
- Halaman board: /boards/pico dan /boards/pico-w
- Kontrak Arduino chip ini: model Raspberry Pi Pico
- MicroPython di ESP32: MicroPython di ESP32