المرجع

عقد لوحة Raspberry Pi Pico W (المرحلة 9)

اللوحة Pico مع CYW43439: الشريحة غير مُنمذجة، وWiFi مُحاكى، وLED خلفها يعمل.

هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من Raspberry Pi Pico W و صفحة اللوحة.

Pico W هو Raspberry Pi Pico مع شريحة CYW43439. في كود Arduino لا تتم محاكاة CYW43439؛ أما في برامج MicroPython وCircuitPython الرسمية الثابتة، التي تتعامل معها بنفسها عبر أطرافها، فتُحاكى، وdocs/cyw43.md هو ذلك العقد (القسم 9 أدناه). كل ما تبقى في اللوحة هو ما في Pico، وdocs/pico.md هو العقد لكل ذلك: نفس RP2040، ونفس الرأس ذي الأربعين طرفًا بالترتيب نفسه، ونفس خريطة الذاكرة، ونفس سجلات الملحقات، ونفس نموذج الزمن ونفس بيئة التشغيل. مكوّن نواة واحد يخدم الاثنين (pico في crates/parts، مع علامة متغيّر)، لأن ما دون الشريحة اللاسلكية لا فرق بينهما.

نوع الفهرس هو picow. هذا المستند يذكر الاختلافات فقط: ثلاثة أطراف GPIO ومكان الـ LED فعلًا، وكتلة واحدة هي من صنع Mokxi نفسه.

اقرأ القسم 6 قبل التخطيط لأي شيء حول هذه اللوحة (والقسم 9 لمشروع Python). لا يوجد راديو هنا. ما يوجد، منذ docs/wifi.md، هو شبكة محاكاة خلف صندوق بريد عند عنوان يتركه RP2040 غير معيّن، وكلمة «محاكاة» هي كل القصة: لا 802.11، ولا برنامج CYW43 ثابت، ولا إنترنت حقيقي. LED اللوحة يعمل، لأن الوصول إليه يتم عبر صندوق البريد نفسه، وهو المكان نفسه الذي يُوصل به على العتاد أيضًا.

1. ما يختلف: ثلاثة أطراف GPIO والـ LED

ثلاثة من أطراف GPIO في RP2040 لا تصل إلى الرأس في كلتا اللوحتين، وهي موصّلة بأشياء مختلفة:

GPIO في Pico في Pico W
GP23 SMPS_MODE، طرف وضع المنظّم WL_ON، تغذية CYW43439
GP24 VBUS_SENSE WL_D، خط البيانات نصف المزدوج لـ CYW43439
GP25 الـ LED الأخضر WL_CS، اختيار شريحة CYW43439
GP29 ADC3، مقسّم VSYS WL_CLK، ومعه مقسّم VSYS

الـ LED في Pico W يتدلى من GPIO 0 الخاص بشريحة CYW43439 نفسها، ويُوصل إليه عبر الرابط الذي يستخدمه الراديو. إذن:

  • LED_BUILTIN ليس رقم GPIO على هذه اللوحة. بل هو MOKXI_WL_LED، رقم طرف أعلى من كل رقم حقيقي، و pinMode, digitalWrite و digitalRead ترسله إلى الجزء اللاسلكي عبر صندوق بريد القسم 3.8 بدل إرساله إلى طرف. هذا هو المسار الذي يسلكه Arduino core على العتاد الحقيقي، حيث LED_BUILTIN يمر عبر درايفر CYW43. digitalWrite(LED_BUILTIN, HIGH) لذلك يضيء مصباح اللوحة هنا، تمامًا كما يفعل على المكتب، و probe يبلّغ عنه بالبت 2، وهو يعود عبر صندوق البريد لا من طرف.
  • GP25 ليس الـ LED. رفعه إلى مستوى عالٍ هنا يرفع WL_CS, which is connected to a chip that is not modeled, and on a desk it would do the same. A sketch that writes GP25 expecting a light gets nothing, in Mokxi and on the bench. The Pico's own blink ELF, which writes GP25, lights nothing on this board, and crates/parts' gp25_is_wl_cs_here_and_lights_nothing يثبّته على تلك الحالة.
  • لا يوجد PWM خلف ذلك المصباح. الوصلة تنقل تشغيلًا وإيقافًا لا دورة عمل، لذا analogWrite(LED_BUILTIN, …) لا يفعل شيئًا على Pico W. fade يوضح ذلك ويستخدم GP14 بدلًا منه للتلاشي.
  • GP24 ليس هو طرف استشعار VBUS. نموذج Pico يبقيه مرتفعًا لأن تلك اللوحة تتغذى دائمًا من USB؛ هنا لا شيء يرفعه فيقرأ منخفضًا.

البديل (اعتبار GP25 هو الـ LED والاكتفاء بالأمل) جرى التفكير فيه ورُفض. كان سيجعل كودًا يضيء في المحاكي لا يفعل شيئًا على طاولة حقيقية، وهذا النوع الوحيد من الخطأ الذي لن يخرج به هذا المشروع. عدم وجود مصباح على الإطلاق كان الجواب الأول ولم يكن صحيحًا هو الآخر: المصباح موجود على اللوحة، والطريق إليه هو واجهة أوامر أصبح لهذا النموذج الآن. لذا جرى نمذجته في موضعه الحقيقي. DECISIONS.md، 2026-09-17.

كل ما تبقى في القسم 1 من docs/pico.md يظل كما هو: الأطراف الأربعون نفسها بالترتيب نفسه في الفهرس، والأسماء نفسها، وسلوك RUN و3V3_EN نفسه، والقضبان نفسها بالجهود نفسها، ومقاومات السحب البالغة 55 k وعتبة الدخل 1.65 V نفسها.

2. خريطة الذاكرة، 3. مسجّلات الوحدات الطرفية، 4. قناة المضيف

كما في القسمين 2 و3 و4 من docs/pico.md، مع إضافة كتلة واحدة ليست من الشريحة وبدون حذف أي شيء. إنه RP2040 نفسه: نافذة XIP للفلاش نفسها، وSRAM بسعة 264 KB نفسه، وRESETS وIO_BANK0 وPADS_BANK0 وTIMER وUART0 وPWM وSIO نفسها بالعناوين نفسها والبتات نفسها، وUART0 كقناة للمضيف.

The CYW43439 is on SPI-like signals that never leave the module, so nothing in the peripheral map changes to make room for it. What is added instead is Mokxi's own simulated network mailbox, which is not the CYW43 and does not pretend to be:

3.8 صندوق بريد شبكة Mokxi‏ (0x4FFF_E000)

هذه الكتلة ليست من RP2040، ولا توجد على Pico عادي. كل عنوان آخر في docs/pico.md هو من الشريحة، مأخوذ من ورقة البيانات، وأي صورة مبنية عليه تعمل على Pico حقيقي. أما هذا فهو من Mokxi نفسه: شبكة crates/net المحاكاة، فوق كل وحدة طرفية APB (تتوقف قبل 0x4008_0000 بكثير) وتحت نافذة AHB-Lite عند 0x5000_0000، بحيث إن أي صورة تستخدمه تسبب خطأً على السيليكون بدلًا من قراءة مسجّل وحدة طرفية أخرى. ذلك الخطأ هو الجواب الصادق، لأن الشيء الكامن خلف هذه الكتلة غير موجود على الشريحة.

لماذا صندوق البريد هو الشكل الصادق هنا أيضًا. الجزء اللاسلكي في Pico W حقيقي هو CYW43439 في الطرف الآخر من وصلة SPI-ish بثلاثة أطراف، يعمل بواسطة كتلة برامج ثابتة مغلقة. إنه ليس مجموعة مسجّلات موثقة على RP2040، تمامًا كما أن راديو ESP32 ليس مجموعة مسجّلات موثقة على شريحته نفسها، وWiFi.h من Arduino على Pico W ينتهي به الأمر فعلًا في الطرف الآخر من واجهة أوامر. لذا فهذه واجهة أوامر: الواجهة نفسها، بايتًا ببايت، التي تستخدمها لوحات ESP الأربع، عند عنوان هذه اللوحة الخاص.

يُربط فقط على Pico W. يعرّف firmware/pico/build.sh‏ MOKXI_BOARD_PICO_W لتلك اللوحة وليس للـ Pico، لذا يُترجم WiFi.h لأحدهما ويرفض للآخر، وSoc::new في crates/rp2040 يترك العنوان فجوة بينما Soc::new_with_network يربطه. على Pico عادي يسبب الوصول خطأً، وهذا ما ينبغي للوحة بلا جزء لاسلكي أن تفعله.

لا ترفع هذه الكتلة أي مقاطعة NVIC. رقم المقاطعة يخص الشريحة، وهذه الكتلة ليست من الشريحة، لذا لم يُعطَ لها رقم. البرنامج الثابت يستخدم الاستطلاع، والنواة المتوقفة في WFI تُوقظ أيضًا عندما تكون لدى الشبكة شيء تقوله، بنفس الطريقة التي تُوقظ بها عند حافة PWM.

لا يوجد هنا لا راديو، ولا 802.11، ولا إنترنت حقيقي. لا شيء في النموذج يرسل أو يمسح أو يرتبط أو يشفّر أو يفتح مقبسًا: كلمة المرور تُقارن كسلسلة نصية، والاسم الذي لا يقع تحت .mokxi لا يُحلّ، والأصول الثلاثة التي تخدمها الشبكة هي دوال في crates/net/src/http.rs. صندوق البريد هو شكل الفاصل الحقيقي وليس خيالًا عن MAC: على ESP32 حقيقية، عتاد WiFi هو كتلة ثنائية مغلقة ذات واجهة أوامر، وتنتهي مكتبة WiFi.h الخاصة بـ Arduino على الجانب الآخر من إحدى هذه الواجهات. docs/wifi.md هو العقد الذي يحدد ما خلفها؛ هذا القسم هو السجلات فقط.

سجل أوامر، وسجل حالة، وذاكرة حلقية بحجم 4096 بايت في كل اتجاه، وبت مقاطعة. كتابة NET_CMD_REG تشغّل الأمر؛ الأمر الذي يستغرق وقتًا في المحاكاة يرفع BUSY ثم يمسحه، مع DONE في NET_INT_RAW_REG، عند اكتماله.

الإزاحة الاسم البتات
0x00 NET_ID_REG يقرأ 0x494B4F4D، ولا شيء آخر يقرأه. الكود الذي يريد معرفة إن كان يعمل على Mokxi يقرأ هذا؛ أما على الرقاقة الحقيقية فيفشل الوصول
0x04 NET_CMD_REG اكتب كود أمر (الجدول أدناه)؛ الكتابة تشغّله
0x08 NET_ARG_REG وسيطة واحدة من كلمة، تُقرأ مجددًا: المنفذ لأمر LISTEN، والحالة لأمر REPLY
0x0C NET_STATUS_REG البت 0 ‏BUSY، البت 1 ‏ERR، البت 2 ‏RX_READY، البت 3 ‏LINK، البت 4 ‏SERVE، البتات 8..11 ‏STATE
0x10 NET_RESULT_REG ما أجاب به الأمر الأخير
0x14 NET_INT_RAW_REG البت 0 ‏DONE، البت 1 ‏EVENT
0x18 NET_INT_ENA_REG نفس البتّين
0x1C NET_INT_CLR_REG اكتب 1 للمسح، نفس البتّين
0x20 NET_TX_LEN_REG البايتات المجهّزة في حلقة الإرسال
0x24 NET_TX_DATA_REG كتابة: ادفع بايتًا واحدًا (البتات 0..7) إلى حلقة الإرسال
0x28 NET_RX_LEN_REG البايتات المنتظرة في حلقة الاستقبال
0x2C NET_RX_DATA_REG قراءة: أخرج بايتًا واحدًا من حلقة الاستقبال، ويكون 0 عند فراغها
0x30 NET_RING_LEN_REG سعة كل حلقة بالبايتات، حتى لا يضطر البرنامج الثابت إلى تثبيت 4096 في الكود
0x40 NET_BT_CMD_REG Bluetooth: اكتب رمز أمر Bluetooth ‏(docs/bluetooth.md)؛ الكتابة تشغّله
0x44 NET_BT_ARG_REG Bluetooth: كلمة وسيطة واحدة، تُقرأ مجددًا؛ الحدث يترك رقمه هنا
0x48 NET_BT_RESULT_REG Bluetooth: ما أجاب به أمر Bluetooth الأخير
0x4C NET_BT_STATUS_REG البت 0 ‏CLASSIC_ON، البت 1 ‏CLASSIC_LINK، البت 2 ‏EVENT، البت 3 ‏BLE_ADV، البت 4 ‏BLE_LINK، البت 5 ‏BT_ERR، البت 8 ‏HAS_CLASSIC، البت 9 ‏HAS_BLE
0x50 NET_BT_TX_LEN_REG Bluetooth: البايتات المجهّزة في حلقة الإرسال الخاصة به
0x54 NET_BT_TX_DATA_REG Bluetooth: كتابة: ادفع بايتًا واحدًا إلى تلك الحلقة
0x58 NET_BT_RX_LEN_REG Bluetooth: البايتات المنتظرة في حلقة الاستقبال الخاصة به
0x5C NET_BT_RX_DATA_REG Bluetooth: قراءة: أخرج بايتًا واحدًا، ويكون 0 عند الفراغ

تقرأ مسجّلات NET_BT_ الثمانية القيمة 0 وتتجاهل الكتابة على هذه اللوحة: فـ CYW43439 هي التي تقوم بالبلوتوث على Pico W حقيقي، وMokxi لا ينمذجه (docs/bluetooth.md).

STATE يدل على حالة المحطة: 0 خاملة، 1 تبدأ بالعمل، 2 تتصل، 3 متصلة، 4 فشلت، 5 لا توجد شبكة بهذا الاسم. NET_CMD_STATUS يحوّل الشيء نفسه إلى رمز wl_status_t الخاص بـ Arduino الذي يقرأه الكود من WiFi.status().

NET_CMD_REG الاسم ما يفعله
0 NOP لا شيء
1 RESET قطع الاتصال، وإسقاط الحلقتين، وإسقاط أي طلب
2 CONNECT تحمل حلقة الإرسال ssid\0password؛ يرفع BUSY لمدة ثانية إلى ثلاث ثوانٍ
3 DISCONNECT قطع الاقتران والعنوان
4 STATUS NET_RESULT_REG = رمز wl_status_t
5 IP NET_RESULT_REG = العنوان المستأجر، والمجموعة الثمانية الأولى في البايت المنخفض
6 RSSI NET_RESULT_REG = الإشارة بوحدة dBm، بعد تمديد بت الإشارة
7 SSID تستقبل حلقة الاستقبال اسم نقطة الوصول
8 MAC تستقبل حلقة الاستقبال بايتات MAC الستة للوحة
9 REQUEST تحمل حلقة الإرسال الصادرة method\0url\0headers\0body؛ وتطلق BUSY
10 POLL NET_RESULT_REG = 0 أثناء التنفيذ، ثم حالة HTTP، أو خطأ سالب مع رفع ERR؛ ويهبط المتن في حلقة الاستقبال
11 LISTEN استمع على المنفذ الموجود في NET_ARG_REG
12 ACCEPT NET_RESULT_REG = 1 وتحمل حلقة الاستقبال method\0path\0query\0body، أو 0 عندما لا ينتظر شيء
13 REPLY أجب على الطلب المقبول بالحالة الموجودة في NET_ARG_REG؛ وتحمل حلقة الإرسال content-type\0body
14 STOP أوقف الاستماع
15 WL_GPIO_SET تشغّل منافذ GPIO الخاصة بالجزء اللاسلكي نفسه من NET_ARG_REG، البت 0 أولًا. البت 0 هو LED هذه اللوحة
16 WL_GPIO_GET تقرأها مرة أخرى إلى NET_RESULT_REG
17 BLYNK عملية واحدة على خادم Blynk المحاكى، العملية في NET_ARG_REG وحقولها في حلقة الإرسال؛ وتُجاب فورًا في NET_RESULT_REG، مع رفع ERR بمعزل عن الشبكة (docs/wifi.md، "Blynk")
20 SOFTAP نقطة الوصول الناعمة (crates/net/src/softap.rs، docs/wifi.md)، العملية في NET_ARG_REG: ‏1 ترفعها (حلقة الإرسال ssid\0password\0 وبايت القناة؛ وNET_RESULT_REG بقيمة 1، أو 0 مع ERR لاسم فارغ أو كلمة مرور من حرف إلى سبعة أحرف)، 2 تخفضها، 3 تضبطها (العنوان والبوابة وقناع الشبكة، أربعة بايتات لكل منها)، 4 عنوانها (0 وهي مخفضة)، 5 المحطات المنضمة، 6 الانضمامات والمغادرات وبتّ الرفع التي يحوّلها وقت التشغيل إلى أحداث، 7 و8 تشغيل خادم DNS لبوابة أسيرة (الاسم، وبايت صفر، والعنوان) وإيقافه، 9 اسمها إلى حلقة الاستقبال، 10 عنوان الهاتف، 11 ‏Host للطلب الجاري خدمته إلى حلقة الاستقبال. المحطة الوحيدة هي هاتف لوحة الويب

الأمران 15 و16 خاصان بهذه اللوحة وحدها. لوحات ESP الأربع تربط صندوق البريد نفسه وراديوهاتها لا تملك مثل هذا الطرف، لذا على تلك اللوحات يضبط كلاهما ERR ولا يشغّلان شيئًا: اختراع طرف يعني اختراع عتاد. أما هنا فهما الطريق الذي يسلكه LED_BUILTIN (القسم 1).

رموز POLL السالبة: ‏-1 الاسم لا يُحلّ، -2 المحطة غير مقترنة، -3 ‏https:// وTLS غير محاكى، -4 متن أطول من الحلقة، -5 عنوان URL لا تستطيع هذه الشبكة تحليله، -6 طلب قيد التنفيذ بالفعل. firmware/include/HTTPClient.h يحوّلها إلى الرموز على طريقة Arduino التي يقارنها الكود بها، وdocs/wifi.md يسرد المطابقة.

التوقيت، كله من هذا النموذج وكله مذكور في docs/wifi.md: يستغرق الاقتران بين ثانية وثلاث ثوانٍ، محددًا من SSID حتى يستغرق الدرس الوقت نفسه مرتين؛ كلمة المرور الخاطئة تصبح WL_CONNECT_FAILED بعد خمس ثوانٍ؛ الطلب إلى أصل محاكى يعود بعد 60 ms؛ والطلب إلى خادم الكود نفسه الذي لا يجيبه الكود أبدًا تغلقه الشبكة بخطأ 504 بعد عشر ثوانٍ.

5. نموذج الزمن والقطعة

كما في القسم 5 من docs/pico.md، مع اختلاف واحد في probe.

probe قناع بتات: 1 يعني يعمل، 2 متوقفة في WFI، 4 LED اللوحة، 8 إرسال تسلسلي خلال آخر 20 ms، 16 استقبال تسلسلي، 32 مع الاستمرار على BOOTSEL؛ و0 بلا برنامج. البت 2 يعني الشيء نفسه الذي يعنيه على Pico لكنه يأتي من مكان آخر: على Pico هو طرف GP25، وهنا هو GPIO 0 الخاص بـ CYW43439، يُقرأ مرة أخرى عبر صندوق البريد. وصف probe في مدخل الفهرس نفسه يقول ذلك، لذا تستطيع أداة تقرأ الفهرس تعلّمه دون قراءة هذا المستند.

poke هو نفسه الخاص بالـ Pico: 1 يضغط BOOTSEL، و0 يتركه، و2 يبقي RUN منخفضًا، و3 يتركه.

6. اللاسلكي

الراديو محاكى. لا يوجد 802.11 في أي مكان في Mokxi، ولا CYW43439، ولا إنترنت حقيقي، ولا طلب يغادر تبويب المتصفح أبدًا. docs/wifi.md هو العقد وهو يتقدم على هذا القسم؛ ما يلي هو النسخة المختصرة وما يخص هذه اللوحة تحديدًا.

يمكن للكود استخدام WiFi.h وWiFiClient.h وWiFiClientSecure.h وHTTPClient.h وWebServer.h (نفس واجهة Arduino المألوفة التي ينسخها صاحب Pico W من درس تعليمي)، وسينضم إلى شبكة، ويجلب صفحة، ويقدّم واحدة. خلف تلك الاستدعاءات يوجد صندوق بريد القسم 3.8 وcrates/net: آلة حالات للنقطة تلتزم بحدود من ثانية إلى ثلاث ثوانٍ، وعقد DHCP واحد عند 192.168.4.2، وأربعة مصادر مختلقة تحت .mokxi. ونقطة الوصول هي ثلاث خصائص للوحة (wifiSsid وwifiPassword وwifiRssi)، لأنه بلا راديو لا يوجد شيء ليمسحه.

الصياغات الخاصة بـ arduino-pico نفسها. الترويسات هي ترويسات نواة ESP32، لأن بيئة التشغيل هي الخاصة بـ ESP32-C3، وواجهة WiFi في arduino-pico هي تلك الواجهة مع بعض الأسماء الخاصة بها. أمثلتها (HelloServer وBasicHttpsClient وأمثلة WiFiServer) تستخدم تلك الأسماء، لذا على هذه اللوحة، وعلى هذه اللوحة فقط، تحمل الترويسات هي أيضًا (#if defined(ARDUINO_RASPBERRY_PI_PICO_W)):

arduino-pico هنا
WiFi.h يعرّف WiFiMulti وWiFiClientSecure وNTP الشيء نفسه، دون تضمين خاص بهما
WiFi.connected() وbeginNoBlock() وend() status() == WL_CONNECTED وbegin() وdisconnect(true)
WiFi.lowPowerMode() وnoLowPowerMode() وsetTimeout() مقبولة، لا تغيّر شيئًا
WiFi.beginAP() softAP(): نقطة الوصول الناعمة على 192.168.42.1، أو 192.168.4.1 في وضع WIFI_AP_STA، كما يختارها beginAP الخاص بـ arduino-pico (libraries/WiFi/src/WiFiClass.cpp)، إلا إذا ضبط softAPConfig() عنوانًا آخر، وهو ما تتصل به لوحة الويب عبر الهاتف (docs/wifi.md)
WiFi.ping() -1، وتقول مرة واحدة إن ICMP لا يُنقل
WiFi.getHostname() PicoW حتى setHostname()
LEAmDNS.h‏ (MDNS.begin()، MDNS.update()) ESPmDNS.h: يُترجم، ويقول إن الاسم لن يُحل
HTTPClient::setInsecure() وsetFingerprint() وsetCACert() وsetX509Time() وsetBufferSizes() مقبولة؛ لكن طلب GET على https:// يفشل مع ذلك بالخطأ HTTPC_ERROR_NO_TLS
rp2040.getFreeHeap()، getUsedHeap()، getTotalHeap() ذاكرة بيئة التشغيل (على الـ Pico أيضًا)

لوحات ESP لا تحصل على هذه الأسماء، لأن أنويتها لا تتضمنها، ولوحة Pico العادية لا تزال ترفض WiFi.h؛ ونصيحة البناء هناك تقول: غيّر اللوحة إلى Pico W. ملف web/src/compile/picow-wifi.test.ts يشغّل الأمثلة.

ما ليس موجودًا هنا، ولن يكون:

  • لا 802.11 بأي شكل. لا قناة، لا مسح، لا WiFi.scanNetworks()، لا إشارة beacon، لا إطارات association، لا WPA2، لا PMK، لا تشفير. كلمة المرور تُقارن كسلسلة نصية. RSSI() هي خاصية، وليست فقد مسار.
  • لا CYW43439 كشريحة، من جهة الكود. لا بروتوكول SPI إليها، لا كتلة برنامج ثابت، لا مشغّل، لا سجلات. (MicroPython و CircuitPython مسألة أخرى: القسم 9.) طرفها GPIO 0 مُنمذج، لأنه LED اللوحة وهو طرف يُشغّله الكود فعلًا؛ والأمران اللذان يصلان إليه موجودان في جدول القسم 3.8 ولا يُشغّلان شيئًا على أي لوحة أخرى. لا شيء من أطراف GPIO الأخرى مُنمذج، ولا يوجد PWM على الطرف المُنمذج.
  • No sequencing. On real hardware the CYW43 has to be powered and its firmware blob loaded before its GPIO 0 will do anything, which the Arduino core does at start-up. Here the command works from the first instruction, whether or not the sketch has called WiFi.begin(). That is a simplification and this is where it is written down.
  • لا Bluetooth. لا LE، لا GATT، لا إقران، لا دالة وهمية. شريحة CYW43439 تتولى Bluetooth على العتاد الحقيقي؛ Mokxi لا تنمذجها، ولا يوجد ملف رأس يفشل الكود عنده.
  • لا إنترنت حقيقي. لا TCP، لا حزمة IP، لا مقابس sockets، لا بروتوكول DNS. أي اسم ليس تحت .mokxi يفشل بجملة واحدة يستطيع الكود قراءتها وتطبعها لوحة السحابة.
  • لا TLS. WiFiClientSecure تُترجم ثم تفشل، لأن TLS يثق بكل شيء سيعلّم الطالب أن https مجاني.

إذا كانت اللاسلكي الحقيقي هي غاية مشروعك، فهذه اللوحة في Mokxi ليست الأداة المناسبة، وكذلك أي لوحة أخرى: لا يوجد راديو في هذا المنتج. الغرض منها هو تعلّم شكل الكود (حلقة الاتصال، رموز الحالة، HTTPClient، معالِج WebServer) وكل ما تؤديه Pico تحتها.

7. زمن تشغيل البرنامج الثابت

firmware/pico/، مع علامة واحدة: firmware/picow/build.sh يشغّله بـ BOARD=picow، مما يضيف -DMOKXI_BOARD_PICO_W. تلك العلامة تعرّف MOKXI_NET_BASE في include/rp2040.h وتُدرج firmware/include/mokxi_net.h، وهذا ما يجعل ملفات رأس الشبكة تُترجم؛ كما تُدخل wifi.cpp الخاص بـ ESP32-C3 في الوصلة، لأن بيئة تشغيل الشبكة لا تعرف عن اللوحة شيئًا سوى ذلك العنوان الواحد. كل شيء آخر (crt0.S، link.ld، src/، arduino.h) هو خاص بـ Pico، دون تغيير ودون نسخ.

الكتالوج program السلسلة هي elf32 arm rp2040 picow، وليست سلسلة Pico. اللوحتان تشغّلان نفس مجموعة التعليمات على نفس خريطة الذاكرة، لكن صورة مبنية للوحة W تكتب إلى عنوان تتركه Pico العادية غير مُعيَّن، فتنهار هناك. سلسلتان تعنيان أن المحرر يقدّم لكل لوحة قائمتها الخاصة، تمامًا كما تبقى سلسلة Nano منفصلة عن سلسلة Uno (docs/nano.md القسم 6)، و web/public/firmware/picow/index.json هي تلك القائمة.

الأمثلة الثمانية: blink وbutton وserial وfade وchaser تُقرأ مباشرةً من firmware/pico/examples/ بدلًا من نسخها؛ أما wificonnect وwifiweather وwifilamp فتوجد في firmware/picow/examples/، لأن هذه اللوحة وحدها قادرة على ترجمتها. blink يشغّل LED_BUILTIN وGP15، وعلى هذه اللوحة يمر الأول منهما عبر صندوق البريد إلى GPIO 0 في CYW43، لذلك يومض المصباحان معًا. fade يعمل التلاشي على GP14 فقط، لأنه لا توجد PWM على الطرف الآخر من هذا الرابط. wifilamp يشغّل الاثنين معًا، لذلك تُشغّل الصفحة مصباحًا على اللوحة وآخر على لوحة التجارب.

توجد فعلًا عائلة ترجمة منفصلة وحزمة زمن تشغيل منفصلة (picow)، لأن الحزمة تُميَّز بسلسلة program. الكود المكتوب في المحرر للوحة Pico W يُترجم في المتصفح، مثل كود Pico.

8. ما هو غير مُنمذج

كل ما في docs/pico.md القسم 6 (النواة الثانية، PIO، DMA، SPI، I2C، USB، ساعة الوقت الحقيقي، شجرة الساعات، boot ROM، ومحمّل الإقلاع الثاني؛ أما ADC فمُنمذج، docs/pico.md القسم 5a)، بالإضافة إلى:

  • الشريحة CYW43439، من جهة الكود، في كل تفصيل إلا واحدًا: بروتوكول SPI الخاص بها، كتلة برنامجها الثابت، سجلاتها، إحساس VBUS على GPIO 2، و802.11 في أي نطاق، وBluetooth، والهوائي. الاستثناء هو GPIO 0، LED اللوحة، وهو مُنمذج لأن الكود يشغّله فعلًا: عبر صندوق البريد، تشغيلًا أو إيقافًا، دون PWM. الشبكة المحاكاة في القسم 6 ليست نموذجًا لهذه الشريحة وليست عند عنوانها؛ إنها كتلة من كتل Mokxi نفسها، والقسم 3.8 يقول ذلك في سطره الأول.
  • GP23 و GP24 و GP25 و GP29 كإشارات لاسلكية، من جهة الكود. إنها موجودة في نموذج RP2040 كأطراف GPIO عادية، لأن هذا ما تحويه الشريحة، ولا شيء يستمع في الطرف الآخر.

9. MicroPython و CircuitPython: الشريحة CYW43439 على أطرافها

لوحة Pico W تُقلع عبر ROM الخاص بها (حزمة MicroPython أو CircuitPython، أو UF2 جاهز من pico-sdk) تجعل CYW43439 على GP23 و GP24 و GP25 و GP29، مُنمذجة من أطرافها إلى الداخل بالعمق الذي يصل إليه cyw43-driver في البرامج الثابتة الرسمية: ناقل PIO gSPI، والـ backplane، ورفع البرنامج الثابت (يُقبل ويُهمَل)، وبديل SDPCM لبرنامج WiFi الثابت يجيب على ioctl وينضم إلى نقطة الوصول في crates/net. docs/cyw43.md هو العقد. على ذلك المسار:

  • الـ LED هو الطرف GPIO 0 الخاص بالشريحة، يُشغَّل عبر gpioout فوق الناقل: Pin("LED") في MicroPython، board.LED في CircuitPython، بت المجس رقم 4 كما في الكود.
  • الـ WiFi هي lwIP الخاصة بالبرنامج الثابت فوق إطارات Ethernet إلى نقطة الوصول عند 192.168.4.1 (crates/net/src/lan.rs)، وهي نفسها التي تستخدمها لوحات ESP32 في MicroPython: DHCP، وDNS لأسماء .mokxi، وTCP إلى المنفذ 80، وخادم على اللوحة تصل إليه لوحة الويب. قيم اللوحة wifiSsid و wifiPassword و wifiRssi هي نقطة الوصول.
  • صندوق البريد عند 0x4FFF_E000 غير مُعيَّن: هذه البرامج الثابتة لا تلمسه أبدًا، وعلى السيليكون هو ثقب.
  • مُشغِّل CircuitPython يبدأ عند 1540 KB، بعد 1536 KB من البرنامج الثابت و4 KB من NVM في بناء W.
  • أين يعمل. ذلك الإقلاع يحتاج CYW43439 وطرف الشبكة IP خلفه (net/lan)، وميزة cyw43 في الحزمة rp2040. مُحاكي المحرر مُبنٍ بدونها، لذا فإن لوحة Pico W تُقلع عبر ROM تعمل على نموذج الشريحة الكامل rp2040::whole (النوع KIND_PICO_W من esp_common::whole_chip) في وحدة wasm لنماذج الشرائح، تُجلب عند أول ضغطة «تشغيل» من هذا النوع، كما تفعل لوحات ESP32 في MicroPython (docs/micropython-esp32.md القسم 7). القطعة تحمل rp2040::chip::Chip: RP2040 للكود، والنموذج لإقلاع ROM. أما في البناء الأصلي فيكون النموذج مضمّنًا فيه. docs/cyw43.md القسم 6 فيه التفاصيل.

بلوتوث، ومحطة ثانية على نقطة الوصول الناعمة (هاتف لوحة الويب ينضم إلى AP_IF، docs/cyw43.md)، وتوفير الطاقة و TLS ليست مُنمذجة هناك أيضًا.

هذا هو الفرق كله. أي شيء لا يذكره هذا المستند فهو من خصائص Pico، وdocs/pico.md هو المكان الذي كُتب فيه.