الراديو محاكى. لا يوجد 802.11 في أي مكان في Mokxi، ولا يمكن لأي شيء يفعله الكود أن يصل إلى الشبكة التي يعمل عليها متصفحك. ما هو أمين هو كود Arduino الذي تكتبه، وهذا هو الهدف كله، لأنه الكود نفسه الذي كنت ستكتبه للوحة حقيقية.
كل لوحة فيها راديو على العتاد الحقيقي تملكه هنا: عائلة ESP32 (ESP32-C3 وESP32-C6 وESP32 الكلاسيكية وESP32-S3، واللوحات المبنية عليها، مثل XIAO وNano ESP32)، ولوحات ESP8266، وRaspberry Pi Pico W وUno R4 WiFi. على كل لوحة أخرى هنا، بما فيها Raspberry Pi Pico العادية التي لا تحمل أي قطعة لاسلكية، يتوقف #include <WiFi.h> مع رسالة تفيد بذلك بدلًا من الكتابة إلى عنوان لا تملكه شريحته. هذا مقصود: stub يجيب "غير متصل" سيكون كذبة بشكل مقنع، أما خطأ الترجمة فلا.
ما هو حقيقي وما هو ليس كذلك
حقيقي، بمعنى أنه يتصرف كما ستتصرف لوحتك:
- الاستدعاءات (
WiFi.begin()وWiFi.status()وWiFi.localIP()وHTTPClientوWebServer) بالتواقيع التي يعطيك إياها الدليل التعليمي؛ - رموز الحالة، وهي enum الخاصة بـ Arduino نفسها، قيمة بقيمة؛
- التوقيت: يستغرق الانضمام بين ثانية وثلاث ثوانٍ، وكلمة المرور الخاطئة تفشل بعد خمس، وهذا ما يحدث مع لوحة حقيقية على شبكة هادئة؛
- الكلفة: الطلب يستغرق فعلًا 60 ms من وقت الكود، والكود الذي ينسى
server.handleClient()لا يجيب فعلًا أبدًا.
غير حقيقي، ولم يُدّعَ يومًا أنه كذلك:
- لا راديو. لا قناة، لا بحث، لا
scanNetworks()، لا beacon، لا WPA2، لا أي تشفير. تُقارن كلمة المرور كسلسلة نصية. - لا إنترنت حقيقي إلا إذا فعّلته. لا TCP، لا DNS، لا sockets، لا شيء يخرج من علامة تبويب المتصفح. توجد أربعة أسماء مختلقة تحت
.mokxiولا غيرها، حتى تفعّل مفتاح الإنترنت الحقيقي في لوحة Cloud: عندها يخرج طلب أي اسم آخر عبر بوابة Mokxi. - لا TLS على اللوحة.
WiFiClientSecureيترجم ثم يفشل، ويقول ذلك. عنوانhttps://يفشل بالطريقة نفسها، إلا إذا كان الإنترنت الحقيقي مفعّلًا: عندها تتولى البوابة إجراء TLS لطلبHTTPClient. لو وُجد TLS على اللوحة يثق بكل شيء لعلّمك أن https مجاني. - لا جهاز ثانٍ. لوحة واحدة، شبكة واحدة، عنوان واحد. لا شيء خارج علامة تبويب المتصفح هذه يستطيع الوصول إلى الخادم الذي يعمل عليه كودك. نقطة الوصول الخاصة باللوحة (أدناه) عليها هاتف واحد بالضبط، لوحة Web.
RSSI()إعداد، لا قياس. تحريك اللوحة في مساحة العمل لا يغيّر شيئًا.- NTP يعطي ساعة المحاكاة، لا الوقت الحقيقي. لا يوجد UDP ولا خادم NTP، والمحاكاة لا تعرف تاريخ اليوم، لذا يضبط
configTime()وupdate()في NTPClient الساعة على 2026-01-01 00:00:00 UTC عند التشغيل مضافًا إليها الثواني المنقضية، والشاشة التسلسلية تذكر ذلك مرة واحدة. - Bluetooth is its own simulation. The ESP32 boards' Bluetooth serial and BLE talk to a phone in the Bluetooth pane (بلوتوث، محاكى). بلوتوث Pico W غير محاكى.
ضبط الشبكة
اضغط على اللوحة وانظر إلى لوحة الخصائص: wifiSsid وwifiPassword وwifiRssi. هذه الثلاثة هي نقطة الوصول الوحيدة التي تراها هذه اللوحة. من دون راديو لا يوجد ما يُبحث عنه، لذا فالشبكة خاصية للوحة لا قطعة تضعها بجانبها.
طابِقها في الكود الخاص بك فتتم الوصلة. أخطئ في أيٍّ منهما عمدًا وشاهد ما يحدث. هذا هو الدرس الأفيد من الاثنين.
لوحة السحابة تعدّل القيم الثلاث نفسها أثناء تشغيل الكود، فيمكنك سحب الشبكة من تحت لوحة تعمل وترى حلقة الاتصال تبدأ من جديد.
الانضمام
#include <WiFi.h>
void setup() {
Serial.begin(115200);
WiFi.begin("Mokxi-Lab", "breadboard");
while (WiFi.status() != WL_CONNECTED) {
Serial.print(".");
delay(250);
}
Serial.println(WiFi.localIP()); // 192.168.4.2
}
تمرّ WiFi.status() بـ WL_IDLE_STATUS، ثم WL_DISCONNECTED أثناء الاقتران، ثم WL_CONNECTED. لا توجد WL_CONNECTING في Arduino، ولهذا السبب كُتبت الحلقة أعلاه بالطريقة التي تكتبها كل الأدلة.
كلمة المرور الخاطئة تصبح WL_CONNECT_FAILED بعد خمس ثوانٍ. الاسم الذي ليس هو الاسم الموجود على اللوحة يصبح WL_NO_SSID_AVAIL. العنوان دائمًا 192.168.4.2، وهو العنوان نفسه بعد disconnect() ونداء begin() مرة ثانية.
جلب البيانات
#include <HTTPClient.h>
WiFiClient client;
HTTPClient http;
http.begin(client, "http://weather.mokxi/");
int code = http.GET();
if (code > 0) Serial.println(http.getString());
else Serial.println(HTTPClient::errorToString(code));
http.end();
توجد أربعة عناوين على شبكة الإنترنت المحاكاة هذه:
http://time.mokxi/: ساعة المحاكاة، كسلسلة ISO. إنها ساعة النواة المحسوبة من منتصف ليل ثابت، لا وقت اليوم، لأن المحاكاة لا تعرف أي يوم هو.http://weather.mokxi/: JSON فيه درجة حرارة ورطوبة تضبطهما في لوحة Cloud. غيّر واحدة وسيُعيد الطلب التالي الرقم الجديد.http://echo.mokxi/: أي شيء ترسله بـPOSTيعود إليك كما هو. وهو أيضًا خادم WebSocket الوحيد هنا:WebSocketsClientمن مكتبة WebSockets الموجّه إلىecho.mokxiيرسل كل رسالة كطلب واحد إليه ويستعيدها كـWStype_TEXT. هذا صدى محاكى يُنقل عبر HTTP، لا WebSocket حقيقي على السلك؛ وأي مضيف WebSocket آخر يحتاج لوحة حقيقية.http://api.mokxi/: الحالة ونوع المحتوى ومتن JSON التي تضبطها في لوحة Cloud، فيمكنك التدرّب على نجاح أو خطأ أو بيانات ناقصة.
أي شيء آخر لا يُحلّ. http://example.com/ يعيد HTTPC_ERROR_CONNECTION_REFUSED، وHTTPClient::errorToString() يخبرك بالسبب في سطر واحد: لا إنترنت حقيقي: الأسماء تحت .mokxi فقط. هذا الرفض قابل للقراءة من الكود بشكل مقصود. إنه أمر يستحق التدريس، لا أمر يجب إخفاؤه.
التقديم (الخادم)
#include <WebServer.h>
WebServer server(80);
void setup() {
// ... join the network first ...
server.on("/", [](){ server.send(200, "text/html", "<h1>hello</h1>"); });
server.begin();
}
void loop() { server.handleClient(); }
on(path, handler) وonNotFound() وsend(code, type, body) وarg(name) وhasArg() وuri() وmethod(). المعالجات هي كودك، وتعمل على نواة اللوحة بساعة اللوحة.
لوحة الويب (تبويب بجانب Serial على طول الأسفل) هي المتصفح لها. فيها شريط عنوان يبدأ من http://192.168.4.2/، وزر تحديث، والصفحة نفسها داخل إطار مع إيقاف السكربتات. الروابط والأزرار في تلك الصفحة تعود إلى كودك، وهذا ما يجعل «بدّل LED من صفحة ويب» يعمل من طرف إلى طرف.
إذا لم تصل الصفحة أبدًا، تقول اللوحة ذلك، وبعد عشر ثوانٍ تردّ الشبكة بـ 504 بنفسها: السبب المعتاد هو loop() توقّف عن نداء handleClient().
نقطة الوصول الخاصة بلوحتك
يمكن للكود أن يبدأ شبكة خاصة به بدلًا من الانضمام إلى واحدة، كما تفعل صفحة الإعداد أو متحكم روبوت:
#include <WiFi.h>
#include <WebServer.h>
WebServer server(80);
void setup() {
Serial.begin(115200);
WiFi.softAP("MyESP", "12345678");
Serial.println(WiFi.softAPIP()); // 192.168.4.1
server.on("/", [](){ server.send(200, "text/html", "<h1>hello</h1>"); });
server.begin();
}
void loop() { server.handleClient(); }
لوحة Web هي الهاتف الذي ينضم إليها. بعد نحو ثانية ونصف من ظهور نقطة الوصول، يظهر صف تحت شريط العنوان يقول Phone joined MyESP، وينتقل شريط العنوان إلى http://192.168.4.1/: اضغط اذهب. اضغط Leave فيغادر الهاتف؛ وانضم ينضم مجددًا بكلمة المرور في الصندوق، والخاطئة تُرفض كما على الهاتف. أثناء الانضمام، تكون WiFi.softAPgetStationNum() تساوي 1، وتستقبل WiFi.onEvent() حدثي اتصال المحطة وانقطاعها.
يجب أن تكون كلمة المرور من 8 إلى 63 حرفًا (أو لا شيء، لشبكة مفتوحة)، وإلا تُرجع softAP() قيمة false، كما على اللوحة الحقيقية. softAPConfig() تنقل العنوان. WIFI_AP_STA تشغّل الاثنين معًا: تحتفظ اللوحة بعقد إيجارها في الشبكة المحاكاة وتظل قادرة على جلب صفحات .mokxi. على Pico W يكون العنوان 192.168.42.1 (و192.168.4.1 مع المحطة مفعّلة أيضًا)، كما تختار arduino-pico، وWiFi.beginAP() تبدأ به؛ وعلى Uno R4 WiFi، تتصرف WiFi.beginAP() وWL_AP_CONNECTED كما في أمثلة WiFiS3.
تعمل البوابات الأسيرة أيضًا: ابدأ DNSServer بـ dnsServer.start(53, "*", WiFi.softAPIP()) وعندما ينضم الهاتف، تفتح لوحة Web صفحتك بنفسها، كما يعرض الهاتف صفحة تسجيل دخول. في MicroPython، network.WLAN(network.AP_IF) هي نقطة الوصول نفسها، وخادم sockets على المنفذ 80 يظهر في لوحة Web.
الهاتف الواحد هو كل ما يوجد: لا يمكن لجهاز ثانٍ الانضمام، ولا شيء يصل إلى الإنترنت عبر اللوحة.
لوحة Cloud
كل طلب، في الاتجاهين: ما طلبته اللوحة من الإنترنت المحاكاة، وما طلبته لوحة Web من اللوحة، مع الطريقة والعنوان والحالة والمتون، وعندما يفشل شيء، سطر يذكر السبب. إنها تبويب الشبكة للوحة.
كما تحتوي على قرصَي weather.mokxi، وإعدادات نقطة الوصول الثلاثة، ومختبر API الذي تختار فيه ما يجيب به api.mokxi. يمكن لدرس أن يغيّر واحدًا ويراقب الكود وهو يلاحظ.
يحصل كود Blynk على قسم Blynk هناك أيضًا، مع أطرافه الافتراضية وصندوق لإرسال قيمة لكل طرف: انظر Blynk، محاكى.
على Pico W
Pico W هي Pico بشريحة لاسلكية، وكود WiFi فيها هو WiFi.h نفسه كما أعلاه. يختلف أمران عن Pico العادية، كما على اللوحة الحقيقية:
LED_BUILTINهي LED اللوحة، وGP25 ليست كذلك. تقع LED على الشريحة اللاسلكية، لذاdigitalWrite(LED_BUILTIN, HIGH)تضيئها. يتحكم GP25 بخط تحديد الشريحة اللاسلكية، لذا فإن كودًا يكتب على GP25 لا يضيء شيئًا، هنا وعلى المنضدة.- الLED إما مضاءة أو مطفأة فقط.
analogWrite(LED_BUILTIN, ...)لا تفعل شيئًا، فخفّف إضاءة LED على طرف عادي بدلًا منها.
MicroPython and CircuitPython run on the Pico W as well, with its CYW43439
modeled from its pins: network.WLAN in MicroPython and wifi.radio in
CircuitPython join the same simulated access point, with the board's WiFi
properties as its name and password. See Pico W؛
التفاصيل الكاملة في نموذج Pico W.
إيثرنت سلكي (ETH.h)
على لوحات ESP32، مكتبة الإيثرنت السلكي للنواة تُبنى وتعمل أيضًا، للأكواد المكتوبة لـ WT32-ETH01 أو Olimex ESP32-POE أو وحدة W5500. اختر ESP32 DevKit لكود WT32-ETH01 أو ESP32-POE: إنها الشريحة نفسها.
#include <ETH.h>
void onEvent(arduino_event_id_t event) {
if (event == ARDUINO_EVENT_ETH_GOT_IP) Serial.println(ETH.localIP());
}
void setup() {
Serial.begin(115200);
Network.onEvent(onEvent); // WiFi.onEvent(onEvent) on core 2.x
ETH.begin();
}
لا يوجد كابل ولا شريحة إيثرنت. تنضم ETH.begin() إلى الشبكة المحاكاة نفسها التي تنضم إليها WiFi، دون اسم شبكة أو كلمة مرور، وبعد نحو 1.5 ثانية تحصل على العنوان 192.168.4.2. ومنذ ذلك الحين تعمل WiFiClient وHTTPClient وWebServer وPubSubClient عبره تمامًا كما تعمل عبر WiFi، وتصل لوحة الويب إلى خادم الكود، ومفتاح الإنترنت الحقيقي وحدوده هما نفسهما.
- كلا استدعاء
ETH.begin()للنواتين يبني: استدعاء النواة 2.xETH.begin(addr, power, mdc, mdio, type, clock)، واستدعاء النواة 3.xETH.begin(ETH_PHY_LAN8720, addr, mdc, mdio, power, clock)وصيغة W5500،ETH.begin(ETH_PHY_W5500, addr, cs, irq, rst, SPI). - تصل الأحداث بترتيب النواة:
ARDUINO_EVENT_ETH_START، ثمARDUINO_EVENT_ETH_CONNECTED، ثمARDUINO_EVENT_ETH_GOT_IP، وبعدETH.end()يصلARDUINO_EVENT_ETH_DISCONNECTEDوARDUINO_EVENT_ETH_STOP. ETH.linkUp()وETH.linkSpeed()(100) وETH.fullDuplex()(true) تعطي قراءة لوحة موصولة بمبدّل شبكة. الكابل موصول دائمًا.ETH.config(ip, gateway, mask, dns)يضبط عنوانًا ثابتًا، وETH.localIP()يبلّغ عنه. لا تزال لوحة الويب تصل إلى اللوحة على192.168.4.2.- لدى اللوحة وصلة واحدة إلى الشبكة. استدعاء
WiFi.begin()بعدETH.begin()ينقلها إلى الـWiFi، وWiFi.status()يقرأ تلك الوصلة الواحدة في كلتا الحالتين. - وحده ESP32 الكلاسيكي يملك متحكم Ethernet الذي يحتاجه LAN8720. على ESP32-S3 أو C3 أو C6 تستخدم اللوحة الحقيقية W5500 عبر SPI؛ لكن كود LAN8720 يعمل هنا أيضًا، وتذكر الشاشة التسلسلية ذلك مرة واحدة.
إنترنت حقيقي
مفتاح الإنترنت الحقيقي أعلى لوحة السحابة يعمل لأي شخص مسجّل دخوله: الباقة المجانية ترسل 100 طلب في اليوم، وباقة Pro أكثر. عندما يكون مطفأً، وهو حال كل جلسة في بدايتها، لا يتغيّر شيء مما سبق. وعندما يكون مفعّلًا، فإن أي طلب لاسم خارج .mokxi (يشمل https://) يخرج إلى الإنترنت الحقيقي عبر بوابة Mokxi، وتعود الإجابة إلى كودك؛ أما أسماء .mokxi فتبقى محاكاة. واللوحة على نقطة الوصول Wokwi-GUEST، كما هي الحال مع مشروع مستورد من Wokwi، تفعّل المفتاح من تلقاء نفسها عند التشغيل. أما بدون تسجيل الدخول فيقول المفتاح أنشئ حسابًا مجانًا، وتبقى اللوحة على الشبكة المحاكاة. وبوت Telegram (UniversalTelegramBot.h) يعمل بهذه الطريقة، وبهذه الطريقة فقط. وفي الإنترنت الحقيقي التفاصيل والحدود.
جرّب هذه
- WiFi: الانضمام إلى الشبكة: حلقة الاتصال، والعنوان، والإشارة.
- WiFi: جلب حالة الطقس:
HTTPClientمعweather.mokxi، وطلب متعمَّد إلىexample.comلتقرأ الرفض بنفسك. - WiFi: مصباح على صفحة ويب: زران ونموذج يشغّلان الـLED على GPIO 8.
- مختبر API: جلب JSON: طلب GET عادي عبر
HTTPClientإلىapi.mokxi. غيّر الإجابة في لوحة السحابة وشغّل الطلب مرة أخرى. - خادم ويب بنقطة وصول ESP32: شبكة اللوحة الخاصة،
MyESP، وصفحة يفتحها هاتف لوحة الويب على 192.168.4.1، فيها أزرار للـLED.
الأمثلة الثلاثة الأولى متوفرة لـESP32-C3 وESP32-C6 وESP32 DevKit وESP32-S3 وESP8266 وPico W، ولدى Uno R4 WiFi مثال انضمام خاص بها. وتتم ترجمة جميعها في المتصفح، تمامًا مثل كل مثال آخر.
العقد كاملًا، سجلًا سجلًا وحدًّا حدًّا، موجود في شبكة WiFi محاكاة.