تفعيله
يعمل على كل لوحة فيها WiFi محاكاة، ومنها لوحات ESP32 وESP8266 وPico W وUno R4 WiFi (انظر WiFi المحاكاة).
افتح لوحة السحابة وفعّل الإنترنت الحقيقي. يتحقق Mokxi من حسابك أولًا:
- بدون تسجيل دخول: يقول المفتاح أنشئ حسابًا مجانًا، وتبقى لوحتك على الشبكة المحاكاة.
- على الباقة المجانية، مع تسجيل الدخول وتأكيد عنوان بريدك الإلكتروني، يُفعَّل المفتاح بحدود الباقة المجانية (أدناه).
- على باقة Pro، أو بسعر الطلاب، أو Classroom، أو تجربة Pro المجانية، يُفعَّل المفتاح بالحدود الأكبر.
تبدأ كل جلسة وهو مطفأ، حتى لا يصل أي مشروع إلى الإنترنت مجرّد فتحه. الاستثناء الوحيد هو لوحة على نقطة الوصول Wokwi-GUEST، وهي ما يستخدمه مشروع مستورد من Wokwi: كما على Wokwi، تصل نقطة الوصول تلك إلى الإنترنت، لذا يفعّل المفتاح نفسه عند تشغيل المشروع. أطفئه ويبقى مطفأً حتى تعيد التحميل.
أثناء تفعيله:
- أي طلب لاسم خارج
.mokxiيخرج عبر بوابة Mokxi وتعود الإجابة إلى كودك،https://مشمولة (البوابة تتولى TLS، لذا استخدمhttp.begin("https://..."))؛ time.mokxiوweather.mokxiوecho.mokxiوapi.mokxiوعنوان اللوحة نفسها تبقى محاكاة؛- يظهر كل طلب كما هو في سجل لوحة السحابة، مع ملاحظة أنه مرّ عبر البوابة.
#include <WiFi.h>
#include <HTTPClient.h>
HTTPClient http;
http.begin("https://api.open-meteo.com/v1/forecast?latitude=52.5&longitude=13.4¤t=temperature_2m");
int code = http.GET();
Serial.println(code);
Serial.println(http.getString());
http.end();
الـwebhook طلب POST بالطريقة نفسها: http.addHeader("Content-Type", "application/json") وhttp.POST("{\"temp\":21.5}").
MQTT
ينشر الكود رسالة MQTT واحدة بطلب POST واحد إلى mqtt.mokxi:
http.begin("http://mqtt.mokxi/publish?broker=test.mosquitto.org&topic=mokxi/demo/temp");
http.addHeader("Content-Type", "text/plain");
int code = http.POST("21.5"); // 200 when the broker took it
ترسلها البوابة إلى الوسيط بوصفها MQTT عبر WebSockets. الوسطاء هم وسطاء الاختبار العامة test.mosquitto.org (الافتراضي) وbroker.hivemq.com وbroker.emqx.io. راقب الموضوع من أي عميل MQTT لتراه يصل.
ما لا يفعله، بصراحة: PubSubClient وغيره من المكتبات التي تفتح اتصال TCP خامًا على المنفذ 1883 لا تعمل، لأن اللوحة المحاكاة بلا مقبس TCP، وبوابتنا لا تستطيع فتح واحد أيضًا. والنشر باتجاه واحد: البوابة لا تشترك ولا تعيد الرسائل إلى اللوحة. والمواضيع التي فيها + أو # تُرفض.
Telegram
مكتبة UniversalTelegramBot.h مدمجة، ويعمل بوت Telegram والمفتاح مفعّل: كل استدعاء منه طلب HTTPS إلى api.telegram.org ترسله البوابة. احصل على رمز من BotFather وضعه في الكود وفعّل الإنترنت الحقيقي وشغّله؛ مكتبة EchoBot موجودة في متصفح المكتبات.
- لا يُستخدم العميل. الـ
WiFiClientSecureالذي تعطيه للبوت، والـTELEGRAM_CERTIFICATE_ROOTالذي تعطيه له، لا يحملان أي معنى هنا: البوابة تتولى TLS وتتحقق من شهادة Telegram. - والمفتاح مطفأ: يعيد كل استدعاء
falseأو0فورًا، وتقول الشاشة التسلسلية مرة واحدة إن Telegram يحتاج الإنترنت الحقيقي. - انتبه للحدود أدناه. طلب الرسائل كل ثانية يعني 60 طلبًا في الدقيقة، أكثر مما تسمح به أي باقة، فاستعلم كل عشر ثوانٍ تقريبًا. وعلى الباقة المجانية، تستنفد طلبات المشروع البالغة 50 في اليوم دقائق قليلة من ذلك: تكفي لرؤية الإجابة، لا لتركه يعمل.
- الصور والملفات المرسلة كبايتات لا تُنقل، لأن البوابة تقبل نصًّا فقط.
sendPhoto()مع عنوان URL لصورة يعمل.
الوقت
يعمل configTime() ويجيب getLocalTime()، وكذلك getFormattedTime() من NTPClient، لكن الساعة هي ساعة المحاكاة نفسها، وتبدأ عند 2026-01-01 00:00:00 UTC: فهي ليست الوقت الحقيقي. فبروتوكول NTP عبر UDP، والإنترنت الحقيقي يحمل HTTP، والمحاكاة لا تعرف تاريخ اليوم. لمعرفة الوقت الحقيقي اطلبه من واجهة API للوقت عبر HTTP والمفتاح مفعّل.
الحدود
| مجاني | Pro | |
|---|---|---|
| طلبات في اليوم، لكل حساب | 100 | 1,000 |
| طلبات في اليوم، لكل مشروع | 50 | 500 |
| طلبات في الدقيقة، لكل حساب | 10 | 30 |
| طلبات في الدقيقة، لكل مشروع | 10 | 20 |
| حجم متن الطلب | 1,024 bytes | 2,048 بايت |
| الرد يُحفظ كما هو | 2,048 بايت | 4,096 بايت |
| رسالة MQTT | 512 بايت | 1,024 bytes |
الأيام بحسب توقيت UTC. في الباقة المجانية، تشارك الشبكة الواحدة أيضًا 300 طلب في اليوم و20 طلبًا في الدقيقة بين كل الحسابات المسجّل دخولها عليها.
- عند تجاوز حدّ ما تحصل اللوحة على الحالة 429 مع جملة تبيّن أي حد تجاوزته. أضف
delay()في الحلقة: قراءة كل عشر ثوانٍ لمدة ربع ساعة تعني تسعين طلبًا. - الأحجام: الرد الأطول يُقتطع، والسجل يذكر ذلك. والمتن غير النصي (صورة مثلًا) يُستبعد.
- الوقت: للمضيف 4 ثوانٍ ليجيب.
- الطرائق: GET و POST، على المنافذ 80 و443 و8080 و8443.
- لا تُتبع عمليات إعادة التوجيه. يصل 301 أو 302 إلى الكود كما هو، مع العنوان الذي يشير إليه كجسم للرد.
- ما يُرفض: العناوين الخاصة والمحلية (10.x و192.168.x و127.0.0.1 و169.254.x وما يقابلها في IPv6)، وأسماء مثل
localhostأو أي شيء يقع تحت.localأو.internal، واسم يُحلّ إلى أحد تلك العناوين، ومضيفات Cloudflare و Mokxi نفسها، وأي مضيف اضطررنا إلى إيقافه. يحصل الكود على رفض مع السبب في لوحة السحابة.WiFiClientSecureما زال مرفوضًا؛ استخدمWiFiClientعاديًا أو لا شيء.
ما نحتفظ به
العدادات، ولا شيء غيرها: كم طلبًا أرسله كل حساب ومشروع وشبكة اليوم، حتى تعمل الحدود اليومية، وكم أرسلت الخدمة كلها. تُحسب الشبكة تحت رمز مشفّر يتغير كل يوم، ولا يُخزَّن عنوانها أبدًا. لا يُخزَّن أو يُسجَّل أي عنوان أو URL أو ترويسة أو جسم.
In a class
بالنسبة لطالب في فصل، يكون الإنترنت الحقيقي مغلقًا إلا إذا فعّله المعلّم، أيًّا كانت باقة الطالب. يمكن للمعلّم الذي تعمل أدوات فصله (Pro أو Classroom أو التجربة) أن يفعّله لفصل ما، فيحصل الفصل حينها على حدود باقة Pro؛ وقبل ذلك يذكر مفتاح الطالب أنه مغلق لفصله. وتتبع الحسابات المعلَّمة بأنها لأقل من 13 عامًا القاعدة نفسها.