Ir al contenido principal
Todas las coleccionesConecta tus dispositivos
Conectar el Kit de Desarrollo Seeed Studio Wio-E5 a Ubidots [Firmware AT de Fábrica]
Conectar el Kit de Desarrollo Seeed Studio Wio-E5 a Ubidots [Firmware AT de Fábrica]

Aprende a conectar y enviar datos a Ubidots utilizando el Seeed Studio Wio-E5 Dev Kit con su firmware AT de fábrica.

Sergio M avatar
Escrito por Sergio M
Actualizado hace más de una semana
image.png

Requisitos

  1. Cualquiera de la serie Wio-E5, como el Wio-E5 Development Kit, la placa Wio-E5 Mini o el Wio-E5 Module

  2. Cualquier consola serial. Puedes usar la consola serial de Arduino o cualquiera de tu elección

  3. Una cuenta activa en Helium Console

  4. Una cuenta activa de Ubidots Account

  5. Acceso a un gateway LoRaWAN conectado a la red Helium

1. Obtén el DevEui, AppEui y AppKey de la placa

Wio-E5 viene con un firmware AT de fábrica que permite la rápida creación de prototipos de aplicaciones y soluciones utilizando solo una consola serial. Se utilizó la consola serial de Arduino en esta guía, sin embargo, puedes elegir cualquier otra con la que te sientas cómodo.


Consejo profesional: recuerda conectar la antena del dispositivo antes de conectarlo a cualquier fuente de alimentación para evitar posibles daños al chip.



Comienza conectando tu placa a la PC usando un cable USB tipo C, luego dirígete a tu IDE de Arduino (no es necesario abrir un sketch en particular), haz clic en “Herramientas” --->“Monitor Serial”, tal como muestra la siguiente imagen:

ArduinoSerialMonitor.png

Una vez que se abra la interfaz de la consola serial, comienza configurando la “velocidad en baudios” a 9600 y el finalizador de línea a “Ambos NL & CR”. Estas configuraciones las puedes encontrar en la esquina inferior derecha. Ahora enviarás el primer comando: escribe “AT” para verificar si hay conexión entre la PC y el Wio-E5. El dispositivo debería responder con un mensaje “OK” a través de la consola serial, tal como muestra el siguiente GIF.

AT_OK.gif

El siguiente paso es obtener la información requerida del dispositivo para registrarlo en la red de Helium. De la misma manera que hiciste antes, escribe el comando “AT+ID=DevEui”. El dispositivo responderá con su número “DevEui” . Ahora, para obtener su “AppEui”, simplemente escribe el comando “AT+ID=AppEui” y, nuevamente, el dispositivo responderá con su número “AppEui”. Mantén esos dos valores a mano, ya que los necesitarás en los siguientes pasos.

APPEUI.png

El último paso es asignar al dispositivo un “AppKey”, que es un identificador de 16 bytes hexadecimales. Para hacerlo, escribe el comando “AT+KEY=APPKEY, “tu-clave”, reemplazando “tu-clave” con la clave real entre comillas dobles. Puedes usar un generador de números aleatorios para generar la clave. El siguiente GIF ilustra esto:

Después de configurar correctamente el “AppKey”, el dispositivo debería repetir lo que acabas de escribir.
Recuerda mantener esos tres valores a mano, ya que los necesitarás en la siguiente sección.

2. Registra el Dispositivo en LoRaWAN de Helium

Inicia sesión en tu consola de Helium, luego busca la sección “Dispositivos” en el lado izquierdo de la pantalla. Allí, haz clic en el botón “Agregar Nuevo Dispositivo” .

heliumCreateDevice.png

Luego se te llevará a una nueva página donde se te pedirá las credenciales del dispositivo, como su nombre, “DevEui”, “AppEui” etc. Completa esos campos con la información adquirida en el paso 1, teniendo en cuenta que el “Nombre” que selecciones aquí es el que se mostrará en Ubidots, por lo que querrás darle un nombre significativo como “Wio-E5....”. Por último, deja el campo “Etiqueta” vacío y luego presiona el botón “Guardar Dispositivo” y ¡eso es todo! Tu dispositivo debería aparecer en la sección de “Dispositivos” de Helium.

REGISTERDEVICE.png

Ahora que el Wio-E5 está registrado en una red LoRa, procedamos a conectarlo a la red. Para hacerlo, regresa a la consola serial de Arduino y, al igual que hiciste en el primer paso, escribe los siguientes cuatro comandos:

  • AT+DR=AU915

  • AT+CH=NUM,8-15

  • AT+MODE=LWOTAA

  • AT+JOIN

Deberías recibir una respuesta como la siguiente en caso de que hayas hecho todo correctamente:

image.png

3. Crea la Integración y Conéctala a Ubidots

Para este paso, necesitarás tener tu Token de Ubidots a mano, así que te recomendamos copiarlo en tu portapapeles. Echa un vistazo a nuestro centro de ayuda si olvidaste dónde encontrarlo.

Dirígete a la sección “Integraciones” en el lado izquierdo de tu pantalla en tu consola de Helium, allí busca el botón “Agregar Nueva Integración” tal como hiciste en la sección anterior cuando agregaste el nuevo dispositivo. Se cargará una nueva página que lista las integraciones de socios de Helium, busca la integración de Ubidots y haz clic en ella, luego serás llevado a la interfaz de creación de integración donde se te pedirá tu Token de Ubidots, así como el nombre de la integración. Completa esos campos y luego presiona el botón “Agregar integración” para guardar los cambios.

helumintetration.gif

Ahora, con la integración creada, necesitamos decirle a Helium qué dispositivo la va a usar y cómo. Para hacerlo, ve a la sección “Flujos” en el lado izquierdo de la pantalla en tu consola de Helium, cuando se cargue la página notarás una pequeña barra etiquetada como “NODOS” con un signo “+” en ella, haz clic en ella y se desplegará un menú mostrando cuatro opciones: “Etiquetas”, “Dispositivos”, “Funciones”, “Integraciones”.
Busca tu dispositivo en la sección “Dispositivos” y arrástralo y suéltalo en el área en blanco a la derecha, luego busca la integración recién creada en la pestaña “Integraciones” y arrástrala y suéltala en el área en blanco. Ahora solo necesitas conectar los dos bloques. El siguiente GIF ilustra este proceso:

4. Crea la Función Decodificadora

Todo lo que queda es crear el decodificador que convertirá los datos en bruto en un formato compatible con la plataforma de Ubidots. Dirígete a la sección “Plugins” bajo la pestaña “Dispositivos” en tu cuenta de Ubidots.

plugins.png

Después de hacer esto, se mostrarán todos tus plugins creados anteriormente. Identifica el que acabas de crear y haz clic en el pequeño ícono de lápiz con la etiqueta “Editar” para editar la configuración de este plugin, específicamente la función decodificadora.
Dirígete a la sección “Decodificador” una vez que se cargue la página, allí notarás un campo de texto con un montón de código en él, por favor elimina todo y pega esto:

import base64import jsondef format_payload(args):    base64String = args["payload"]    decodedString = base64.b64decode(base64String).decode('utf-8')    decodedString = decodedString.replace("'","\"")    myPayload = json.loads(decodedString)    print(myPayload)    return myPayload

Haz clic en el botón “Guardar y Hacer Vivo” para guardar los cambios en nuestro decodificador.


El siguiente GIF te guía a través de estas instrucciones:

5. Envía Datos a Ubidots

Ahora, supongamos que tenemos un sensor que obtiene datos de temperatura y humedad que deseas enviar a Ubidots usando tu Wio-E5, volvamos a la terminal serial de Arduino y escribe lo siguiente:

AT+MSG="{'temperature':34, 'humidity':10} "

Regresa a la sección “Dispositivos” de Ubidots y allí notarás un nuevo dispositivo creado con la etiqueta que configuraste en Helium, si inspeccionas sus variables, verás que tanto las variables “temperatura” como “humedad” se han actualizado con los valores 34 y 10, respectivamente.

asdf.png

6. Comentarios, Sugerencias y Artículos Relacionados

No dudes en publicar preguntas o sugerencias en nuestro portal comunitario, o envíanos un correo a support@ubidots.com.

¿Ha quedado contestada tu pregunta?