Düzenleyici

Hazır bir firmware çalıştır

Pico, ESP32 veya ESP32-S3 üzerinde Wokwi'nin wokwi.toml dosyasında adı geçen şekilde bir Pico SDK veya ESP-IDF derlemesi çalıştır.

Mokxi, Çalıştır'a bastığında Arduino kodlarını kendisi derler. Raspberry Pi Pico SDK (C veya pico/stdlib.h ile C++) veya ESP-IDF (app_main) için yazılmış bir program, ya da esp-hal veya esp-idf-hal ile Rust'ta yazılmış bir program burada derlenmez: kendi bilgisayarında derler ve derlemenin ürettiği dosyayı Mokxi'ye verirsin. Kart, dosya kendisine yazıldıktan sonra gerçek kartın yaptığı gibi tam olarak onu başlatır.

Firmware yükle

  1. Tuvalin üzerine bir Raspberry Pi Pico (Pico W veya Arduino Nano RP2040 Connect de olur), bir ESP32 ya da ESP32-S3 kartı koy ve üzerine tıkla.
  2. Özelliklerinde program seçeneğini aç ve Firmware yükle'yi seç (kabul edilen dosya adlarını listeler, örneğin .uf2, .elf).
  3. Derlemenin oluşturduğu dosyayı seç ve Çalıştır'a bas.

Her kart hangi dosyaları kabul eder:

Kart Dosyalar Nasıl açılır
Pico, Pico W, Nano RP2040 Connect .uf2, .elf boot ROM ve kalıbın kendi ikinci aşaması üzerinden, tıpkı dosyayı kartın sürücüsüne kopyaladıktan sonraki gibi
ESP32 DevKit V1, DevKitC, LOLIN32 Lite .bin, .elf idf.py flash sonrasındaki gibi: uygulama 0x10000 adresinde ya da derlemenin yerleştirdiği birleşik bir kalıp olarak
ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 .bin, .elf aynı şekilde

Other boards offer Upload ELF… in the same place instead: an .elf built for that board elsewhere, for example by arduino-cli. The AVR boards (Uno, Nano, Mega 2560, Leonardo, Pro Mini, ATtiny85) also take a raw .bin flash image. A .hex from the Arduino IDE's Export Compiled Binary opens through İçe aktar ile açılır: İçe aktarma sayfasına bırak ve proje, kart onu çalıştırarak açılır.

Bir Pico'da seri monitör, Pico SDK'nın iki seri çıkışını da gösterir: GP0 ve GP1 pinlerindeki UART0, 115200 baud hızında (pico_enable_stdio_uart) ve USB seri portu (pico_enable_stdio_usb). ESP32 veya ESP32-S3'de bu, çipin günlükleri yazdığı UART0'dır. Yazdığın her şey her durumda karta gider.

Bir .elf, hata ayıklama bilgisi olmadan kartın açtığı kalıp olarak tutulur, bu yüzden büyük bir .elf genellikle sığar. Tutulan dosya en fazla 2 MB olabilir. Başka bir çip için derlenmiş bir dosya, hangi çip için derlendiğini belirten bir cümle ile reddedilir.

Bilgisayarında bir tane derle

Pico SDK'yı Raspberry Pi'nin Raspberry Pi Pico ile başlangıç kılavuzundaki gibi kur, ya da SDK'yı ve derleyiciyi senin yerine hazırlayan VS Code için Raspberry Pi Pico eklentisini kullan. Ardından projenin klasöründe:

mkdir build
cd build
cmake .. -DPICO_BOARD=pico
make

Derleme, <program adın>.uf2 ve <program adın>.elf dosyalarını build/ klasöründe bırakır. İkisinden birini yükle. Kodu değiştirdikten sonra yeniden derle ve yeni dosyayı yükle: Mokxi, düzenleyicideki kodu değil, verdiğin dosyayı çalıştırır.

Bir ESP32 veya ESP32-S3 için, ESP-IDF'yi Espressif'ın Başlangıç kılavuzundaki gibi kur, ardından projenin klasöründe:

idf.py set-target esp32
idf.py build

Bu işlem build/<proje adın>.bin ve build/<proje adın>.elf dosyalarını bırakır. İkisinden birini yükle. Birleştirilmiş bir imge (esptool merge-bin) da çalışır, Rust derlemesi de: esp-hal (bare metal) veya esp-idf-hal ile cargo build --release, sonra target/ içindeki ELF ya da .bin dosyasını yazan espflash save-image.

Wokwi'den

Bir Wokwi for VS Code projesi derlemesinin adını wokwi.toml içinde belirtir (Pico için firmware = 'build/blink.uf2', ESP-IDF için firmware = 'build/flasher_args.json'). Projeyi o dosya yüklemeye dahil olacak şekilde içe aktar (tüm klasörün bir zip'i, build/ dahil, en kolayı) ve kart onu çalıştırır: içe aktarma raporu hangi dosyayı aldığını söyler. Dosya yoksa, rapor hangisini eklemen gerektiğini söyler.

Neler çalışıyor, neler henüz çalışmıyor

Pico'da boot ROM, flash, saatler, zamanlayıcı, UART, GPIO, PWM, ADC, I2C, SPI, DMA, PIO, USB ve watchdog'un tümü simüle edilir, dolayısıyla Pico SDK örneklerinin çoğu olduğu gibi çalışır, ws2812.pio ile WS2812 LED'ler dahil. Pico W'de CYW43439, resmi MicroPython ve CircuitPython derlemelerinin onu cyw43-driver üzerinden kullanması ve pico_cyw43_arch sürücüsünü bağlaması için modellenir; böylece kart Mokxi'nin simüle edilmiş ağına katılır. Bluetooth, erişim noktası modunun istemcileri, güç tasarrufu ve TLS simüle edilmez. Çalışmayanlar:

  • İkinci çekirdek. multicore_launch_core1 kartı durdurur.
  • Sistem saati her zaman 125 MHz'dir, set_sys_clock_khz ne isterse istesin.

ESP32 ve ESP32-S3'te firmware, iki çekirdek dahil tüm çipin bir modeli üzerinde başlar: mask ROM, önbelleğin arkasındaki flash, zamanlayıcılar, kesme matrisi, GPIO, LEDC, RMT, I2C, SPI master'ları, UART'lar ve ADC1. ESP-IDF'nin kendi hello_world, blink, GPIO, LEDC ve FreeRTOS örnekleri çalışır, Rust derlemeleri de öyle. Çalışmayanlar:

  • Wi-Fi ve Bluetooth. Sürücüleri, herkese açık kayıtları olmayan bir radyoyu kullanan Espressif'ın kapalı kütüphaneleridir; bu yüzden ikisinden birini başlatan bir firmware, radyoda durur ve Seri Monitör'de bunu belirten bir satır görünür. (Bir Arduino kodunun Wi-Fi'si çalışır: Mokxi onu kendi çalışma zamanına karşı derler.)
  • Modelde olmayan bir çevre birimi (I2S, pulse counter, motor kontrol PWM'i, TWAI, SD/MMC, şifreleme hızlandırıcıları) kartı, adını belirten bir satırla durdurur; yalnızca yazılanı hatırlayan kayıtlar üzerinde çalıştırmaz.
  • Hafif ve derin uyku ile PSRAM simüle edilmez.

ESP32-C3 ve ESP32-C6 kartları henüz bir ESP-IDF derlemesini çalıştırmaz: burada derlenen Arduino kodlarını çalıştırırlar.