اللوحات

Raspberry Pi Pico

شريحة RP2040 على نواة Cortex-M0+ الخاصة بنا: نواة واحدة، وSIO GPIO، وTIMER، وUART0، وPWM، وADC.

نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج Raspberry Pi Pico (كل السجلات).

ما هي

لوحة Raspberry Pi Pico، بشريحة RP2040 تعمل على نواة Cortex خاصة بنا ضمن نمط ARMv6-M. البرنامج الثابت ملف Thumb ELF يتعامل مع عناوين RP2040 الحقيقية، فتعمل الصورة نفسها على العتاد الحقيقي.

تردد ساعة النظام 125 MHz بعد إعادة التشغيل، لأن شجرة الساعة غير مُمثَّلة في النموذج ولا يوجد ما يحتاج إلى تهيئة.

الأطراف

التوصيلة ذات الأطراف الـ 40، بالترتيب الموجود على اللوحة.

العمود الأيسر، الأطراف من 1 إلى 20: GP0، GP1، GND، GP2 إلى GP5، GNDb، GP6 إلى GP9، GNDc، GP10 إلى GP13، GNDd، GP14، GP15.

العمود الأيمن، الأطراف من 40 إلى 21: VBUS، VSYS، GNDe، 3V3_EN، 3V3، ADC_VREF، GP28، AGND، GP27، GP26، RUN، GP22، GNDf، GP21، GP20، GP19، GP18، GNDg، GP17، GP16.

تطبع اللوحة الكتابة GND على أطراف الأرضي السبعة؛ وهنا أُضيفت أحرف حتى يكون كل اسم فريدًا. نقاط الاختبار ورأس SWD لا يُعدّان أطرافًا.

هذه لوحة بجهد 3.3 فولت وأطرافها لا تتحمل 5 V. يوفّر 3V3 جهد 3.3 V، ويوفّر VBUS جهد 5 V، ويوفّر VSYS جهد 4.7 V، وهو جهد 5 V بعد مروره بدايود شوتكي على اللوحة نفسها.

الأطراف GP23 وGP24 وGP25 موجودة في النموذج لكنها ليست على رأس الأطراف، كما هو الحال على اللوحة الحقيقية. الطرف GP25 هو LED اللوحة المدمج، ولهذا فإن LED_BUILTIN يساوي 25.

What is modeled

وحدات SIO GPIO، وTIMER سعته 64 بت، وUART0، وUART1، وPWM، وADC. كل شريحة PWM تقود القناة A على طرف ذي رقم زوجي والقناة B على طرف ذي رقم فردي، ولهذا يمكن تخفيف سطوع LED الموجود على اللوحة عند GP25.

Serial (وكذلك Serial1، وهو المنفذ نفسه) هو UART0، وهو الشاشة التسلسلية. أما Serial2 فهو UART1، كما في arduino-pico، وتظهر بايتاته على أطرافه لا على الشاشة: الإرسال على GP4 والاستقبال على GP5، أو زوج UART1 آخر (GP8 وGP9، GP20 وGP21) يُختار بالدالتين Serial2.setTX() وSerial2.setRX() قبل begin(). وحدة GPS أو وحدة HC-05 أو لوحة ثانية موصّلة هناك تسمعه بتًا بتًا، بمعدل الباود الذي يعطيه المقسّم فعلًا.

المحوّل ADC هو محوّل RP2040 ذو الاثني عشر بتًا. الأطراف GP26 وGP27 وGP28 هي A0 إلى A2، ودالة analogRead() على أحدها تقرأ الجهد على الشبكة مقابل 3.3 V: عشرة بتات افتراضيًا، كما في arduino-pico، أو اثنا عشر بتًا بعد analogReadResolution(12). ودالة analogReadTemp() تقرأ حساس الحرارة المدمج في الشريحة، وهو عند 27 C هنا. المحوّل بلا ضجيج وبلا خطأ، ولم تُحاكَ آلية FIFO ولا DMA ولا المقاطعات فيه.

هذه هي المجموعة التي تحتاجها الدوال pinMode وdigitalWrite وdigitalRead وanalogRead وanalogWrite وmillis وmicros وdelay وSerial وSerial2 وattachInterrupt، عند عناوينها الحقيقية.

ما لم يُحتَذَ به

قائمة طويلة، وتستحق القراءة قبل أن تخطّط مشروعًا حول أحدها: PIO وDMA وSPI وI2C وUSB وساعة الوقت الحقيقي وشجرة الساعات وواجهة QSPI للفلاش والنواة الثانية وROM المدمج والمُداخِلات. أما المراقب (watchdog) فمحاكى: الدالتان watchdog_enable() وrp2040.wdt_begin() تعيدان تشغيل كود يتوقف عن إطعامهما.

كتل عناوينها غير مخططة، فلمس أحدها يسبب خطأ ناقل (bus fault) بدلًا من صفر صامت. هذا مقصود: فالبرنامج الذي يقرأ لا شيء بصمت يصعب تصحيحه أكثر من البرنامج الذي يتوقف.

A Pico SDK program is not built in the editor, but its prebuilt .uf2 or .elf runs: the Pico boots it through its boot ROM, with the clocks, I2C, SPI, DMA and USB blocks there as for MicroPython (see شغّل برنامجًا ثابتًا جاهزًا)، و PIO يعمل هناك أيضًا. النواة الثانية توقف مثل هذا البرنامج وتعرض جملة تقول ذلك.

SPI.h و Wire.h تعمل أيضًا، برمجيًا على أطراف عادية (أدناه)، فغياب كتلتي SPI وI2C لا يهم إلا الكود الذي يكتب في سجلّاتهما. اللوحة التي تشغّل MicroPython أو برنامجًا ثابتًا جاهزًا هي الاستثناء: تقلع كما تقلع الشريحة الحقيقية، وكتل I2C وSPI وDMA وPIO موجودة من أجل machine.I2C, machine.SPI و rp2.StateMachine (انظر MicroPython على Pico).

هناك تقريبان يجدر معرفتهما أيضًا. تعمل النواة في قطع زمنية مدة كل منها 1.024 us لا تعليمة واحدة تلو الأخرى، لأن مفسّر Cortex-M لا يملك متسعًا عند 125 MHz: تنبيهات المؤقت وحواف PWM وبايتات UART تقع على دورتها الدقيقة، لكن تغيّر طرف بفعل البرنامج قد يتأخر حتى ميكروثانية. وساعة النظام دائمًا 125 MHz، مهما برمجه الكود، لأن شجرة الساعات غير موجودة.

القائمة الكاملة، وفرز القسم 8 لما هو رقم من ورقة البيانات وما هو تقريب، موجودة في نموذج Raspberry Pi Pico.

مكتبات Arduino الرسمية

درس تعليمي يتضمن Servo.h و Wire.h و SPI.h و EEPROM.h و LiquidCrystal_I2C.h و Adafruit_GFX.h مع Adafruit_SSD1306.h و DHT.h يُترجم هنا كما هو. كل منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مبني على مشغّلات القطع في الصندوق، وليس أي منها كود المكتبة الأصلية.

  • تضع الدالة Wire.begin() ناقل I2C على GP4 (SDA) وGP5 (SCL).
  • تعمل المكتبة EEPROM.h، لكن نموذج هذه اللوحة لا يحتوي EEPROM ولا فلاش قابلًا للكتابة، لذلك تُخزَّن البايتات في 4 KB من الذاكرة RAM: يمكن قراءتها مرة أخرى خلال التشغيل نفسه، لكنها تضيع عند إعادة الضبط.
  • تسيّر المكتبة Adafruit_NeoPixel.h شريط WS2812. لوحة Pico حقيقية ترسل البتات من PIO، وهو غير محاكى، لذا هنا يوقّت النواة كل بت على SysTick، داخل نوافذ ورقة البيانات، مع تعطيل المقاطعات طوال الإطار.

يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.

MicroPython

يمكن لـ Pico تشغيل Python بدلًا من الكود. في قسم البرنامج الثابت الخاص باللوحة، اختر MicroPython (main.py): تصبح ملفات اللوحة main.py، ويبدأ زر «تشغيل» بها. ما يعمل هو MicroPython v1.29.0، البرنامج الثابت الرسمي للـ Pico من micropython.org، على RP2040 المحاكى. ينسخ زر «تشغيل» ملفات .py الخاصة بك إلى اللوحة كما يفعل Thonny، ثم تشغّل اللوحة main.py بنفسها. تذهب print() إلى الشاشة التسلسلية، ويجيب الـ REPL هناك بمجرد انتهاء main.py أو إيقافك له بـ Ctrl-C.

تعمل machine.Pin وmachine.PWM وmachine.ADC وmachine.UART(1) وmachine.I2C وmachine.SPI وSoftI2C وSoftSPI، لذا يمكن للمشغّلات مثل ssd1306.py من micropython-lib التواصل مع القطع في مساحة العمل. وعند حدوث خطأ، يشير التتبع إلى السطر في ملفك تمامًا كما يفعل خطأ الترجمة.

يعمل PIO أيضًا: rp2.PIO وrp2.StateMachine يشغّلان برامجهما على كتل PIO المُحاكاة، لذا يضيء مثال WS2812 من توثيق MicroPython شريط NeoPixel. غير مُحاكاة: النواة الثانية (_thread توقف اللوحة برسالة)، ووضع الهدف في I2C ووضع التابع في SPI. تبقى وحدة المعالجة عند 125 MHz مهما قالت machine.freq().

The Pico W runs MicroPython too, with its own build: its CYW43439 radio chip is modeled, so Pin("LED") lights and network.WLAN joins Mokxi's simulated network (see Pico W). للبدء، انظر MicroPython على Pico.

CircuitPython

اختر CircuitPython (code.py) في لوحة البرنامج الثابت للوحة بدلًا منها، ويقلع زر «تشغيل» البرنامج الثابت الرسمي CircuitPython 10.3.1 للـ Pico. ملفك code.py يُحفظ على محرّك أقراص CIRCUITPY للوحة عبر USB ويُشغّل، وتذهب مكتبات Adafruit التي يستوردها إلى مجلد lib/ بنفسها. انظر CircuitPython على Pico.

برنامج Pico SDK

البرنامج المبني بـ Raspberry Pi Pico SDK يعمل من نسخته المبنية: في لوحة «البرنامج الثابت» للوحة اختر رفع البرنامج الثابت (.uf2, .elf) واختر .uf2 أو .elf من مجلد build/ الخاص بك. يُقلع Pico عبر boot ROM، كما بعد نسخه إلى محرّك أقراص اللوحة، وتُظهر الشاشة التسلسلية UART0 والمنفذ التسلسلي USB معًا. يعمل PIO، أما النواة الثانية فغير محاكاة. الخطوات في تشغيل برنامج ثابت جاهز.

لغة التجميع

توفر لوحة البرنامج الثابت أيضًا لغة التجميع (بدون Arduino): وميض Blink، وزر إلى LED، ورسالة UART، ومقاطعة مؤقت، كلها بلغة التجميع ARM Thumb لمعالج Cortex-M0+. تصبح ملفات اللوحة ملفًا واحدًا main.S، ولا يُربط سوى ذلك الملف، فيحمل جدول المتجهات الخاص به: .word _stack_top، ثم Reset_Handler، ثم معالجاته. تستغرق البدايات IO_BANK0 و PADS_BANK0 من RESETS، وتشغّل GPIO25 عبر SIO وتقيس وقتها على TIMERAWL. A .S تعمل تبويبة الشريحة المخصصة بجانب كود عادي أيضًا. لا تتوفر مشاريع بداية لـ Pico W، لأن LED فيه على شريحة الراديو. انظر كتابة لغة التجميع.

الأمثلة

أمثلة Blink وButton وSerial وFade وChaser، وأمثلة وحدة التحكم بالألعاب: خطوات عصا القتال الأربع، وعصا القتال، ووحدة التحكم بالرافعة، ووحدة التحكم بنمط Mixbox، وأوقف الضوء.

في مواضع أخرى