Aprender

Conecta una placa a WiFi y sirve una página

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
ESP32-C3: una lámpara en una página weben vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
El ejemplo wifilamp, sirviendo una página que la pestaña Web puede abrir. La red es simulada: no hay 802.11 y nada sale de esta pestaña a menos que inicies sesión y actives el internet real.

Al final de esta página tu placa se habrá unido a una red, habrá recibido una dirección y habrá servido una página web en la que puedes hacer clic, con un LED que sigue al botón que está en ella. Todo lo que escribas es el código Arduino que escribirías para la placa sobre tu escritorio.

Una cosa primero, porque importa más que cualquier otra aquí: la red es simulada. No hay 802.11 en Mokxi y, con el internet real apagado, nada de lo que haga tu sketch sale de esta pestaña del navegador. Con la sesión iniciada, puedes activar el internet real en el panel Nube, y las solicitudes HTTP y HTTPS a hosts reales salen por la puerta de enlace de Mokxi. Lo que es fiel es el código, los códigos de estado, el orden en que llegan los estados y el segundo o dos que tarda la conexión, que es lo que te da una placa real. La pestaña Web es el único navegador del mundo que puede alcanzar tu servidor, y esa es la verdad del asunto.

Cinco placas pueden hacer esto, y son las cinco con radio en el hardware real: la ESP32-C3, la ESP32-C6, la clásica ESP32 DevKit, la ESP8266 NodeMCU y la Raspberry Pi Pico W. Elige la que esté sobre tu escritorio. El circuito de arriba es la C3 con un LED y una resistencia de 220 ohmios en GPIO 8, y cada una de las cinco trae los mismos tres ejemplos cableados a su propio pin de lámpara, así que el sketch y el cableado van juntos.

Verás el ciclo de conexión imprimir sus puntos y luego una dirección, como lo hace en una placa real.

Luego abres la pestaña Web y lees la página que tu propio sketch está sirviendo, en un marco con los scripts desactivados.

Presiona Encendido en esa página y el LED se enciende, en la placa y en la protoboard.

Unirse a la red

Presiona Ejecutar y mira primero el monitor serie. El sketch llama a WiFi.begin con el nombre y la contraseña del único punto de acceso que esta placa puede ver, luego hace un ciclo con WiFi.status() hasta que reporta WL_CONNECTED. Eso tarda entre uno y tres segundos, que es lo que tarda una placa real en una red tranquila. Luego la dirección: 192.168.4.2, asignada como la asignaría DHCP, con la puerta de enlace en 192.168.4.1 y la intensidad de la señal al lado.

El punto de acceso es una configuración de la placa, no un componente que se conecta. Haz clic en la placa y busca wifiSsid, wifiPassword y wifiRssi en el panel de propiedades. Sin radio no hay nada que escanear ni nada que lleve un componente aparte hasta la placa, así que la única red que puede ver vive en la placa misma. El RSSI también es una configuración, no una medición: mover la placa por el lienzo no cambia nada.

Pruébalo mal a propósito. Cambia la contraseña por otra y presiona Ejecutar de nuevo. El sketch, sin cambios, recibe WL_CONNECT_FAILED cinco segundos después, que es lo que hace una placa real cuando te equivocas, y el estado que recorre en el camino (inactivo, luego desconectado, luego fallido) es la propia secuencia de Arduino, valor por valor.

Sirve una página y ábrela en la pestaña Web

La pestaña Web está en la parte inferior del editor, junto a Serie. Abre http://192.168.4.2/, que es la dirección que la placa acaba de imprimir, y muestra la página que tus controladores están enviando. Hay una barra de direcciones y un botón de Actualizar, y el marco tiene los scripts desactivados, así que nada dentro de la página puede ejecutarse y nada dentro de ella puede descargar una imagen o una fuente de ningún lado.

Los enlaces y los envíos de formularios dentro de ese marco se capturan y se enrutan de vuelta a la red simulada. Presionar Encendido realmente llega al controlador que registraste con server.on, realmente lo ejecuta en el propio núcleo de la placa a su propio reloj, y realmente mueve el pin. El LED sigue, en la placa y en la protoboard. Olvida server.handleClient() en loop() y la página expira después de diez segundos, exactamente como pasaría en el hardware.

La pestaña Nube que está al lado es la pestaña de la red: cada solicitud que hizo la placa y cada solicitud que la página hizo hacia la placa, con el método, la URL, el estado y los cuerpos, y una línea que dice por qué cuando una falló. También lleva las tres configuraciones del punto de acceso y los dos números con los que responde weather.mokxi, así que una clase puede mover un control y ver cómo la siguiente solicitud trae de vuelta el nuevo valor.

Qué hay ahí afuera, y qué no

Cuatro nombres se resuelven y ningún otro: time.mokxi, weather.mokxi, echo.mokxi y api.mokxi, más la propia dirección de la placa. Pide cualquier otra cosa y recibes una frase de vuelta, que tu sketch puede leer e imprimir: no hay internet real, solo nombres bajo .mokxi. Esa negativa es algo para enseñar y no para esconder, y el ejemplo WiFi: fetch the weather pide example.com a propósito para que lo leas en tu propio monitor serie. Eso es con el internet real apagado; actívalo, con la sesión iniciada, y otros nombres salen a los hosts reales.

https:// también falla mientras el internet real está apagado, y dice por qué. WiFiClientSecure compila y luego se niega, porque un TLS que confiara en todo te enseñaría que https es gratis. Con el internet real activado, las solicitudes https:// de HTTPClient salen por la puerta de enlace de Mokxi. No hay TCP, ni protocolo DNS, ni socket en ninguna parte debajo de todo esto, y nada fuera de esta pestaña del navegador puede alcanzar el servidor que ejecuta tu sketch.

Carga WiFi: join the network primero y luego WiFi: a lamp on a web page desde el selector de ejemplos, y léelos junto a esta página. Cuando lleves el mismo sketch a una placa real, la única línea que cambiarás es el nombre de tu propia red.

Abre este circuito en el editor. ESP32-C3: una lámpara en una página web, cableado tal como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Preguntas

¿El WiFi es real?

No, y cada página que lo menciona lo dice. No hay 802.11 en ninguna parte de Mokxi, ni canal, ni escaneo, ni WPA2, y ninguna solicitud sale de la pestaña del navegador a menos que inicies sesión y actives el internet real. La contraseña se compara como una cadena de texto. Lo que es fiel es la API de Arduino, los códigos de estado, el orden de los estados y el uno a tres segundos que tarda una conexión.

¿Mi sketch puede descargar un sitio web real?

No. Cuatro nombres inventados bajo .mokxi se resuelven y nada más. Pide cualquier otra cosa y HTTPClient devuelve una negativa con una frase adjunta, que tu sketch puede imprimir. https:// falla de la misma manera, porque un TLS que confiara en todo te enseñaría que https es gratis.

¿Qué placas pueden hacer esto?

La ESP32-C3, la ESP32-C6, la clásica ESP32 DevKit, la ESP8266 NodeMCU y la Raspberry Pi Pico W, que son las cinco placas de aquí con radio en el hardware real. En cualquier otra placa, incluida una Raspberry Pi Pico común, WiFi.h se niega a compilar con una frase que dice por qué, en lugar de fingir.

¿Alguien más puede abrir la página que sirve mi placa?

No. No hay socket a la escucha y nada fuera de esta pestaña del navegador puede alcanzarla. La pestaña Web es el único cliente que existe, y su marco se sirve con los scripts desactivados para que la página no pueda descargar nada de ningún lado.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.