O editor

Internet de verdade

Deixe uma placa com WiFi acessar serviços web reais, webhooks e brokers MQTT públicos. Grátis assim que você entra, com mais no Pro, e desligado até você ativar.

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 .mokxi sai pelo gateway do Mokxi, e a resposta volta para o seu sketch, com https:// incluído (o gateway cuida do TLS, então use http.begin("https://..."));
  • time.mokxi, weather.mokxi, echo.mokxi, api.mokxi e 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&current=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 WiFiClientSecure que você passa para o bot, e o TELEGRAM_CERTIFICATE_ROOT que 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 false ou 0 imediatamente, 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 localhost ou qualquer coisa sob .local ou .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. WiFiClientSecure ainda é recusado; use um WiFiClient comum 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.