Encenderlo
Funciona en toda placa con WiFi simulado, entre ellas las placas ESP32 y ESP8266, la Pico W y la Uno R4 WiFi (ver WiFi, simulado).
Abre el panel Cloud y marca Internet real. Mokxi revisa primero tu cuenta:
- Sin sesión iniciada, el interruptor te dice que inicies sesión gratis, y tu placa conserva la red simulada.
- En Gratis, con sesión iniciada y tu correo confirmado, se enciende con la asignación de Gratis (abajo).
- En Pro, el precio de estudiante, Salón de clases y la prueba gratis de Pro, se enciende con la asignación mayor.
Cada sesión inicia con el interruptor apagado, así un proyecto nunca llega al internet solo con abrirse. La única excepción es una placa en el punto de acceso Wokwi-GUEST, que es lo que usa un proyecto importado de Wokwi: como en Wokwi, ese punto de acceso llega al internet, así que el interruptor se enciende solo cuando el proyecto corre. Desmárcalo y queda apagado hasta que recargues.
Mientras esté encendido:
- una petición a un nombre fuera de
.mokxisale por la pasarela de Mokxi, y la respuesta regresa a tu sketch,https://incluido (la pasarela hace el TLS, así que usahttp.begin("https://...")); time.mokxi,weather.mokxi,echo.mokxi,api.mokxiy la dirección propia de la placa siguen simuladas;- cada petición sigue apareciendo en el registro del panel Cloud, con una nota que dice que pasó por la pasarela.
#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();
Un webhook es un POST de la misma forma: http.addHeader("Content-Type", "application/json") y http.POST("{\"temp\":21.5}").
MQTT
Un sketch publica un mensaje de MQTT con un solo HTTP POST a 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
La pasarela lo envía al broker como MQTT sobre WebSockets. Los brokers son los brokers públicos de prueba test.mosquitto.org (el predeterminado), broker.hivemq.com y broker.emqx.io. Observa el tema desde cualquier cliente MQTT para verlo llegar.
Lo que no hace, con honestidad: PubSubClient y otras bibliotecas que abren una conexión TCP directa al puerto 1883 no funcionan, porque la placa simulada no tiene un socket TCP y nuestra pasarela tampoco puede abrir uno. Publicar es en un solo sentido: la pasarela no se suscribe ni trae mensajes de vuelta a la placa. Los temas con + o # se rechazan.
Telegram
UniversalTelegramBot.h está integrado, y un bot de Telegram funciona con el interruptor encendido: cada una de sus llamadas es una petición HTTPS a api.telegram.org, que la pasarela envía. Consigue un token con BotFather, ponlo en el sketch, marca Internet real y ejecútalo; el EchoBot de la biblioteca está en el explorador de bibliotecas.
- El cliente no se usa. El
WiFiClientSecureque le das al bot, y elTELEGRAM_CERTIFICATE_ROOTque le das, aquí no transmiten nada: la pasarela hace el TLS y revisa el certificado de Telegram. - Con el interruptor apagado, cada llamada devuelve
falseo0de inmediato, y el monitor serie dice una vez que Telegram necesita el internet real. - Cuida los límites de abajo. Pedir mensajes cada segundo son 60 peticiones por minuto, más de lo que permite cualquier plan, así que consulta más o menos cada diez segundos. En Gratis, las 50 diarias de un proyecto duran unos minutos de eso: suficiente para verlo responder, no para dejarlo corriendo.
- Las fotos y archivos enviados como bytes no se transmiten, porque la pasarela acepta texto.
sendPhoto()con la URL de una imagen sí funciona.
Tiempo
configTime() funciona y getLocalTime() responde, y también el getFormattedTime() de NTPClient, pero el reloj es el de la simulación misma, que inicia en 2026-01-01 00:00:00 UTC: no es la hora real. NTP es un protocolo UDP, el internet real transmite HTTP, y la simulación no sabe la fecha de hoy. Para la hora real del día, pregunta a una API de tiempo por HTTP con el interruptor encendido.
Los límites
| Gratis | Pro | |
|---|---|---|
| Peticiones al día, por cuenta | 100 | 1,000 |
| Peticiones al día, por proyecto | 50 | 500 |
| Peticiones por minuto, por cuenta | 10 | 30 |
| Peticiones por minuto, por proyecto | 10 | 20 |
| Cuerpo de la petición | 1,024 bytes | 2,048 bytes |
| Respuesta conservada | 2,048 bytes | 4,096 bytes |
| mensaje MQTT | 512 bytes | 1,024 bytes |
Los días son UTC. En Gratis, una red también comparte 300 solicitudes al día y 20 por minuto entre todas las cuentas con sesión iniciada en ella.
- Al pasar un límite la placa recibe el estado 429 con una frase que indica qué límite alcanzó. Pon un
delay()en tu loop: una lectura cada diez segundos durante un cuarto de hora son noventa solicitudes. - Tamaños: una respuesta más larga se corta, y el registro lo indica. Un cuerpo que no sea texto (una imagen, por ejemplo) se omite.
- Tiempo: el host tiene 4 segundos para responder.
- Métodos: GET y POST, en los puertos 80, 443, 8080 y 8443.
- No se siguen redirecciones. Un 301 o 302 llega a tu sketch tal cual, con la dirección a la que apunta como cuerpo.
- Lo que se rechaza: direcciones privadas y locales (10.x, 192.168.x, 127.0.0.1, 169.254.x y los equivalentes de IPv6), nombres como
localhosto cualquier cosa bajo.localo.internal, un nombre que se resuelva a una de esas, los hosts propios de Cloudflare y de Mokxi, y cualquier host que hayamos tenido que detener. Tu sketch recibe un rechazo con el motivo en el panel Nube.WiFiClientSecurese sigue rechazando; usa unWiFiClientnormal o ninguno.
Lo que guardamos
Conteos, y nada más: cuántas solicitudes envió hoy cada cuenta, proyecto y red, para que los límites diarios funcionen, y cuántas envió todo el servicio. Una red se cuenta bajo un código revuelto que cambia cada día, nunca su dirección. No se guarda ni registra ninguna dirección, URL, header ni cuerpo.
In a class
Para un estudiante de una clase, el internet real está desactivado a menos que el maestro lo active, sin importar el plan del estudiante. Un maestro con las herramientas de clase activadas (Pro, Salón de clases o la prueba) puede activarlo para un grupo, y el grupo entonces tiene los límites de Pro; hasta entonces el interruptor del estudiante indica que está desactivado para su grupo. Las cuentas marcadas como menores de 13 años siguen la misma regla.