Düzenleyici

Gerçek internet

Bir WiFi kartının gerçek web servislerine, webhook'lara ve herkese açık MQTT aracılarına ulaşmasını sağlayın. Giriş yaptığınızda ücretsiz, Pro ile daha fazlası, ve siz açana kadar kapalıdır.

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:

  • .mokxi dışı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üzden http.begin("https://...") kullan);
  • time.mokxi, weather.mokxi, echo.mokxi, api.mokxi ve 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&current=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 WiFiClientSecure ve ona verdiğin TELEGRAM_CERTIFICATE_ROOT burada 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 false veya 0 dö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ı), localhost gibi adlar veya .local ya da .internal altı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. WiFiClientSecure hâlâ reddedilir; düz bir WiFiClient kullan 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.