Index AMI Gateway

Introducción

¿Qué es Index AMI Gateway?

Index AMI Gateway es una aplicación para dispositivos Android que permite descubrir, conectar, configurar y administrar dispositivos IoT Index AMI mediante Bluetooth Low Energy (BLE). La aplicación proporciona una interfaz moderna e intuitiva para:

• Buscar y conectar dispositivos Index AMI cercanos
• Autenticación segura con credenciales de dispositivo
• Configurar parámetros del dispositivo (sistema, red, notificaciones)
• Administrar dispositivos localmente vía Bluetooth (Reinicio, cambio de credenciales, actualización de firmware y seguimiento de registros tipo LOGs)
• Monitorear estado del dispositivo en tiempo real

Objetivos Principales

1. Facilitar la configuración inicial de dispositivos Index AMI en centro de gestión u operaciones en campo
2. Permitir la administración local de dispositivos vía Bluetooth (sin requerir conexión física al dispositivo)
3. Proporcionar monitoreo del estado en tiempo real
4. Asegurar comunicaciones seguras con autenticación y validación de datos

Audiencia

Este manual está diseñado para:

• Técnicos de instalación y configuración
• Personal de mantenimiento
• Usuarios que administren dispositivos Index AMI

Requisitos Previos

Dispositivo Android Requerido

Dispositivo Index AMI Requerido

• Dispositivo Index AMI HW3 con firmware compatible (contactar al proveedor)
• Dispositivo Index AMI HW3 energizado (a través de medidor o fuente externa)
• Rango de alcance: Aproximadamente 3 metros (dependiendo del entorno)

Permisos y Configuración Necesaria

• Bluetooth habilitado en el dispositivo Android
• Ubicación habilitada (requerido por Android para Bluetooth)
• Servicios de Ubicación activados (requerido en Android 10/11 para que el escaneo BLE funcione)

Primeros Pasos

1. Descargar la aplicación "Index AMI Gateway" en Google Play Store®
2. Asegúrate de que Bluetooth esté habilitado
3. Abre la aplicación y sigue las indicaciones

Inicio de la Aplicación — Pantalla Home

Al abrir la aplicación, se muestra la pantalla principal denominada INDEX AMI GATEWAY (HomeScreen). La pantalla inicial muestra:

• Ícono de Bluetooth en la parte central
• Botón "Buscar Dispositivos": inicia el flujo de escaneo y conexión
• Botón "Actualizar Estado": verifica los requisitos de Bluetooth y permisos nuevamente
• Estado actual del dispositivo (Bluetooth habilitado/deshabilitado, permisos, etc.)

Flujo de Navegación

1. Validación de Bluetooth

Si Bluetooth no está habilitado, la aplicación muestra el estado correspondiente y un botón "Configuración" que abre los ajustes del sistema. La aplicación no redirige automáticamente.

2. Solicitud de Permisos

En caso de requerirlo, se solicitan permisos de Bluetooth. Los botones disponibles son:

• "Otorgar Permisos": solicita los permisos de Bluetooth al sistema Android
• "Abrir configuración de ubicación": abre ajustes del sistema (solo en Android 10/11)

3. Advertencia de Servicios de Ubicación (Android 10/11)

En dispositivos con Android 10 u 11, el escaneo BLE requiere que los Servicios de Ubicación estén activos. Si están desactivados, la aplicación muestra un aviso con el botón "Abrir configuración de ubicación".

4. Acceder al Escaneo

Al presionar "Buscar Dispositivos" en la pantalla Home, la aplicación navega a la pantalla de Escaneo donde comenzará automáticamente a buscar dispositivos Index AMI cercanos.

Escaneo de Dispositivos

Cómo Buscar Dispositivos Index AMI

Al entrar a la pantalla de Escaneo, el escaneo arranca automáticamente. Primero muestra "Inicializando escáner..." y luego comienza la búsqueda activa.

Pantalla de Escaneo

• El escaneo se inicia automáticamente al entrar
• Muestra primero "Inicializando escáner..." antes de escanear
• Luego muestra la lista de dispositivos encontrados en tiempo real
• Cada dispositivo muestra: Nombre, Dirección MAC y Fuerza de Señal (RSSI)
• Indicador de progreso mientras se escanea
• Durante el escaneo aparece el botón "Detener Búsqueda" que permite cancelarlo
• El escaneo finaliza automáticamente después de 10 segundos
• Botón "Buscar Nuevamente" para iniciar un nuevo escaneo

Información de Cada Dispositivo

• Nombre: Identificador del dispositivo Index AMI (ej: "INDEX-AMI-001") — usado para identificar visualmente el dispositivo
• Dirección MAC: Identificador único Bluetooth (formato XX:XX:XX:XX:XX:XX, ej: 1A:2B:3C:4D:5E:6F) — válido para identificar de forma única el dispositivo globalmente

Indicador de Fuerza de Señal

La intensidad de la señal Bluetooth se muestra con barras visuales en cada dispositivo (columna "Fuerza de Señal"):

Identificar Tu Dispositivo

Busca el dispositivo que deseas conectar en la lista. Si no aparece:

• Asegúrate de que el dispositivo esté alimentado
• Verifica que el LED del dispositivo se encuentre en un patrón de parpadeo lento (aproximadamente 2 segundos)
• Verifica que el dispositivo esté dentro del rango de alcance (aproximadamente 3 metros) y muestre una intensidad de señal

Conexión y Vinculación BLE

La vinculación BLE (Bluetooth Low Energy) es el proceso mediante el cual tu dispositivo Android se empareja y conecta con un dispositivo Index AMI para establecer una comunicación segura.

Proceso de Vinculación BLE

Una vez seleccionas un dispositivo, comienza el proceso de vinculación automático. La aplicación muestra los siguientes mensajes de estado en secuencia:

1. "Estableciendo conexión..." — La aplicación inicia la conexión al dispositivo
2. "Conectando con el dispositivo..." — Se establece el canal GATT
3. "Realizando autenticación..." — Se intercambian credenciales de seguridad (PIN: 123456)
4. "Configurando comunicación..." — Se negocia el MTU y parámetros de transferencia
5. "Preparando servicios..." — Se descubren los servicios BLE disponibles
6. "Activando comunicación..." — Se activan las notificaciones BLE

Tarjeta de Emparejamiento Bluetooth

Cuando el dispositivo requiera emparejamiento, aparecerá una tarjeta de instrucciones en pantalla. Aparecerá un diálogo del sistema Android solicitando un PIN.

Vinculación Exitosa

• Aparece un ícono de ✓ (cheque)
• Se muestra el mensaje "¡Conectado!"
• Aparece el texto "Conectado exitosamente a [nombre del dispositivo]"
• Se muestra el mensaje "Redirigiendo al inicio de sesión..."
• La aplicación navega automáticamente a la pantalla de Login

Errores Durante la Vinculación

Consejos para Vinculación Exitosa

• Proximidad: Mantén el dispositivo a menos de 5 metros durante la vinculación
• Sin interferencias: Aleja de microondas, routers WiFi y otros dispositivos Bluetooth
• Dispositivo encendido: Asegúrate de que el Index AMI esté correctamente alimentado
• Batería suficiente: Tu teléfono debe tener batería suficiente (>20%)
• Bluetooth activado: Verifica que el Bluetooth de tu Android esté habilitado
• Primera conexión: La primera vinculación puede tardar un poco más

Re-vincular a un Dispositivo

• Si anteriormente vinculaste un dispositivo, el emparejamiento se guarda en tu teléfono
• La próxima conexión será más rápida
• Si tienes problemas, puedes desvincular desde Configuración de Android y repetir el proceso

Login y Autenticación

Credenciales Necesarias

• Usuario: Credencial de autenticación (Valor por defecto: "admin")
• Contraseña: Credencial de autenticación (Valor por defecto: "admin")

Pasos para Iniciar Sesión

1. Ingresa las credenciales de configuración del dispositivo (usuario/contraseña)
2. Presiona "Iniciar Sesión"
3. La aplicación verifica las credenciales
4. Descarga automáticamente los datos del dispositivo (info_map.json y conf.json) — puede tomar aproximadamente 60 segundos
5. Si todo es correcto, pasa al Menú Principal

Validaciones de Login

• Usuario: 5-16 caracteres alfanuméricos (incluyendo ñ/Ñ)
• Contraseña: 5-16 caracteres (puede incluir caracteres especiales)

Descarga de Información del Dispositivo

Después de la autenticación, la aplicación descarga automáticamente la información del dispositivo en este orden:

1. info_map.json: Estado en tiempo real del dispositivo (IMEI, señal, etc.)
2. conf.json: Configuración guardada del dispositivo
3. logStorage.json: Estadísticas de almacenamiento y registros (descarga en paralelo)

Menú Principal

Estructura del Menú Principal

El Menú Principal es tu punto central de seguimiento y configuración. Muestra:

1. Descripción general (Overview): Información del dispositivo
2. Configuración: Sistema, Conectividad y Notificaciones
3. Administración: Seguridad y Reinicio (próximas: Actualización del dispositivo y Seguimiento de Registros)

• En la barra superior: Ícono de ajustes (engranaje) — abre la pantalla de Configuración de la Aplicación (AppSettings)
• En la parte inferior — Botón "Aplicar cambios en el dispositivo": aplica la configuración pendiente al dispositivo
• En la parte inferior — Botón "Desconectar del Dispositivo": cierra la conexión BLE y regresa a la pantalla Home

Descripción General (Overview)

Al presionar "Descripción General" en el Menú Principal, accederás a la información del dispositivo organizada en 4 pestañas (tabs).

Perfil del Dispositivo

Muestra la identidad y estado actual del dispositivo. Información del Activo:

• Nombre del dispositivo: Nombre descriptivo del equipo
• Descripción: Detalles adicionales del dispositivo
• Número de dispositivo: Identificador numérico único
• Etiqueta de puerto: Identificación del puerto de conexión
• Ubicación: Ubicación geográfica o de instalación

Información del Sistema:

• MAC: Identificador único del dispositivo Index AMI
• Firmware: Versión del software del dispositivo Index AMI
• Hardware: Versión del hardware del dispositivo Index AMI
• Fecha y Hora: Hora actual del sistema (UTC)
• Tiempo Activo: Tiempo formateado como Xd Xh Xm Xs (ej: 1d 4h 30m 12s) — tiempo transcurrido desde el último reinicio

Almacenamiento (Storage):

• Total de Archivos de Log: Número total de archivos de registro almacenados
• Tamaño Total: Espacio total ocupado por los archivos de log (ej: 2.3 MB)
• Archivos No Sincronizados: Cantidad de archivos pendientes de sincronización con el servidor

Estado del Dispositivo

Muestra información en tiempo real del módulo LTE y su conectividad en cinco secciones:

Información del Módem

• IMEI: Identificador único del módulo LTE
• ICCID 0: Identificador de la primera tarjeta SIM
• ICCID 1: Identificador de la segunda tarjeta SIM
• Slot: Cuál tarjeta SIM está en uso (Nano SIM o eSIM)

Detalles de Red

• Dirección IP: Dirección IPv4 asignada
• Máscara de Red: Máscara de subred
• Puerta de Enlace: Router principal
• DNS Primario: Servidor DNS principal
• DNS Secundario: Servidor DNS secundario
• Latencia: Tiempo de respuesta en milisegundos (ms)

Fuerza de Señal

• RSSI: Intensidad de señal recibida (dBm)
• RSRQ: Calidad de señal recibida (dB)
• RSRP: Potencia de referencia de señal (dBm)
• SINR: Relación señal-ruido en dB (calculado como raw/2 − 23.5 dB)

Detalles de Celda

• Red: Nombre del operador
• Modo de Comunicación: LTE (4G)
• MCC/MNC: Código de país/red del operador
• ID de Celda: Identificador único de la celda
• TAC: Código de área de rastreo
• PCI: Identificador de celda física
• EARFCN: Número de canal de frecuencia E-UTRA

Banda de Frecuencia y Ancho de Banda

• Banda: Banda LTE en uso
• Ancho UL: Ancho de banda de subida (MHz)
• Ancho DL: Ancho de banda de bajada (MHz)

Estado de Conectividad

Muestra el estado de las conexiones externas configuradas en el dispositivo:

Bridge (TCP)

• Estado: Conectado/Desconectado
• Última Conexión: Fecha y hora de la última conexión exitosa
• Última Desconexión: Fecha y hora de la última desconexión
• Duración (seg): Tiempo en segundos de la conexión actual
• Bytes TX: Total de datos enviados
• Bytes RX: Total de datos recibidos
• Nota: Si no está configurado, muestra "Bridge no configurado"

MQTT Details

• Estado: Conectado/Desconectado
• Última Conexión / Desconexión: Fecha y hora
• Última Publicación: Fecha y hora del último mensaje publicado
• Total Publicado / Recibido: Cantidad de mensajes
• Conteo de Conexiones / Desconexiones: Número de veces
• Total de Errores: Número total de errores de conexión MQTT
• Nota: Si no está configurado, muestra "MQTT no configurado"

Configuración del Sistema (resumen)

• Last Gasp: Estado Activa/Inactiva
• Alerta de Temperatura: Estado con parámetros de umbral, histéresis y período de muestreo
• Alerta de Interruptor: Estado con tipo Bajo (0V) o Alto (5V)
• Sincronización NTP: Host NTP, Puerto NTP, Intervalo
• Monitoreo ICMP: Host ICMP, Número de paquetes, Intervalo
• Reinicio Programado: Período de reinicio en horas

Cargar Perfiles Predefinidos

La aplicación incluye perfiles de configuración predefinidos para dispositivos comunes. Estos perfiles permiten cargar automáticamente la configuración de UART y TCP adaptada a cada tipo de medidor.

Ubicación del botón: En el Menú Principal, en la sección de Configuración, hay un botón "Perfil / JSON" con un ícono de descarga.

Perfiles Disponibles

Cómo Cargar un Perfil

1. En el Menú Principal, presiona el ítem "Configuración de Conectividad"
2. Presiona el botón "Perfil / JSON" en la esquina superior derecha
3. Se abrirá un diálogo mostrando la lista de perfiles disponibles
4. Selecciona el perfil que corresponde a tu tipo de medidor
5. La configuración se cargará automáticamente en los campos correspondientes
6. Presiona "← Atrás" para volver al Menú Principal
7. Presiona "Aplicar cambios en el dispositivo" para aplicar la configuración

Beneficios de los Perfiles Predeterminados

• Configuración rápida: Preconfigura automáticamente UART y TCP según el tipo de medidor
• Precisión: Elimina errores de configuración manual
• Compatibilidad: Garantiza que el dispositivo funcionará correctamente con medidores estándar
• Personalización: Después de cargar, puedes editar manualmente si es necesario

Perfiles Personalizados

La aplicación también permite importar y guardar perfiles personalizados desde archivos de configuración completos. Esto es útil cuando tienes dispositivos con configuraciones específicas que deseas reutilizar.

Cómo Importar un Perfil Personalizado

Requisitos del archivo de configuración:

• Archivo en formato JSON (.json)
• Debe contener las secciones: system, connectivity, notification
• Debe incluir servidor NTP (system.rtc.ntp_server) y servidor ICMP (system.icmp.server)
• No debe estar vacío
• Formato JSON debe ser válido (sin errores de sintaxis)

Opción A — Aplicar sin guardar (Carga Rápida)

Usa el botón "Aplicar archivo de configuración" para cargar el archivo directamente al dispositivo sin guardarlo como perfil reutilizable. Útil para configuraciones puntuales.

Opción B — Guardar como perfil reutilizable

Usa el botón "Guardar y cargar como perfil (.json)" para importar el archivo Y guardarlo con un nombre para usarlo en el futuro. Se te solicitará nombrar el perfil (máximo 40 caracteres).

Mensajes de Error en Perfiles

Estructura Mínima Válida

{
  "system": {
    "rtc": { "ntp_server": "pool.ntp.org" },
    "icmp": { "server": "8.8.8.8" }
  },
  "connectivity": {},
  "notification": {}
}

Secciones de Configuración

Las configuraciones se organizan en tres ítems del Menú Principal, cada uno abre una pantalla separada:

1. Configuración del sistema
2. Configuración de Conectividad
3. Configuración de Notificaciones

Presiona cada ítem del Menú Principal para acceder a sus parámetros.

Configuración del Sistema

La Configuración del Sistema permite personalizar parámetros fundamentales del dispositivo, incluyendo: identificación y ubicación, sincronización de hora, monitoreo de conectividad y programación de reinicios.

Identificación del Dispositivo

Sincronización de Hora (NTP)

Monitoreo ICMP (Ping)

Reinicio Programado (Runtime)

• 0 = Deshabilitado (sin reinicio automático)
• 24 = Reinicia diariamente
• 48 = Reinicia cada dos días

Configuración de Conectividad

La Configuración de Conectividad controla cómo se conecta tu dispositivo a internet y a otros sistemas. Incluye: configuración de red móvil (LTE/APN), VPN, Puentes de Comunicación (TCP, UART) y MQTT.

Red Móvil (LTE/APN)

VPN

TCP Bridge

Comunicación Serial (UART — RS485/RS232)

MQTT

Tópicos MQTT

Configuración de Notificaciones

La Configuración de Notificaciones controla qué alertas genera el dispositivo en situaciones específicas: Notificaciones de Last Gasp (cuando pierde energía), Alerta de Temperatura (cuando alcanza cierto umbral) y Alerta de Interruptor (cambio de estado) Puerto SWITCH1.

Last Gasp

Alerta de Temperatura

Alerta de Interruptor (SWITCH1)

Guardar y Aplicar Cambios de Configuración

• Guardado Parcial: Puedes guardar cambios de cualquiera de las tres secciones (Sistema, Conectividad o Notificaciones) de forma independiente
• Guardado Completo: También puedes completar las configuraciones de las otras dos secciones antes de guardar y aplicar todos los cambios juntos

1. En el Menú Principal, presiona el ítem de configuración correspondiente y realiza los cambios
2. Presiona "← Atrás" para volver al Menú Principal
3. Repite para las demás secciones si es necesario
4. Presiona "Aplicar cambios en el dispositivo" al final de la pantalla del Menú Principal
5. Aparecerá un diálogo de confirmación — presiona "Aplicar y reiniciar" para confirmar
6. Espera a que se sincronicen los cambios; el dispositivo se reiniciará automáticamente (~30 segundos)

Administración del Dispositivo

La administración del dispositivo permite controlar aspectos críticos de seguridad y operación. Se organizan en dos secciones:

1. Seguridad — Cambio de credenciales de acceso
2. Reinicio — Reiniciar el dispositivo

Seguridad — Cambio de Credenciales

Pasos para cambiar credenciales

1. Presiona la sección "Seguridad" en el Menú Principal
2. Ingresa el nuevo usuario y contraseña
3. Confirma la contraseña en el campo de verificación
4. Presiona "Establecer credenciales"
5. El dispositivo se reiniciará automáticamente para activar las nuevas credenciales
6. Espera a que aparezca el mensaje de confirmación

Reinicio — Reiniciar el Dispositivo

1. Presiona la sección "Reinicio" en el Menú Principal
2. Lee la advertencia de impacto
3. Presiona "Reiniciar Ahora" para proceder
4. La conexión BLE se cerrará inmediatamente
5. La app mostrará "Regresando al escaneo en unos segundos..." y navegará a Home automáticamente tras 3 segundos
6. Debes buscar y conectarte al dispositivo manualmente

Seguimiento de Registros y Actualización de Firmware

Configuración de la Aplicación (AppSettings)

La pantalla de Configuración de la Aplicación es accesible desde el ícono de ajustes (engranaje) ubicado en la barra superior del Menú Principal.

En la sección Documentación encontrarás dos documentos disponibles para descargar a tu dispositivo móvil: Guía de Instalación (instrucciones de instalación del hardware) y Manual de Usuario (este manual, en formato PDF). Presiona el botón "Descargar" junto a cada documento.

Solución de Problemas

El dispositivo no aparece en la búsqueda

Posibles causas:

1. Bluetooth deshabilitado en el dispositivo Android
2. El dispositivo Index AMI está apagado o fuera de rango
3. El Bluetooth del dispositivo Index AMI no está activado
4. Interferencia de otras señales

Solución:

1. Verifica que Bluetooth esté activado en tu Android
2. Acerca el dispositivo Index AMI a menos de 3 metros
3. Reinicia ambos dispositivos
4. Aleja de otros aparatos que usen 2.4 GHz

Fallo de autenticación (Login incorrecto)

Problema: Ves el mensaje "Credenciales inválidas". Soluciones:

1. Verifica que escribiste correctamente el usuario y contraseña
2. Diferencia entre mayúsculas y minúsculas
3. Elimina espacios accidentales antes o después
4. Contacta al proveedor si olvidaste las credenciales

Descarga de información falla

Problema: Después de login, aparece error "No fue posible obtener información del dispositivo". Soluciones:

1. Verifica que el dispositivo esté correctamente alimentado
2. Acerca el dispositivo Android al Index AMI
3. Reinicia el dispositivo Index AMI
4. Intenta de nuevo la conexión

No se aplican los cambios de configuración

Problema: Presionas "Aplicar cambios en el dispositivo" pero no sucede nada. Soluciones:

1. Verifica que el dispositivo Index AMI esté conectado
2. Asegúrate de que la conexión Bluetooth sea estable
3. Espera a que se complete el progreso (10-30 segundos)
4. Si falla, presiona "Aplicar cambios en el dispositivo" nuevamente

La conexión se cae constantemente

Problema: Se desconecta sin razón aparente. Soluciones:

1. Aleja de interferencias (Wi-Fi, microondas, otros Bluetooth)
2. Acerca el dispositivo Android al Index AMI
3. Reinicia ambos dispositivos
4. Contacta al proveedor

Mensajes de error "Sin conectividad" o "Timeout"

1. Verifica la configuración APN (LTE)
2. Asegúrate de que el servidor NTP sea accesible
3. Verifica los servidores ICMP configurados
4. Contacta al proveedor de telecomunicaciones

Emparejamiento no completado

Causa: El dispositivo Index AMI no recibió la contraseña de vinculación (123456) dentro del tiempo disponible. Soluciones:

1. Asegúrate de que el dispositivo esté listo: encendido y a menos de 3 metros
2. Completa el emparejamiento correctamente: cuando aparezca la ventana emergente, ingresa 123456 y confirma antes de que se cierre
3. Si falla nuevamente: reinicia el Bluetooth en tu Android y usa el botón "Reintentar"
4. Si aún no funciona: reinicia el Index AMI, reinicia tu teléfono y contacta soporte

El escaneo no encuentra dispositivos (Android 10/11)

Causa: Android 10 y 11 requiere Servicios de Ubicación activos para escaneo BLE. Solución:

1. Presiona el botón "Abrir configuración de ubicación"
2. Activa los Servicios de Ubicación en los ajustes del sistema
3. Regresa a la aplicación e inicia el escaneo nuevamente

Errores de transferencia BLE (errores del protocolo)

Error de conexión — Status 147

Causa: Error transitorio de la pila Bluetooth del dispositivo (problema temporal de comunicación BLE). Soluciones:

1. Reintento automático: La aplicación reintentará automáticamente con esperas progresivas (10-30 segundos)
2. Si persiste: reinicia el Bluetooth en tu Android, reinicia el Index AMI (espera 30 seg) e intenta conectar nuevamente
3. Verifica el entorno: aleja de interferencias, asegúrate de estar a menos de 3 metros
4. Si sigue ocurriendo: contacta al proveedor de soporte técnico

Glosario de Términos

Contacto y Soporte

Soporte Técnico

Información a preparar al contactar soporte

• Describe el problema en detalle
• Incluye cualquier mensaje de error que veas en la pantalla
• Ten disponible la dirección MAC del dispositivo Index AMI