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
.mokxikeluar lewat gateway Mokxi, dan jawabannya kembali ke sketch-mu,https://termasuk (gateway yang mengerjakan TLS, jadi pakaihttp.begin("https://...")); time.mokxi,weather.mokxi,echo.mokxi,api.mokxidan 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¤t=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.
WiFiClientSecureyang kamu berikan ke bot, danTELEGRAM_CERTIFICATE_ROOTyang kamu berikan, tidak berperan di sini: gateway yang mengerjakan TLS dan memeriksa sertifikat Telegram. - Dengan saklar mati, setiap panggilan langsung mengembalikan
falseatau0, 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
localhostatau apa pun di bawah.localatau.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.WiFiClientSecuretetap ditolak; pakaiWiFiClientbiasa 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.