هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من 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 ownblinkELF, which writes GP25, lights nothing on this board, andcrates/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 هو المكان الذي كُتب فيه.