Introducción y primeros pasos
Index AMI Configuration Tool es la aplicación oficial para crear, gestionar y entregar archivos de configuración (conf.json) a los dispositivos Index AMI. Centraliza la gestión de plantillas, dispositivos, generación de configuraciones y la escritura directa al dispositivo por Bluetooth (BLE).
La herramienta funciona completamente sin conexión a internet (offline). Toda la información —registro de dispositivos, plantillas, historial de generación y copias de respaldo— se almacena en una base de datos local en su PC. No se envía ningún dato a servidores externos.
¿Qué puede hacer con esta herramienta?
- Crear y reutilizar plantillas de configuración para distintos escenarios o tipos de medidores, y exportarlas/importarlas para usarlas en otros computadores.
- Registrar dispositivos y generar archivos conf.json personalizados para un grupo de medidores.
- Enviar la configuración y los certificados directamente al dispositivo por Bluetooth (BLE) sin cables, ya sea desde el centro de gestión o antes de despachar las unidades a campo.
- Validar archivos de configuración antes de usarlos.
- Recuperar respaldos y exportar configuraciones generadas previamente, todos almacenados localmente en su PC.
Requisitos del sistema
| Componente | Requisito |
|---|---|
| Sistema operativo | Windows 10/11 o Linux x64 (Ubuntu 20.04+, ArcoLinux, etc.) |
| Espacio en disco | ~80 MB para la aplicación + espacio para respaldos |
| Bluetooth | Adaptador BLE (Bluetooth 4.0+) para aprovisionamiento inalámbrico |
| Descompresor ZIP | 7-Zip (p7zip en Linux) para abrir respaldos cifrados con AES-256 |
Estructura de carpetas de trabajo
Todos los datos son locales y se organizan así:
| Contenido | Ubicación (Linux) | Ubicación (Windows) |
|---|---|---|
| Base de datos (dispositivos, plantillas, historial) | ~/.config/IndexAmiConfig/app.db | %APPDATA%\IndexAmiConfig\app.db |
| Respaldos internos (conf.json + certificados) | ~/.config/IndexAmiConfig/backups/ | %APPDATA%\IndexAmiConfig\backups\ |
| Archivos generados y exportados | Carpeta de exportación configurada (por defecto: Descargas) | Carpeta de exportación configurada (por defecto: Descargas) |
Inicio de sesión
Al abrir la aplicación se muestra la pantalla de inicio de sesión. Ingrese su nombre de usuario y contraseña para acceder.
- Ingrese su usuario en el campo superior.
- Ingrese su contraseña. Use el ícono de ojo para mostrar u ocultar el texto.
- Presione «Iniciar sesión» o la tecla Enter.
¿Olvidó su contraseña? — Procedimiento de recuperación
Si olvidó su contraseña, puede restablecerla a los valores por defecto ejecutando el siguiente comando desde una terminal con acceso al PC:
Windows (PowerShell o CMD como administrador):
"C:\Program Files\Noatec\Index AMI Configuration Tool\IndexAmiConfig.Presentation.Avalonia.exe" --reset-admin
Linux:
/opt/IndexAmiConfig/IndexAmiConfig.Presentation.Avalonia --reset-admin
El comando restablece el usuario a admin y la contraseña a Admin1234!. Después de ejecutarlo, inicie sesión normalmente y cambie la contraseña de inmediato.
Gestión de plantillas
Una plantilla define los valores base de configuración que se aplicarán a todos los dispositivos de un grupo de medidores. Se puede crear una plantilla por cada escenario o tipo de medidor a criterio del usuario. Incluye la identificación del dispositivo (etiqueta de puerto y descripción), parámetros de conectividad, VPN, MQTT, alertas y más. Los campos personalizables pueden ajustarse por dispositivo durante el asistente de generación.
Plantillas incluidas por defecto
Al instalar la aplicación encontrará un conjunto de plantillas predefinidas asociadas a medidores comerciales de uso frecuente:
| Plantilla | Puerto de referencia | UART |
|---|---|---|
| Microstar D2000 | RJ45-1 | 9600 8N1 |
| Microstar P2000-D RS485 | RJ45-2 | 9600 8N1 |
| Microstar P2000-D RS232 Port1 | RJ45-1 | 9600 8N1 |
| Microstar P2000-D RS232 Port2 | RJ45-2 | 9600 8N1 |
| ISKRA MT174 | Pin 27→A, 29→B | 9600 7E1 |
| ITRON ACE600 | RS232 | 9600 8N1 |
| ELSTER Type A1830 | DB9-RS232 | 9600 8N1 |
| Landys+Gyr ZMG405 | RJ12-RS232 | 9600 8N1 |
Cada una tiene preconfigurada la sección Puente TCP-UART y la Identificación del dispositivo. El resto de parámetros —NTP, ICMP, APN, VPN, MQTT, alertas— deben completarse con los valores propios de su red antes de usarlas para generar configuraciones.
Crear una nueva plantilla
- En la barra de navegación, haga clic en «Plantillas» y luego en «Nueva plantilla».
- Ingrese el Nombre de la plantilla (obligatorio) y una Descripción del tipo de medidor o escenario.
- Seleccione la sección «Identificación del dispositivo» en el panel izquierdo. Ingrese la Etiqueta de puerto (ej. RJ45-1, DB9-RS232) y la Descripción del dispositivo.
- Recorra las demás secciones y configure los valores según el tipo de medidor: RTC/ICMP/Reinicio programado, LTE-APN, VPN/MQTT (solo si aplica), Notificaciones/Alertas (solo si aplica). Los campos marcados (Obligatorio) no pueden quedar vacíos.
- Haga clic en «Guardar».
Secciones de parámetros
| Sección | Descripción | Valores por defecto / Restricciones |
|---|---|---|
| Identificación del dispositivo | Etiqueta de puerto y Descripción del dispositivo. Ambos personalizables por dispositivo. | Las plantillas incluidas por defecto ya tienen estos campos precargados. La etiqueta de puerto debe completarse manualmente. |
| RTC | Servidor NTP, puerto y frecuencia de sincronización de reloj. Servidor NTP: obligatorio. | NTP: pool.ntp.org · Puerto: 123 · Intervalo: 12 h (máx. 12 h) |
| ICMP | Servidor de ping para verificar conectividad, paquetes, intervalo y timeout. Servidor: obligatorio. | Servidor: 8.8.8.8 · Paquetes: 4 · Intervalo: 1000 ms · Timeout: 5000 ms |
| Reinicio programado | Período máximo de operación continua antes de reinicio automático. Personalizable por dispositivo. | Default: 24 h · Rango: 0–48 h · 0 = deshabilitado |
| LTE - Contexto APN | APN del operador móvil (predefinidos o personalizado), usuario, contraseña y método de autenticación. | Tipo de contexto: IPv4 · Autenticación: None · APN: Noatec, Claro, Movistar, Tigo, Avantel u otros |
| VPN - WireGuard | Dirección IP, máscara, endpoint y keepalive del túnel. Solo cuando VPN está habilitado. | Puerto: 51820 · Keepalive: 25 s · IP y endpoint: sin valor por defecto |
| Puente TCP - UART | Modo de puerto serie, baudios, bits de datos, paridad, bits de stop y timeout de recepción. | Modo: RS232 · Baudios: 9600 · Datos: 8 bits · Paridad: None · Stop: 1 bit · Timeout RX: 100 ms |
| Puente TCP - TCP | Modo de comunicación TCP (None / TCP / Modbus TCP), puerto y timeout de recepción. | Modo: TCP · Puerto: 4059 · Timeout RX: 60 s |
| MQTT | Broker, transporte (TCP/SSL), credenciales, puerto, keepalive, certificados TLS y tópicos. Solo cuando MQTT está habilitado. | Transporte: SSL · Puerto: 8883 · Keepalive: 120 s · Verificación CN: habilitada |
| Alerta de temperatura | Umbral, histéresis y período de muestreo. Solo cuando la alerta está habilitada. | Umbral: 65 °C · Histéresis: 5 °C · Período de muestreo: 60 s |
| Alerta de interruptor | Estado del contacto seco que dispara la alerta. Solo cuando la alerta está habilitada. | Estado: Low — opciones: Low, High |
Editar o eliminar una plantilla
- Editar: Seleccione la plantilla en la lista y haga clic en «Editar». Se abrirá el editor con todos los valores actuales cargados; realice los cambios y haga clic en «Guardar».
- Eliminar: Seleccione la plantilla y haga clic en «Eliminar». La herramienta pedirá confirmación antes de proceder, ya que la acción no se puede deshacer.
Exportar e importar plantillas
- Exportar: Seleccione la plantilla y haga clic en «Exportar». Se genera un archivo .json en la carpeta de exportación configurada.
- Importar: Haga clic en «Importar plantilla», seleccione el archivo .json exportado previamente y confirme.
Asistente de generación de archivos de configuración
El asistente de generación de archivos de configuración es el módulo central de la aplicación. Permite condensar en un único archivo conf.json toda la información que el dispositivo Index AMI necesita para operar: parámetros de sistema (NTP, ICMP, reinicio programado), de conectividad (APN, VPN, puente TCP/UART, MQTT) y de notificaciones (alertas de temperatura e interruptor). Todo el flujo está guiado en 4 pasos.
Paso 1 — Seleccionar plantilla
- En la barra de navegación, haga clic en «Generar».
- Use el buscador para filtrar plantillas por nombre.
- Seleccione la plantilla que desea usar como base.
- Haga clic en «Siguiente».
Paso 2 — Dispositivos y personalización
En este paso se registran y parametrizan los dispositivos Index AMI que recibirán el archivo de configuración. El objetivo es generar un conf.json personalizado para cada unidad.
Agregar y editar dispositivos
- Haga clic en «Nuevo» e ingrese al menos la Etiqueta personalizada del dispositivo (obligatorio).
- Complete o ajuste los parámetros en las tres pestañas disponibles (ver detalle abajo).
- Una vez completados los parámetros, haga clic en «Guardar» para agregar el dispositivo a la lista. Para editar uno existente, selecciónelo, realice las modificaciones y haga clic en «Guardar cambios».
Pestañas de parámetros
| Pestaña | Contenido |
|---|---|
| Sistema | Identificación del dispositivo: Etiqueta personalizada (obligatorio), Número, Descripción, Ubicación y Etiqueta del puerto. La Descripción y la Etiqueta del puerto se pre-llenan con los valores definidos en la plantilla. También muestra los parámetros de RTC, ICMP y Reinicio programado que la plantilla haya marcado como personalizables. |
| Conectividad | Parámetros de APN y Puente TCP/UART heredados de la plantilla. Incluye las casillas «Habilitar VPN» y «Habilitar MQTT»: al marcarlas se despliegan los parámetros correspondientes. Si estas opciones quedan habilitadas, los datos de VPN y MQTT serán incluidos en el conf.json generado para ese dispositivo. |
| Notificaciones | Permite habilitar: Habilitar notificaciones Last Gasp, Habilitar alerta de temperatura (muestra umbral, histéresis y período de muestreo), Habilitar alerta de interruptor (muestra el campo de estado: Low/High). |
Paso 3 — Vista previa y validación
Antes de generar los archivos, la herramienta muestra una vista previa del conf.json para cada dispositivo y ejecuta las validaciones automáticamente.
- Los dispositivos con errores de validación se marcan en rojo. Regrese al Paso 2 para corregirlos.
- Los dispositivos con advertencias se marcan en amarillo. Puede continuar, pero revise los valores.
- Los dispositivos listos se muestran en verde.
Paso 4 — Generar
- Verifique o seleccione la carpeta de destino donde se guardarán los archivos generados. Si ya configuró una ruta de exportación en Configuración, esta aparecerá precargada; de lo contrario, use «Explorar...» para seleccionarla.
- (Opcional) Marque «Generar archivo ZIP por dispositivo» si desea obtener además una copia del conf.json empaquetada en formato ZIP.
- Haga clic en «Generar todos los archivos de configuración».
- Espere a que el proceso termine. Cada dispositivo mostrará ✓ al completarse. Los archivos quedan en la ubicación seleccionada, organizados en subcarpetas por dispositivo con la fecha de generación.
- Haga clic en «Finalizar» para cerrar el asistente.
Configurar dispositivo (BLE)
Esta sección permite enviar el archivo conf.json y los certificados directamente a un dispositivo Index AMI por Bluetooth Low Energy (BLE), sin necesidad de cables. Es el paso final del proceso de alistamiento y permite aprovisionar cada unidad de forma ágil desde el centro de gestión antes de despacharlas a campo.
Pasos de aprovisionamiento
El flujo siempre inicia con 3 pasos. Si el conf.json cargado tiene VPN o MQTT habilitados, la herramienta agrega automáticamente los pasos de certificados entre el paso 1 y el de escaneo.
- Cargar conf.json — Seleccione el archivo de configuración generado en el asistente usando el botón «Seleccionar». La herramienta lo valida automáticamente al cargarlo y muestra los errores o advertencias encontrados, así como los servicios habilitados (VPN / MQTT). Si el archivo tiene errores de validación, corrija el conf.json antes de continuar.
- Certificados VPN (aparece solo si el conf.json tiene VPN habilitado) — Seleccione la clave privada y la clave pública WireGuard del dispositivo.
- Certificados MQTT (aparece solo si el conf.json tiene MQTT habilitado) — Seleccione el certificado CA, el certificado cliente y la clave privada del broker MQTT.
- Escanear y seleccionar dispositivo BLE — Verifique que el indicador de Bluetooth esté activo (la herramienta lo comprueba automáticamente cada 10 segundos). Haga clic en «Escanear dispositivos»; el escaneo dura aproximadamente 10 segundos. Seleccione el dispositivo Index AMI de la lista y verifique que la señal sea adecuada (idealmente superior a -70 dBm).
- Enviar archivos al dispositivo — Haga clic en «Enviar archivos al dispositivo». La barra de progreso muestra el avance en tiempo real. Al llegar al 100%, el dispositivo se reinicia automáticamente con la nueva configuración.
Solución de problemas BLE
| Síntoma | Solución |
|---|---|
| El dispositivo no aparece en el escaneo | Verifique que la unidad Index AMI esté energizada y en rango. Acérquese al dispositivo y vuelva a escanear. Si acaba de realizar una escritura exitosa, espere 15 segundos para que el dispositivo termine de reiniciarse y vuelva a escanear. |
| Error de conexión o desconexión | Deseleccione la unidad usando el botón «Deseleccionar», vuelva a escanear y selecciónela de nuevo. Si persiste, reinicie el dispositivo físicamente. |
| Error durante la escritura | Revise el registro de pasos. El dispositivo puede necesitar ser retirado del historial Bluetooth del computador antes de reconectar (se hace automáticamente). |
| No se detecta Bluetooth | En Linux: ejecute bluetoothctl power on. En Windows: active Bluetooth en la configuración del sistema. |
| El adaptador Bluetooth no responde o el escaneo falla en Windows | Haga clic en «Reiniciar adaptador Bluetooth» (visible debajo del estado de Bluetooth). La herramienta apaga y enciende el adaptador automáticamente. Si el problema persiste, desactive y reactive Bluetooth manualmente desde Configuración de Windows. |
Validar archivo conf.json
La vista de validación permite verificar un archivo conf.json existente contra las reglas de la herramienta, sin necesidad de pasar por el asistente de generación.
Cómo validar un archivo
- En la barra de navegación, vaya a Herramientas → Validar.
- Haga clic en «Seleccionar archivo» y elija el conf.json a validar.
- Los resultados se muestran automáticamente.
Interpretación de resultados
| Indicador | Significado |
|---|---|
| 🟢 Sin errores | El archivo es válido y puede usarse en el dispositivo. |
| 🟡 Advertencia | El archivo tiene valores que pueden causar problemas en algunos escenarios. Revise cada advertencia. |
| 🔴 Error | El archivo tiene campos inválidos o faltantes. No se recomienda usar este archivo sin corregirlo. |
Recuperación de archivos
La sección de recuperación muestra todos los dispositivos que tienen respaldo de configuración almacenado en la base de datos local. Permite acceder a contraseñas de ZIP, detalles de los archivos incluidos y exportar o entregar las configuraciones.
Panel izquierdo — Lista de dispositivos
Muestra todos los dispositivos con información de respaldo. Cada dispositivo tiene una etiqueta de estado:
- «conf.json + certificados» — Respaldo completo con conf.json y certificados.
- «Solo conf.json» — No hay respaldo BLE; solo existe el conf.json generado por el asistente.
Panel derecho — Detalle del dispositivo
Con respaldo BLE (conf.json + certificados):
- Contraseña del ZIP: La contraseña necesaria para abrir el respaldo exportado. Puede mostrarla u ocultarla, y copiarla al portapapeles.
- Detalles del backup (colapsable): Lista de certificados incluidos y vista previa del contenido del conf.json.
- Exportar configuración y certificados: Entrega el respaldo completo como archivo ZIP cifrado con AES-256 a la carpeta de exportación.
- Exportar conf.json: Exporta solo el conf.json sin cifrar, extraído del respaldo en disco.
Sin respaldo BLE (Solo conf.json):
- Se muestra un aviso indicando que el dispositivo no tiene respaldo BLE.
- Exportar conf.json: Exporta el último conf.json generado por el asistente, registrado en la base de datos.
Abrir el ZIP exportado (cifrado AES-256)
El cifrado AES-256 es incompatible con Windows Explorer y con unzip en Linux. Use 7-Zip:
7z x NombreDispositivo_backup.zip
- Windows → instale 7-Zip: clic derecho → 7-Zip → Extraer aquí
- Linux → p7zip
- Android → ZArchiver o RAR (Play Store)
¿Cuándo se crea un respaldo?
El respaldo se crea automáticamente cada vez que se realiza un aprovisionamiento BLE exitoso (al hacer clic en «Enviar archivos al dispositivo»). La herramienta guarda una copia del conf.json enviado y de los certificados utilizados, organizada por dispositivo:
- Linux: ~/.config/IndexAmiConfig/backups/{id_dispositivo}/
- Windows: %APPDATA%\IndexAmiConfig\backups\{id_dispositivo}\
Cada aprovisionamiento sobreescribe el respaldo anterior del mismo dispositivo, conservando siempre el más reciente.
Configuración de la aplicación
Apariencia
- Tema visual: Elija entre Claro, Oscuro o Sistema (sigue la configuración del sistema operativo). El cambio se aplica de inmediato.
- Idioma: La herramienta está disponible en Español e Inglés. El cambio se aplica en tiempo real.
Carpeta de exportación
Define la carpeta donde se guardan los archivos conf.json generados y los respaldos exportados. Por defecto es la carpeta Descargas del usuario. Haga clic en «Seleccionar carpeta», elija la carpeta deseada y el cambio se guarda automáticamente.
Cuenta de usuario
Cambie su nombre de usuario y contraseña desde la sección Cuenta de usuario.
Backup — Salt personalizado del ZIP
Valor opcional que se combina con la semilla única de cada dispositivo para derivar la contraseña de los respaldos cifrados. Si se deja vacío, la contraseña se deriva únicamente de la semilla del dispositivo.
Registro (logs)
Controla el nivel de detalle de los registros de la aplicación. El nivel por defecto es Information. Si se presentan fallos o comportamientos inesperados, cambie el nivel a Debug (el más detallado), repita los pasos que generan el problema y luego exporte el archivo de log generado para compartirlo con el servicio de soporte del proveedor.
Acerca de la aplicación
| Campo | Valor |
|---|---|
| Nombre | Index AMI Configuration Tool |
| Versión | 1.0.0 — MVP |
| Compatible con | Firmware Index AMI v1 y v2 |
| Plataformas | Windows 10/11 · Linux x64 |
| Desarrollado por | Noatec SAS |
| Licencia | Uso interno — Noatec SAS |
¿Dudas o problemas? Contáctanos
| Canal | Dato |
|---|---|
| Teléfono | 315 559 0927 |
| Correo | contacto@noatec.co |
Preguntas frecuentes
¿Puedo usar la herramienta sin conexión a internet?
Sí. La herramienta funciona completamente sin conexión. Toda la información se almacena en una base de datos local.
¿Qué pasa si cierro el asistente de generación a la mitad?
Se muestra un diálogo de confirmación. Si confirma la salida, se pierde el progreso del asistente. Los dispositivos no se guardan en la base de datos hasta completar el Paso 4.
¿Cuántos dispositivos puedo configurar en un grupo de dispositivos?
No hay límite técnico impuesto por la herramienta. Sin embargo, se recomienda hacerlo por grupo de dispositivos para mantener tiempos de generación razonables y control de los activos.
¿Puedo editar un conf.json generado manualmente?
Puede hacerlo con un editor de texto, pero use la vista Validar para verificar el archivo modificado antes de usarlo en un dispositivo.
El escaneo BLE no detecta el dispositivo. ¿Qué hago?
Verifique que la unidad Index AMI esté energizada y en rango BLE. Acérquese al dispositivo (idealmente menos de 2 metros) y vuelva a escanear. En Linux, asegúrese de que el servicio Bluetooth esté activo:
sudo systemctl start bluetooth
¿Cómo sé si el aprovisionamiento fue exitoso?
La barra de progreso llegará al 100% y el registro de pasos mostrará todos los ítems en verde. El dispositivo se reiniciará automáticamente al finalizar la escritura.
¿Cómo abro el ZIP del respaldo en Windows?
Instale 7-Zip. Haga clic derecho en el archivo → 7-Zip → Extraer aquí. Ingrese la contraseña mostrada en la sección de Recuperación.
¿Los respaldos se sincronizan en la nube?
No. Los respaldos son locales. Se almacenan en ~/.config/IndexAmiConfig/backups/ (Linux) o %APPDATA%\IndexAmiConfig\backups\ (Windows). Haga copias de seguridad de esta carpeta periódicamente.