اللوحات

CircuitPython على لوحة Pico

شغّل code.py على لوحة Pico مع البرنامج الثابت الرسمي لـ CircuitPython: لوحة البرنامج الثابت، وقرص CIRCUITPY، والمكتبات، وREPL، والاستيراد من Wokwi.

أي اللوحات

لوحة Raspberry Pi Pico تشغّل CircuitPython، وكذلك Arduino Nano RP2040 Connect، ببناء CircuitPython الخاص بها: شريحة RP2040 نفسها، مع board.LED على D13 ‏(GPIO 6) و board.I2C() على A4 و A5. انظر Nano RP2040 Connect. لوحة Raspberry Pi Pico W تشغّل بناءها الخاص، مع محاكاة شريحة الراديو CYW43439 الخاصة بها، لذا board.LED يعمل الضوء وWiFi على شبكة Mokxi المحاكاة (راجع الـ WiFi على الـ Pico W). لوحة ESP32-S3-DevKitC-1 تشغّل CircuitPython أيضًا، ببنائها الخاص مع REPL ووحدة التخزين على منفذ USB الأصلي لشريحة S3؛ لا تُحاكى شبكة WiFi تحت CircuitPython هناك. وتشغّل Pico لغة MicroPython أيضًا؛ راجع لوحة Pico.

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

اختياره في لوحة البرنامج الثابت

  1. ضع Raspberry Pi Pico أو Pico W أو Arduino Nano RP2040 Connect أو ESP32-S3-DevKitC-1 على مساحة العمل.
  2. افتح لوحة البرنامج الثابت الخاصة به واختر CircuitPython (code.py).
  3. تصبح ملفات اللوحة ملف code.py. إذا كانت تحتوي على عمل من إنجازك، سيُسألك أولًا. اكتب برنامجك هناك واضغط «تشغيل».

اللوحة التي تحتوي ملفاتها على code.py ولا تحتوي على .ino تشغّل CircuitPython. كود Arduino أو مشروع MicroPython على اللوحة نفسها يعمل كما كان، ولا يُحمَّل له أي شيء من CircuitPython.

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

محرك الأقراص CIRCUITPY وcode.py

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

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

يطبع code.py بعد نحو ثانيتين من التشغيل. معظم ذلك الوقت من CircuitPython نفسه: نافذة الوضع الآمن التي تدوم ثانية واحدة عند الإقلاع، بينما يومض LED على GP25، والانتظار بعد الحفظ قبل إعادة التحميل.

يحتفظ microcontroller.reset() وعداد المراقبة (watchdog) بمحرك الأقراص، فيعمل code.py مجددًا؛ وما يطبعه قبل أن يُفتح المنفذ التسلسلي مجددًا يضيع، كما يحدث على منضدة حقيقية. التشغيل مرة أخرى يبدأ من محرك أقراص مكتوب من جديد.

المكتبات

يقرأ 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 الخاص باللوحة، في الاتجاهين: ما يطبعه code.py، وتقارير أخطائه، وCode done running. عندما ينتهي.

  • يوقف Ctrl-C تشغيل code.py مع KeyboardInterrupt.
  • أي مفتاح بعدها ينقلك إلى REPL، و>>> يجيب هناك.
  • يعيد Ctrl-D التحميل ويشغّل code.py مرة أخرى.

عندما يتوقف برنامج بسبب خطأ، يطبع CircuitPython تقرير الخطأ (traceback). يقرأه Mokxi، ويحدد السطر في ملفك، ويقول ما يعنيه الخطأ عادةً بكلمات CircuitPython: وحدة MicroPython في برنامج CircuitPython، أو مقاومة سحب (pull-up) مفقودة، أو طرف مستخدم من قبل، أو board.I2C() التي لا يملكها الـ Pico (استخدم busio.I2C(board.GP5, board.GP4)).

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

digitalio وanalogio وpwmio وbusio.I2C وbusio.UART تعمل، لذا تتواصل adafruit_bme280 وadafruit_ssd1306 وdisplayio مع adafruit_display_text مع القطع الموجودة في مساحة العمل.

ويعمل PIO أيضًا، فيضيء neopixel_write ومكتبة neopixel شريط WS2812، وتقرأ pulseio.PulseIn الصدى الذي يقيس به adafruit_hcsr04 حساس HC-SR04.

غير محاكى: النواة الثانية؛ وaudiobusio وaudiopwmio وpicodvi؛ وقراءة محرك الأقراص من الحاسوب، فهو يحفظ إليه فقط.

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

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

import wifi, socketpool, adafruit_requests

wifi.radio.connect("Mokxi-Lab", "breadboard")
print("Connected, IP address", wifi.radio.ipv4_address)
requests = adafruit_requests.Session(socketpool.SocketPool(wifi.radio))
print(requests.get("http://weather.mokxi/").json())

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

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

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

على لوحة حقيقية

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

على الـ Pico W، اسحب ملف .uf2 من circuitpython.org/board/raspberry_pi_pico_w بدلًا من ذلك، وضَع اسم شبكتك وكلمة مرورها في code.py. على الـ Nano RP2040 Connect، وصّل REC بـ GND أثناء توصيله بدلًا من ذلك، واسحب ملف .uf2 من circuitpython.org/board/arduino_nano_rp2040_connect. على الـ ESP32-S3-DevKitC-1، وصّل منفذ USB الخاص به (الموسوم USB وليس UART) واستخدم أداة التثبيت على circuitpython.org/board/espressif_esp32s3_devkitc_1_n8.

مشاريع البداية

مشاريع بداية على الـ Pico، كل منها في صفحته الخاصة: blink، زر، قوس قزح NeoPixel، حساس BME280 و نص على شاشة SSD1306 OLED. محاكي CircuitPython يتناولها بالشرح.

في مواضع أخرى