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
RSTpara 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:
analogWriteacepta 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
- La página de la placa: /boards/nodemcu
- El documento del contrato: el modelo del ESP8266 NodeMCU
- La otra placa Xtensa: el ESP32 DevKit
- El chip que lo reemplazó: el ESP32-C3
- El mismo chip en placas más pequeñas: el Wemos D1 mini y el ESP-01S