Comenzar con el Kit de Desarrollo Wio-WM1110
Preparación
- Kit de Desarrollo Wio-WM1110 x 1
- Computadora x 1
- Cable USB Tipo-C x 1
- Programador de Depuración J-Link x 1
Conexión del Dispositivo
Conecte la Placa de Desarrollo Wio-WM1110 al Programador de Depuración J-Link de la siguiente manera:
3V3 (Placa de Desarrollo Wio-WM1110) -> VTref (Programador de Depuración J-Link Pin 1)
CLK (Placa de Desarrollo Wio-WM1110) -> SWCLK (Programador de Depuración J-Link Pin 9)
DIO (Placa de Desarrollo Wio-WM1110) -> SWDIO (Programador de Depuración J-Link Pin 7)
GND (Placa de Desarrollo Wio-WM1110) -> GND (Programador de Depuración J-Link GND)
Configure su cadena de herramientas
Antes de poder comenzar a desarrollar, las siguientes herramientas son necesarias para esta Guía de Inicio.
SEGGER Embedded Studio (SES)
SES es una solución todo en uno para gestionar, construir, probar e implementar aplicaciones embebidas. Esto significa operaciones de desarrollo fluidas y eficientes gracias a su amplia gama de características. El potente gestor de proyectos permite la gestión de proyectos grandes y pequeños. Las características de control de versiones permiten el despliegue automático de aplicaciones.
SEGGER Embedded Studio (SES)-DescargaSe recomienda usar la versión 5.68.
Paquete de Software y Documentación SEGGER J-Link
Paquete de Software y Documentación SEGGER J-Link-DescarganRF5 SDK
El nRF5 SDK proporciona un entorno de desarrollo rico para dispositivos de la Serie nRF5 al incluir una amplia selección de controladores, bibliotecas, ejemplos para periféricos, SoftDevices y protocolos de radio propietarios.
Todos los ejemplos de código incluidos en el SDK están adaptados para compilar y ejecutar en el Kit de Desarrollo Wio-WM1110.
nRF5 SDK-Descarga
Paquete de Ejemplos de Seeed
Seeed proporciona un proyecto de ejemplo para que los desarrolladores puedan comenzar más rápidamente. Este ejemplo incluye comunicación LoRaWAN, adquisición de información de posicionamiento, adquisición de datos de sensores a bordo, etc.
Ejemplo de Seeed-Descarga
Ejecutando una Primera Prueba
Agregar archivo de ejemplo de Seeed al SDK nRF5
Copia el archivo de ejemplo de Seeed a la siguiente ruta del SDK nRF5:
.../nRF5_SDK_17.1.0_ddde560/examples/peripheral/
Construyamos el proyecto "ses_blinky" para verificar si tu cadena de herramientas está configurada correctamente. Importa el proyecto "ses_blinky".
Compilando la aplicación de prueba
Selecciona "Build" > "Compile project_target".
Programando la aplicación de prueba
Después de compilar la aplicación, puedes programarla en la placa de desarrollo.
Haz clic en "Target" -- "Connect J-Link"
Haz clic en "Build" -- "Build and Run" para construir el proyecto blinky.
Verás "Download successful" cuando se haya completado.
Entonces los 2 LEDs en la placa parpadearán como sigue.
Comenzar
Este capítulo te guiará a través de mostrar información de ubicación actual en Node-Red vía TTN, y explica cómo configurar todos los servidores requeridos (Servidor de Red (NS) y un Servidor de Aplicación (AS)).
Arquitectura y Flujo de Datos
Configurar las Claves
Antes de que un dispositivo pueda comunicarse vía el NS, necesitamos registrarlo con las 3 claves.
Wio-WM1110 DK permite a los usuarios establecer el DevEUI, AppEUI y AppKey, esto es requerido en los siguientes pasos, así que puedes definir nuestros propios parámetros en el archivo 'lorawan_key_config.h', luego flashearlo en el DK.
Archivo ubicado en:
.../nRF5_SDK_17.1.0_ddde560/examples/peripheral/Seeed_Wio_WM1110_Dev_Board/apps/common/lorawan_key_config.h
O puedes obtener las claves generadas por TTN, luego llenar el archivo 'lorawan_key_config.h' y ejecutarlo en el DK.
Servicios de Módem y Geolocalización LoRa Cloud™
Los Servicios de Módem y Geolocalización LoRa Cloud proporcionan un conjunto completo de características de gestión del ciclo de vida para dispositivos LoRa® operando en una red LoRaWAN. Estas características incluyen pero no se limitan a:
- Telemetría integral del dispositivo
- Configuración del dispositivo y aplicación
- Sincronización de reloj
- Servicios avanzados de transporte de datos con robustez contra pérdida de paquetes y fragmentación transparente de datos (streaming de buffer y carga de archivos).
- Geolocalización
Para comenzar, ve al portal LoRa Cloud™ y regístrate para una cuenta.
Paso 1: Crear un Propietario
Para crear un token, primero necesitas crear un propietario. Navega a la página DEVICE OWNERS. Haz clic en CREATE NEW OWNER.
Paso 2: Obtener un Token
Se requiere un token para que el servidor de aplicación autentique llamadas al servidor de Servicios de Módem y Geolocalización LoRa Cloud.
Paso 3: URL de API
La URL de Servicios de Módem y Geolocalización LoRa Cloud depende de la región en la cual el dispositivo será desplegado. Haz clic en "Manage Tokens", luego puedes verificar la URL de API:
Cuando se reciben datos de un dispositivo, se registra automáticamente con el servidor de Servicios de Módem y Geolocalización LoRa Cloud. Esto significa que el dispositivo no necesita ser registrado de antemano.
Servidor de Red LoRaWAN® (TTN)
Actualmente usamos The Things Network V3
Para comenzar, regístrate para una cuenta con The Things Industries o The Things Network.
Paso 1: Crear una aplicación
Navega a la página Applications, haz clic en "+Create application".
Ingresa un ID de Aplicación, haz clic en Crear Aplicación para guardar tus cambios.
Paso 2: Registrar el Dispositivo
Haz clic en "Registrar dispositivo final".
Configura los siguientes parámetros:
Plan de Frecuencia: Selecciona el plan de frecuencia apropiado para la región objetivo
Versión LoRaWAN: Especificación LoRaWAN 1.0.3
Versión de Parámetros Regionales: V1.0.3 REV A
JoinEUI/DevEUI/APPEUI: Los cuales definiste en el archivo 'lorawan_key_config.h' en la configuración anterior.
Paso 3: Crear Credenciales
El servidor de red The Things Network V3 requiere que generes una contraseña MQTT única. En la página de Aplicación de la consola:
- Haz clic en Integraciones y luego en MQTT.
- Selecciona Generar nueva clave API.
- Copia los valores de los siguientes campos: Dirección del Servidor, Nombre de Usuario y Contraseña.
Servidor de Aplicación
El servidor de aplicación maneja los datos de aplicación y las tramas de gestión de dispositivos. Como no hay conexión de fondo entre el servidor de red LoRaWAN® y los Servicios de Módem y Geolocalización de LoRa Cloud™, todos los uplinks relacionados con el tráfico del módem deben ser reenviados por el servidor de aplicación a los Servicios de Módem y Geolocalización de Lora Cloud.
Usamos Node-RED como servidor de aplicación. Node-RED es una herramienta de programación visual basada en navegador que permite la creación rápida de prototipos. Construido sobre Node.js, Node-RED puede usarse para conectar flujos usando una amplia gama de nodos. Estos nodos pueden luego desplegarse al tiempo de ejecución de Node-RED con un solo clic.
Instalar Node.js®
Para instalar Node-RED localmente necesitarás una Versión de Node Soportada
Descarga la última versión LTS 16.x de Node.js desde el sitio oficial de Node.js Te ofrecerá la mejor versión para tu sistema.
Al instalar Node.js, si estás usando una computadora que no ha tenido ningún entorno de programación instalado, recomendaríamos que marques la casilla para instalar las herramientas necesarias mientras instalas Node.js, lo cual te ahorrará muchos problemas necesarios.
La forma más fácil de instalar Node-RED es usando la herramienta de gestión de paquetes de Node, npm. Sin embargo, no recomendamos instalar Node-RED con npm 1.x, sino más bien actualizarlo a la última versión npm 2.x.
En Windows (Requiere Windows 10 y superior), usa el atajo Win+R y escribe cmd en la ventana emergente para abrir la terminal y ejecutar el siguiente comando.
Si estás usando MacOS o Linux, por favor ejecuta el siguiente comando en la terminal y añade sudo al frente del comando para usuarios no root.
npm install -g npm@2.x
Una vez instalado, abre un símbolo del sistema y ejecuta el siguiente comando para asegurar que Node.js y npm estén instalados correctamente.
node --version && npm --version
Deberías recibir una salida que se vea similar a:
> v18.7.0
> 9.6.5
Instalar Node-RED
Instalar Node-RED como un módulo global añade el comando node-red a la ruta de tu sistema. Ejecuta lo siguiente en el símbolo del sistema:
npm install -g --unsafe-perm node-red
Si Node-RED está instalado como un paquete npm global, entonces ejecuta el comando node-red directamente:
node-red
Esto te permitirá ver el editor de Node-RED en http://localhost:1880.
La interfaz de usuario tiene tres áreas clave:
- Paleta: Aquí es donde puedes seleccionar nodos; estos son bloques funcionales que se pueden arrastrar y soltar, y luego se pueden vincular entre sí para crear un flujo.
- Flujo: Este es el código fuente del programa. En este panel, puedes vincular nodos entre sí para crear una aplicación.
- Barra lateral: La barra lateral muestra cualquier información de ayuda o depuración disponible para el nodo seleccionado.
Instalar librerías
Para configurar la demostración, instalaremos 2 librerías adicionales:
-
node-red-contrib-loracloud-utils: Maneja conexiones a servidores LoRa Cloud™
-
node-red-contrib-web-worldmap: Página web de mapa mundial para trazar "cosas" en él
Haz clic en el menú en la esquina superior derecha y selecciona "Manage palette".
Selecciona Install en el menú Palette.
Busca "node-red-contrib-loracloud-utils" e instala.
Repite estos pasos para instalar las librerías "node-red-contrib-web-worldmap".
Importar el Flujo
El paquete de Seeed incluye ejemplos útiles para guiarte a través de este proyecto de ejemplo, solo necesitas importar estos 2 archivos de configuración.
.../nRF5_SDK_17.1.0_ddde560/examples/peripheral/Seeed_Wio_WM1110_Dev_Board-master/apps/examples/geolocation_application_server/modem.json
.../nRF5_SDK_17.1.0_ddde560/examples/peripheral/Seeed_Wio_WM1110_Dev_Board-master/apps/examples/geolocation_application_server/geolocation.json
Luego verás los siguientes flujos:
Configurar el Flujo
Configurando el Servidor de Red LoRaWAN (MQTT) Todos los conectores del servidor de red están activados por defecto; sin embargo, la conexión MQTT debe configurarse por separado. Antes de comenzar, obtén los datos requeridos:
- Dirección del servidor MQTT
- Puerto MQTT
- Nombre de usuario MQTT
- Contraseña MQTT
Estos datos se pueden obtener en Paso 3: Crear Credenciales
Haz doble clic en el nodo "TTN v3-Uplinks" y edita el nodo MQTT.
Puedes encontrar el Servidor y Puerto en el paso anterior.
Luego añade el nombre de usuario y contraseña a "Security".
Haz clic en Add y luego en Done.
Haz doble clic en el nodo "TTN joinReq" y selecciona el servidor MQTT que añadimos en el paso anterior.
Configuración del Servicio de Módem y Geolocalización
Para configurar el servidor, los valores MGS URL y MGS TOKEN del paso anterior
Completa el EUI de tu dispositivo.
Haz clic en el botón "Deploy" para desplegar el flujo.
Vista de Datos
Haz clic en "Debug" para ver los datos devueltos por los Servicios de Módem y Geolocalización de LoRa Cloud:
Geolocalización
Para mostrar el mapa, añade /worldmap a la URL en tu navegador web.
Por ejemplo: http://127.0.0.1:1880/worldmap
Recursos
SEGGER J-Link Software and Documentation Pack
Soporte Técnico
¿Necesitas ayuda con tu Wio-WM1110 Dev Kit? ¡Estamos aquí para asistirte!