تعلّم

محاكي CircuitPython: البرنامج الثابت الرسمي على Pico، عبر الإنترنت

مبتدئ

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Raspberry Pi Pico: CircuitPython يُومض LEDمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
اضغط «تشغيل». يُقلع برنامج CircuitPython الرسمي، ويُحفظ code.py على محرك CIRCUITPY، ويومض كلا مصباحي LED.

يشغّل Mokxi لغة CircuitPython على Raspberry Pi Pico وPico W وArduino Nano RP2040 Connect وESP32-S3-DevKitC-1. ضع Pico على مساحة العمل، واختر CircuitPython (code.py) في لوحة البرنامج الثابت الخاصة بها، واكتب code.py ثم اضغط «تشغيل». ما يعمل هو البرنامج الثابت الرسمي من Adafruit، CircuitPython 10.3.1 لـ Raspberry Pi Pico، بايتًا بايت كما ينشره circuitpython.org، على RP2040 المحاكى على مستوى التعليمات في Mokxi. لا شيء في الصفحة يفسّر كود Python الخاص بك.

تُقلع اللوحة كما تفعل اللوحة الحقيقية: يُوصّل CircuitPython محرك الأقراص CIRCUITPY الخاص به، وينتظر نافذة الوضع الآمن التي تدوم ثانية واحدة بينما يومض LED على GP25، ثم يشغّل USB. بعدها يفتح الحاسوب في نهاية كابل USB المحاكى المتصل باللوحة منفذه التسلسلي ويحفظ code.py على محرك الأقراص، كما يفعل حاسوبك عندما تحفظ من محررك، فيعيد CircuitPython تحميله وتشغيله تلقائيًا.

الدائرة أعلاه هي أولى المشاريع التمهيدية أدناه: يومض board.LED لـ LED اللوحة Pico نفسها وLED أحمر على GP15، وتطبع الشاشة التسلسلية on وoff.

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

يحتفظ CircuitPython بملفاته على محرك أقراط اسمه CIRCUITPY، في ذاكرة Pico flash. عند الضغط على «تشغيل»، يكتب Mokxi ذلك المحرك قبل تشغيل اللوحة: ملف boot_out.txt الخاص بالبرنامج الثابت نفسه، ومكتبات Adafruit التي يستوردها برنامجك تحت lib/، وكل تبويب .py و.txt و.json و.csv و.toml عدا code.py.

أما code.py نفسه فيُحفظ عبر USB، قطاعًا قطاعًا، بالطريقة التي يكتب بها نظام تشغيل ملفًا إلى محرك أقراص USB. يستقبل CircuitPython الحفظ في ذاكرة flash ويعيد التحميل، فيعمل code.py والشاشة التسلسلية موصولة، فتُعرض كل سطر يطبعه. يطبع بعد نحو ثانيتين من الضغط على «تشغيل»، معظمها نافذة الوضع الآمن الخاصة بـ CircuitPython نفسه والانتظار بعد الحفظ قبل إعادة التحميل.

الوميض باستخدام digitalio

digitalio.DigitalInOut(board.LED) هو LED اللوحة Pico نفسها على GP25، وboard.GP15 يشغّل LED أحمر عبر مقاومة 220 أوم إلى الأرضي. يضيء الاثنان معًا، وتطبع الشاشة التسلسلية on وoff بعد سطر CircuitPython code.py output:.

code.py: أومض LED
# CircuitPython on a Raspberry Pi Pico: blink an LED.
# board.LED is the Pico's own LED (GP25); the red LED on GP15 through
# 220 ohms blinks with it.
import board
import digitalio
import time

onboard = digitalio.DigitalInOut(board.LED)
onboard.direction = digitalio.Direction.OUTPUT
led = digitalio.DigitalInOut(board.GP15)
led.direction = digitalio.Direction.OUTPUT

while True:
    onboard.value = led.value = True
    print("on")
    time.sleep(0.5)
    onboard.value = led.value = False
    print("off")
    time.sleep(0.5)

زر مع مقاومة السحب الخاصة بالطرف

زر من GP14 إلى الطرف الأرضي، مع switch_to_input(pull=digitalio.Pull.UP): يقرأ الطرف True حتى يُضغط الزر، وFalse أثناء الضغط. يطبع البرنامج Press the button، ويضيء LED اللوحة ما دمت مضغطًا عليه، ويحسب كل ضغطة مرة واحدة.

code.py: زر يضيء LED
# CircuitPython on a Raspberry Pi Pico: a button lights the LED.
# The button joins GP14 to ground. The pin's own pull-up holds it True, so
# a press reads False.
import board
import digitalio
import time

led = digitalio.DigitalInOut(board.LED)
led.direction = digitalio.Direction.OUTPUT
button = digitalio.DigitalInOut(board.GP14)
button.switch_to_input(pull=digitalio.Pull.UP)

print("Press the button")
presses = 0
was_pressed = False
while True:
    pressed = not button.value
    led.value = pressed
    if pressed and not was_pressed:
        presses += 1
        print("pressed", presses)
    was_pressed = pressed
    time.sleep(0.01)

قوس قزح NeoPixel باستخدام مكتبة neopixel

ثمانية LED من نوع WS2812 على GP16. تذهب مكتبة neopixel من Adafruit إلى lib/ من تلقاء نفسها، وترسل بتات الشريط من إحدى آلات PIO الحالية في Pico، كما في Pico حقيقية. تدور الألوان حول الشريط، وكل 64 خطوة يطبع البرنامج رقم الخطوة ولون البكسل الأول، بدءًا من step 64 first pixel.

code.py: قوس قزح NeoPixel
# CircuitPython on a Raspberry Pi Pico: a NeoPixel rainbow.
# Eight WS2812 LEDs on GP16, driven by Adafruit's neopixel library (which
# the editor puts in lib/ for you) through the Pico's PIO.
import board
import neopixel
import time

pixels = neopixel.NeoPixel(board.GP16, 8, brightness=0.3, auto_write=False)

def wheel(pos):
    # 0 to 255 around the color wheel: red, green, blue and back to red.
    if pos < 85:
        return (255 - pos * 3, pos * 3, 0)
    if pos < 170:
        pos -= 85
        return (0, 255 - pos * 3, pos * 3)
    pos -= 170
    return (pos * 3, 0, 255 - pos * 3)

print("Rainbow on 8 NeoPixels")
step = 0
while True:
    for i in range(8):
        pixels[i] = wheel((i * 32 + step) % 256)
    pixels.show()
    if step % 64 == 0:
        print("step", step, "first pixel", pixels[0])
    step = (step + 4) % 256
    time.sleep(0.02)

حساس BME280 مع adafruit_bme280

busio.I2C(board.GP5, board.GP4) هو I2C0 في Pico، مع SCL أولًا ثم SDA. تقرأ مكتبة adafruit_bme280 من Adafruit الحساس؛ ولا تحتاج إلى إضافتها في أي مكان، لأن المحرر يضعها في مجلد lib/ على محرك الأقراط عندما يستوردها code.py. مع ضبط القطعة على 22.5 C و45% تطبع 22.5 C 45.0 % humidity والضغط كل ثانيتين، وعندما تغيّر درجة الحرارة على القطعة تتبعها القراءة التالية.

code.py: BME280 على الشاشة التسلسلية
# CircuitPython on a Raspberry Pi Pico: a BME280 to the Serial Monitor.
# I2C0 on GP5 (SCL) and GP4 (SDA); Adafruit's adafruit_bme280 library goes
# into lib/ for you.
import board
import busio
import time
from adafruit_bme280 import basic as adafruit_bme280

i2c = busio.I2C(board.GP5, board.GP4)
bme = adafruit_bme280.Adafruit_BME280_I2C(i2c, address=0x76)

while True:
    print("%.1f C  %.1f %% humidity  %.1f hPa" % (bme.temperature, bme.relative_humidity, bme.pressure))
    time.sleep(2)

نص على شاشة SSD1306 OLED باستخدام displayio

يرسم displayio على الشاشة عبر adafruit_displayio_ssd1306، وتصنع adafruit_display_text التسميات، بخط terminalio الخاص بالبرنامج الثابت نفسه. تذهب المكتبتان، مع adafruit_ticks التي تحتاجها adafruit_display_text، إلى lib/ تلقائيًا. يكتب البرنامج عنوانًا وعدادًا يزداد مرة كل ثانية، ويطبع count 0 وcount 1 وهكذا.

code.py: نص على شاشة OLED من نوع SSD1306
# CircuitPython on a Raspberry Pi Pico: text on an SSD1306 OLED.
# I2C0 on GP5 (SCL) and GP4 (SDA). displayio draws a label with the built-in
# terminalio font; adafruit_displayio_ssd1306 and adafruit_display_text go
# into lib/ for you.
import board
import busio
import displayio
import i2cdisplaybus
import terminalio
import time
import adafruit_displayio_ssd1306
from adafruit_display_text import label

displayio.release_displays()
i2c = busio.I2C(board.GP5, board.GP4)
bus = i2cdisplaybus.I2CDisplayBus(i2c, device_address=0x3C)
display = adafruit_displayio_ssd1306.SSD1306(bus, width=128, height=64)

group = displayio.Group()
title = label.Label(terminalio.FONT, text="Hello, Pico!", x=4, y=8)
counter = label.Label(terminalio.FONT, text="", x=4, y=32, scale=2)
group.append(title)
group.append(counter)
display.root_group = group

n = 0
while True:
    counter.text = str(n)
    print("count", n)
    n += 1
    time.sleep(1)

الـ WiFi على الـ Pico W

يعمل Pico W بنسخة CircuitPython الخاصة به، مع محاكاة شريحة الراديو CYW43439 من أطرافها: board.LED هو LED على شريحة الراديو، وwifi.radio.connect() يتصل بنقطة الوصول المحاكاة في Mokxi. اسمها وكلمة سرها هما خصائص WiFi الخاصة باللوحة، وتبدأ بقيمتي Mokxi-Lab وbreadboard. socketpool ومكتبة adafruit_requests من Adafruit، مع adafruit_connection_manager التي تحتاجها، تُوضع كلها في مجلد lib/ من أجلك، ثم تجلب مواقع .mokxi الافتراضية على الشبكة المحاكاة، مثل http://weather.mokxi/.

الشبكة محاكاة: الأسماء خارج نطاق .mokxi لا تُعثر عليها، ولا وجهة لـ https://. البلوتوث وعملاء وضع نقطة الوصول وتوفير الطاقة غير محاكاة، وwifi.radio.ap_info يطلق NotImplementedError، كما أن نسخة CircuitPython للوحة Pico W لا تطبّقه.

المكتبات التي تُوضع في lib/ تلقائيًا

يقرأ Mokxi كل سطر import ويضع مكتبات Adafruit التي يجدها في مجلد lib/ على محرك الأقراص، مع ما تستورده بدورها، كما يفعل circup. وهي ملفات .mpy المترجمة من Adafruit نفسها من حزمة CircuitPython 10.x، دون تغيير: adafruit_bme280، وadafruit_display_text (مع adafruit_ticks)، وadafruit_displayio_ssd1306، وadafruit_framebuf (مع ملف font5x8.bin في أعلى محرك الأقراص)، وadafruit_hcsr04، وadafruit_requests (مع adafruit_connection_manager)، وadafruit_ssd1306 وneopixel. والتبويب الذي يحمل اسم مكتبة، مثل neopixel.py، هو ملفك الخاص ويُستخدم بدلًا منها.

الوحدات المدمجة في البرنامج الثابت لا تحتاج إلى شيء: board وdigitalio وanalogio وpwmio وbusio وtime وdisplayio وterminalio وi2cdisplaybus وغيرها.

الـ REPL

الشاشة التسلسلية هي منفذ USB التسلسلي للوحة Pico، في الاتجاهين: ما يطبعه code.py، وأخطاء التتبع الخاصة به، وCode done running. عند انتهائه. يوقف Ctrl-C برنامج code.py مع KeyboardInterrupt، ثم أي مفتاح يدخلك إلى الـ REPL حيث يجيب >>>، ويعيد Ctrl-D التحميل ويشغّل code.py من جديد.

عندما يتوقف البرنامج بخطأ، يعلّم Mokxi السطر في ملفك ويشرح ما يعنيه الخطأ عادةً بمصطلحات CircuitPython: وحدة MicroPython مثل machine في برنامج CircuitPython، أو مقاومة سحب مفقودة، أو طرف قيد الاستخدام، أو board.I2C() الذي لا تتوفر عليه الـ Pico.

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

يعمل ما يلي: digitalio وanalogio وpwmio وbusio.I2C وbusio.UART مع القطع الموجودة في مساحة العمل؛ وadafruit_bme280 وadafruit_ssd1306 مع adafruit_framebuf، وdisplayio مع adafruit_display_text. ويعمل PIO أيضًا، لذا فإن neopixel_write ومكتبة neopixel تضيئان شريط WS2812، وpulseio.PulseIn يقرأ الصدى الذي يقيس به adafruit_hcsr04 زمن حساس HC-SR04. وإعادة التعيين من الداخل، باستخدام microcontroller.reset() أو الـ watchdog، تحافظ على محرك الأقراص، لذا يعمل code.py مرة أخرى.

غير محاكاة بعد: النواة الثانية؛ وaudiobusio، وaudiopwmio وpicodvi؛ وقراءة محرك الأقراص من الحاسوب، فهو يحفظ إليه فقط. تعمل ESP32-S3-DevKitC-1 بـ CircuitPython كذلك، بنسختها الخاصة وبـ REPL ومحرك أقراص على منفذ USB الأصلي للـ S3، لكن WiFi غير محاكاة تحت CircuitPython هناك.

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

مشروع Wokwi للوحة Pico أو Pico W أو Nano RP2040 Connect أو ESP32-S3-DevKitC-1 يحتوي على code.py يُستورد مع ضبط لوحته على CircuitPython، ويعمل. على لوحة أخرى يُحفظ code.py كنص، ويوضح الاستيراد السبب. ربما استخدم Wokwi نسخة CircuitPython أخرى؛ ويوضح تقرير الاستيراد أيّ نسخة تعمل هنا.

نفس الكود على Pico حقيقية

لوحة CircuitPython لا تحتاج إلى بناء. ضع CircuitPython على الـ Pico (اضغط BOOTSEL أثناء توصيلها، ثم اسحب ملف .uf2 من circuitpython.org/board/raspberry_pi_pico إلى محرّك RPI-RP2)، ثم احفظ code.py على محرّك CIRCUITPY الذي يظهر، وانسخ أي مكتبات يستوردها إلى CIRCUITPY/lib (الأمر circup install يفعل ذلك من أجلك).

افتح هذه الدائرة في المحرر. Raspberry Pi Pico: يشغّل CircuitPython وميض LED، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

افتح الدائرة

الأسئلة

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

نعم. تعمل اللوحة بالبرنامج الثابت الرسمي CircuitPython 10.3.1 للوحة Raspberry Pi Pico، نفس ملف .uf2 الذي ينشره circuitpython.org، بايت ببايت، على RP2040 مُحاكى. لا شيء في صفحة الويب يفسّر كود Python الخاص بك.

أي اللوحات تعمل بـ CircuitPython؟

Raspberry Pi Pico؛ وPico W، مع WiFi على شبكة محاكاة؛ وArduino Nano RP2040 Connect بنسخة CircuitPython الخاصة بها، حيث `board.LED` هو LED على الطرف D13 و`board.I2C()` على الطرفين A4 وA5؛ وESP32-S3-DevKitC-1. اختر CircuitPython (code.py) في لوحة البرنامج الثابت للوحة. يمكن لنفس الـ Pico تشغيل MicroPython (main.py) أو كود Arduino بدلًا من ذلك.

هل أحتاج إلى تثبيت المكتبات؟

لا. مكتبات Adafruit التي يستوردها البرنامج، من بين ما يملكه Mokxi، تُوضع من تلقاء نفسها عند التشغيل في مجلد lib/ على محرك الأقراص، مع ما تحتاجه بدورها، كما كان circup سيضعها هناك.

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

أول تشغيل لمشروع CircuitPython ينزّل البرنامج الثابت، ويحتفظ به المتصفح لكل تشغيل لاحق. كل مكتبة تُنزّل فقط عندما يستوردها برنامج. وكود Arduino لا ينزّل أيًّا منهما أبدًا.

المصادر

من أين جاءت الحقائق في هذه الصفحة

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

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