YuboxNow: Equipa tu placa ESP32 con su propia interfaz Web de configuración y soporte LoRaWAN
Edgar Landivar 4 lectura mínima
De la misma manera que puedes configurar un ruteador inalámbrico, YuboxNow te permite embeber una interface de configuración en tu placa electrónica ESP32. YuboxNow se encuentra bajo licencia libre y una característica muy interesante es que soporta chipsets con LoRaWAN, que está muy de moda en el mundo de Internet de las Cosas o IoT.
Qué tarjetas ESP32 están soportadas?
Teóricamente cualquier tarjeta ESP32. Las que puedo confirmar en lo personal son:
- Heltec WiFi LoRa
- HiLetgo ESP-WROOM-32 (sin LoRaWAN)
- Yubox Node (obviamente, el proyecto nació para dar soporte a esta tarjeta)
Aquí haré un pequeño tutorial de cómo instalar YuboxNow en la tarjeta Heltec WiFi LoRa, debido a que es muy fácil conseguirla. Dejo vínculo a Amazon.
Más información de la placa Heltec WiFi LoRa en su sitio Web oficial https://heltec.org/project/wifi-lora-32/
Requisitos
- El board Heltec WiFi LoRa 32 (V2)
- Arduino IDE, al menos versión 1.8.13
- Soporte ESP32 para Arduino IDE, versión 1.0.6 o superior
- Bibliotecas de YUBOX Now y dependencias actualizadas
Paso 1) Descargar YuboxNow
El proyecto YuboxNow se encuentra alojado en GitHub en el siguiente vínculo. Podemos usar la herramienta GIT para clonar el proyecto, o si eso suena complicado, también podemos descargarlo directamente de aquí, en formato zip.
Este archivo contiene una carpeta llamada yubox-now-master. Esta carpeta la colocamos dentro del directorio “libraries“, donde se instalan todas las demás bibliotecas de Arduino.
| Sistema Operativo | Ruta bibliotecas (librerías) Arduino |
|---|---|
| Mac OS X | /Users/USUARIO/Documents/Arduino/libraries |
| Windows | C:\Users\USUARIO\Documents\Arduino\libraries |
| Linux | /home/USUARIO/arduino/sketchbook/libraries |
Si tenemos problemas con la ruta, podemos ir al menú de Preferencias, dentro del Arduino IDE y allí está la ruta exacta.
Paso 2) Instalar dependencias
El sketch de YUBOXNow se puede compilar desde el Arduino IDE, como se hace con otros proyectos. Se debe de elegir el board “Heltec WiFi LoRa 32 (V2)” desde el gestor de tarjetas. Debemos también tener en cuenta que vamos a necesitar tener las siguientes extensiones instaladas previamente.
- YUBOX – Assemble HTML Interface: crea el directorio data/ y reúne los módulos de YUBOXNow en los archivos HTML y Javascript para el SPIFFS inicial. Se trata de una librería que se puede descargar de este vínculo, en formato ZIP y se instala del mismo modo que YuboxNow, es decir, colocando la carpeta dentro de “libraries”.
- ESP32 Sketch Data Upload: genera y carga el sistema de archivos SPIFFS inicial de YUBOXNow al board. Se puede instalar desde el gestor de bibliotecas (librerías) de Arduino.
Soporte LoRaWAN Arduino
Podemos usar YuboxNow sin el menú de LoRaWAN, pero aquí mostraremos cómo añadir este menú, puesto que muchas veces es algo engorroso configurar LoRaWAN desde el código. Con YuboxNow es mucho más sencillo. Para agregar el soporte LoRaWAN, es necesario instalar las siguientes bibliotecas adicionales en el Arduino IDE:
- Beelan LoRaWAN, la biblioteca base que implementa soporte LoRaWAN para el chipset SX127x. Esta biblioteca puede instalarse de forma ordinaria usando el gestor de bibliotecas de Arduino IDE, y buscándola con el nombre indicado.
- yubox-LoRaWAN, el adaptador que permite configurar el AppEUI y AppKey para el soporte OTAA de LoRaWAN. La versión que utiliza la biblioteca Beelan-LoRaWAN está en la rama SX127x-Beelan-LoRaWAN, la cual puede descargarse como un archivo ZIP desde este vínculo e instalarse como una biblioteca ZIP.
Paso 3) Ejecutar programa de ejemplo
La biblioteca yubox-LoRaWAN contiene el ejemplo yubox-lorawan-helloworld que muestra la integración como parte de un programa completo.
Se debe estar seguro de haber seleccionado el board “Heltec WiFi LoRa 32 (V2)” como objetivo desde el Arduino IDE, de lo contrario, las definiciones de pines LoRa no estarán disponibles y fallará la compilación.
Luego de compilar y transferir el código deberíamos ver una nueva red en el menú de red WiFi de nuestro computador. El nombre de la red comienza con la palabra YUBOX. Nos conectamos a esa red y visitamos la interfaz Web en la IP 192.168.4.1. Ya está casi todo listo!
Paso 4) Configuración LoRaWAN
Ahora sí, vamos a un navegador, visitamos al IP antes mencionada y nos encontramos con la interfaz de YuboxNow. El usuario por omisión es admin y la clave es yubox. Lo primero que debemos hacer al ingrsar es cambiar la clave.
Accederemos a una interfaz responsiva y slim desde donde configurar el acceso a WiFi, actualizar el firmware o configurar LoRaWAN será bastante sencilla… siiiiiiiiiii!
Les dejo mi pantalla de configuración de LoRaWAN. Los datos más importante son el EUI del dispositivo y la clave de aplicación. El EUI de aplicación puede quedar en 16 ceros como se ve en la figura, a menos que nuestra red LoRaWAN necesite algo diferente.
Extra) Compilación desde línea de comandos, para usuarios expertos
Algunos usuarios expertos prefieren compilar sin utilizar el Arduino IDE. Es por eso que YuboxNow trae la posibilidad de compilar desde la línea de comandos. Para compilar ejecutamos el comando make con las siguientes opciones.
make ARDUINO_INSTALL=~/arduino-1.8.15 YF=~/Arduino/libraries/yubox-now-master ESP32_BOARD=heltec_wifi_lora_32_V2
La opción ARDUINO_INSTALL debe apuntar al directorio donde se encuentra instalado Arduino en nuestro sistema.
Para transferir nuestro sketch ejecutamos nuevamente el comando make, pero con la opción fullupload
make fullupload
Este comando asume que nuestro dispositivo se encuentra conectado al puerto USB llamado /dev/ttyUSB0, pero se lo puede cambiar la ruta si agregamos el parámetro SERIALPORT=ruta
