محاكي MicroPython للوحة ESP32: البرنامج الثابت الرسمي، عبر الإنترنت
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
يشغّل 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 أوم إلى الأرض، فيضيءان معًا وينطفئان معًا.
# 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.
# 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 ويخفت بخطوات صغيرة: يتنفس بدلًا من أن يومض.
# 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 %، وعند تغيير الحرارة على القطعة تتبعها القراءة التالية.
# 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 سيفعل؛ ثم يرسم البرنامج سطرين من نص وعدادًا يزيد مرة كل ثانية.
# 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:// لا يقود إلى أي مكان.
# 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 فلا ينزّلها أبدًا.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.