نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج Raspberry Pi Pico W (كل سجل).
أما كود Arduino فيُحاكى الـ WiFi خلف صندوق بريد بدلًا من ذلك، ويعمل LED بالطريقتين.
ما هي
The same RP2040 on the same board outline with the same forty pins as the Raspberry Pi Pico، وتعمل على النموذج نفسه. الجوهر وSIO GPIO وTIMER وUART0 وPWM كلها تخص Pico، بالعناوين نفسها، وبرنامج مبني لـ Pico هنا هو ملف ELF نفسه الذي يشغّله Pico W.
ما تضيفه اللوحة الحقيقية هو CYW43439: واي فاي 2.4 GHz (802.11n) وبلوتوث، على شريحة بجوار RP2040 بهوائي خاص بها محفور في طرف اللوحة.
شريحة CYW43439 وكود Arduino
هذا القسم والقسم التالي عن أكواد Arduino. أما MicroPython وCircuitPython فيصلان إلى واجهة الشريحة الحقيقية، وهي محاكاة لهما: انظر MicroPython وCircuitPython أدناه.
بالنسبة لكود Arduino، لا يُحاكى من تلك الشريحة شيء تقريبًا. لا بروتوكول SPI إليها، ولا حزمة برنامج ثابت، ولا مشغّل، ولا سجلات، ولا بلوتوث: لا LE، ولا GATT، ولا إقران، ولا حتى كعب (stub). الكود الذي يستدعي البلوتوث لن تتم ترجمته هنا، لأن بيئة التشغيل لا تعرّفه.
الاستثناء الوحيد هو طرفه GPIO 0، وهو LED اللوحة، لأنه طرف يقوده الكود فعلًا؛ انظر أدناه. على العتاد الحقيقي يجب تغذية الشريحة وتحميل برنامجها الثابت قبل أن يفعل ذلك الطرف أي شيء، وهو ما ترتبه نواة Arduino عند البدء؛ هنا يعمل من أول تعليمة، وهذا تبسيط لا نموذج للتسلسل.
هذا مقصود. كعب يعيد «غير متصل» سيكون كذبة بشكل مقنع، وكعبًا يعيد «متصل» سيكون أسوأ.
ما تملكه اللوحة بدلًا من ذلك هو شبكة محاكاة، موصوفة أدناه، وما تبقى له هو كل ما يصلح له Pico (الجوهر، المؤقتات، PWM، UART، الأطراف) على اللوحة التي اشتراها الناس فعلًا. إذا كان الراديو الحقيقي هو جوهر مشروعك، فهذه اللوحة في Mokxi ليست الأداة المناسبة، ولا توجد أداة أخرى كذلك: لا راديو في هذا المنتج.
WiFi, simulated
لا يوجد راديو. ولن يكون هناك أبدًا: فطبقة MAC الخاصة بمعيار 802.11 ليست شيئًا يمكن لهذا النموذج أن يعيد إنتاجه بأمانة.
ما يوجد بدلاً من ذلك هو شبكة محاكاة. كتلة هي من Mokxi نفسها لا من الشريحة (صندوق بريد عند 0x4FFF_E000، حيث لا توجد أي ذاكرة معيّنة في RP2040 حقيقي) تحمل WiFi.h وHTTPClient.h وWebServer.h، لذا يعمل كود Arduino الذي يعطيك إياه أي دليل هنا: تنضم اللوحة إلى نقطة وصول اسمها وكلمة مرورها من خصائص اللوحة، ويمرّ WiFi.status() بالحالات نفسها خلال ثانية إلى ثلاث ثوانٍ، ويمنحها DHCP عنوان 192.168.4.2، ويمكن للكود جلب صفحة أو تقديمها.
ما يقف خلف ذلك هو برمجية، ولا شيء مخفي في هذا الأمر. لا يوجد 802.11، ولا قناة، ولا بحث عن الشبكات، ولا WPA2، ولا TCP، ولا TLS و لا إنترنت حقيقي: أربعة أسماء اخترعناها تحت .mokxi تُحلّ ولا غيرها، ولا شيء يفعله الكود يستطيع الوصول إلى الشبكة التي يعمل عليها متصفحك. WiFiClientSecure يترجم ثم يفشل، قائلًا إن TLS غير مُحاكى. لوحتا Web و Cloud على طول أسفل المحرر تُفتحان بهذه الجملة ولا تُمرّرها بعيدًا.
الاستثناء الوحيد هو إنترنت حقيقي، مفتاح في لوحة Cloud لأي شخص سجّل دخوله (المزيد منه مع Pro) يكون مغلقًا في كل مرة تُحمَّل فيها الصفحة. عند تشغيله، يخرج طلب اسم خارج .mokxi,
https:// مشمولًا، يخرج عبر بوابة Mokxi وتعود الإجابة إلى الكود. انظر إنترنت حقيقي.
وصندوق البريد هو الشكل الصادق هنا أيضًا. الجزء اللاسلكي في Pico W الحقيقي هو CYW43439 في الطرف الآخر من وصلة SPI من ثلاثة أطراف تقريبًا، يُشغَّل بكود ثنائي مغلق، وليس مجموعة سجلات موثّقة على RP2040، تمامًا كما أن راديو ESP32 ليس مجموعة سجلات موثّقة على الشريحة نفسها. فهذه واجهة أوامر، وهذا هو الفاصل الحقيقي. بالنسبة للكود، لا تتم محاكاة CYW43439 نفسه، والبلوتوث لا تتم محاكاته إطلاقًا.
الكتلة معيّنة على Pico W وغير معيّنة على Pico العادي، لذا تتم ترجمة WiFi.h على لوحة ويرفض على الأخرى، وبرامج الأمثلة على اللوحتين غير قابلة للتبديل.
تأتي مع هذه اللوحة أربعة أمثلة: WiFi: الانضمام إلى الشبكة، WiFi: جلب حالة الطقس، مختبر API: جلب JSON وWiFi: مصباح على صفحة ويب.
أكواد مكتوبة لـ arduino-pico
The Pico W's Arduino core is arduino-pico, and its WiFi examples build here as
they are written: HelloServer with WebServer and LEAmDNS.h, BasicHttpsClient
with a WiFiMulti and HTTPClient, and the WiFiServer ones with
server.accept(). Its own calls are here too: WiFi.connected(),
WiFi.noLowPowerMode(), WiFi.end(), http.setInsecure() and
rp2040.getFreeHeap(). A few compile and do nothing, because what they reach
is not simulated, and the serial monitor says so once: WiFi.ping() answers -1,
MDNS.begin("picow") names
nothing that resolves, and an https:// address still fails after
setInsecure().
أمران يجب تغييرهما في كود منسوخ: اسم الشبكة وكلمة المرور، ويجب أن يطابقا ما على اللوحة نفسها (Mokxi-Lab وbreadboard ما لم تغيّرهما على اللوحة)، وأي عنوان خارج .mokxi، فلا شيء يجيب عليه. الكود على Raspberry Pi Pico عادي لا يُبنى مع WiFi.h إطلاقًا، لأن تلك اللوحة لا تحتوي على شريحة لاسلكية؛ غيّر اللوحة إلى Pico W.
WiFi، محاكى هو كيفية استخدامه؛ وWiFi المحاكى هو العقد، حدًّا بعد حد.
الـ LED ليست على GP25
هذا هو الجزء الذي يوقع الناس في الفخ، ويوقعهم على المنضدة الحقيقية أيضًا.
يوجد LED الأخضر على Pico على الطرف GP25. أما على Pico W فليس كذلك. فعلى Pico W تذهب الأطراف GP23 وGP24 وGP25 جميعها إلى شريحة CYW43439 بدلًا من ذلك (WL_ON وWL_D وWL_CS)، ويتصل LED بالطرف GPIO 0 الخاص بشريحة CYW43 نفسها، عبر نفس الرابط الذي يستخدمه الراديو.
لذا digitalWrite(25, HIGH) لا يضيء شيئًا هنا، ولا يضيء شيئًا على العتاد الحقيقي أيضًا.
digitalWrite(LED_BUILTIN, HIGH) يضيئها، على كلتيهما. LED_BUILTIN على هذه اللوحة ليس رقم GPIO إطلاقًا: يرسله نظام التشغيل إلى الجزء اللاسلكي عبر صندوق البريد نفسه الذي تستخدمه الشبكة، وهو المسار الذي تسلكه نواة Arduino على اللوحة الحقيقية. والمصباح على اللوحة في المحرر يضيء معه.
أمر واحد لا تستطيع تلك الوصلة حمله هو نسبة الاستخدام، لذا analogWrite(LED_BUILTIN, …) لا يفعل شيئًا على Pico W. الـ LED المتنفسة تحتاج طرف رأس، وهذا ما يفعله مثال Fade.
وصّل LED ومقاومة 220 أوم من طرف رأس إلى طرف أرضي وومضها بدلاً من ذلك. مثال blink الخاص باللوحة يفعل ذلك بالضبط.
الأطراف
أربعون طرفًا تمامًا كما على Pico، بالترتيب نفسه وبالأسماء نفسها: انظر Raspberry Pi Pico. هذه لوحة 3.3 فولت وأطرافها لا تحتمل 5 فولت.
GP29 هو WL_CLK على Pico W كما أنه مقسّم VSYS، وGP24 ليس حسّاس VBUS. لا شيء يقوده هنا، فيقرأ منخفضًا. ولا أحدهما على الرأس في أي من اللوحتين.
ما هو مُنمذج، وما ليس كذلك
نفس ما على Pico، كل سطر منه، زائد كتلة واحدة ليست من الشريحة إطلاقًا: SIO GPIO، وTIMER ذو 64 بت، وUART0، وUART1 (Serial2، على أطرافه)، وPWM، وADC، وصندوق بريد الشبكة المحاكاة والطرف الوحيد لـ CYW43 خلفه موجودة؛ أما PIO وDMA وSPI وI2C وUSB وRTC وشجرة الساعات والنواة الثانية وboot ROM فلا، ولا بقية CYW43439 أيضًا. هذه لوحة الكود: تحت MicroPython وCircuitPython تقلع اللوحة عبر ROM الخاص بها مع نموذج الشريحة الكامل للـ Pico، وCYW43439 على أطرافه (أدناه). analogRead() يقرأ GP26 إلى GP28 (A0 إلى A2) كما على Pico.
The full list is in طراز Raspberry Pi Pico W، الذي يذكر الاختلافات فقط، و طراز Raspberry Pi Pico، الذي يذكر كل ما تبقّى.
مكتبات Arduino الرسمية
نفس ما على لوحة Pico: Servo.h,
Wire.h (على GP4 و GP5), SPI.h, EEPROM.h (في RAM)، LiquidCrystal_I2C.h,
Adafruit_SSD1306.h, Adafruit_NeoPixel.h و DHT.h تُترجم كما هي.
الأمثلة
Blink وButton وSerial وFade وChaser هي أمثلة Pico نفسها، مترجمة مرة أخرى لهذه اللوحة. Blink يشغّل LED_BUILTIN وGP15، فيومض مصباح اللوحة نفسه ومصباح على لوحة التجارب معًا؛ وFade يُخفت GP14 وحده، لأنه لا توجد إشارة PWM على الوصلة إلى مصباح اللوحة. وأمثلة ذراع التحكم الخاصة بـ Pico (خطوات Fight stick الأربع، وFight stick، وLeverless controller، وMixbox-style controller، وStop the light) موجودة هنا أيضًا.
وأربعة أخرى لهذه اللوحة وحدها، لأنها وحدها لديها شبكة: WiFi: join the network، وWiFi: fetch the weather، وAPI lab: fetch JSON، وWiFi: a lamp on a web page، الذي يبدّل حالة المصباحين معًا من تبويب الويب.
بناء Pico W يستخدم كتلة يتركها Pico العادي غير معيّنة، لذا تحمل اللوحتان سلسلتي برنامج مختلفتين، ويعرض المحرر لكل منهما قائمتها الخاصة.
MicroPython وCircuitPython
اختر MicroPython (main.py) أو CircuitPython (code.py) في لوحة البرنامج الثابت للوحة، وزر «تشغيل» يقلع البرنامج الثابت الرسمي لـ Pico W: إصدار Pico W من MicroPython v1.29.0، أو إصدار CircuitPython 10.3.1. وكلاهما يشغّل شريحة CYW43439 كما يفعل على منضدة حقيقية، عبر أطراف الشريحة نفسها (GP23 وGP24 وGP25 وGP29)، والشريحة محاكاة بالقدر الذي يصل إليه مشغّلها: الناقل، ورفع البرنامج الثابت (يُقبل ثم يُهمل)، وأوامر WiFi.
- الـ LED هي GPIO 0 الخاصة بالشريحة:
Pin("LED")في MicroPython، وboard.LEDفي CircuitPython. - WiFi joins Mokxi's simulated access point, whose name and password are
the board's WiFi properties (Mokxi-Lab and breadboard unless you
change them). In MicroPython,
network.WLAN(network.STA_IF)connects andsocket,requestsandurequestsreach the.mokxisites; a socket server on the board opens in the Web panel. In CircuitPython,wifi.radio.connect()connects andsocketpoolwithadafruit_requestsfetches the same sites. - نقطة الوصول الخاصة باللوحة: تشغّل
WiFi.beginAP()(على 192.168.42.1، أو 192.168.4.1 في وضعWIFI_AP_STA، كما في arduino-pico) وnetwork.WLAN(network.AP_IF)في MicroPython (على 192.168.4.1) هذه النقطة، ثم تنضم لوحة الويب إليها كأنها هاتف وتفتح صفحة اللوحة هناك. - غير محاكى: البلوتوث، ومحطة ثانية على نقطة الوصول، ونقطة الوصول في CircuitPython، وتوفير الطاقة، وTLS، وأي شبكة غير شبكة Mokxi. في CircuitPython يرفع
wifi.radio.ap_infoاستثناءNotImplementedError، لأن نسخة Pico W منه لا تنفّذه.
راجع صفحة Pico لـ MicroPython ودليل CircuitPython على Pico لـ CircuitPython؛ وطراز Raspberry Pi Pico W فيه التفاصيل.
في مواضع أخرى
- صفحة اللوحة: /boards/pico-w
- وثيقة العقد: نموذج Raspberry Pi Pico W
- اللوحة التي هي نسخة منها: Raspberry Pi Pico
- بايثون عليها: CircuitPython على Pico