Açmak
Simüle edilmiş WiFi olan her kartta çalışır, aralarında ESP32 ve ESP8266 kartları, Pico W ve Uno R4 WiFi vardır (bkz. WiFi, simüle edilmiş).
Cloud panelini aç ve Real internet kutusunu işaretle. Mokxi önce hesabını kontrol eder:
- Çıkış yapmışsan, anahtar ücretsiz giriş yapmanı söyler ve kartın simüle edilmiş ağı korur.
- Free planındaysan, e-posta adresin doğrulanmış şekilde giriş yaptıysan, Free'nin kotasıyla (aşağıda) açılır.
- Pro'daysan, öğrenci fiyatı, Classroom ve ücretsiz Pro denemesi ile, daha büyük kotayla açılır.
Her oturum kapalı olarak başlar, böylece bir proje yalnızca açılmakla internete asla erişmez. Tek istisna, Wokwi-GUEST erişim noktasındaki bir karttır ki Wokwi'den içe aktarılan bir projenin kullandığı budur: Wokwi'de olduğu gibi o erişim noktası internete erişir, dolayısıyla anahtar proje çalıştığında kendiliğinden açılır. İşareti kaldırırsan sayfayı yeniden yükleyene kadar kapalı kalır.
Açıkken:
.mokxidışındaki bir ada giden istek Mokxi'nin ağ geçidi üzerinden çıkar ve yanıt koduna geri gelir,https://dahil (TLS'yi ağ geçidi yapar, o yüzdenhttp.begin("https://...")kullan);time.mokxi,weather.mokxi,echo.mokxi,api.mokxive kartın kendi adresi simüle edilmiş olarak kalır;- her istek Cloud panelinin günlüğünde yine görünür, ağ geçidinden geçtiğini belirten bir notla.
#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();
Bir webhook da aynı şekilde bir POST'tur: http.addHeader("Content-Type", "application/json") ve http.POST("{\"temp\":21.5}").
MQTT
Bir kod, mqtt.mokxi'ye tek bir HTTP POST ile tek bir MQTT mesajı yayınlar:
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
Ağ geçidi onu MQTT over WebSockets olarak aracıya gönderir. Aracılar, herkese açık test aracıları test.mosquitto.org (varsayılan), broker.hivemq.com ve broker.emqx.io'dur. Mesajın geldiğini görmek için konuyu herhangi bir MQTT istemcisinden izle.
Dürüstçe söyleyelim, yapmadığı şeyler: PubSubClient ve 1883 numaralı porta ham TCP bağlantısı açan diğer kütüphaneler çalışmaz, çünkü simüle edilmiş kartta TCP soketi yoktur ve ağ geçidimiz de açamaz. Yayınlama tek yönlüdür: ağ geçidi abone olmaz ve mesajları karta geri getirmez. + veya # içeren konular reddedilir.
Telegram
UniversalTelegramBot.h hazır gelir ve bir Telegram botu anahtar açıkken çalışır: çağrılarının her biri, ağ geçidinin gönderdiği api.telegram.org'a bir HTTPS isteğidir. BotFather'dan bir anahtar al, koda koy, Real internet kutusunu işaretle ve çalıştır; kütüphanenin EchoBot'u kütüphane tarayıcısındadır.
- İstemci kullanılmaz. Bota verdiğin
WiFiClientSecureve ona verdiğinTELEGRAM_CERTIFICATE_ROOTburada hiçbir şey taşımamaz: TLS'yi ağ geçidi yapar ve Telegram'ın sertifikasını o kontrol eder. - Anahtar kapalıyken, her çağrı hemen
falseveya0döndürür ve seri monitör, Telegram'ın gerçek internete ihtiyaç duyduğunu bir kez söyler. - Aşağıdaki sınırlara dikkat et. Her saniye mesaj istemek dakikada 60 istektir, her iki planın izin verdiğinden fazladır, o yüzden on saniyede bir sorgula. Free'de bir projenin günlük 50 isteği bu tempoda birkaç dakika sürer: yanıt verdiğini görmeye yeter, çalışır halde bırakmaya değil.
- Ağ geçidi metin taşıdığından bayt olarak gönderilen fotoğraflar ve dosyalar taşınmaz. Bir resmin URL'siyle
sendPhoto()çalışır.
Zaman
configTime() çalışır, getLocalTime() yanıt verir ve NTPClient'ın getFormattedTime() fonksiyonu da öyle, ama saat simülasyonun kendi saatidir ve 2026-01-01 00:00:00 UTC'de başlar: gerçek saat değildir. NTP bir UDP protokolüdür, gerçek internet HTTP taşır ve simülasyon bugünün tarihini bilmez. Gerçek saat için anahtar açıkken HTTP üzerinden bir zaman API'sine sor.
Sınırlar
| Ücretsiz | Pro | |
|---|---|---|
| Günlük istek, hesap başına | 100 | 1,000 |
| Günlük istek, proje başına | 50 | 500 |
| Dakikalık istek, hesap başına | 10 | 30 |
| Dakikalık istek, proje başına | 10 | 20 |
| İstek gövdesi | 1.024 bayt | 2.048 bayt |
| Yanıt tutuldu | 2.048 bayt | 4.096 bayt |
| MQTT mesajı | 512 bayt | 1.024 bayt |
Günler UTC'ye göredir. Free planında bir ağ ayrıca günde 300 ve dakikada 20 isteği, üzerinde oturum açmış her hesap arasında paylaştırır.
- Bir limit aşılınca kart 429 durum kodu alır ve hangi limite takıldığını söyleyen bir cümle gelir. Döngüne bir
delay()koy: çeyrek saat boyunca her on saniyede bir okuma, doksan istektir. - Boyutlar: daha uzun bir yanıt kesilir ve günlük bunu söyler. Metin olmayan bir gövde (örneğin bir resim) bırakılır.
- Süre: sunucunun yanıtı için 4 saniyesi vardır.
- Yöntemler: GET ve POST, 80, 443, 8080 ve 8443 portlarında.
- Yönlendirmeler takip edilmez. Bir 301 veya 302, işaret ettiği adresi gövde olarak taşıyarak, koduna olduğu gibi döner.
- Neler reddedilir: özel ve yerel adresler (10.x, 192.168.x, 127.0.0.1, 169.254.x ve IPv6 karşılıkları),
localhostgibi adlar veya.localya da.internalaltındaki her şey, bunlardan birine çözülen bir ad, Cloudflare'in ve Mokxi'nin kendi sunucuları ve durdurmak zorunda kaldığımız her sunucu. Kodun bir ret yanıtı alır ve gerekçe Cloud panelinde görünür.WiFiClientSecurehâlâ reddedilir; düz birWiFiClientkullan ya da hiç kullanma.
Ne saklıyoruz
Sadece sayılar, başka hiçbir şey: günlük limitler işlesin diye her hesap, proje ve ağın bugün kaç istek gönderdiği ve servisin bütününün kaç istek gönderdiği. Bir ağ, her gün değişen karıştırılmış bir kod altında sayılır, adresi asla kullanılmaz. Hiçbir adres, URL, başlık veya gövde saklanmaz veya günlüğe yazılmaz.
In a class
Bir sınıftaki öğrenci için gerçek internet, öğrenci hangi planda olursa olsun, öğretmen açmadıkça kapalıdır. Sınıf araçları açık olan bir öğretmen (Pro, Classroom veya deneme) bir sınıf için bunu açabilir ve sınıf o zaman Pro'nun limitlerine kavuşur; o zamana kadar öğrencinin düğmesi, sınıfı için kapalı olduğunu söyler. 13 yaşından küçük olarak işaretlenen hesaplar aynı kurala uyar.