Editor

WiFi, disimulasikan

Board bisa bergabung dengan jaringan, mengambil sebuah halaman dan menyajikannya. Radio-nya disimulasikan, dan saat masuk, saklar Real internet bisa mengakses host sungguhan.

Radionya disimulasikan. Tidak ada 802.11 di mana pun di Mokxi dan tidak ada yang bisa dilakukan sketch untuk menjangkau jaringan tempat browsermu berada. Yang asli adalah kode Arduino yang kamu tulis, dan itulah intinya, karena itulah kode yang akan kamu tulis untuk board sungguhan.

Setiap board yang punya radio di perangkat keras aslinya memilikinya di sini: keluarga ESP32 (ESP32-C3, ESP32-C6, ESP32 klasik, dan ESP32-S3, serta board yang dibangun di atasnya, seperti XIAO dan Nano ESP32), board ESP8266, Raspberry Pi Pico W, dan Uno R4 WiFi. Di board lain mana pun di sini, termasuk Raspberry Pi Pico biasa yang tidak punya komponen nirkabel, #include <WiFi.h> berhenti dengan kalimat yang menjelaskannya, bukan menulis ke alamat yang tidak dimiliki chipnya. Itu disengaja: stub yang menjawab "tidak terhubung" akan menjadi kebohongan yang tampak masuk akal, sedangkan error kompilasi tidak.

Apa yang asli dan apa yang tidak

Asli, dalam arti berperilaku seperti board-mu nanti:

  • pemanggilannya (WiFi.begin(), WiFi.status(), WiFi.localIP(), HTTPClient, WebServer) dengan tanda tangan fungsi seperti yang diberikan tutorial;
  • kode status, yaitu enum milik Arduino sendiri, nilai demi nilai;
  • waktunya: bergabung memakan waktu satu sampai tiga detik, dan password salah gagal setelah lima detik, sesuai board asli di jaringan yang sepi;
  • biayanya: fetch benar-benar memakan 60 ms waktu sketch, dan sketch yang lupa server.handleClient() benar-benar tidak pernah menjawab.

Tidak asli, dan tidak pernah dibuat-buat seolah asli:

  • tanpa radio. Tidak ada channel, tidak ada scan, tidak ada scanNetworks(), tidak ada beacon, tidak ada WPA2, tidak ada enkripsi apa pun. Password dibandingkan sebagai string.
  • tanpa internet sungguhan kecuali kamu menyalakannya. Tidak ada TCP, tidak ada DNS, tidak ada socket, tidak ada yang keluar dari tab browser. Empat nama buatan di bawah .mokxi ada dan tidak ada yang lain, sampai sakelar Internet sungguhan di panel Cloud dinyalakan: setelah itu permintaan untuk nama lain keluar melalui gateway Mokxi.
  • tanpa TLS di board. WiFiClientSecure berhasil dikompilasi lalu gagal, dengan pesan yang menjelaskannya. URL https:// gagal dengan cara yang sama, kecuali Internet sungguhan dinyalakan: saat itu gateway yang melakukan TLS untuk permintaan HTTPClient. TLS di board yang mempercayai segalanya akan mengajarkanmu bahwa https itu gratis.
  • tanpa mesin kedua. Satu board, satu jaringan, satu alamat. Tidak ada di luar tab browser ini yang bisa menjangkau server tempat sketch-mu berjalan. Access point milik board (di bawah) hanya punya satu HP, yaitu panel Web.
  • RSSI() adalah pengaturan, bukan pengukuran. Memindahkan board di kanvas tidak mengubah apa pun.
  • NTP memberikan jam simulasi, bukan waktu sungguhan. Tidak ada UDP dan tidak ada server NTP, dan simulasi tidak tahu tanggal hari ini, jadi configTime() dan update() milik NTPClient mengatur jam ke 2026-01-01 00:00:00 UTC saat menyala ditambah detik sejak itu, dan serial monitor menyebutkannya sekali.
  • Bluetooth is its own simulation. The ESP32 boards' Bluetooth serial and BLE talk to a phone in the Bluetooth pane (Bluetooth, tersimulasi). Bluetooth Pico W tidak disimulasikan.

Mengatur jaringan

Klik board dan lihat panel properti: wifiSsid, wifiPassword, dan wifiRssi. Ketiganya adalah satu-satunya access point yang bisa dilihat board ini. Tanpa radio tidak ada yang bisa discan, jadi jaringan adalah properti board, bukan komponen yang kamu pasang di sebelahnya.

Cocokkan keduanya di sketch-mu dan board bergabung. Sengaja buat salah satu dan lihat apa yang terjadi. Itu pelajaran yang lebih berguna di antara keduanya.

Panel Cloud mengedit ketiganya yang sama saat sketch berjalan, jadi kamu bisa menarik jaringan dari bawah board yang sedang berjalan dan melihat loop koneksi mulai lagi.

Bergabung

#include <WiFi.h>

void setup() {
  Serial.begin(115200);
  WiFi.begin("Mokxi-Lab", "breadboard");
  while (WiFi.status() != WL_CONNECTED) {
    Serial.print(".");
    delay(250);
  }
  Serial.println(WiFi.localIP());   // 192.168.4.2
}

WiFi.status() melewati WL_IDLE_STATUS, lalu WL_DISCONNECTED saat mengasosiasi, lalu WL_CONNECTED. Tidak ada WL_CONNECTING di Arduino, itu sebabnya loop di atas ditulis seperti yang ditulis di setiap tutorial.

Password yang salah menjadi WL_CONNECT_FAILED setelah lima detik. Nama yang bukan nama di board menjadi WL_NO_SSID_AVAIL. Alamatnya selalu 192.168.4.2, dan alamatnya sama setelah disconnect() dan begin() kedua.

Mengambil data

#include <HTTPClient.h>
WiFiClient client;
HTTPClient http;
http.begin(client, "http://weather.mokxi/");
int code = http.GET();
if (code > 0) Serial.println(http.getString());
else Serial.println(HTTPClient::errorToString(code));
http.end();

Ada empat alamat di internet simulasi ini:

  • http://time.mokxi/: jam simulasi, sebagai string ISO. Ini jam kernel yang dihitung dari tengah malam tetap, bukan waktu hari itu, karena simulasi tidak tahu hari apa itu.
  • http://weather.mokxi/: JSON dengan suhu dan kelembapan yang kamu atur di panel Cloud. Ubah salah satu dan pengambilan berikutnya membawa angka baru itu kembali.
  • http://echo.mokxi/: apa pun yang kamu POST, langsung kembali. Ini juga satu-satunya server WebSocket di sini: WebSocketsClient dari library WebSockets yang ditunjukkan ke echo.mokxi mengirim setiap pesan sebagai satu permintaan ke sana dan menerimanya kembali sebagai WStype_TEXT. Itu echo simulasi yang dibawa lewat HTTP, bukan WebSocket di kabel; host WebSocket lain butuh board sungguhan.
  • http://api.mokxi/: status, tipe konten dan body JSON yang kamu atur di panel Cloud, jadi kamu bisa berlatih sukses, error, atau data yang hilang.

Apa pun selain itu tidak bisa di-resolve. http://example.com/ kembali sebagai HTTPC_ERROR_CONNECTION_REFUSED, dan HTTPClient::errorToString() memberi tahu alasannya dalam satu baris: no real internet: names under .mokxi only. Penolakan itu sengaja bisa dibaca dari sketch. Itu hal yang layak diajarkan, bukan disembunyikan.

Melayani

#include <WebServer.h>
WebServer server(80);

void setup() {
  // ... join the network first ...
  server.on("/", [](){ server.send(200, "text/html", "<h1>hello</h1>"); });
  server.begin();
}

void loop() { server.handleClient(); }

on(path, handler), onNotFound(), send(code, type, body), arg(name), hasArg(), uri() dan method(). Handler-mu adalah kodemu sendiri, berjalan di core board dengan jam board.

Panel Web (tab di samping Serial di bagian bawah) adalah browser-nya. Ada address bar yang mulai dari http://192.168.4.2/, tombol Refresh, dan halamannya sendiri dalam frame dengan script dimatikan. Link dan tombol di halaman itu kembali ke sketch-mu, dan itulah yang membuat "menyalakan LED dari halaman web" bekerja dari ujung ke ujung.

Jika halaman tidak pernah datang, panel memberi tahu, dan setelah sepuluh detik jaringan menjawab 504 sendiri: alasan biasanya adalah loop() yang berhenti memanggil handleClient().

Access point milik board-mu sendiri

Sebuah sketch bisa memulai jaringannya sendiri alih-alih bergabung, seperti halaman setup atau pengendali robot:

#include <WiFi.h>
#include <WebServer.h>
WebServer server(80);

void setup() {
  Serial.begin(115200);
  WiFi.softAP("MyESP", "12345678");
  Serial.println(WiFi.softAPIP());   // 192.168.4.1
  server.on("/", [](){ server.send(200, "text/html", "<h1>hello</h1>"); });
  server.begin();
}

void loop() { server.handleClient(); }

Panel Web adalah HP yang bergabung. Kira-kira satu setengah detik setelah access point aktif, baris di bawah address bar menampilkan Phone joined MyESP, dan address bar berpindah ke http://192.168.4.1/: tekan Go. Tekan Leave dan HP keluar; Join bergabung lagi dengan kata sandi di kotaknya, dan kata sandi yang salah ditolak, seperti di HP sungguhan. Selama tergabung, WiFi.softAPgetStationNum() bernilai 1 dan WiFi.onEvent() menerima event station connected dan disconnected.

Password harus 8 sampai 63 karakter (atau tidak ada, untuk jaringan terbuka), atau softAP() mengembalikan false, seperti di board sungguhan. softAPConfig() memindahkan alamat. WIFI_AP_STA menjalankan keduanya: board mempertahankan lease-nya di jaringan simulasi dan tetap bisa mengambil halaman .mokxi. Di Pico W alamatnya 192.168.42.1 (192.168.4.1 dengan station aktif juga), sesuai pilihan arduino-pico, dan WiFi.beginAP() memulainya; di Uno R4 WiFi, WiFi.beginAP() dan WL_AP_CONNECTED berperilaku seperti contoh WiFiS3.

Captive portal juga bisa: mulai DNSServer dengan dnsServer.start(53, "*", WiFi.softAPIP()) dan, saat HP bergabung, panel Web membuka halamanmu sendiri, seperti HP yang menampilkan halaman login. Di MicroPython, network.WLAN(network.AP_IF) adalah access point yang sama, dan socket server di port 80 tampil di panel Web.

Satu HP itu saja yang ada: tidak ada perangkat kedua yang bisa bergabung, dan tidak ada yang mencapai internet melalui board.

Panel Cloud

Setiap permintaan, dua arah: apa yang board minta dari internet simulasi, dan apa yang panel Web minta dari board, dengan metode, alamat, status, body dan, saat ada yang gagal, satu baris yang menjelaskan alasannya. Ini tab network untuk sebuah board.

Panel ini juga memuat dua tombol weather.mokxi, tiga pengaturan access point dan lab API, tempat kamu memilih apa yang dijawab api.mokxi. Sebuah pelajaran bisa mengubah satu dan melihat sketch menyadarinya.

Sketch Blynk mendapat bagian Blynk di sana juga, dengan pin virtualnya dan kotak untuk mengirim nilai ke masing-masing: lihat Blynk, disimulasikan.

Di Pico W

Pico W adalah Pico dengan chip nirkabel, dan kode WiFi-nya sama dengan WiFi.h di atas. Dua hal berbeda dari Pico biasa, seperti di board sungguhan:

  • LED_BUILTIN adalah LED bawaan board, dan GP25 bukan. LED berada di chip nirkabel, jadi digitalWrite(LED_BUILTIN, HIGH) menyalakannya. GP25 mengendalikan select line chip nirkabel, jadi sketch yang menulis GP25 tidak menyalakan apa pun, di sini maupun di meja kerja.
  • LED hanya bisa nyala atau mati saja. analogWrite(LED_BUILTIN, ...) tidak berefek, jadi lakukan fade LED di pin biasa saja.

MicroPython and CircuitPython run on the Pico W as well, with its CYW43439 modeled from its pins: network.WLAN in MicroPython and wifi.radio in CircuitPython join the same simulated access point, with the board's WiFi properties as its name and password. See the Pico W; detail lengkapnya ada di the Pico W model.

Ethernet kabel (ETH.h)

Di board ESP32, library Ethernet kabel dari core juga bisa dikompilasi dan dijalankan, untuk sketch yang ditulis untuk WT32-ETH01, Olimex ESP32-POE, atau modul W5500. Pilih ESP32 DevKit untuk sketch WT32-ETH01 atau ESP32-POE: chipnya sama.

#include <ETH.h>

void onEvent(arduino_event_id_t event) {
  if (event == ARDUINO_EVENT_ETH_GOT_IP) Serial.println(ETH.localIP());
}

void setup() {
  Serial.begin(115200);
  Network.onEvent(onEvent);   // WiFi.onEvent(onEvent) on core 2.x
  ETH.begin();
}

Tidak ada kabel dan tidak ada chip Ethernet. ETH.begin() bergabung ke jaringan simulasi yang sama dengan WiFi, tanpa nama jaringan atau kata sandi, dan kira-kira 1,5 detik kemudian ia punya alamat 192.168.4.2. Setelah itu WiFiClient, HTTPClient, WebServer dan PubSubClient bekerja di atasnya persis seperti di atas WiFi, panel Web bisa mengakses server di sketch-mu, dan saklar Real internet beserta batasannya sama saja.

  • Pemanggilan ETH.begin() dari kedua core bisa dikompilasi: ETH.begin(addr, power, mdc, mdio, type, clock) dari core 2.x, ETH.begin(ETH_PHY_LAN8720, addr, mdc, mdio, power, clock) dari core 3.x dan bentuk W5500-nya, ETH.begin(ETH_PHY_W5500, addr, cs, irq, rst, SPI).
  • Eventnya datang sesuai urutan core: ARDUINO_EVENT_ETH_START, ARDUINO_EVENT_ETH_CONNECTED, ARDUINO_EVENT_ETH_GOT_IP, dan setelah ETH.end(), ARDUINO_EVENT_ETH_DISCONNECTED dan ARDUINO_EVENT_ETH_STOP.
  • ETH.linkUp(), ETH.linkSpeed() (100) dan ETH.fullDuplex() (true) terbaca seperti board yang dicolokkan ke sebuah switch. Kabelnya selalu terpasang.
  • ETH.config(ip, gateway, mask, dns) mengatur alamat statis, dan ETH.localIP() melaporkannya. Panel Web tetap bisa menghubungi board di 192.168.4.2.
  • Board punya satu link ke jaringan. WiFi.begin() setelah ETH.begin() memindahkannya ke WiFi, dan WiFi.status() membaca link itu, mana pun arahnya.
  • Hanya ESP32 klasik yang punya kontroler Ethernet yang dibutuhkan LAN8720. Di ESP32-S3, C3 atau C6, board asli memakai W5500 lewat SPI; sketch LAN8720 tetap bisa berjalan di sini, dan serial monitor akan mengatakan itu sekali.

Internet sungguhan

Saklar Real internet di bagian atas panel Cloud berfungsi untuk siapa saja yang masuk: paket Gratis mengirim 100 permintaan sehari, dan Pro punya lebih banyak. Saat mati, yang merupakan keadaan awal setiap sesi, tidak ada yang berubah di atas. Saat nyala, permintaan untuk nama di luar .mokxi (termasuk https://) keluar ke internet sungguhan lewat gateway Mokxi, dan jawabannya kembali ke sketch-mu; nama .mokxi tetap disimulasikan. Board di access point Wokwi-GUEST, seperti hasil impor Wokwi, menyalakannya sendiri saat berjalan. Saat belum masuk, saklarnya menyuruhmu masuk gratis, dan board tetap memakai jaringan simulasi. Bot Telegram (UniversalTelegramBot.h) juga bekerja dengan cara ini, dan hanya dengan cara ini. Real internet memuat detail dan batasannya.

Coba yang ini

  • WiFi: bergabung ke jaringan: loop koneksi, alamat, dan sinyalnya.
  • WiFi: ambil data cuaca: HTTPClient ke weather.mokxi, dan satu permintaan sengaja ke example.com supaya kamu bisa membaca sendiri penolakannya.
  • WiFi: lampu di halaman web: dua tombol dan sebuah form yang menghidupkan dan mematikan LED di GPIO 8.
  • Lab API: ambil JSON: GET HTTPClient biasa ke api.mokxi. Ubah jawabannya di panel Cloud lalu jalankan lagi permintaannya.
  • Web server access point ESP32: jaringan milik board sendiri, MyESP, dan halaman yang dibuka HP di panel Web di 192.168.4.1, dengan tombol untuk sebuah LED.

Tiga contoh pertama tersedia untuk ESP32-C3, ESP32-C6, ESP32 DevKit, ESP32-S3, ESP8266, dan Pico W, dan Uno R4 WiFi punya contoh bergabung ke jaringan sendiri. Semuanya dikompilasi di browser, sama persis seperti contoh lainnya.

Seluruh kontraknya, register demi register dan batasan demi batasan, ada di WiFi tersimulasi.