Placas

La ESP8266 NodeMCU

Una placa ESP8266 con WiFi simulado, un Xtensa LX106 a 80 MHz, pines D0 a D8 que difieren de los números de GPIO, y PWM por software.

La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la ESP8266 NodeMCU (todos los registros).

Qué es

La NodeMCU V1.0 "Amica", un módulo ESP-12E en un soporte de treinta pines, funcionando con nuestro propio núcleo Xtensa en su configuración LX106. El firmware es un ELF de Xtensa que habla con las direcciones reales del ESP8266, con una excepción, que se menciona abajo, de la que el modelo es transparente.

La placa mide 48.3 por 25.6 mm y sus dos filas de quince pines están a 0.9 pulgadas de distancia, así que cabalga sobre el canal central de una protoboard dejando libre una fila de orificios a cada lado. La placa que la gente fotografía uniendo dos protoboards es la V3 "LoLin", más ancha, cuyas filas están a una pulgada completa de distancia. Este componente es la V1.0.

D0 to D8 are not GPIO numbers

Esto es lo que a todos les sorprende en esta placa, así que va primero:

Serigrafía D0 D1 D2 D3 D4 D5 D6 D7 D8 RX TX
GPIO 16 5 4 0 2 14 12 13 15 3 1

digitalWrite(2, HIGH) es D4, no D2. El entorno de ejecución de Mokxi define D0 a D8, así puedes escribir digitalWrite(D2, HIGH) y referirte al pin que estás viendo.

Los pines

Quince en cada borde largo, el conector micro-USB abajo.

Columna izquierda, de arriba abajo: A0, RSV, RSV, SD3, SD2, SD1, CMD, SD0, CLK, GND, 3V3, EN, RST, GND, VIN.

Columna derecha, de arriba abajo: D0, D1, D2, D3, D4, 3V3, GND, D5, D6, D7, D8, RX, TX, GND, 3V3.

Esta es una placa de 3.3 voltios y sus pines no toleran 5 V. VIN es el riel de 5 V del USB.

SD0 a SD3, CMD y CLK son los seis cables del chip de flash. Están en el header de una NodeMCU real y están en este componente, y aquí no están conectados a nada: no manejan ni leen señales. Manejar uno en una placa real detiene la flash de la que corre tu programa, así que un simulador que te dejara usarlos te estaría enseñando a dañar una placa. Los dos pines RSV son iguales.

Dos LED, y ambos están al revés

D4 (GPIO 2) tiene el LED azul del módulo ESP-12 y D0 (GPIO 16) el de la placa soporte. Ambos son activos en bajo: digitalWrite(LED_BUILTIN, LOW) enciende el del módulo. LED_BUILTIN es 2.

El ejemplo blink escribe el LED integrado y uno cableado en D1 en sentidos opuestos a propósito, para que los dos queden siempre invertidos entre sí, que es lo que ves en un escritorio.

El botón FLASH es el GPIO 0, que es D3, activo en bajo. Al hacer clic en él sobre la placa, el pin se conecta a tierra.

D0 no es un pin ordinario

El GPIO 16 (D0) es un pin del RTC, no del bloque GPIO. De ahí siguen tres cosas:

  • Tiene una resistencia pull-down, mientras que todas las demás patillas de este componente tienen pull-up.
  • No puede generar una interrupción. attachInterrupt(D0, ...) no hace nada.
  • En una placa real es el pin que conectas a RST para despertar del sueño profundo, lo cual no se modela aquí porque el sueño profundo tampoco.

analogRead: un pin, diez bits y un divisor

A0 es el único pin analógico que tiene el ESP8266. No es un GPIO y no se puede escribir.

El pin del chip convierte de 0 a 1.0 V. Una NodeMCU pone un divisor 220k/100k delante, así que la A0 del header va de 0 a unos 3.2 V y un potenciómetro a través del riel de 3.3 V cubre casi todo el rango. El divisor es parte de la placa, y Mokxi lo modela: el pin carga tu red con 320 k, que es lo que hace uno real.

Diez bits, de 0 a 1023, que también es el rango PWM de esta placa, así que el ejemplo del knob pasa la lectura directo al ciclo útil.

Esto es lo único en esta placa que no está en una dirección real. Espressif nunca publicó los registros del ADC del ESP8266 (el SDK llama a system_adc_read() desde un blob binario), así que en lugar de inventar una dirección y dejarte asumir que es la del chip, Mokxi pone ahí tres registros propios y lo declara. Lo que eso significa en la práctica: si llevas una compilación de aquí a una NodeMCU real, analogRead es la única llamada que tendrías que cambiar. Nada más.

analogWrite es por software, el rango es 1023 y le cuesta algo al núcleo

El ESP8266 no tiene hardware de PWM en absoluto. No un LEDC reducido: nada. El núcleo de Arduino para ESP8266 genera sus formas de onda desde un manejador de temporizador, y este entorno de ejecución también: ocho pines a la vez, 1 kHz por defecto, analogWriteFreq(40..60000).

De ahí siguen dos cosas, y ambas son reales:

  • analogWrite acepta de 0 a 1023, no de 0 a 255. analogWrite(pin, 255) es un cuarto del brillo, no el máximo. Eso es lo que hace el núcleo real, y copiarlo fue la decisión entre sorprenderte aquí o sorprenderte en el escritorio. analogWriteRange(255) hace que un sketch de Uno se comporte así.
  • El núcleo despierta dos veces por período para mover el pin. En un ESP32 un LED que se desvanece es gratis; aquí no. Ambas placas están aquí, y la diferencia entre ellas es una de las cosas más útiles que enseña este par.

Serie

Serial es UART0 en TX y RX, que es el puerto donde está el puente USB, y está conectado al monitor serie. Los bytes salen a la velocidad en baudios que configures.

Serial1 no está modelado. En un ESP8266 real el pin TX de UART1 es GPIO 2, que también es el LED del módulo, y por eso no puedes tener ambos.

Para un segundo puerto, SoftwareSerial.h funciona en cualquier par de pines excepto D0 (GPIO 16 no tiene interrupción), con las llamadas de EspSoftwareSerial, la biblioteca que incluye el núcleo del ESP8266: SoftwareSerial gps(D5, D6); gps.begin(9600);. Cada flanco en el pin de recepción se cronometra en una interrupción contra el contador de ciclos, así que varios puertos reciben a la vez y listen() no detiene a los demás. Solo 8N1.

What is modeled

El Xtensa LX106 con el ABI call0: dieciséis registros y sin ventana de registros, que es lo que emite su compilador y por qué una imagen de ESP32 falla en este núcleo en lugar de comportarse mal en silencio. A su alrededor: el bloque de GPIO y el IO_MUX, los registros del RTC que son GPIO 16, UART0, el convertidor TOUT, y CCOUNT y CCOMPARE0 detrás de millis(), micros(), delay() y el PWM por software.

Ese es el conjunto que pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt y Serial necesitan, en sus direcciones reales, con el ADC como la excepción indicada.

WiFi, simulated

No hay radio. Nunca lo habrá: una MAC 802.11 no es algo que este modelo pudiera reproducir con honestidad.

Lo que hay en su lugar es una red simulada. Un bloque que es propio de Mokxi y no del chip (un buzón en 0x6FFF_E000, donde un ESP8266 real no tiene nada asignado) soporta WiFi.h, HTTPClient.h y WebServer.h, así que el código de Arduino que te da un tutorial corre aquí: la placa se une a un punto de acceso cuyo nombre y contraseña son propiedades de la placa, WiFi.status() recorre los mismos estados en el mismo lapso de uno a tres segundos, el DHCP le asigna 192.168.4.2, y un sketch puede descargar una página o servir una.

Lo que hay detrás es software, y no se oculta nada de eso. No hay 802.11, ni canal, ni escaneo, ni WPA2, ni TCP, ni TLS y no hay internet real: cuatro nombres inventados bajo .mokxi se resuelven y ningún otro, y nada de lo que haga un sketch puede llegar a la red donde está tu navegador. WiFiClientSecure compila y luego falla, diciendo que TLS no está simulado. Los paneles Web y Cloud en la parte de abajo del editor se abren con esa frase y no la hacen desaparecer al hacer scroll.

La única excepción es Internet real, un interruptor en el panel Cloud para cualquiera con sesión iniciada (más con Pro) que está apagado cada vez que se carga una página. Con él encendido, una petición por un nombre fuera de .mokxi, https:// incluido, sale por la pasarela de Mokxi y la respuesta vuelve al sketch. Ver Internet real.

Esta es la parte con una radio y sin documentación alguna: el WiFi del ESP8266 es un blob binario en el SDK y Espressif nunca ha publicado sus registros. Este modelo no los inventa. Lo que ofrece en su lugar es un buzón que honestamente es de Mokxi, en una dirección que honestamente no es de la parte.

Tres ejemplos vienen con esta placa: WiFi: conectarse a la red, WiFi: consultar el clima y WiFi: una lámpara en una página web.

WiFi, simulado explica cómo usarlo; WiFi simulado es el contrato, límite por límite.

Lo que no está

Una radio de cualquier tipo. Sin 802.11, sin PHY, sin canal, sin WPA2 y sin registro de la radio propia de la parte, porque Espressif nunca ha publicado uno. En una parte cuya razón de existir es el WiFi, eso es lo más grande que falta aquí, y se dice primero y no al final, por eso la sección anterior es la red simulada y no esta.

También está ausente: la flash y la caché que la mapea, así que no hay PROGMEM lectura de la flash, ni SPIFFS, ni LittleFS ni OTA. FRC1 y FRC2, los dos temporizadores de hardware. El reloj aquí es el propio contador de ciclos del núcleo, que es un registro que ningún modelo tiene que inventar. El sueño profundo y el RTC, su contador y su memoria. SPI, I2S y el UART1 de hardware. No hay periférico I2C en este chip para empezar; el núcleo de Arduino lo implementa por software bit a bit, y eso tampoco está aquí. Los eFuses. Los watchdog sí están modelados: un sketch que no ceda el control durante 3 a 5 s recibe el "Soft WDT reset" del núcleo, y uno que lo haya desactivado con ESP.wdtDisable() el reinicio del watchdog de hardware a los 8.4 s aproximadamente.

Los binarios del SDK del fabricante y del núcleo de Arduino no correrán aquí: el runtime es nuestro.

Compilar tu sketch

Edita el sketch y presiona Ejecutar: se compila en la pestaña, como en todas las demás placas de aquí. Para este chip el compilador es el propio clang de Espressif, que tiene el backend de Xtensa, así que la primera compilación descarga un toolchain aparte (clang-v3, unos 80 MB, una sola vez) y las siguientes lo reutilizan. No se carga nada. Un ejemplo sin modificar corre su programa precompilado; cambia una línea y Ejecutar compila el tuyo.

La aritmética de punto flotante funciona: el LX106 no tiene FPU, así que las sumas de float y double se hacen por software, como en un ESP8266 real. Compilar en el navegador tiene el relato completo.

The full list of what the model implements, and a plain account of which addresses are as real as this part allows, which are believed and which three are invented, is in el modelo del ESP8266 NodeMCU. La sección 6 es la que hay que leer antes de llevar una compilación de aquí al silicio real.

Las bibliotecas estándar de Arduino que compilan las otras placas (Servo.h, Wire.h, EEPROM.h, Adafruit_SSD1306.h y las demás) también están en la ruta de include aquí, pero aún no se han verificado en esta placa.

Los ejemplos

Blink, Button, Serial, Fade, Knob y los tres de WiFi: WiFi: unirse a la red, WiFi: obtener el clima y WiFi: una lámpara en una página web. Cada uno ejecuta su programa precompilado hasta que lo cambias, y entonces Ejecutar compila tu versión.

En otras partes