المحرر

تشغيل برنامج ثابت جاهز

شغّل بناء Pico SDK أو ESP-IDF على Pico أو ESP32 أو ESP32-S3، بالطريقة التي يشغّل بها Wokwi الملف المذكور في wokwi.toml.

يبني Mokxi كودات Arduino بنفسه عندما تضغط تشغيل. أما البرنامج المكتوب لـ Raspberry Pi Pico SDK ‏(C أو C++ مع pico/stdlib.h) أو لـ ESP-IDF ‏(app_main)، أو بلغة Rust مع esp-hal أو esp-idf-hal، فلا يُبنى هنا: تبنيه على حاسوبك ثم تعطي Mokxi الملف الناتج عن البناء. بعدها تُقلع اللوحة به تمامًا كما تفعل اللوحة الحقيقية بعد كتابة الملف عليها.

ارفع برنامجًا ثابتًا

  1. ضع لوحة Raspberry Pi Pico (تعمل Pico W أو Arduino Nano RP2040 Connect أيضًا)، أو لوحة ESP32 أو ESP32-S3، في مساحة العمل ثم اضغط عليها.
  2. في خصائصها، افتح program واختر Upload firmware (يحدد هذا أنواع الملفات التي تقبلها اللوحة، مثل .uf2, .elf).
  3. اختر الملف الذي أنشأه البناء، ثم اضغط تشغيل.

الملفات التي تقبلها كل لوحة:

اللوحة الملفات كيف يبدأ التشغيل
Pico, Pico W, Nano RP2040 Connect .uf2, .elf عبر ذاكرة القراءة للإقلاع (boot ROM) والمرحلة الثانية الخاصة بالصورة، تمامًا كما لو نسختَ الملف إلى محرّك أقراص اللوحة
ESP32 DevKit V1, DevKitC, LOLIN32 Lite .bin, .elf كما بعد idf.py flash: التطبيق عند 0x10000، أو صورة مدمجة وضعها البناء في موضعها
ESP32-S3 DevKitC-1, XIAO ESP32-S3, Nano ESP32 .bin, .elf بالطريقة نفسها

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 استيراد: أفلته على صفحة الاستيراد وسينفتح المشروع واللوحة تشغّله.

على لوحة Pico تعرض الشاشة التسلسلية كلا المخرجين التسلسليين في Pico SDK:‏ UART0 على GP0 وGP1 بسرعة 115200 baud‏ (pico_enable_stdio_uart) ومنفذ USB التسلسلي (pico_enable_stdio_usb). وعلى ESP32 أو ESP32-S3 يكون ذلك UART0، وهو المنفذ الذي تسجّل الشريحة رسائلها عليه. وما تكتبه يصل إلى اللوحة في الحالتين.

يُحفظ ملف .elf كصورة تُقلع منها اللوحة، من دون معلومات التنقيح، لذا فملف .elf كبير عادةً يتّسع. الحد الأقصى لحجم الملف المحفوظ هو 2 MB. أما الملف المبني لشريحة أخرى فيُرفض مع جملة تذكر الشريحة التي بُني لأجلها.

ابنِ واحدًا على حاسوبك

ثبّت Pico SDK بالطريقة الموضحة في دليل Raspberry Pi Getting started with the Raspberry Pi Pico، أو استخدم إضافة Raspberry Pi Pico لبرنامج VS Code، فهي تُعدّ لك الـ SDK والمترجم. ثم، في مجلد مشروعك:

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

تُنتج عملية البناء <your program>.uf2 و<your program>.elf داخل build/. ارفع أيًّا منهما. بعد تعديل الكود، أعد البناء وارفع الملف الجديد: فـ Mokxi يشغّل الملف الذي أعطيته إياه، لا الكود الموجود في المحرر.

أما بالنسبة لـ ESP32 أو ESP32-S3، فثبّت ESP-IDF بالطريقة الموضحة في دليل Espressif Get Started، ثم في مجلد مشروعك:

idf.py set-target esp32
idf.py build

ينتج عن ذلك build/<your project>.bin وbuild/<your project>.elf. ارفع أيًّا منهما. الصورة المدمجة (esptool merge-bin) تعمل أيضًا، وكذلك البناء بلغة Rust: cargo build --release مع esp-hal (bare metal) أو esp-idf-hal، ثم ملف ELF من target/، أو ملف .bin الذي يكتبه espflash save-image.

من Wokwi

يحدّد مشروع Wokwi for VS Code اسم ملف البناء في wokwi.toml (firmware = 'build/blink.uf2' للـ Pico، وfirmware = 'build/flasher_args.json' لـ ESP-IDF). استورد المشروع مع تضمين ذلك الملف في الرفع (أسهل طريقة هي ملف zip لكامل المجلد، بما فيه build/) وستشغّله اللوحة: يخبرك تقرير الاستيراد بأي ملف تم استخدام. وبدون الملف، يخبرك التقرير بأي ملف عليك إضافته.

ما يعمل، وما لا يعمل بعد

على Pico، يُحاكى كل من boot ROM والفلاش والساعات والمؤقت وUART وGPIO وPWM وADC وI2C وSPI وDMA وPIO وUSB وwatchdog، لذا تعمل معظم أمثلة Pico SDK كما هي، بما فيها LED من نوع WS2812 عبر ws2812.pio. أما على Pico W فيُحاكى CYW43439 كما تستخدمه إصدارات MicroPython وCircuitPython الرسمية عبر cyw43-driver، وهو المشغّل الذي يربطه pico_cyw43_arch، ويتصل بشبكة Mokxi المحاكاة؛ أما Bluetooth وعملاء وضع نقطة الوصول وتوفير الطاقة وTLS فلا تُحاكى. ما لا يعمل:

  • النواة الثانية. multicore_launch_core1 يوقف اللوحة.
  • ساعة النظام دائمًا 125 MHz، مهما طلب set_sys_clock_khz.

على ESP32 وESP32-S3، يُقلع البرنامج الثابت على نموذج للشريحة كاملة، بالنواتين معًا: mask ROM والفلاش خلف الذاكرة المخبئية والمؤقتات ومصفوفة المقاطعات وGPIO وLEDC وRMT وI2C وSPI masters ومنافذ UART وADC1. تعمل أمثلة ESP-IDF نفسها مثل hello_world وblink وGPIO وLEDC وFreeRTOS، وتعمل أيضًا عمليات البناء بلغة Rust. ما لا يعمل:

  • Wi-Fi وBluetooth. مشغّلاتهما مكتبات مغلقة من Espressif تشغّل راديوًا بلا سجلات علنية، لذا فإن أي برنامج ثابت يبدأ بأحدهما يتوقف عند الراديو مع سطر في الشاشة التسلسلية يوضح ذلك. (أما Wi-Fi في كود Arduino فيعمل: Mokxi يبنيه مقابل بيئة التشغيل الخاصة به.)
  • أي وحدة طرفية غير موجودة في النموذج (I2S، وعداد النبضات، وPWM للتحكم بالمحركات، وTWAI، وSD/MMC، ومعجّلات التشفير) يوقف اللوحة مع سطر يذكر اسمها، بدلًا من أن يعمل على سجلات لا تحفظ إلا ما كُتب فيها.
  • السبات الخفيف والعميق، وذاكرة PSRAM، لا تُحاكى.

لوحتا ESP32-C3 وESP32-C6 لا تشغّلان بعد برامج ESP-IDF المبنية: بل تشغّلان أكواد Arduino المبنية هنا.