Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

36 Commits

Folders and files

Repository files navigation

MiniOS WiFi Client

Firmware ligero para ESP32 que se conecta al backend centralizado MiniOS.

Diferencias con MiniOS_WiFi Original

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

Librerías Requeridas

Instalar desde el Library Manager del IDE (o con arduino-cli lib install):

  1. WebSockets — Markus Sattler (probado con 2.7.2)
  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)
  3. DHT sensor library — Adafruit (1.4.7) + Adafruit Unified Sensor
  4. Adafruit AHTX0 (2.0.6)
  5. Adafruit BMP280 Library (3.0.0)
  6. Adafruit BME280 Library (2.3.0)
  7. Adafruit NeoPixel (1.15.5) — solo se usa en ESP32 y ESP32-S3

Opciones de compilación

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_Client

Tamaños verificados: ESP32-C3 1,32 MB (67%) · ESP32-S3 1,21 MB (61%).

Configuración Inicial

Las credenciales no van en el código. El archivo .ino está en un repositorio público y el historial de git conserva para siempre lo que se escriba en él. WIFI_SSID y WIFI_PASS se dejan vacíos y se configuran por el puerto serie: quedan guardados en NVS y sobreviven a los reinicios.

Via Serial (115200 baud)

  1. Configurar WiFi:
wifi MiRed MiPassword
  1. Configurar backend:
server 192.168.1.100 3000

O si tienes dominio:

server mi-servidor.com 3000
  1. Ver estado:
status
  1. Token de dispositivo (solo si el backend tiene DEVICE_TOKEN configurado):
token el-token-del-servidor

Se envía en la URL del WebSocket y en las descargas OTA. Con token - se borra.

  1. Reiniciar:
reboot

Funcionamiento

  1. El ESP32 se conecta al WiFi configurado
  2. Establece conexión WebSocket con el backend
  3. Se registra automáticamente usando su MAC Address
  4. Recibe configuraciones (GPIO, DHT, micrófono) del backend
  5. Envía datos de sensores cada 5 segundos
  6. Ejecuta comandos recibidos (set GPIO, reiniciar, OTA)

Micrófono I2S (INMP441)

El dispositivo puede grabar audio cada cierto tiempo y subirlo al backend, donde se escucha desde el dashboard (pestaña Audio del dispositivo).

Conexión (ESP32-C3 SuperMini)

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.

Funcionamiento

  • 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.

Actualizaciones OTA

  1. Subir archivo .bin al backend desde el dashboard
  2. Seleccionar "Enviar a todos" o actualizar dispositivo específico
  3. El ESP32 descarga e instala automáticamente
  4. Se reinicia con el nuevo firmware

Estructura de Mensajes

Registro (ESP32 → Backend)

{
  "type": "register",
  "mac_address": "AA:BB:CC:DD:EE:FF",
  "firmware_version": "1.0.0",
  "ip_address": "192.168.1.50"
}

Datos de Sensores (ESP32 → Backend)

{
  "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}
    ]
  }
}

Comando GPIO (Backend → ESP32)

{
  "type": "command",
  "action": "set_gpio",
  "pin": 2,
  "value": 1
}

Comando OTA (Backend → ESP32)

{
  "type": "command",
  "action": "ota_update",
  "ota_id": 1,
  "filename": "firmware_1.0.1.bin",
  "filesize": 512000,
  "checksum": "abc123..."
}

Compilación

Arduino IDE

  1. Board: "ESP32S3 Dev Module"
  2. Partition Scheme: "Default 4MB with spiffs"
  3. Upload Speed: 921600

PlatformIO

[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

Troubleshooting

No conecta al WiFi

  • Verificar SSID y contraseña
  • El ESP32 debe estar cerca del router

No conecta al backend

  • Verificar IP/puerto del servidor
  • El backend debe estar corriendo
  • Verificar firewall del VPS

OTA falla

  • Verificar espacio en flash
  • El archivo .bin debe ser válido
  • Conexión estable durante descarga

Pines por Defecto

  • LED Status: GPIO 2 (LED integrado)
  • Los demás GPIOs se configuran desde el dashboard

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages