Editor

Internet sungguhan

Biarkan board WiFi mengakses layanan web sungguhan, webhook dan broker MQTT publik. Gratis begitu kamu masuk, dengan lebih banyak di Pro, dan mati sampai kamu menyalakannya.

Menyalakannya

Berfungsi di semua board dengan WiFi tersimulasi, termasuk board ESP32 dan ESP8266, Pico W, dan Uno R4 WiFi (lihat WiFi, tersimulasi).

Buka panel Cloud dan centang Real internet. Mokxi memeriksa akunmu dulu:

  • Belum masuk, saklarnya menyuruh kamu masuk gratis, dan board-mu tetap memakai jaringan simulasi.
  • Di paket Gratis, masuk dengan alamat email yang sudah dikonfirmasi, fitur ini aktif dengan jatah paket Gratis (lihat di bawah).
  • Di paket Pro, harga pelajar, Classroom dan uji coba Pro gratis, ia menyala dengan jatah yang lebih besar.

Setiap sesi mulai dengan saklar mati, jadi sebuah proyek tidak pernah otomatis mengakses internet hanya karena dibuka. Satu pengecualiannya adalah board di access point Wokwi-GUEST, yang dipakai proyek hasil impor dari Wokwi: seperti di Wokwi, access point itu bisa mengakses internet, jadi saklarnya menyala sendiri saat proyek berjalan. Hapus centangnya dan ia tetap mati sampai kamu memuat ulang.

Saat saklar nyala:

  • permintaan untuk nama di luar .mokxi keluar lewat gateway Mokxi, dan jawabannya kembali ke sketch-mu, https:// termasuk (gateway yang mengerjakan TLS, jadi pakai http.begin("https://..."));
  • time.mokxi, weather.mokxi, echo.mokxi, api.mokxi dan alamat board itu sendiri tetap disimulasikan;
  • setiap permintaan tetap muncul di log panel Cloud, dengan catatan bahwa ia melewati gateway.
#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();

Webhook adalah POST dengan cara yang sama: http.addHeader("Content-Type", "application/json") dan http.POST("{\"temp\":21.5}").

MQTT

Sebuah sketch menerbitkan satu pesan MQTT dengan satu POST HTTP ke 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

Gateway mengirimkannya ke broker sebagai MQTT lewat WebSockets. Brokernya adalah broker uji publik test.mosquitto.org (bawaan), broker.hivemq.com dan broker.emqx.io. Pantau topiknya dari klien MQTT mana pun untuk melihat pesannya tiba.

Yang tidak bisa dilakukan, jujur saja: PubSubClient dan library lain yang membuka koneksi TCP mentah ke port 1883 tidak berfungsi, karena board simulasi tidak punya socket TCP dan gateway kami juga tidak bisa membukanya. Penerbitan hanya satu arah: gateway tidak berlangganan topik atau membawa pesan kembali ke board. Topik dengan + atau # ditolak.

Telegram

UniversalTelegramBot.h sudah bawaan, dan bot Telegram bekerja dengan saklar nyala: setiap panggilannya adalah permintaan HTTPS ke api.telegram.org, yang dikirim oleh gateway. Ambil token dari BotFather, taruh di sketch, centang Real internet dan jalankan; EchoBot milik library itu ada di browser library.

  • Klien tidak dipakai. WiFiClientSecure yang kamu berikan ke bot, dan TELEGRAM_CERTIFICATE_ROOT yang kamu berikan, tidak berperan di sini: gateway yang mengerjakan TLS dan memeriksa sertifikat Telegram.
  • Dengan saklar mati, setiap panggilan langsung mengembalikan false atau 0, dan serial monitor mengatakan sekali bahwa Telegram butuh internet sungguhan.
  • Perhatikan batasan di bawah. Meminta pesan setiap detik berarti 60 permintaan semenit, lebih dari jatah paket mana pun, jadi poll kira-kira setiap sepuluh detik. Di paket Gratis, jatah 50 sehari untuk sebuah proyek hanya cukup beberapa menit untuk itu: cukup untuk melihatnya menjawab, tidak untuk membiarkannya berjalan.
  • Foto dan file yang dikirim sebagai byte tidak dibawa, karena gateway hanya menerima teks. sendPhoto() dengan URL gambar berfungsi.

Waktu

configTime() berfungsi dan getLocalTime() menjawab, begitu juga getFormattedTime() milik NTPClient, tapi jamnya adalah jam simulasi itu sendiri, yang dimulai pada 2026-01-01 00:00:00 UTC: itu bukan waktu sungguhan. NTP adalah protokol UDP, internet sungguhan memakai HTTP, dan simulasi tidak tahu tanggal hari ini. Untuk waktu sungguhan sepanjang hari, tanyakan ke API waktu lewat HTTP dengan saklar menyala.

Batasannya

Gratis Pro
Permintaan per hari, per akun 100 1,000
Permintaan per hari, per proyek 50 500
Permintaan per menit, per akun 10 30
Permintaan per menit, per proyek 10 20
Body permintaan 1.024 byte 2.048 byte
Respons disimpan 2.048 byte 4.096 byte
pesan MQTT 512 byte 1.024 byte

Hari dihitung dengan UTC. Di paket Gratis, satu jaringan juga membagi 300 permintaan per hari dan 20 per menit untuk semua akun yang masuk lewat jaringan itu.

  • Melewati batas, board mendapat status 429 dengan kalimat yang menyebutkan batas mana yang terlampaui. Taruh delay() di loop-mu: satu pembacaan setiap sepuluh detik selama seperempat jam adalah sembilan puluh permintaan.
  • Ukuran: respons yang terlalu panjang dipotong, dan log menyebutkannya. Body yang bukan teks (misalnya gambar) dibiarkan.
  • Waktu: host diberi 4 detik untuk menjawab.
  • Metode: GET dan POST, di port 80, 443, 8080 dan 8443.
  • Redirect tidak diikuti. 301 atau 302 kembali ke sketch-mu apa adanya, dengan alamat tujuannya sebagai body.
  • Yang ditolak: alamat privat dan lokal (10.x, 192.168.x, 127.0.0.1, 169.254.x dan padanan IPv6-nya), nama seperti localhost atau apa pun di bawah .local atau .internal, nama yang mengarah ke salah satunya, host milik Cloudflare dan Mokxi sendiri, serta host mana pun yang harus kami hentikan. Sketch-mu mendapat penolakan dengan alasannya di panel Cloud. WiFiClientSecure tetap ditolak; pakai WiFiClient biasa atau tanpa itu.

Yang kami simpan

Hitungan, dan tidak ada yang lain: berapa banyak permintaan yang dikirim setiap akun, proyek dan jaringan hari ini, supaya batas harian berfungsi, dan berapa banyak yang dikirim seluruh layanan. Jaringan dihitung dengan kode acak yang berubah setiap hari, bukan alamatnya. Tidak ada alamat, URL, header atau body yang disimpan atau dicatat.

In a class

Untuk siswa di sebuah kelas, internet sungguhan mati kecuali guru menyalakannya, apa pun paket siswa itu. Guru yang alat kelasnya aktif (Pro, Classroom atau uji coba) bisa menyalakannya untuk satu kelas, dan kelas itu lalu memakai batas Pro; sampai itu terjadi, tombol si siswa menyatakan internet mati untuk kelasnya. Akun yang ditandai di bawah 13 tahun mengikuti aturan yang sama.