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
- 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.
- Özelliklerinde program seçeneğini aç ve Firmware yükle'yi seç (kabul edilen dosya adlarını listeler, örneğin
.uf2, .elf). - 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_core1kartı durdurur. - Sistem saati her zaman 125 MHz'dir,
set_sys_clock_khzne 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.
Related
- Kod ve derleme: Mokxi'nin kendi derlediği Arduino kodları.
- VS Code ve GitHub ile Mokxi: VS Code'tan bir Wokwi veya PlatformIO derlemesi çalıştır.
- Bir programı gerçek karta göndermek