وصّل لوحة بشبكة WiFi وقدّم صفحة
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
بنهاية هذه الصفحة ستكون لوحتك قد انضمت إلى شبكة، وحصلت على عنوان، وقدّمت صفحة ويب يمكنك النقر عليها، مع LED يتبع الزر الموجود عليها. كل ما تكتبه هو كود Arduino الذي كنت لتكتبه للوحة على مكتبك.
أمر واحد أولًا، لأنه أهم من أي شيء آخر هنا: الشبكة محاكاة. لا يوجد 802.11 في Mokxi، ومع إيقاف الإنترنت الحقيقي، لا شيء يفعله كودك يخرج من تبويب المتصفح هذا. وبعد تسجيل الدخول يمكنك تشغيل «الإنترنت الحقيقي» في لوحة السحابة، فتخرج طلبات HTTP و HTTPS إلى المضيفين الحقيقيين عبر بوابة Mokxi. ما هو أمين للواقع هو الكود، ورموز الحالة، وترتيب الحالات، والثانية أو الثانيتان التي يستغرقها الانضمام، وهذا ما تعطيك إياه لوحة حقيقية. تبويب الويب هو المتصفح الوحيد في العالم الذي يمكنه الوصول إلى خادمك، وهذه هي الحقيقة كما هي.
خمس لوحات تستطيع فعل هذا، وهي الخمس التي فيها راديو على العتاد الحقيقي: ESP32-C3 و ESP32-C6 و ESP32 DevKit الكلاسيكية و ESP8266 NodeMCU و Raspberry Pi Pico W. اختر أيًّا منها كانت على مكتبك. الدائرة أعلاه هي C3 مع LED ومقاومة 220 أوم على GPIO 8، وكل واحدة من الخمس تأتي مع نفس الأمثلة الثلاثة موصولة بطرف المصباح الخاص بها، فينتقل الكود والتوصيلات معًا.
سترى حلقة الاتصال تطبع نقاطها ثم عنوانًا، تمامًا كما تفعل على لوحة حقيقية.
بعد ذلك افتح تبويب Web واقرأ الصفحة التي يقدّمها كودك الخاص، داخل إطار مع إيقاف السكربتات.
اضغط «On» في تلك الصفحة فتُضاء LED على اللوحة وعلى لوحة التجارب.
انضم إلى الشبكة
اضغط «تشغيل» وانظر أولًا إلى الشاشة التسلسلية. يستدعي الكود WiFi.begin باسم وكلمة مرور نقطة الوصول الوحيدة التي تراها هذه اللوحة، ثم يكرر التحقق من WiFi.status() حتى تُرجع WL_CONNECTED. يستغرق ذلك ما بين ثانية وثلاث ثوانٍ، وهو ما تحققه لوحة حقيقية على شبكة هادئة. ثم يأتي العنوان: 192.168.4.2، مُستأجرًا بالطريقة التي يستأجر بها DHCP، مع البوابة عند 192.168.4.1 وقوة الإشارة بجانبه.
نقطة الوصول إعداد على اللوحة، وليست قطعة توصّلها. اضغط على اللوحة وابحث عن wifiSsid وwifiPassword وwifiRssi في لوحة الخصائص. مع غياب الراديو لا يوجد ما يمكن مسحه، ولا ما يحمل قطعة منفصلة إلى اللوحة، لذا فالشبكة الوحيدة التي تراها تعيش على اللوحة نفسها. وRSSI هو أيضًا مجرد إعداد وليس قياسًا: تحريك اللوحة في مساحة العمل لا يغيّر شيئًا.
جرّب الخطأ عمدًا. غيّر كلمة المرور إلى شيء آخر واضغط «تشغيل» مرة أخرى. يحصل الكود، دون أي تعديل عليه، على WL_CONNECT_FAILED بعد خمس ثوانٍ، وهو ما تفعله لوحة حقيقية عند الخطأ، والحالات التي يمرّ بها في الطريق (خامل، ثم مفصول، ثم فاشل) هي نفس تسلسل Arduino قيمةً بقيمة.
قدّم صفحة، وافتحها في تبويب Web
يقع تبويب Web على طول أسفل المحرر، بجانب Serial. يفتح على http://192.168.4.2/، وهو العنوان الذي طبعت اللوحة للتو، ويعرض الصفحة التي ترسلها معالجاتك. يوجد شريط عنوان وزر تحديث، والإطار معطّل فيه السكربتات، فلا شيء داخل الصفحة يمكنه العمل، ولا شيء فيها يمكنه جلب صورة أو خط من أي مكان.
تُلتقط الوصلات وإرسالات النماذج داخل ذلك الإطار وتُوجَّه مجددًا إلى الشبكة المحاكاة. الضغط على «On» يصل فعلًا إلى المعالج الذي سجّلته بـ server.on، ويعمل فعلًا على نواة اللوحة نفسها وبسرعة اللوحة نفسها، ويحرّك الطرف فعلًا. فتتبعه LED على اللوحة وعلى لوحة التجارب. انسَ server.handleClient() داخل loop() وستنتهي مهلة الصفحة بعد عشر ثوانٍ، تمامًا كما يحدث على العتاد الحقيقي.
تبويب «السحابة» بجانبه هو تبويب الشبكة: كل طلب أرسلته اللوحة وكل طلب أرسلته الصفحة إلى اللوحة، مع الطريقة وعنوان URL والحالة والمحتوى، وسطر يوضّح السبب عند فشل أي طلب. كما يضم إعدادات نقطة الوصول الثلاثة والرقمين اللذين يجيب بهما weather.mokxi، بحيث يمكن للدرس أن يحرّك مؤشرًا ويراقب الطلب التالي يعيد القيمة الجديدة.
ما المتاح وما ليس متاحًا
تُحلّ أربعة أسماء فقط لا غير: time.mokxi وweather.mokxi وecho.mokxi وapi.mokxi، إضافة إلى عنوان اللوحة نفسها. اطلب أي شيء آخر وستحصل على جملة واحدة يمكن لكودك قراءتها وطباعتها: لا يوجد إنترنت حقيقي، والأسماء تحت .mokxi فقط. هذا الرفض أمر يجب تعليمه لا إخفاؤه، ومثال WiFi: fetch the weather يطلب example.com عن قصد لتقرأه بنفسك في الشاشة التسلسلية. هذا عندما يكون «الإنترنت الحقيقي» مطفأ؛ شغّله بعد تسجيل الدخول، وستخرج الأسماء الأخرى إلى الخوادم الحقيقية.
يفشل https:// أيضًا أثناء إطفاء «الإنترنت الحقيقي»، ويوضّح السبب. تتم ترجمة WiFiClientSecure لكنه يرفض الاتصال، لأن نظام TLS يثق بكل شيء سيعلّمك أن https مجاني. مع تشغيل «الإنترنت الحقيقي»، تخرج طلبات https:// عبر HTTPClient عبر بوابة Mokxi. لا يوجد TCP ولا بروتوكول DNS ولا مقبس في أي مكان تحت كل هذا، ولا شيء خارج تبويب المتصفح هذا يمكنه الوصول إلى الخادم الذي يعمل عليه كودك.
افتح مثال WiFi: join the network أولًا ثم WiFi: a lamp on a web page من منتقي الأمثلة، واقرأهما بجانب هذه الصفحة. عندما تنقل الكود نفسه إلى لوحة حقيقية، السطر الوحيد الذي ستغيّره هو اسم شبكتك الخاصة.
افتح هذه الدائرة في المحرر. ESP32-C3: مصباح على صفحة ويب، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.
الأسئلة
هل الـ WiFi حقيقي؟
لا، وكل صفحة تذكر ذلك توضّحه. لا يوجد 802.11 في أي مكان من Mokxi، لا قناة ولا بحث عن الشبكات ولا WPA2، ولا يخرج أي طلب من تبويب المتصفح إلا إذا سجّلت الدخول وشغّلت الإنترنت الحقيقي. تُقارن كلمة المرور كنص عادي. أما ما هو دقيق فهو واجهة Arduino البرمجية، ورموز الحالة، وترتيب الحالات، ومدة الاتصال من ثانية إلى ثلاث ثوانٍ.
هل يمكن لكودي جلب موقع ويب حقيقي؟
لا. تُحلّ أربعة أسماء تخيّلية تحت .mokxi ولا شيء غيرها. اطلب أي شيء آخر وسيعيد HTTPClient رفضًا مع جملة واحدة يمكن لكودك طباعتها. ويفشل https:// بالطريقة نفسها، لأن نظام TLS يثق بكل شيء سيعلّمك أن https مجاني.
ما اللوحات التي تدعم هذا؟
ESP32-C3 وESP32-C6 وESP32 DevKit الكلاسيكية وESP8266 NodeMCU وRaspberry Pi Pico W، وهي اللوحات الخمس هنا التي تحتوي على راديو في العتاد الحقيقي. على أي لوحة أخرى، بما فيها Raspberry Pi Pico العادية، يرفض WiFi.h الترجمة مع جملة تشرح السبب، بدلًا من التظاهر بغير ذلك.
هل يمكن لأي شخص آخر فتح الصفحة التي تقدّمها لوحتي؟
لا. لا يوجد مقبس استماع ولا شيء خارج تبويب المتصفح هذا يمكنه الوصول إليه. تبويب الويب هو العميل الوحيد الموجود، ويُقدَّم إطاره مع إطفاء البرمجيات النصية حتى لا تستطيع الصفحة جلب أي شيء من أي مكان.
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.