تعلّم

محاكي MicroPython للوحة ESP32: البرنامج الثابت الرسمي، عبر الإنترنت

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32 DevKit: وميض LED بلغة MicroPythonمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
اضغط «تشغيل». يقلع البرنامج الثابت الرسمي لـ MicroPython، ويُنسخ main.py إلى اللوحة، فيومض GPIO 2 كلا LED.

يشغّل Mokxi لغة MicroPython على لوحات ESP32 الكلاسيكية: DOIT DevKit V1 وDevKitC وLOLIN32 Lite. ضع واحدة على مساحة العمل، واختر MicroPython (main.py) في لوحة البرنامج الثابت، واكتب main.py ثم اضغط «تشغيل». ما يعمل هو البرنامج الثابت الرسمي MicroPython v1.29.0 للوحة ESP32، نفس الملف الذي ينشره micropython.org، على نموذج Mokxi للشريحة كاملة، مقلعًا من ذاكرة ROM المقنّعة الخاصة بـ Espressif نفسها. لا شيء في الصفحة يفسّر كود Python الخاص بك.

عند الضغط على «تشغيل»، ينسخ الحاسوب في طرف كابل USB المحاكى الخاص باللوحة ملفات .py الخاصة بك إلى فلاش اللوحة بالطريقة نفسها التي يفعلها Thonny وmpremote، ثم يعيد تشغيلها تشغيلًا خفيفًا. يطبع MicroPython عبارة MPY: soft reboot ويشغّل main.py. كل ما يقوله print() يظهر في الشاشة التسلسلية، وعندما ينتهي main.py، أو توقفه بـ Ctrl-C، يعود REPL للإجابة هناك.

الدائرة أعلاه هي أولى ست دوائر تمهيدية أدناه: GPIO 2 يومض LED اللوحة الأزرق وLED أحمر موصولًا بـ D2، وتقول الشاشة التسلسلية on وoff.

وميض باستخدام machine.Pin

Pin(2, Pin.OUT) هو GPIO 2، وهو في DevKit V1 موصول بـ LED اللوحة الأزرق وبطرف التوصيلة D2. يمر LED الأحمر على D2 عبر مقاومة 220 أوم إلى الأرض، فيضيءان معًا وينطفئان معًا.

main.py: وميض LED
# MicroPython on an ESP32 DevKit: blink an LED.
# GPIO 2 is the DevKit's own blue LED, and the red LED wired to D2 through
# 220 ohms blinks with it.
from machine import Pin
import time

led = Pin(2, Pin.OUT)

while True:
    led.value(1)
    print("on")
    time.sleep_ms(500)
    led.value(0)
    print("off")
    time.sleep_ms(500)

زر باستخدام Pin.irq()

A button from D15 to ground, with the pin’s own pull-up: the pin reads 1 until the button is pressed, and Pin.IRQ_FALLING calls the handler when it goes to 0. A real button bounces, and so does this one, so the handler only sets a flag. The main loop waits 20 ms for the contacts to settle and counts a press only if the pin is still 0. Pressed three times, it prints presses 1, presses 2 and presses 3, once each, and toggles the board’s LED with each press.

main.py: عدّ الضغطات بمقاطعة
# MicroPython on an ESP32 DevKit: count button presses with an interrupt.
# The button joins D15 to ground. The pin's own pull-up holds it at 1, so a
# press pulls it to 0 and IRQ_FALLING calls pressed().
from machine import Pin
import time

led = Pin(2, Pin.OUT)                       # the DevKit's blue LED
button = Pin(15, Pin.IN, Pin.PULL_UP)
presses = 0
flag = False

def pressed(pin):
    global flag
    flag = True                             # keep a handler short: set a flag

button.irq(trigger=Pin.IRQ_FALLING, handler=pressed)
print("Press the button")

while True:
    if flag:
        time.sleep_ms(20)                   # let the contacts stop bouncing
        flag = False
        if button.value() == 0:             # still down: a real press
            presses += 1
            led.value(not led.value())
            print("presses", presses)
    time.sleep_ms(5)

أخِف LED باستخدام PWM

PWM(Pin(4), freq=1000) هو أحد قنوات LEDC في ESP32 على D4، وduty_u16() يقبل من 0 إلى 65535. ترفع الحلقة قيمة الدورة وتخفضها، فيزداد سطوع LED ويخفت بخطوات صغيرة: يتنفس بدلًا من أن يومض.

main.py: LED يتنفس
# MicroPython on an ESP32 DevKit: an LED that breathes.
# The LED on D4 is driven by PWM at 1 kHz; the duty goes up and down
# from 0 to 65535 in steps, so the LED fades in and out.
from machine import Pin, PWM
import time

led = PWM(Pin(4), freq=1000)

while True:
    for duty in range(0, 65536, 2048):
        led.duty_u16(duty)
        time.sleep_ms(20)
    for duty in range(65535, -1, -2048):
        led.duty_u16(duty)
        time.sleep_ms(20)
    print("breath")

حساس DHT22 مع وحدة dht

وحدة dht الخاصة بـ MicroPython تقرأ DHT22 على D4، بتًا بتًا عبر الطرف، كما على لوحة حقيقية. عند ضبط القطعة على 23.5 C و41% يطبع Temperature: 23.5 C Humidity: 41.0 %، وعند تغيير الحرارة على القطعة تتبعها القراءة التالية.

main.py: حساس DHT22
# MicroPython on an ESP32 DevKit: a DHT22 temperature and humidity sensor.
# DATA is on D4; the module has its own pull-up.
from machine import Pin
import dht
import time

sensor = dht.DHT22(Pin(4))
time.sleep(2)                    # the DHT22 needs a moment after power-up

while True:
    try:
        sensor.measure()
        print("Temperature: %.1f C  Humidity: %.1f %%" % (sensor.temperature(), sensor.humidity()))
    except OSError as e:
        print("Could not read the DHT22:", e)
    time.sleep(2)                # a DHT22 gives a new reading every two seconds

شاشة OLED من نوع SSD1306 عبر I2C

I2C(0, scl=Pin(22), sda=Pin(21)) هي أول كتلة I2C في ESP32 على الطرفين اللذين تستخدمهما أغلب شروحات ESP32. يجد scan() شاشة OLED ويطبع I2C: ['0x3c']. أضف ملف ssd1306.py من micropython-lib كتبويب بجانب main.py فيُنسخ إلى اللوحة معه، كما كان Thonny سيفعل؛ ثم يرسم البرنامج سطرين من نص وعدادًا يزيد مرة كل ثانية.

main.py: نص على شاشة SSD1306 OLED
# MicroPython on an ESP32 DevKit: an SSD1306 OLED on I2C.
# SCL is on D22 and SDA on D21, the ESP32's usual I2C pins.
# ssd1306.py, micropython-lib's driver, is in its own tab.
from machine import I2C, Pin
import ssd1306
import time

i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=400000)
print("I2C:", [hex(a) for a in i2c.scan()])   # 0x3c, the OLED

oled = ssd1306.SSD1306_I2C(128, 64, i2c)
count = 0

while True:
    oled.fill(0)
    oled.text("Hello, ESP32!", 0, 0)
    oled.text("MicroPython", 0, 16)
    oled.text("count %d" % count, 0, 40)
    oled.show()
    print("count", count)
    count += 1
    time.sleep(1)

شبكة WiFi وطلب HTTP GET باستخدام urequests

ينضم network.WLAN إلى نقطة الوصول المحاكاة في Mokxi. اسمها وكلمة المرور هما خصائص WiFi الخاصة باللوحة، وتبدأ بقيمتي Mokxi-Lab وbreadboard. تحصل اللوحة على عنوانها عبر DHCP وتطبع Connected, IP address 192.168.4.2.

ثم يجلب urequests.get() العنوان http://weather.mokxi/، أحد المواقع الافتراضية في الشبكة المحاكاة، فيطبع البرنامج Mokxi: 21.5 C, 48 % humidity. تعرض لوحة Cloud الطلبات التي ترسلها اللوحة. الشبكة محاكاة: لا يمكن العثور على الأسماء خارج نطاق .mokxi، وhttps:// لا يقود إلى أي مكان.

main.py: الانضمام إلى WiFi وجلب حالة الطقس
# MicroPython on an ESP32 DevKit: join WiFi and fetch the weather.
# The board joins Mokxi's simulated access point; its name and password are
# the board's WiFi properties. On a real board, put in your own network's.
import network
import time
import urequests

SSID = "Mokxi-Lab"
PASSWORD = "breadboard"

wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect(SSID, PASSWORD)
print("Connecting to", SSID)
while not wlan.isconnected():
    time.sleep_ms(250)
print("Connected, IP address", wlan.ifconfig()[0])

while True:
    r = urequests.get("http://weather.mokxi/")
    weather = r.json()
    r.close()
    print("%s: %.1f C, %d %% humidity" % (weather["location"], weather["temperatureC"], weather["humidity"]))
    time.sleep(10)

ما يعمل، وما لا يعمل

يعمل: machine.Pin مع المقاطعات، وPWM على LEDC، وADC على قنوات ADC1 الثماني مع الانحلالات الأربعة، وI2C وSoftI2C، وSPI وSoftSPI، وUART(1) وUART(2)، وneopixel، وdht، وonewire وds18x20، وmachine.freq() عند 80 أو 160 أو 240 MHz، وnetwork.WLAN مع socket وurequests على الشبكة المحاكاة. وتتواصل برامج التشغيل مثل ssd1306.py مع القطع على مساحة العمل.

غير محاكاة: النوم الخفيف والعميق؛ وADC2؛ وPSRAM؛ وأوضاع I2C وSPI التابعة (slave)؛ وتحكم تدفق UART؛ والاستقبال عبر RMT؛ وإعادة تعيين اللوحة بواسطة المراقبات (watchdogs)؛ وعلى الشبكة: محطة ثانية على نقطة الوصول البرمجية (هاتف لوحة الويب ينضم إلى WLAN(AP_IF))، وESP-NOW، وتوفير الطاقة، وTLS، وأي شبكة غير الشبكة المحاكاة. البرنامج الثابت هو بناء النواة الواحدة. والكود في ذاكرة flash يعمل بسرعة الكود في ذاكرة RAM، لأن توقيت الذاكرة المؤقتة غير مُنمذج.

الاستيراد من Wokwi

يُستورد مشروع Wokwi للوحة ESP32 مع main.py كمشروع MicroPython، مع ضبط لوحته على MicroPython. تنضم اللوحة إلى Wokwi-GUEST بدون كلمة سر، كما في Wokwi، لذا يعمل السطر المعتاد wlan.connect("Wokwi-GUEST", "") كما هو مكتوب.

الكود نفسه على لوحة 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.

على لوحة حقيقية، غيّر SSID وكلمة السر في بداية WiFi إلى شبكتك الخاصة. مواقع .mokxi موجودة في Mokxi فقط.

افتح هذه الدائرة في المحرر. ESP32 DevKit: MicroPython يُومض LED، موصولًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم شغّله مرة أخرى.

افتح الدائرة

الأسئلة

هل هذا MicroPython حقيقي؟

نعم. تعمل اللوحة ببرنامج MicroPython الرسمي v1.29.0 لـ ESP32، بناء النواة الواحدة الذي ينشره micropython.org، على نموذج للشريحة كاملة يُقلع من ذاكرة Espressif ROM. لا شيء في صفحة الويب يفسّر كود Python الخاص بك.

أي اللوحات تشغّل MicroPython؟

لوحات ESP32 الكلاسيكية: DOIT DevKit V1، وDevKitC، وLOLIN32 Lite، بالإضافة إلى Raspberry Pi Pico. اختر MicroPython (main.py) في لوحة البرنامج الثابت للوحة. أما كود Arduino على اللوحة نفسها فيعمل كما كان من قبل.

كيف يصل main.py إلى اللوحة؟

بالطريقة التي يفعلها mpremote. عند الضغط على «تشغيل»، يدخل الحاسوب المحاكى المتصل بمنفذ USB الخاص باللوحة إلى وضع REPL الخام عبر UART0، ويكتب كل ملف .py في نظام ملفات اللوحة، ثم يعيد تشغيل اللوحة برمجيًا، فتشغّل boot.py وmain.py.

هل يحمّل البرنامج أي شيء؟

أول ضغطة «تشغيل» لمشروع MicroPython على ESP32 تنزّل البرنامج الثابت وذاكرة الشريحة ROM، بحجم 1.4 MB، ويحتفظ بها المتصفح لكل ضغطة «تشغيل» بعدها. أما كود Arduino فلا ينزّلها أبدًا.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.