Soldinamic WIKI / DOCS v1.0
Soldinamic Documentación Equipos Activos

Equipos Activos

NOTE

La vista de Equipos Activos es el centro de control principal para los dispositivos que ya han superado la fase de inventario (Lista Blanca) y se encuentran oficialmente aprovisionados y operando en la red LoRaWAN. Desde aquí, los administradores y clientes finales pueden monitorear métricas vitales en tiempo real, gestionar su ubicación espacial, enviar comandos de red (Downlinks) y auditar el tráfico.

Dashboard principal de dispositivos activos

Vista Principal Equipos Activos

Al ingresar a esta vista, encontrarás un resumen de alto nivel conocido como el Mini Dashboard, que te ofrece un vistazo rápido a la salud de tu flota:

  • 🟢 En Línea (Online): Equipos que han transmitido datos recientemente de manera exitosa.
  • 🟠 Fuera de Línea (Offline): Equipos que han superado su intervalo máximo esperado sin transmitir.
  • 🟡 Nunca Vistos (Never Seen): Equipos aprovisionados pero que jamás han logrado su primer JOIN a la red.
  • 🔵 Total Registrados: El universo total de dispositivos asociados a tu cuenta.

Columnas de la Tabla Principal

La tabla de datos, optimizada para cargar miles de registros, despliega información granular por equipo:

  1. Identificador / Nombre: Despliega el nombre amigable del equipo y su ID. Cuenta con un punto indicador de estado de conexión (Verde: Activo, Naranja: Inactivo, Amarillo: Nunca Visto). Al hacer clic sobre el nombre, viajarás a la consola de Monitoreo en Vivo del equipo.
  2. DevEUI: Identificador criptográfico global del nodo (formato hexadecimal).
  3. Serial Number (SN): El número de serie físico impreso en la carcasa del hardware.
  4. Distribuidor (Tenant): El corporativo o mayorista dueño del equipo.
  5. Filial (Subsidiaria): El cliente o sucursal final donde se ubica operativamente el dispositivo.
  6. Última Conexión: Muestra la fecha, hora exacta y formato de tiempo relativo (ej. "Hace 5 minutos") del último payload recibido.
  7. Estado: Muestra si el equipo está Activo o Suspendido a nivel lógico. Un equipo suspendido denegará tráfico en la red.

Acciones por Equipo

Modal de Downlinks

En la última columna de la tabla (Acciones), se disponen iconos para la gestión individual:

  • ⬇️ Enviar Downlink (Consola de Comandos): Abre un modal avanzado para encolar cargas útiles (payloads) descendentes hacia el dispositivo. Puedes enviar tramas en formatos HEX, BASE64 o JSON. Permite configurar el FPort (puerto de red), solicitar confirmación (Confirmed), y hasta definir una fecha límite de caducidad (ExpiresAt). Además, cuenta con el poder de purgar la cola ("Flush Queue") en caso de que un comando antiguo haya quedado atascado.
  • ✏️ Editar Equipo: Modifica el nombre, ubicación geográfica y metadatos sin alterar las llaves LoRaWAN subyacentes.
  • 🗑️ Eliminar: Borra el equipo. Es importante saber que esto lo remueve permanentemente de la plataforma SaaS y del Network Server subyacente.

Vincular Equipo (Reclamar un Dispositivo)

Esta es la Fase 2 del aprovisionamiento ("SN Claim"). Aquí es donde un cliente extrae un equipo de la Lista Blanca introduciendo su Serial Number.

Tab 1: Información General

Vincular Equipo - General

Pestaña de identidad base del sensor.

  • Nombre del Dispositivo *: El identificador amigable.
  • Modelo & Descripción: Metadatos descriptivos opcionales.
  • Serial Number (SN) *: Componente crítico de seguridad. Si el equipo fue pre-registrado en el inventario global, al escribir el SN y perder el foco, el sistema lo validará contra la base de datos. Si es exitoso, los campos de DevEUI y AppKey se autocompletarán "mágicamente", impidiendo errores de tipeo.
  • Zona Horaria: Define el uso horario interno para logs.
  • Habilitado en Core: Switch lógico. Si se apaga, el equipo se desactiva sin borrarse del sistema.

Tab 2: Credenciales & Red

Vincular Equipo - Credenciales

Define la soberanía operativa y los parámetros de cifrado en la red LoRaWAN:

  • Distribuidor Propietario *: Selecciona a qué Tenant (Corporativo) pertenecerá. Solo los SuperAdmins pueden alterar esto.
  • Filial (Application) *: La agrupación lógica del cliente final. Todo equipo debe pertenecer a una filial para mantener el aislamiento multitenant.
  • Perfil de Dispositivo (Device Profile) *: La plantilla que instruirá al servidor LNS sobre cómo decodificar los datos, en qué frecuencias operará y qué versión MAC tiene el nodo.
  • Protocolo: Seleccionable entre LoRaWAN, Sigfox o NB-IoT.
  • DevEUI *: El identificador único de 16 caracteres hexadecimales para el Network Server.
  • AppKey de Activación *: La clave AES-128 ultra secreta (32 caracteres hexadecimales) que el dispositivo usará para hacer Join de forma encriptada.

Tab 3: Ubicación Geográfica

Vincular Equipo - Mapa

Otorga posicionamiento GPS al sensor.

  • Tipo de Marcador: Escoge el icono visual (Sensor de temperatura, Gateway, Smart Home, Servidor, etc) para representarlo en el mapa de calor.
  • Mapa Leaflet Interactivo: Puedes buscar tu dirección usando la barra flotante. Con un clic establecerás el marcador y los inputs de Latitud y Longitud se autocompletarán. Soporta capas hibridas (Calles y Satélite).
  • Latitud y Longitud: Se pueden editar manualmente con alta precisión.

Tab 4: Metadatos y Etiquetas

Vincular Equipo - Tags

Diseñado para infraestructura empresarial. Permite agregar pares de "Clave-Valor" infinitos (ej. CentroDeCosto: 405-A, UbicacionInterna: Pasillo 4). Estas etiquetas viajan con cada payload y son útiles para ruteo de datos y facturación cruzada.


Carga Masiva (Bulk Upload)

Si el administrador requiere dar de alta miles de sensores de forma simultánea ya asociados a un Tenant, la función de importación por lote es la herramienta idónea.

1. Descargar Plantilla (.xlsx)

Plantilla Excel de Equipos

Al presionar el botón "Descargar Plantilla", el sistema generará un Excel con la estructura de cabeceras requerida por la base de datos:

  • sn: Obligatorio.
  • name: Opcional. Nombre amigable del dispositivo.
  • description: Opcional.
  • model: Opcional.
  • protocol: Opcional. (ej. LORA, SIGFOX).
  • deviceProfileId: Obligatorio. UUID del perfil asociado.
  • tenantId: Opcional. ID del distribuidor.
  • subsidiaryCompanyId: Opcional. ID de la filial.
  • timezone: Opcional. (ej. America/La_Paz).
  • latitude: Opcional. Coordenada GPS.
  • longitude: Opcional. Coordenada GPS.
  • enabled: Opcional. Por defecto true (Habilitado).
  • status: Opcional. Boolean para estado general.

2. Procesamiento Inteligente de Carga Masiva

Modal Carga Masiva

El modal de Carga Masiva ofrece una zona "Dropzone" donde puedes arrastrar tu archivo Excel. El sistema backend procesará los registros implementando una política de fallos parciales:

TIP

Resiliencia ante Errores: Si subes un Excel con 1000 dispositivos y resulta que 5 tienen un DevEUI duplicado, el sistema insertará y asociará con éxito a los 995 sensores válidos, y abrirá un reporte gráfico en pantalla detallando la fila exacta y el error (Error Report Modal) de los 5 que fallaron. ¡Tu flujo de trabajo nunca se bloquea!

Busca temas, dispositivos, MQTT, gateways, API...
Vista ampliada