Aprender

Conecte uma placa ao WiFi e sirva uma página

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
ESP32-C3: uma lâmpada em uma página webao vivo0.000 s 0.00x
Clique para abrir no editor
O exemplo wifilamp, servindo uma página que a aba Web pode abrir. A rede é simulada: não há 802.11, e nada sai desta aba a menos que você entre e ative a internet real.

Ao final desta página, sua placa terá entrado em uma rede, recebido um endereço e servido uma página web em que você pode clicar, com um LED que acompanha o botão nela. Tudo o que você escreve é o código Arduino que você escreveria para a placa na sua mesa.

Uma coisa primeiro, porque importa mais do que qualquer outra aqui: a rede é simulada. Não há 802.11 no Mokxi, e com a internet real desativada, nada do que seu sketch faz sai desta aba do navegador. Com login feito, você pode ativar a internet real no painel Nuvem, e requisições HTTP e HTTPS para hosts reais saem pelo gateway do Mokxi. O que é fiel é o código, os códigos de status, a ordem em que os estados chegam e o segundo ou dois que a conexão leva, que é o que uma placa real dá a você. A aba Web é o único navegador do mundo que consegue alcançar seu servidor, e essa é a forma honesta disso.

Cinco placas podem fazer isso, e são as cinco com rádio no hardware real: a ESP32-C3, a ESP32-C6, a ESP32 DevKit clássica, a ESP8266 NodeMCU e a Raspberry Pi Pico W. Escolha a que estiver na sua mesa. O circuito acima é a C3 com um LED e um resistor de 220 ohms no GPIO 8, e cada uma das cinco traz os mesmos três exemplos ligados ao seu próprio pino da lâmpada, então o sketch e a ligação viajam juntos.

Você vai ver o laço de conexão imprimir seus pontinhos e depois um endereço, do jeito que acontece em uma placa real.

Depois você abre a aba Web e lê a página que seu próprio sketch está servindo, em um quadro com scripts desativados.

Aperte Ligar naquela página e o LED acende, na placa e na protoboard.

Entrar na rede

Aperte Rodar e olhe primeiro para o monitor serial. O sketch chama WiFi.begin com o nome e a senha do único ponto de acesso que esta placa consegue ver, então faz um laço em WiFi.status() até ele reportar WL_CONNECTED. Isso leva de um a três segundos, que é onde uma placa real em uma rede tranquila fica. Depois o endereço: 192.168.4.2, atribuído do jeito que o DHCP atribuiria, com o gateway em 192.168.4.1 e a força do sinal ao lado.

O ponto de acesso é uma configuração na placa, não um componente que você liga. Clique na placa e procure wifiSsid, wifiPassword e wifiRssi no painel de propriedades. Sem rádio, não há nada para escanear e nada que justifique um componente separado levado até a placa, então a única rede que ela consegue ver mora na própria placa. O RSSI também é uma configuração, e não uma medição: mover a placa no canvas não muda nada.

Tente errar de propósito. Mude a senha para outra coisa e aperte Rodar de novo. O sketch, sem mudanças, recebe WL_CONNECT_FAILED cinco segundos depois, que é o que uma placa real faz quando você erra, e os estados pelos quais ele passa no caminho (idle, depois disconnected, depois failed) são a própria sequência do Arduino, valor por valor.

Sirva uma página e abra na aba Web

A aba Web fica na parte de baixo do editor, ao lado de Serial. Ela abre em http://192.168.4.2/, que é o endereço que a placa acabou de imprimir, e renderiza a página que seus handlers estão enviando. Há uma barra de endereço e um botão Atualizar, e o quadro tem scripts desativados, então nada dentro da página pode ser executado e nada dentro dela pode buscar uma imagem ou uma fonte de qualquer lugar.

Links e envios de formulário dentro daquele quadro são capturados e roteados de volta para a rede simulada. Apertar Ligar realmente chega ao handler que você registrou com server.on, realmente o executa no núcleo da própria placa no clock da própria placa, e realmente move o pino. O LED acompanha, na placa e na protoboard. Esqueça server.handleClient() no loop() e a página dá timeout depois de dez segundos, exatamente como aconteceria no hardware.

A aba Nuvem ao lado é a aba de rede: cada requisição que a placa fez e cada requisição que a página fez para a placa, com o método, a URL, o status e os corpos, e uma linha dizendo por que quando uma falhou. Ela também carrega as três configurações do ponto de acesso e os dois números com que weather.mokxi responde, então uma aula pode girar um botão e ver a próxima busca trazer o novo valor de volta.

O que existe lá fora, e o que não existe

Quatro nomes resolvem e nenhum outro: time.mokxi, weather.mokxi, echo.mokxi e api.mokxi, mais o endereço da própria placa. Peça qualquer outra coisa e você recebe uma frase de volta, que seu sketch pode ler e imprimir: não há internet real, apenas nomes sob .mokxi. Essa recusa é uma coisa para ensinar em vez de esconder, e o exemplo WiFi: fetch the weather pede example.com de propósito para você ler no seu próprio monitor serial. Isso é com a internet real desativada; ative-a, com login feito, e outros nomes saem para os hosts reais.

https:// também falha com a internet real desativada, e diz por quê. WiFiClientSecure compila e depois recusa, porque um TLS que confiasse em tudo ensinaria que https é de graça. Com a internet real ativada, as requisições https:// do HTTPClient saem pelo gateway do Mokxi. Não há TCP, protocolo DNS nem socket em nenhum lugar sob nada disso, e nada fora desta aba do navegador consegue alcançar o servidor que seu sketch executa.

Carregue WiFi: join the network primeiro e depois WiFi: a lamp on a web page no seletor de exemplos, e leia-os ao lado desta página. Quando você levar o mesmo sketch para uma placa real, a única linha que mudará é o nome da sua própria rede.

Abra este circuito no editor. ESP32-C3: uma lâmpada em uma página web, ligada como roda no topo desta página. Mude um componente ou um valor e rode de novo.

Perguntas

O WiFi é real?

Não, e toda página que o menciona diz isso. Não há 802.11 em lugar nenhum do Mokxi, nenhum canal, nenhuma varredura e nenhum WPA2, e nenhuma requisição sai da aba do navegador a menos que você entre e ative a internet real. A senha é comparada como string. O que é fiel é a API do Arduino, os códigos de status, a ordem dos estados e o um a três segundos que uma conexão leva.

Meu sketch pode buscar um site real?

Não. Quatro nomes inventados sob .mokxi resolvem e nada mais. Peça qualquer outra coisa e o HTTPClient devolve uma recusa com uma frase anexada, que seu sketch pode imprimir. https:// falha do mesmo jeito, porque um TLS que confiasse em tudo ensinaria que https é de graça.

Quais placas podem fazer isso?

A ESP32-C3, a ESP32-C6, a ESP32 DevKit clássica, a ESP8266 NodeMCU e a Raspberry Pi Pico W, que são as cinco placas daqui com rádio no hardware real. Em qualquer outra placa, incluindo uma Raspberry Pi Pico comum, a WiFi.h se recusa a compilar com uma frase dizendo por quê, em vez de fingir.

Alguém mais pode abrir a página que minha placa está servindo?

Não. Não há socket em escuta e nada fora desta aba do navegador consegue alcançá-la. A aba Web é o único cliente que existe, e seu quadro é servido com scripts desativados, então a página não pode buscar nada de lugar nenhum.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.