Como ligar
Funciona em toda placa com WiFi simulado, entre elas as placas ESP32 e ESP8266, a Pico W e a Uno R4 WiFi (veja WiFi, simulado).
Abra o painel Cloud e marque Internet real. O Mokxi verifica sua conta primeiro:
- Sem login, o interruptor diz para entrar de graça, e sua placa mantém a rede simulada.
- No Grátis, com login e e-mail confirmado, ele liga com a cota do Grátis (abaixo).
- No Pro, no preço de estudante, no Sala de aula e no teste grátis do Pro, ele liga com a cota maior.
Toda sessão começa com ele desligado, então um projeto nunca alcança a internet só por ser aberto. A única exceção é uma placa no ponto de acesso Wokwi-GUEST, que é o que um projeto importado do Wokwi usa: como no Wokwi, esse ponto de acesso alcança a internet, então o interruptor liga sozinho quando o projeto roda. Desmarque-o e ele fica desligado até você recarregar.
Enquanto estiver ligado:
- uma requisição para um nome fora de
.mokxisai pelo gateway do Mokxi, e a resposta volta para o seu sketch, comhttps://incluído (o gateway cuida do TLS, então usehttp.begin("https://...")); time.mokxi,weather.mokxi,echo.mokxi,api.mokxie o próprio endereço da placa continuam simulados;- toda requisição ainda aparece no registro do painel Cloud, com uma nota dizendo que passou pelo 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();
Um webhook é um POST do mesmo jeito: http.addHeader("Content-Type", "application/json") e http.POST("{\"temp\":21.5}").
MQTT
Um sketch publica uma mensagem MQTT com um único POST HTTP para 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
O gateway a envia ao broker como MQTT sobre WebSockets. Os brokers são os brokers públicos de teste test.mosquitto.org (o padrão), broker.hivemq.com e broker.emqx.io. Observe o tópico de qualquer cliente MQTT para vê-la chegar.
O que ele não faz, com honestidade: PubSubClient e outras bibliotecas que abrem uma conexão TCP direta na porta 1883 não funcionam, porque a placa simulada não tem soquete TCP e nosso gateway também não pode abrir um. Publicar é em um só sentido: o gateway não assina nem traz mensagens de volta para a placa. Tópicos com + ou # são recusados.
Telegram
UniversalTelegramBot.h vem incluída, e um bot do Telegram funciona com o interruptor ligado: cada chamada dele é uma requisição HTTPS para api.telegram.org, que o gateway envia. Pegue um token com o BotFather, coloque no sketch, marque Internet real e rode; o EchoBot da biblioteca está no navegador de bibliotecas.
- O cliente não é usado. O
WiFiClientSecureque você passa para o bot, e oTELEGRAM_CERTIFICATE_ROOTque você dá a ele, não carregam nada aqui: o gateway cuida do TLS e verifica o certificado do Telegram. - Com o interruptor desligado, toda chamada retorna
falseou0imediatamente, e o monitor serial diz uma vez que o Telegram precisa da internet real. - Atenção aos limites abaixo. Pedir mensagens a cada segundo são 60 requisições por minuto, mais do que qualquer plano permite, então faça consultas a cada dez segundos, mais ou menos. No Grátis, as 50 por dia de um projeto duram poucos minutos assim: o bastante para ver a resposta, não para deixá-lo rodando.
- Fotos e arquivos enviados como bytes não são transportados, porque o gateway aceita texto.
sendPhoto()com a URL de uma imagem funciona.
Tempo
configTime() funciona e getLocalTime() responde, e o getFormattedTime() do NTPClient também, mas o relógio é o da própria simulação, que começa em 2026-01-01 00:00:00 UTC: não é a hora real. NTP é um protocolo UDP, a internet real carrega HTTP, e a simulação não sabe a data de hoje. Para a hora real do dia, pergunte a uma API de horário por HTTP com o interruptor ligado.
Os limites
| Grátis | Pro | |
|---|---|---|
| Requisições por dia, por conta | 100 | 1,000 |
| Requisições por dia, por projeto | 50 | 500 |
| Requisições por minuto, por conta | 10 | 30 |
| Requisições por minuto, por projeto | 10 | 20 |
| Corpo da requisição | 1.024 bytes | 2.048 bytes |
| Resposta mantida | 2.048 bytes | 4.096 bytes |
| mensagem MQTT | 512 bytes | 1.024 bytes |
Os dias são em UTC. No plano Grátis, uma rede também compartilha 300 requisições por dia e 20 por minuto entre todas as contas conectadas nela.
- Depois de passar de um limite, a placa recebe o status 429 com uma frase dizendo qual limite foi atingido. Coloque um
delay()no seu loop: uma leitura a cada dez segundos por um quarto de hora dá noventa requisições. - Tamanhos: uma resposta mais longa é cortada, e o log avisa. Um corpo que não é texto (uma imagem, por exemplo) é deixado de fora.
- Tempo: o servidor tem 4 segundos para responder.
- Métodos: GET e POST, nas portas 80, 443, 8080 e 8443.
- Redirecionamentos não são seguidos. Um 301 ou 302 volta para o seu sketch como está, com o endereço para o qual ele aponta como corpo.
- O que é recusado: endereços privados e locais (10.x, 192.168.x, 127.0.0.1, 169.254.x e os equivalentes IPv6), nomes como
localhostou qualquer coisa sob.localou.internal, um nome que resolve para um deles, os servidores da Cloudflare e os da própria Mokxi, e qualquer servidor que tenhamos tido de bloquear. Seu sketch recebe uma recusa com o motivo no painel Cloud.WiFiClientSecureainda é recusado; use umWiFiClientcomum ou nenhum.
O que guardamos
Contagens, e nada mais: quantas requisições cada conta, projeto e rede enviou hoje, para que os limites diários funcionem, e quantas o serviço inteiro enviou. Uma rede é contada com um código embaralhado que muda todos os dias, nunca pelo seu endereço. Nenhum endereço, URL, cabeçalho ou corpo é armazenado ou registrado.
In a class
Para um aluno em uma turma, a internet real fica desligada a menos que o professor a ative, seja qual for o plano do aluno. Um professor com as ferramentas de turma ativadas (Pro, Sala de aula ou o teste) pode ligá-la para uma turma, e a turma então tem os limites do Pro; até lá, o interruptor do aluno diz que está desligada para a turma dele. Contas marcadas como menores de 13 anos seguem a mesma regra.