أي اللوحات
عدة لوحات توفّر خيار MicroPython (main.py) في لوحة البرنامج الثابت. هذه الصفحة عن لوحات ESP32 الكلاسيكية: DOIT DevKit V1 وDevKitC وLOLIN32 Lite. أما البقية فتشغّل الإصدار الرسمي لشريحتها بالطريقة نفسها:
- ESP32-S3: الـ ESP32-S3-DevKitC-1, XIAO ESP32-S3 و Arduino Nano ESP32.
- ESP32-C3: ESP32-C3-DevKitM-1، XIAO ESP32-C3 و ESP32-C3 SuperMini.
- ESP32-C6: ESP32-C6-DevKitC-1 و XIAO ESP32-C6.
- RP2040: Raspberry Pi Pico و لوحة Pico W.
تستخدم Cheap Yellow Display وT-Display وD1 R32 شريحة ESP32 الكلاسيكية أيضاً، لكنها تشغّل كود Arduino فقط.
ما يعمل هو MicroPython v1.29.0 لـ ESP32، الإصدار الرسمي أحادي النواة، بايتاً ببايت كما ينشره micropython.org، على نموذج Mokxi للشريحة كاملة، مُقلعاً من ذاكرة ROM الأصلية من Espressif. لا شيء في هذه الصفحة يفسّر كود Python الخاص بك.
اختياره في لوحة البرنامج الثابت
- ضع ESP32 DevKit V1 أو DevKitC أو LOLIN32 Lite على مساحة العمل.
- افتح لوحة البرنامج الثابت واختر MicroPython (main.py).
- تصبح ملفات اللوحة ملف
main.py. اكتب برنامجك هناك واضغط «تشغيل».
اللوحة التي تحتوي ملفاتها على main.py بلا ملف .ino تشغّل MicroPython. وكود Arduino على اللوحة نفسها يعمل كما كان، ولا يُحمَّل له أي شيء من MicroPython.
أول ضغطة على «تشغيل» لمشروع MicroPython على ESP32 تنزّل البرنامج الثابت وذاكرة ROM الخاصة بالشريحة، 1.4 MB، ويحتفظ بها المتصفح لكل تشغيل لاحق. أما كود Arduino فلا ينزّلها أبداً.
ما يفعله «تشغيل» بـ main.py
يقوم «تشغيل» بإقلاع البرنامج الثابت، والحاسوب في نهاية كابل USB المُحاكى المتصل باللوحة ينسخ ملفات .py الخاصة بك إلى اللوحة كما تفعل Thonny وmpremote: يدخل وضع REPL الخام عبر المنفذ التسلسلي للوحة، ويكتب كل ملف في ذاكرة الفلاش، ثم يعيد الإقلاع برمجياً. تطبع اللوحة MPY: soft reboot، ثم تشغّل boot.py ثم main.py.
تُنسخ كل تبويبات .py و.txt و.json و.csv، لذا يوضع مُشغِّل مثل ssd1306.py من مكتبة micropython-lib في تبويب خاص به بجانب main.py، فيجده أمر import ssd1306.
زر EN وmachine.reset() يحتفظان بالملفات، فيعمل main.py من جديد، كما على المنضدة. أما «تشغيل» من جديد فيبدأ من شريحة فارغة.
الشاشة التسلسلية وREPL
ابتداءً من MPY: soft reboot، تصبح الشاشة التسلسلية هي UART0 للوحة، في الاتجاهين. كل ما يقوله print() يظهر هناك. وعندما ينتهي main.py، أو توقفه بـ Ctrl-C، يجيبك REPL هناك: اكتب تعبيراً واضغط Enter.
عندما يتوقف البرنامج بخطأ، يطبع MicroPython تقرير التتبع. يقرأه Mokxi، ويحدد السطر في ملفك، ويشرح ما يعنيه الخطأ عادةً، كما يفعل على لوحة Pico.
ما يعمل
machine.Pin مع المقاطعات، وPWM (وحدة LEDC)، وADC على قنوات ADC1 الثماني بالتوهينات الأربعة، وI2C وSoftI2C، وSPI وSoftSPI، وUART(1) وUART(2) على الأطراف الموصولة بهما، وneopixel، وdht، وonewire وds18x20، وmachine.freq() عند 80 أو 160 أو 240 MHz.
غير محاكى: النوم الخفيف والعميق، وADC2، وذاكرة PSRAM، ووضعي التابع I2C وSPI، وتحكم تدفق UART، والاستقبال عبر RMT، وإعادة ضبط اللوحة بواسطة أجهزة المراقبة (watchdogs). البناء المستخدم أحادي النواة.
WiFi
تنضم network.WLAN إلى نقطة الوصول المحاكاة في Mokxi، وهي نفسها التي تنضم إليها WiFi.begin في كود Arduino. اسمها وكلمة سرها من خصائص WiFi للوحة، وتبدأ باسم Mokxi-Lab وكلمة سر breadboard؛ غيّرهما من خصائص اللوحة، واستخدم القيمتين نفسيهما في wlan.connect(). تحصل اللوحة على العنوان 192.168.4.2 عبر DHCP.
import network, time, urequests
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect("Mokxi-Lab", "breadboard")
while not wlan.isconnected():
time.sleep_ms(250)
r = urequests.get("http://weather.mokxi/")
print(r.json())
r.close()
تصل socket وurequests إلى المواقع الافتراضية للشبكة المحاكاة: time.mokxi وweather.mokxi وecho.mokxi وapi.mokxi. أي اسم آخر لا يُعثر عليه، ولا توجد وجهة لـ https://. تعرض لوحة السحابة ما تطلبه اللوحة.
تشغّل network.WLAN(network.AP_IF) نقطة وصول خاصة باللوحة: تنضم إليها لوحة الويب كهاتف، وتسردها ap.status('stations')، ويفتح خادم socket على المنفذ 80 على http://192.168.4.1/. لتشغيله بجانب وضعية العميل، انقل عنوانه باستخدام ap.ifconfig()، لأن الشبكة المحاكاة هي أيضًا ضمن 192.168.4.0/24.
غير محاكى على الشبكة: عميل ثانٍ على نقطة الوصول، وESP-NOW، وتوفير الطاقة، وTLS، وأي شبكة غير الشبكة المحاكاة.
يغطي WiFi, simulated الشبكة نفسها.
الاستيراد من Wokwi
مشروع Wokwi للوحة ESP32 DevKit V1 أو DevKitC أو LOLIN32 Lite يحتوي على
main.py يُستورد كمشروع MicroPython، مع ضبط لوحته على MicroPython. تُسمى شبكة اللوحة Wokwi-GUEST بلا كلمة سر، كما في Wokwi، لذا
wlan.connect("Wokwi-GUEST", "") يعمل كما هو مكتوب. راجع
القادمون من Wokwi.
على لوحة ESP32 حقيقية
لا تحتاج لوحة MicroPython إلى بناء. ضع MicroPython على ESP32 باستخدام esptool (esptool.py --chip esp32 erase_flash، ثم esptool.py --chip esp32 write_flash -z 0x1000 ESP32_GENERIC-UNICORE-20260824-v1.29.0.bin، من micropython.org/download/ESP32_GENERIC)، ثم انسخ main.py إليها باستخدام Thonny أو mpremote. ضع اسم شبكتك وكلمة سرها في wlan.connect(): مواقع .mokxi موجودة في Mokxi فقط.
مشاريع البداية
ستة مشاريع بداية على DevKit V1، كل منها في صفحته: blink، زر مع Pin.irq()، تلاشي باستخدام PWM، حساس DHT22، شاشة OLED من نوع SSD1306 و WiFi والطقس. محاكي ESP32 لـ MicroPython يشرح الستة جميعها.
في مواضع أخرى
- اللوحات: ESP32 DevKit V1، لوحة DevKitC و لوحة LOLIN32 Lite
- MicroPython على Pico: لوحة Pico
- صفحات اللوحات: /boards/esp32-devkit و/boards/esp32-devkitc
- عقد Arduino للشريحة: نموذج ESP32 DevKit