Firmware ligero para ESP32 que se conecta al backend centralizado MiniOS.
| Característica | Original | Client |
|---|---|---|
| Servidor Web | Sí (HTML embebido) | No |
| Tamaño Flash | ~800KB | ~300KB |
| Configuración | Local via web | Remota via backend |
| Acceso | Solo red local | Desde cualquier lugar |
Instalar desde el Library Manager del IDE (o con arduino-cli lib install):
- WebSockets — Markus Sattler (probado con 2.7.2)
- ArduinoJson — Benoit Blanchon (probado con 7.4.3; el código usa la API v6, que sigue funcionando en v7 aunque avise de obsolescencia)
- DHT sensor library — Adafruit (1.4.7) + Adafruit Unified Sensor
- Adafruit AHTX0 (2.0.6)
- Adafruit BMP280 Library (3.0.0)
- Adafruit BME280 Library (2.3.0)
- Adafruit NeoPixel (1.15.5) — solo se usa en ESP32 y ESP32-S3
El firmware no cabe con el esquema de particiones por defecto: hay que elegir uno con más espacio de aplicación que conserve las dos particiones OTA.
| Opción del IDE | Valor |
|---|---|
| Partition Scheme | Minimal SPIFFS (1.9MB APP with OTA) |
| USB CDC On Boot | Enabled (si no, los logs salen por UART0 y no por el USB) |
Con arduino-cli:
arduino-cli compile \
--fqbn esp32:esp32:esp32c3:CDCOnBoot=cdc,PartitionScheme=min_spiffs \
MiniOS_WiFi_ClientTamaños verificados: ESP32-C3 1,32 MB (67%) · ESP32-S3 1,21 MB (61%).
Las credenciales no van en el código. El archivo
.inoestá en un repositorio público y el historial de git conserva para siempre lo que se escriba en él.WIFI_SSIDyWIFI_PASSse dejan vacíos y se configuran por el puerto serie: quedan guardados en NVS y sobreviven a los reinicios.
- Configurar WiFi:
wifi MiRed MiPassword
- Configurar backend:
server 192.168.1.100 3000
O si tienes dominio:
server mi-servidor.com 3000
- Ver estado:
status
- Token de dispositivo (solo si el backend tiene
DEVICE_TOKENconfigurado):
token el-token-del-servidor
Se envía en la URL del WebSocket y en las descargas OTA. Con token - se borra.
- Reiniciar:
reboot
- El ESP32 se conecta al WiFi configurado
- Establece conexión WebSocket con el backend
- Se registra automáticamente usando su MAC Address
- Recibe configuraciones (GPIO, DHT, micrófono) del backend
- Envía datos de sensores cada 5 segundos
- Ejecuta comandos recibidos (set GPIO, reiniciar, OTA)
El dispositivo puede grabar audio cada cierto tiempo y subirlo al backend, donde se escucha desde el dashboard (pestaña Audio del dispositivo).
| INMP441 | Pin |
|---|---|
| VDD | 3.3 (nunca 5 V) |
| GND | G |
| SCK | GPIO 6 |
| WS | GPIO 7 |
| SD | GPIO 5 |
| L/R | G (canal izquierdo) · 3.3 para el derecho |
Los pines se configuran desde el dashboard; esos son los que vienen por defecto. Un segundo micrófono comparte SCK, WS y SD con el primero: solo cambia el L/R.
- La grabación ocurre durante la ventana en que el dispositivo está despierto, justo después de enviar los sensores. Mientras duerme no graba.
- El audio se sube mientras se graba (PCM de 16 bits a
/api/audio/upload), así que nunca ocupa la RAM entera: 10 s a 16 kHz son 320 KB, más de lo que le queda libre a la C3. - "Grabar cada" se mide con el reloj, que se conserva durante el deep sleep. El intervalo real nunca es menor que el del deep sleep.
- "Grabar ahora" desde el dashboard graba en la ventana de comandos actual, o al próximo despertar si el dispositivo está dormido.
- Si la subida falla, se vuelve a intentar en el siguiente ciclo.
Para probar el micrófono por separado, sin backend, está el sketch
tests/INMP441_Test: muestra el nivel en
dB en el Serial Plotter.
- Subir archivo .bin al backend desde el dashboard
- Seleccionar "Enviar a todos" o actualizar dispositivo específico
- El ESP32 descarga e instala automáticamente
- Se reinicia con el nuevo firmware
{
"type": "register",
"mac_address": "AA:BB:CC:DD:EE:FF",
"firmware_version": "1.0.0",
"ip_address": "192.168.1.50"
}{
"type": "data",
"mac_address": "AA:BB:CC:DD:EE:FF",
"payload": {
"temperature": 25.5,
"humidity": 60,
"gpio": [
{"pin": 2, "value": 1},
{"pin": 4, "value": 0}
]
}
}{
"type": "command",
"action": "set_gpio",
"pin": 2,
"value": 1
}{
"type": "command",
"action": "ota_update",
"ota_id": 1,
"filename": "firmware_1.0.1.bin",
"filesize": 512000,
"checksum": "abc123..."
}- Board: "ESP32S3 Dev Module"
- Partition Scheme: "Default 4MB with spiffs"
- Upload Speed: 921600
[env:esp32s3]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
lib_deps =
links2004/WebSockets@^2.4.0
bblanchon/ArduinoJson@^6.21.0
adafruit/DHT sensor library@^1.4.4- Verificar SSID y contraseña
- El ESP32 debe estar cerca del router
- Verificar IP/puerto del servidor
- El backend debe estar corriendo
- Verificar firewall del VPS
- Verificar espacio en flash
- El archivo .bin debe ser válido
- Conexión estable durante descarga
- LED Status: GPIO 2 (LED integrado)
- Los demás GPIOs se configuran desde el dashboard