MicroPython على Raspberry Pi Pico، دون أي شيء لتثبيته
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
يشغّل Mokxi لغة MicroPython على لوحة Raspberry Pi Pico الخاصة به. ضع لوحة Pico على مساحة العمل، واختر MicroPython (main.py) في لوحة البرنامج الثابت، واكتب main.py ثم اضغط «تشغيل». ما يعمل هو برنامج MicroPython الرسمي v1.29.0 للوحة Pico، نفس الملف الذي كنت ستنسخه إلى لوحة حقيقية، على RP2040 المحاكى في Mokxi، تعليمة بتعليمة.
عندما تضغط «تشغيل» تقلع اللوحة بهذا البرنامج الثابت، والحاسوب في نهاية كابل USB المحاكى ينسخ ملفات .py الخاصة بك إلى نظام ملفات اللوحة كما يفعل Thonny، ثم يعيد تشغيلها تشغيلًا خفيفًا. يطبع MicroPython العبارة MPY: soft reboot ويشغّل main.py. كل ما يقوله print() يظهر في الشاشة التسلسلية، وعندما ينتهي main.py يجيبك الـ REPL: اكتب 6*7 فيقول 42.
الدائرة أعلاه هي مقبض (مقاومة متغيرة) على الطرف GP26 وLED على GP15. أدر المقبض فيخفت ضوء LED ويزداد، وتُظهر الشاشة التسلسلية موقع المقبض كنسبة مئوية.
البرنامج: مدخل ADC ومخرج PWM
ADC(26) هو المدخل التناظري في RP2040 على الطرف GP26، وread_u16() يعطي 0 عند 0 فولت و65535 عند مرجع 3.3 فولت. المحول نفسه بدقة 12 بت، فتتحرك القيمة بخطوات مقدارها نحو 16. أما PWM(Pin(15)) فهو شريحة PWM الخاصة بالطرف GP15، وduty_u16() يقبل نفس المدى من 0 إلى 65535، لذا يمكن إدخال قراءة المقبض مباشرة كدورة تشغيل.
عندما يكون المزلاق على 1.1 فولت، أي ثلث المسافة، طبع read_u16() القيمة 21845 في كل مرة هنا: 1365 عدًّا من أصل 4095، تمدّدها MicroPython إلى 16 بت بإزاحتها أربع بتات للأعلى وتكرار بتاتها الأربع العليا تحتها، كما على لوحة Pico حقيقية. وعند دورة تشغيل 32768 كان طرف LED مرتفعًا بنسبة 50.0% من كل دورة مدتها 1 ms.
# MicroPython on a Raspberry Pi Pico: a knob dims an LED.
# The potentiometer's wiper is on GP26 (ADC0), the LED on GP15 is driven by PWM.
from machine import ADC, Pin, PWM
import time
knob = ADC(26) # read_u16(): 0 at 0 V, 65535 at 3.3 V
led = PWM(Pin(15))
led.freq(1000) # 1 kHz, far too fast to see it flicker
last = -1
while True:
value = knob.read_u16()
led.duty_u16(value) # the knob's position is the LED's duty cycle
percent = value * 100 // 65535
if percent != last:
print("knob", percent, "%")
last = percent
time.sleep_ms(50)
الوميض بـ machine.Pin، وكم يستغرق sleep فعلًا
LED لوحة Pico هو الطرف GP25. البرنامج أدناه يبدّل حالته كل 100 ms. وعند القياس على طرف اللوحة، كانت كل دورة هنا 200 ms بدقة تصل إلى أجزاء من الألف من الثانية، لأن time.sleep_ms() ينتظر على مؤقت RP2040 الدقيق بالميكروثانية نفسه.
utime.ticks_us() يقرأ ذلك المؤقت أيضًا. أربعة استدعاءات متتالية لـ sleep_ms(250) قاست ضمن نصف ميكروثانية من 1000000 ميكروثانية في كل مرة هنا. وmachine.freq() يقول 125000000، أي تردد Pico البالغ 125 MHz.
from machine import Pin
import time
led = Pin(25, Pin.OUT) # the Pico's green LED
while True:
led.toggle()
time.sleep_ms(100)
زر مع مقاطعة
Pin.irq() يشغّل دالة عندما يتغير طرف، دون أن تراقبه حلقة البرنامج الرئيسية. هنا زر من GP14 إلى الأرضي يستخدم مقاومة السحب الداخلية للطرف، فيقرأ الطرف 1 حتى يُضغط الزر، وIRQ_FALLING يشغّل الدالة المعالجة مرة لكل ضغطة. أبقِ الدالة قصيرة: زد عدّادًا أو ارفع راية، ودَع الحلقة الرئيسية تتولى الطباعة.
from machine import Pin
import time
presses = 0
def pressed(pin):
global presses
presses += 1
button = Pin(14, Pin.IN, Pin.PULL_UP)
button.irq(trigger=Pin.IRQ_FALLING, handler=pressed)
last = 0
while True:
if presses != last:
last = presses
print("presses", presses)
time.sleep_ms(5)
نقل كود Arduino إلى MicroPython
لكل جزء من كود Arduino توأم بسطر واحد في MicroPython. لا يوجد setup() وloop(): أعلى main.py يعمل مرة واحدة، وحلقة while True: في النهاية تعمل للأبد. الأطراف كائنات تُبنى من وحدة machine، والأوقات تأتي من وحدة time.
أمران يتغير نطاقهما. analogRead() على لوحة Uno يعطي من 0 إلى 1023، بينما read_u16() يعطي من 0 إلى 65535 مهما كانت دقة المحول نفسه. ويؤخذ فرق الوقت بـ time.ticks_diff() الذي يبقى صحيحًا عند التفاف العدّاد، بدلًا من الطرح المباشر.
أدناه مثال Arduino AnalogReadSerial بعد نقله، على دائرة منظّم الخفوت نفسها. مع المقبض في المنتصف طبع 0 ms 32743 1.65 V، ثم نفس القراءة عند 500 ms و1000 ms وهكذا: القيمة 32743 هي 2046 عدًّا من أصل 4095، ممدودة إلى 16 بت.
| Arduino | MicroPython |
|---|---|
| pinMode(15, OUTPUT); digitalWrite(15, HIGH); | led = Pin(15, Pin.OUT); led.value(1) |
| pinMode(14, INPUT_PULLUP); digitalRead(14) | button = Pin(14, Pin.IN, Pin.PULL_UP); button.value() |
| analogRead(A0), 0 إلى 1023 | ADC(26).read_u16(), 0 إلى 65535 |
| analogWrite(15, 128), 0 إلى 255 | PWM(Pin(15)).duty_u16(32768), 0 إلى 65535 |
| delay(500) | time.sleep_ms(500) |
| millis() | time.ticks_ms() |
| Serial.println(x) | print(x) |
| attachInterrupt(..., FALLING) | Pin.irq(trigger=Pin.IRQ_FALLING, handler=...) |
# Arduino's AnalogReadSerial, ported to MicroPython
from machine import ADC
import time
pot = ADC(26) # analogRead(A0) becomes ADC(26)
start = time.ticks_ms() # millis() becomes time.ticks_ms()
while True:
value = pot.read_u16() # 0 to 65535, not 0 to 1023
volts = value * 3.3 / 65535
print(time.ticks_diff(time.ticks_ms(), start), "ms", value, "%.2f V" % volts)
time.sleep_ms(500) # delay(500) becomes time.sleep_ms(500)
I2C: شاشة OLED وحساس BME280 بـ machine.I2C
machine.I2C(0) وmachine.I2C(1) هما وحدتا I2C في RP2040، والقطع على الناقل تجيب على عناوينها: هنا شاشة SSD1306 OLED على I2C0 (الطرفان GP4 وGP5) يجدها scan() عند 0x3C (60)، وحساس BME280 على I2C1 (الطرفان GP6 وGP7) عند 0x76 (118). ويمكنهما مشاركة ناقل واحد أيضًا لأن عنوانيهما مختلفان. أضف المشغّلات كتبويبات، ssd1306.py من micropython-lib ومشغّل BME280، فتُنسخ إلى اللوحة مع main.py كما ينسخها Thonny.
يعمل الناقل على الساعة المحاكاة بالسرعة التي تولّدها الوحدة فعلًا: طلب 400 kHz يعطي 376 kHz على السلك، وoled.show()، وهي 1 KB من الصورة، تستغرق 25.4 ms. اطلب عنوانًا لا يجيب عليه أحد فيرفع الاستدعاء OSError: [Errno 5] EIO كما على لوحة Pico حقيقية. وmachine.SPI يعمل بالطريقة نفسها، مع DMA وكل شيء، بينما SoftI2C وSoftSPI يعملان على أي أطراف.
# MicroPython on a Raspberry Pi Pico: a BME280 and an SSD1306 OLED on I2C.
# The OLED is on I2C0: SDA on GP4 (pin 6), SCL on GP5 (pin 7).
# The BME280 is on I2C1: SDA on GP6 (pin 9), SCL on GP7 (pin 10).
# Both run from 3V3 (pin 36). ssd1306.py and bme280.py are in their own tabs.
from machine import I2C, Pin
import time
import ssd1306
import bme280
i2c0 = I2C(0, scl=Pin(5), sda=Pin(4), freq=400000)
i2c1 = I2C(1, scl=Pin(7), sda=Pin(6), freq=400000)
print("I2C0:", [hex(a) for a in i2c0.scan()]) # 0x3c, the OLED
print("I2C1:", [hex(a) for a in i2c1.scan()]) # 0x76, the BME280
oled = ssd1306.SSD1306_I2C(128, 64, i2c0)
sensor = bme280.BME280(i2c=i2c1)
while True:
t, p, h = sensor.read_compensated_data() # C, Pa, %RH
oled.fill(0)
oled.text("Pico weather", 0, 0)
oled.text("%.1f C" % t, 0, 20)
oled.text("%.1f hPa" % (p / 100), 0, 34)
oled.text("%.1f %%RH" % h, 0, 48)
oled.show()
print("%.2f C %.2f hPa %.2f %%" % (t, p / 100, h))
time.sleep(2)
عندما يتوقف البرنامج بسبب خطأ
يوقف MicroPython البرنامج الذي يخطئ ويطبع سجل التتبع: الملف والسطر والخطأ. يقرأ Mokxi ذلك من المنفذ التسلسلي، ويحدد السطر في المحرر، ويشرح ما يعنيه الخطأ عادةً. خطأ NameError يعني اسمًا استُخدم قبل إعطائه قيمة أو استيراده (أسماء Python حساسة لحالة الأحرف)؛ وخطأ SyntaxError يعني سطرًا ليس Python صحيحة، وغالبًا نقص نقطتين رأسيتين في نهاية سطر if أو for أو while أو def؛ وخطأ ImportError للمكتبتين RPi.GPIO أو gpiozero يعني كودًا كُتب لحاسوب Raspberry Pi، لا للوحة Pico.
بعد سجل التتبع يعود REPL للإجابة، فيمكنك تجربة السطر يدويًا قبل تعديل main.py.
ما هو مُحاكى وما ليس مُحاكى
ما يُحاكى: نواة Cortex-M0+ في RP2040 وذاكرة الإقلاع ROM الخاصة بها، ومحمّل الإقلاع من المرحلة الثانية، وشريحة الفلاش ونظام ملفات littlefs عليها، والساعات، ومنفذ USB، وأطراف GPIO مع مقاومات السحب والمقاطعات، وPWM، وADC مع حساس الحرارة، وكتلتا I2C وSPI وDMA، والمؤقّت، وRTC، ومراقب التشغيل.
ما لا يُحاكى بعد: النواة الثانية، لذا يوقف _thread اللوحة برسالة تفيد بذلك؛ وكتلة I2C كهدف (machine.I2CTarget)؛ وتردد المعالج، الذي يبقى على 125 MHz مهما ضُبط machine.freq()، مع أن المؤقّت وكل قياسات الوقت تبقى صحيحة. كتلا PIO تعملان، فيقود rp2.PIO وrp2.StateMachine أطرافهما. أما Pico W فيشغّل نسخته الخاصة من MicroPython، مع نمذجة شريحته CYW43439 من أطرافها: Pin("LED") يضيء LED اللوحة، وnetwork.WLAN ينضم إلى شبكة Mokxi المحاكاة.
افتح هذه الدائرة في المحرر. لوحة Raspberry Pi Pico: يخفّض MicroPython إضاءة LED باستخدام مقبض، موصولة كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.
افتح الدائرةالأسئلة
هل هذا MicroPython حقيقي أم تقليد له؟
حقيقي. تشغّل اللوحة البرنامج الثابت الرسمي MicroPython v1.29.0 للوحة Raspberry Pi Pico، نفس ملف .uf2 الذي ينشره micropython.org، على شريحة RP2040 محاكاة. لا شيء في صفحة الويب يفسّر كود Python الخاص بك: البرنامج الثابت هو الذي يترجمه ويشغّله على الشريحة المحاكاة.
كيف يصل main.py إلى اللوحة؟
بالطريقة نفسها التي يفعلها Thonny وmpremote. عند الضغط على «تشغيل»، يفتح الحاسوب المحاكى على منفذ USB الخاص بلوحة Pico منفذه التسلسلي، ويدخل وضع REPL الخام، ويكتب كل تبويب .py في نظام ملفات littlefs على اللوحة عبر نص برمجي قصير، ثم يعيد تشغيل اللوحة تشغيلًا خفيفًا، فتشغّل main.py.
هل يمكنني إضافة وحداتي الخاصة أو مكتبة؟
نعم. أضف تبويبًا بملف الوحدة .py، مثل ssd1306.py، واستورده من main.py. كل تبويب .py يُنسخ إلى اللوحة مع main.py.
هل يحمّل البرنامج أي شيء؟
أول ضغطة «تشغيل» لمشروع MicroPython تُنزّل البرنامج الثابت، 229 KB، ويحتفظ به المتصفح لكل تشغيل بعده. أما مشروع Arduino فلا ينزّله أبدًا.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.