Bật tính năng
Tính năng hoạt động trên mọi bo mạch có WiFi mô phỏng, trong đó có các bo ESP32 và ESP8266, Pico W và Uno R4 WiFi (xem WiFi, simulated).
Mở bảng Cloud và đánh dấu Real internet. Mokxi kiểm tra tài khoản của bạn trước:
- Chưa đăng nhập, công tắc nhắc bạn đăng nhập miễn phí, và bo mạch của bạn vẫn dùng mạng mô phỏng.
- Trên gói Free, đã đăng nhập và xác nhận địa chỉ email, công tắc bật kèm hạn mức của gói Free (dưới đây).
- Trên gói Pro, giá học sinh, gói Classroom và bản dùng thử Pro miễn phí, công tắc bật kèm hạn mức lớn hơn.
Mọi phiên đều bắt đầu với công tắc tắt, nên một dự án không bao giờ tự truy cập internet chỉ vì được mở. Ngoại lệ duy nhất là bo mạch trên điểm truy cập Wokwi-GUEST, thứ mà một dự án nhập từ Wokwi dùng: như trên Wokwi, điểm truy cập đó nối được ra internet, nên công tắc tự bật khi dự án chạy. Bỏ đánh dấu và nó giữ tắt cho tới khi bạn tải lại trang.
Khi công tắc đang bật:
- một yêu cầu đến tên ngoài
.mokxiđi ra qua cổng kết nối của Mokxi, và câu trả lời quay về sketch của bạn, kể cảhttps://(cổng kết nối làm phần TLS, nên dùnghttp.begin("https://...")); time.mokxi,weather.mokxi,echo.mokxi,api.mokxivà chính địa chỉ của bo mạch vẫn được mô phỏng;- mọi yêu cầu vẫn hiện trong log của bảng Cloud, kèm ghi chú là đã đi qua cổng kết nối.
#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 cũng là một POST theo cách đó: http.addHeader("Content-Type", "application/json") và http.POST("{\"temp\":21.5}").
MQTT
Một sketch xuất bản một tin nhắn MQTT bằng một HTTP POST đến 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
Cổng kết nối gửi nó tới broker dưới dạng MQTT qua WebSockets. Các broker là các broker thử nghiệm công cộng test.mosquitto.org (mặc định), broker.hivemq.com và broker.emqx.io. Hãy theo dõi topic từ bất kỳ MQTT client nào để xem tin nhắn đến.
Những gì nó không làm, nói thẳng là thế: PubSubClient và các thư viện khác mở kết nối TCP thẳng đến cổng 1883 không hoạt động, vì bo mạch mô phỏng không có socket TCP và cổng kết nối của chúng tôi cũng không mở được. Xuất bản là một chiều: cổng kết nối không đăng ký topic và không đưa tin nhắn về bo mạch. Các topic chứa + hoặc # bị từ chối.
Telegram
UniversalTelegramBot.h được tích hợp sẵn, và một bot Telegram hoạt động khi công tắc bật: mỗi lời gọi của nó là một yêu cầu HTTPS đến api.telegram.org, do cổng kết nối gửi đi. Lấy token từ BotFather, đặt vào sketch, đánh dấu Real internet rồi chạy; EchoBot của thư viện có trong trình duyệt thư viện.
- Client không được dùng.
WiFiClientSecurebạn đưa cho bot, vàTELEGRAM_CERTIFICATE_ROOTbạn đưa cho nó, không mang ý nghĩa gì ở đây: cổng kết nối làm phần TLS và kiểm tra chứng chỉ của Telegram. - Khi công tắc tắt, mọi lời gọi trả về
falsehoặc0ngay lập tức, và serial monitor nói một lần rằng Telegram cần internet thật. - Chú ý các giới hạn dưới đây. Hỏi tin nhắn mỗi giây là 60 yêu cầu một phút, nhiều hơn mức cả hai gói cho phép, nên cứ khoảng mười giây hỏi một lần. Trên gói Free, 50 yêu cầu một ngày của một dự án chỉ đủ vài phút ở tốc độ đó: đủ để thấy nó trả lời, chứ không đủ để để nó chạy suốt.
- Ảnh và tệp gửi dạng byte không được mang theo, vì cổng kết nối chỉ nhận văn bản.
sendPhoto()với URL của một bức ảnh thì hoạt động.
Thời gian
configTime() hoạt động và getLocalTime() trả lời, và getFormattedTime() của NTPClient cũng vậy, nhưng đồng hồ là của chính bản mô phỏng, khởi động lúc 2026-01-01 00:00:00 UTC: đó không phải giờ thật. NTP là giao thức UDP, internet thật mang HTTP, và bản mô phỏng không biết ngày hôm nay. Muốn biết giờ thật trong ngày, hãy hỏi một time API qua HTTP với công tắc bật.
Các giới hạn
| Miễn phí | Pro | |
|---|---|---|
| Yêu cầu mỗi ngày, mỗi tài khoản | 100 | 1,000 |
| Yêu cầu mỗi ngày, mỗi dự án | 50 | 500 |
| Yêu cầu mỗi phút, mỗi tài khoản | 10 | 30 |
| Yêu cầu mỗi phút, mỗi dự án | 10 | 20 |
| Nội dung yêu cầu | 1.024 byte | 2.048 byte |
| Phản hồi được giữ lại | 2.048 byte | 4.096 byte |
| Tin nhắn MQTT | 512 byte | 1.024 byte |
Các ngày tính theo giờ UTC. Ở gói Free, một mạng còn chia sẻ 300 yêu cầu mỗi ngày và 20 yêu cầu mỗi phút cho mọi tài khoản đang đăng nhập trên mạng đó.
- Vượt quá giới hạn, bo mạch nhận trạng thái 429 kèm một câu cho biết đã chạm giới hạn nào. Hãy đặt
delay()vào vòng lặp của bạn: một lần đọc mỗi mười giây trong mười lăm phút là chín mươi yêu cầu. - Kích thước: phản hồi quá dài sẽ bị cắt, và log sẽ ghi rõ điều đó. Nội dung không phải văn bản (chẳng hạn hình ảnh) sẽ bị bỏ qua.
- Thời gian: máy chủ có 4 giây để trả lời.
- Phương thức: GET và POST, trên các cổng 80, 443, 8080 và 8443.
- Không tự động theo chuyển hướng. Mã 301 hoặc 302 trả về sketch của bạn nguyên trạng, với địa chỉ mà nó trỏ tới nằm trong phần nội dung.
- Những gì bị từ chối: các địa chỉ riêng tư và cục bộ (10.x, 192.168.x, 127.0.0.1, 169.254.x và các địa chỉ IPv6 tương đương), các tên như
localhosthay bất cứ gì thuộc.localhoặc.internal, một tên phân giải về một trong các địa chỉ đó, các máy chủ của Cloudflare và của chính Mokxi, cùng bất kỳ máy chủ nào mà chúng tôi phải chặn. Sketch của bạn nhận được thông báo từ chối kèm lý do trong bảng Cloud.WiFiClientSecurevẫn bị từ chối; hãy dùngWiFiClientthường hoặc không dùng gì cả.
Những gì chúng tôi lưu giữ
Chỉ các con số, không có gì khác: mỗi tài khoản, dự án và mạng đã gửi bao nhiêu yêu cầu hôm nay, để các giới hạn hằng ngày hoạt động, và toàn bộ dịch vụ đã gửi bao nhiêu. Một mạng được tính dưới một mã đã xáo trộn, thay đổi mỗi ngày, không bao giờ dùng địa chỉ của nó. Không địa chỉ, URL, header hay nội dung nào được lưu trữ hay ghi log.
In a class
Với học sinh trong một lớp học, internet thật tắt trừ khi giáo viên bật lên, bất kể học sinh đang ở gói nào. Giáo viên có công cụ lớp học đang bật (Pro, Classroom hoặc bản dùng thử) có thể bật internet thật cho lớp, khi đó lớp có giới hạn của gói Pro; cho đến lúc đó công tắc của học sinh hiển thị là đang tắt cho lớp của em. Các tài khoản đánh dấu dưới 13 tuổi cũng theo quy tắc này.