Trình soạn thảo

WiFi, mô phỏng

Bo mạch có thể tham gia mạng, tải một trang web và phục vụ một trang web. Bộ đàm được mô phỏng, và khi đã đăng nhập, công tắc Real internet kết nối được đến các máy chủ thật.

Bộ radio được mô phỏng. Không có 802.11 nào trong Mokxi cả, và không việc gì sketch làm có thể chạm tới mạng mà trình duyệt của bạn đang dùng. Điều trung thực là code Arduino bạn viết, đó chính là điểm mấu chốt, vì đó là code bạn sẽ viết cho một bo mạch thật.

Mọi bo mạch có radio trên phần cứng thật đều có nó: họ ESP32 (ESP32-C3, ESP32-C6, ESP32 kinh điển và ESP32-S3, cùng các bo mạch dựng trên chúng, chẳng hạn XIAO và Nano ESP32), các bo mạch ESP8266, Raspberry Pi Pico W và Uno R4 WiFi. Trên mọi bo mạch khác ở đây, kể cả Raspberry Pi Pico thường, vốn không có linh kiện không dây, #include <WiFi.h> dừng lại với một câu nói rõ điều đó, thay vì ghi vào một địa chỉ mà chip của nó không có. Đó là chủ ý: một stub trả lời "not connected" sẽ là một lời nói dối có vẻ đáng tin, còn lỗi biên dịch thì không.

Cái gì thật và cái gì không

Thật, theo nghĩa là nó hành xử như bo mạch của bạn sẽ làm:

  • các lệnh gọi (WiFi.begin(), WiFi.status(), WiFi.localIP(), HTTPClient, WebServer) với chữ ký được nêu trong hướng dẫn;
  • các mã trạng thái, chính là enum của Arduino, đúng từng giá trị;
  • thời gian: việc vào mạng mất từ một đến ba giây, và mật khẩu sai thất bại sau năm giây, đúng như một bo mạch thật trên một mạng yên tĩnh;
  • chi phí: một lệnh fetch thực sự mất 60 ms thời gian của sketch, và một sketch quên server.handleClient() thực sự không bao giờ trả lời.

Không thật, và không bao giờ giả vờ là thật:

  • không radio. Không kênh, không quét, không scanNetworks(), không beacon, không WPA2, không mã hóa nào cả. Mật khẩu được so sánh như một chuỗi ký tự.
  • không internet thật trừ khi bạn bật nó. Không TCP, không DNS, không socket, không gì rời khỏi tab trình duyệt. Bốn cái tên bịa dưới .mokxi tồn tại và không thêm tên nào khác, cho đến khi công tắc Internet thật của bảng Cloud được bật: khi đó một yêu cầu cho bất kỳ tên nào khác sẽ đi ra qua cổng kết nối của Mokxi.
  • không TLS trên bo mạch. WiFiClientSecure biên dịch xong rồi thất bại, và nói rõ điều đó. Một URL https:// thất bại theo cách tương tự, trừ khi Internet thật đang bật: khi đó cổng kết nối làm phần TLS cho một yêu cầu HTTPClient. Một TLS trên bo mạch mà tin mọi thứ sẽ dạy bạn rằng https là miễn phí.
  • không máy thứ hai. Một bo mạch, một mạng, một địa chỉ. Không gì bên ngoài tab trình duyệt này có thể truy cập máy chủ mà sketch của bạn chạy. Điểm phát sóng của chính bo mạch (bên dưới) có đúng một chiếc điện thoại trên đó, bảng Web.
  • RSSI() là một cài đặt, không phải một phép đo. Di chuyển bo mạch trên khung vẽ không thay đổi gì.
  • NTP đưa ra đồng hồ của bản mô phỏng, không phải thời gian thật. Không có UDP và không có máy chủ NTP, và bản mô phỏng không biết ngày hôm nay, nên configTime() và update() của NTPClient đặt đồng hồ thành 2026-01-01 00:00:00 UTC lúc khởi động cộng với số giây trôi qua, và Serial Monitor nói rõ điều đó một lần.
  • Bluetooth is its own simulation. The ESP32 boards' Bluetooth serial and BLE talk to a phone in the Bluetooth pane (Bluetooth, được mô phỏng). Bluetooth của Pico W không được mô phỏng.

Thiết lập mạng

Nhấp vào bo mạch và xem bảng thuộc tính: wifiSsid, wifiPassword và wifiRssi. Ba cái đó là điểm phát sóng duy nhất mà bo mạch này thấy được. Không có radio nên không có gì để quét, thế nên mạng là một thuộc tính của bo mạch thay vì một linh kiện bạn đặt cạnh nó.

Khớp đúng cả hai trong sketch của bạn thì nó sẽ kết nối. Cố làm sai một trong hai và xem chuyện gì xảy ra. Đó là bài học hữu ích hơn trong hai điều này.

Bảng Cloud chỉnh chính ba thứ đó trong khi sketch đang chạy, nên bạn có thể rút mạng ra khỏi một bo mạch đang chạy và xem vòng lặp kết nối bắt đầu lại.

Tham gia

#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() đi qua WL_IDLE_STATUS, rồi WL_DISCONNECTED khi nó đang kết nối, rồi WL_CONNECTED. Không có WL_CONNECTING trong Arduino, đó là lý do vòng lặp trên được viết theo cách mọi hướng dẫn đều viết.

Sai mật khẩu sẽ thành WL_CONNECT_FAILED sau năm giây. Tên mạng không đúng với tên trên bo mạch sẽ thành WL_NO_SSID_AVAIL. Địa chỉ luôn là 192.168.4.2, và đó vẫn là địa chỉ đó sau một lệnh disconnect() và lệnh begin() thứ hai.

Tải dữ liệu

#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();

Có bốn địa chỉ trên mạng internet mô phỏng này:

  • http://time.mokxi/: đồng hồ của bản mô phỏng, dạng chuỗi ISO. Đây là đồng hồ của kernel đếm từ một nửa đêm cố định, không phải giờ trong ngày, vì bản mô phỏng không biết hôm nay là ngày nào.
  • http://weather.mokxi/: JSON với nhiệt độ và độ ẩm mà bạn đặt trong bảng Cloud. Đổi một giá trị thì lần tải kế tiếp sẽ nhận về số mới.
  • http://echo.mokxi/: cái gì bạn POST lên, sẽ nhận lại y nguyên. Nó cũng là máy chủ WebSocket duy nhất ở đây: WebSocketsClient của thư viện WebSockets trỏ tới echo.mokxi sẽ gửi mỗi thông điệp thành một yêu cầu tới nó và nhận lại dưới dạng WStype_TEXT. Đó là một dịch vụ echo mô phỏng chạy trên HTTP, không phải WebSocket thực; mọi máy chủ WebSocket khác cần bo mạch thật.
  • http://api.mokxi/: trạng thái, kiểu nội dung và phần thân JSON bạn đặt trong bảng Cloud, để bạn luyện tập với trường hợp thành công, lỗi hoặc thiếu dữ liệu.

Mọi địa chỉ khác không phân giải được. http://example.com/ trả về HTTPC_ERROR_CONNECTION_REFUSED, và HTTPClient::errorToString() cho bạn biết lý do trong một dòng: no real internet: names under .mokxi only. Sự từ chối đó được đọc được từ sketch là có chủ đích. Đó là điều đáng để dạy, không phải điều cần giấu.

Phục vụ

#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() và method(). Các handler là code của bạn, chạy trên nhân của bo mạch với xung nhịp của bo mạch.

Bảng Web (một tab cạnh Serial dọc theo đáy màn hình) là trình duyệt cho chúng. Nó có thanh địa chỉ bắt đầu tại http://192.168.4.2/, nút Refresh, và trang web đó trong một khung với scripts switched off. Liên kết và nút trong trang đó quay ngược về sketch của bạn, và đó là điều khiến "bật tắt LED từ trang web" chạy được từ đầu đến cuối.

Nếu trang không bao giờ đến, bảng sẽ nói vậy, và sau mười giây mạng tự trả về 504: lý do thường thấy là loop() đã ngừng gọi handleClient().

Điểm truy cập riêng của bo mạch bạn

Một sketch có thể tự khởi tạo một mạng thay vì tham gia vào một mạng, giống như một trang cài đặt hay bộ điều khiển của 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(); }

Bảng Web chính là chiếc điện thoại tham gia vào nó. Khoảng một giây rưỡi sau khi điểm truy cập hoạt động, một dòng dưới thanh địa chỉ ghi Phone joined MyESP, và thanh địa chỉ chuyển sang http://192.168.4.1/: nhấn Go. Nhấn Leave thì điện thoại rời đi; Join tham gia lại với mật khẩu trong ô, và mật khẩu sai sẽ bị từ chối, như trên điện thoại thật. Khi đang tham gia, WiFi.softAPgetStationNum() bằng 1 và WiFi.onEvent() nhận các sự kiện trạm kết nối và ngắt kết nối.

Mật khẩu phải dài từ 8 đến 63 ký tự (hoặc không đặt, cho mạng mở), nếu không softAP() sẽ trả về false, giống như trên bo mạch thật. softAPConfig() dùng để đổi địa chỉ. WIFI_AP_STA chạy cả hai chế độ: bo mạch vẫn giữ địa chỉ thuê trên mạng mô phỏng và vẫn có thể tải các trang .mokxi. Trên Pico W, địa chỉ là 192.168.42.1 (192.168.4.1 khi bật thêm chế độ station), theo cách arduino-pico chọn, và WiFi.beginAP() sẽ khởi động nó; trên Uno R4 WiFi, WiFi.beginAP() và WL_AP_CONNECTED hoạt động như trong các ví dụ của WiFiS3.

Captive portal cũng hoạt động: khởi động DNSServer bằng dnsServer.start(53, "*", WiFi.softAPIP()) và, khi điện thoại tham gia, bảng Web tự mở trang của bạn, giống như điện thoại hiển thị trang đăng nhập. Trong MicroPython, network.WLAN(network.AP_IF) cũng là điểm phát sóng đó, và một server socket trên cổng 80 sẽ hiện trong bảng Web.

Chiếc điện thoại duy nhất đó là tất cả: không có thiết bị thứ hai tham gia được, và không gì đi qua bo mạch ra internet được.

Bảng Cloud

Mọi yêu cầu, cả hai chiều: bo mạch đã xin gì từ mạng internet mô phỏng, và bảng Web đã xin gì từ bo mạch, kèm phương thức, địa chỉ, trạng thái, phần thân và, khi có lỗi, một dòng nói rõ lý do. Đây là tab network cho một bo mạch.

Nó cũng chứa hai núm chỉnh của weather.mokxi, ba cài đặt điểm truy cập và phòng thí nghiệm API, nơi bạn chọn api.mokxi trả lời gì. Một bài học có thể chỉnh một thứ và xem sketch nhận ra.

Một sketch Blynk sẽ có một Blynk phần ở đó nữa, với các chân ảo và một ô để gửi giá trị cho từng chân: xem Blynk, được mô phỏng.

Trên Pico W

Pico W là một Pico kèm chip không dây, và code WiFi của nó vẫn là WiFi.h như trên. Hai điều khác so với Pico thường, như trên bo mạch thật:

  • LED_BUILTIN là LED trên bo mạch, còn GP25 thì không. LED nằm trên chip không dây, nên digitalWrite(LED_BUILTIN, HIGH) sẽ sáng nó. GP25 điều khiển đường chọn của chip không dây, nên sketch ghi vào GP25 sẽ không làm đèn sáng gì, cả ở đây lẫn trên bàn thật.
  • LED chỉ bật hoặc tắt. analogWrite(LED_BUILTIN, ...) không có tác dụng, nên hãy làm mờ dần LED trên một chân thường thay vào đó.

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; chi tiết đầy đủ nằm trong the Pico W model.

Ethernet dây (ETH.h)

Trên các bo ESP32, thư viện Ethernet dây của core cũng biên dịch và chạy được, cho các sketch viết cho WT32-ETH01, Olimex ESP32-POE hoặc module W5500. Chọn ESP32 DevKit cho sketch WT32-ETH01 hoặc ESP32-POE: đó là cùng một chip.

#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();
}

Không có dây cáp và không có chip Ethernet. ETH.begin() tham gia vào cùng mạng mô phỏng mà WiFi dùng, không cần tên mạng hay mật khẩu, và sau khoảng 1,5 giây nó có địa chỉ 192.168.4.2. Từ đó WiFiClient, HTTPClient, WebServer và PubSubClient hoạt động qua nó y như qua WiFi, bảng Web truy cập được server của sketch, và công tắc Real internet cùng giới hạn của nó cũng vậy.

  • Cả hai lệnh ETH.begin() của hai core đều biên dịch được: ETH.begin(addr, power, mdc, mdio, type, clock) của core 2.x, ETH.begin(ETH_PHY_LAN8720, addr, mdc, mdio, power, clock) của core 3.x và dạng W5500 của nó, ETH.begin(ETH_PHY_W5500, addr, cs, irq, rst, SPI).
  • Các sự kiện đến theo thứ tự của core: ARDUINO_EVENT_ETH_START, ARDUINO_EVENT_ETH_CONNECTED, ARDUINO_EVENT_ETH_GOT_IP, và sau ETH.end() là ARDUINO_EVENT_ETH_DISCONNECTED và ARDUINO_EVENT_ETH_STOP.
  • ETH.linkUp(), ETH.linkSpeed() (100) và ETH.fullDuplex() (true) đọc như một bo mạch cắm vào switch. Dây mạng luôn được cắm.
  • ETH.config(ip, gateway, mask, dns) đặt địa chỉ tĩnh, và ETH.localIP() trả về địa chỉ đó. Bảng Web vẫn truy cập được bo mạch tại 192.168.4.2.
  • Bo mạch chỉ có một kết nối đến mạng. WiFi.begin() gọi sau ETH.begin() sẽ chuyển kết nối sang WiFi, và WiFi.status() đọc kết nối duy nhất đó trong cả hai trường hợp.
  • Chỉ ESP32 cổ điển có bộ điều khiển Ethernet mà LAN8720 cần. Trên ESP32-S3, C3 hoặc C6, một bo mạch thật dùng W5500 qua SPI; một sketch LAN8720 vẫn chạy được ở đây, và serial monitor sẽ nói điều đó một lần.

Internet thật

Công tắc Real internet ở đầu bảng Cloud hoạt động với bất kỳ ai đã đăng nhập: gói Free gửi được 100 yêu cầu mỗi ngày, và gói Pro nhiều hơn. Khi tắt, như mọi phiên đều bắt đầu, không có gì ở trên thay đổi. Khi bật, một yêu cầu đến tên ngoài .mokxi (kể cả https://) sẽ đi ra internet thật qua cổng kết nối của Mokxi, và câu trả lời quay về sketch của bạn; các tên .mokxi vẫn được mô phỏng. Một bo mạch trên điểm truy cập Wokwi-GUEST, như một bản nhập từ Wokwi, tự bật công tắc khi chạy. Khi chưa đăng nhập, công tắc nhắc bạn đăng nhập miễn phí, và bo mạch vẫn dùng mạng mô phỏng. Một bot Telegram (UniversalTelegramBot.h) cũng hoạt động theo cách này, và chỉ theo cách này. Real internet có chi tiết và các giới hạn.

Thử các ví dụ này

  • WiFi: join the network: vòng lặp kết nối, địa chỉ và tín hiệu.
  • WiFi: fetch the weather: HTTPClient truy vấn weather.mokxi, và một yêu cầu cố ý đến example.com để bạn tự đọc thông báo từ chối.
  • WiFi: a lamp on a web page: hai nút nhấn và một form để bật tắt LED ở chân GPIO 8.
  • API lab: fetch JSON: một GET bằng HTTPClient đến api.mokxi. Đổi câu trả lời trong bảng Cloud rồi chạy lại yêu cầu.
  • ESP32 access point web server: mạng riêng của bo mạch, MyESP, và một trang mà điện thoại trong khung Web mở tại 192.168.4.1, với các nút điều khiển LED.

Ba ví dụ đầu có sẵn cho ESP32-C3, ESP32-C6, ESP32 DevKit, ESP32-S3, ESP8266 và Pico W, còn Uno R4 WiFi có ví dụ kết nối riêng. Tất cả đều biên dịch ngay trong trình duyệt, giống hệt mọi ví dụ khác.

Toàn bộ giao ước, từng thanh ghi một và từng giới hạn một, nằm trong WiFi mô phỏng.