Noatec S.A.S. · Aplicación de Escritorio · Windows / Linux

Index AMI Configuration Tool

Manual completo para crear plantillas, generar archivos de configuración conf.json, aprovisionar dispositivos Index AMI por Bluetooth (BLE) y gestionar respaldos cifrados.

Código: MA-CFG-01·Versión: 1.0 (MVP) · Marzo 2026
01

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.

💡 Datos locales — importante tener en cuenta: Al desinstalar la aplicación o cambiar de computador, los datos no se migran automáticamente. Antes de hacerlo, exporte sus plantillas desde la vista Plantillas para poder importarlas en el nuevo computador, y haga una copia manual de la carpeta de respaldos (~/.config/IndexAmiConfig/backups/ en Linux o %APPDATA%\IndexAmiConfig\backups\ en Windows).

¿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.
Identifique bien las unidades antes del despacho: Si configura varios medidores antes de enviarlos a campo, asegúrese de marcar o identificar físicamente cada unidad con el nombre o número de dispositivo registrado en la herramienta. Un despacho cruzado (unidad configurada con los datos de otra) puede causar problemas de conectividad difíciles de rastrear en campo.

Requisitos del sistema

ComponenteRequisito
Sistema operativoWindows 10/11 o Linux x64 (Ubuntu 20.04+, ArcoLinux, etc.)
Espacio en disco~80 MB para la aplicación + espacio para respaldos
BluetoothAdaptador BLE (Bluetooth 4.0+) para aprovisionamiento inalámbrico
Descompresor ZIP7-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í:

ContenidoUbicació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 exportadosCarpeta de exportación configurada (por defecto: Descargas)Carpeta de exportación configurada (por defecto: Descargas)
02

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.

  1. Ingrese su usuario en el campo superior.
  2. Ingrese su contraseña. Use el ícono de ojo para mostrar u ocultar el texto.
  3. Presione «Iniciar sesión» o la tecla Enter.
💡 Credenciales por defecto: admin / Admin1234! Se recomienda cambiarlas inmediatamente desde Herramientas → Configuración → Cuenta de usuario.

¿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.

Seguridad física: El comando --reset-admin requiere acceso físico al PC. Nunca comparta el acceso físico o remoto (RDP, SSH) al PC con personas no autorizadas.
03

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:

PlantillaPuerto de referenciaUART
Microstar D2000RJ45-19600 8N1
Microstar P2000-D RS485RJ45-29600 8N1
Microstar P2000-D RS232 Port1RJ45-19600 8N1
Microstar P2000-D RS232 Port2RJ45-29600 8N1
ISKRA MT174Pin 27→A, 29→B9600 7E1
ITRON ACE600RS2329600 8N1
ELSTER Type A1830DB9-RS2329600 8N1
Landys+Gyr ZMG405RJ12-RS2329600 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.

💡 Complete las plantillas antes de usar: Para garantizar que las configuraciones generadas sean funcionales, edite cada plantilla desde Plantillas → seleccione la plantilla → Editar, complete los campos faltantes y guarde.
💡 Duplicar: genera una copia exacta con un nuevo nombre, conservando todos los parámetros configurados. Es la forma más rápida de crear variantes sin alterar la plantilla original — por ejemplo, una versión con VPN habilitada y otra sin ella para el mismo tipo de medidor. Eliminar: borra la plantilla de forma permanente de la base de datos local. La herramienta solicitará confirmación explícita. Ambas acciones están disponibles desde la vista Plantillas, seleccionando la plantilla en la lista.

Crear una nueva plantilla

  1. En la barra de navegación, haga clic en «Plantillas» y luego en «Nueva plantilla».
  2. Ingrese el Nombre de la plantilla (obligatorio) y una Descripción del tipo de medidor o escenario.
  3. 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.
  4. 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.
  5. Haga clic en «Guardar».
💡 Estos valores pre-llenan el asistente de generación: La Etiqueta de puerto y la Descripción definidas en la plantilla se usan como valores por defecto al agregar dispositivos en el Paso 2 del asistente. Si todos los medidores del grupo usan el mismo puerto, no necesita modificarlos uno a uno.

Secciones de parámetros

SecciónDescripciónValores por defecto / Restricciones
Identificación del dispositivoEtiqueta 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.
RTCServidor 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)
ICMPServidor 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 programadoPerí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 APNAPN 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 - WireGuardDirecció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 - UARTModo 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 - TCPModo de comunicación TCP (None / TCP / Modbus TCP), puerto y timeout de recepción.Modo: TCP · Puerto: 4059 · Timeout RX: 60 s
MQTTBroker, 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 temperaturaUmbral, 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 interruptorEstado del contacto seco que dispara la alerta. Solo cuando la alerta está habilitada.Estado: Low — opciones: Low, High
💡 Campos personalizables: Los parámetros marcados con (Personalizable) pueden modificarse por dispositivo durante el asistente de generación. Los demás aplican igual a todos los dispositivos del grupo. La Etiqueta de puerto y la Descripción son siempre personalizables.

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.
Eliminación permanente: Al eliminar una plantilla no se puede deshacer la acción. Asegúrese antes de proceder.

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.
💡 Recomendación al cambiar de computador: Antes de desinstalar la aplicación o migrar a otro computador, exporte todas sus plantillas desde la vista Plantillas — son los únicos datos que no se pueden recuperar desde los respaldos de dispositivos. En el nuevo computador, impórtelas con «Importar plantilla». Consulte la sección 7. Recuperación de archivos para más detalles.
04

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.

💡 Flujo recomendado: Antes de iniciar el asistente, asegúrese de tener al menos una plantilla creada y de conocer los identificadores de los dispositivos que va a configurar.

Paso 1 — Seleccionar plantilla

  1. En la barra de navegación, haga clic en «Generar».
  2. Use el buscador para filtrar plantillas por nombre.
  3. Seleccione la plantilla que desea usar como base.
  4. 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.

Identifique bien las unidades antes del despacho: Si configura varios medidores antes de enviarlos a campo, asegúrese de marcar o identificar físicamente cada unidad con el nombre registrado en la herramienta. Un despacho cruzado puede causar problemas de conectividad difíciles de rastrear en campo.

Agregar y editar dispositivos

  1. Haga clic en «Nuevo» e ingrese al menos la Etiqueta personalizada del dispositivo (obligatorio).
  2. Complete o ajuste los parámetros en las tres pestañas disponibles (ver detalle abajo).
  3. 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».
Los datos no se guardan hasta finalizar: Si sale del asistente antes de completar el Paso 4, todos los dispositivos y parámetros ingresados se perderán. Los datos solo se persisten en la base de datos al finalizar la generación.

Pestañas de parámetros

PestañaContenido
SistemaIdentificació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.
ConectividadPará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.
NotificacionesPermite 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).
💡 Parámetros personalizables vs. solo lectura: Los parámetros que en la plantilla fueron marcados como (Personalizable) pueden modificarse individualmente para cada dispositivo en este paso. Si no se modifican, toman el valor definido en la plantilla. Los parámetros no personalizables se muestran en modo lectura.
Cambios sin guardar: Si edita los campos de un dispositivo y hace clic en «Siguiente» o «Atrás» sin guardar, la aplicación mostrará una advertencia. Guarde el dispositivo antes de continuar.

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.
💡 Haga clic en cada dispositivo de la lista para ver su conf.json completo en el panel derecho antes de generar.

Paso 4 — Generar

  1. 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.
  2. (Opcional) Marque «Generar archivo ZIP por dispositivo» si desea obtener además una copia del conf.json empaquetada en formato ZIP.
  3. Haga clic en «Generar todos los archivos de configuración».
  4. 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.
  5. Haga clic en «Finalizar» para cerrar el asistente.
💡 Estructura de salida: Los archivos se agrupan en una carpeta fechada: conf_AAAAMMDD_HHmmss/. Dentro de ella, cada dispositivo tiene su propia subcarpeta con el conf.json generado y, si se habilitó la opción ZIP, el archivo comprimido correspondiente. Ejemplo: conf_20240315_143022 / MedidorNorte / conf.json
Salir del asistente: Si cierra el asistente antes de finalizar, se pedirá confirmación para descartar el progreso. Los dispositivos no se guardan en la base de datos hasta completar la generación en el Paso 4.
05

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.

Requisitos previos: • El PC debe tener un adaptador Bluetooth BLE (4.0+) y estar encendido. • El dispositivo Index AMI debe estar encendido y visible en el rango BLE. Puede energizarlo conectándolo al PC mediante un cable USB-A a USB-C. • En Linux: el usuario debe tener permisos para BlueZ (bluetoothctl). Consulte la guía de instalación.

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.

  1. 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.
  2. Certificados VPN (aparece solo si el conf.json tiene VPN habilitado) — Seleccione la clave privada y la clave pública WireGuard del dispositivo.
  3. 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.
  4. 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).
  5. 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.
💡 Orden de escritura: Los archivos se envían en este orden: certificados primero, conf.json al último. Este orden es necesario para que el dispositivo arranque correctamente con la nueva configuración.

Solución de problemas BLE

SíntomaSolución
El dispositivo no aparece en el escaneoVerifique 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ónDeseleccione 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 escrituraRevise 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 BluetoothEn 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 WindowsHaga 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.
06

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

  1. En la barra de navegación, vaya a Herramientas → Validar.
  2. Haga clic en «Seleccionar archivo» y elija el conf.json a validar.
  3. Los resultados se muestran automáticamente.

Interpretación de resultados

IndicadorSignificado
🟢 Sin erroresEl archivo es válido y puede usarse en el dispositivo.
🟡 AdvertenciaEl archivo tiene valores que pueden causar problemas en algunos escenarios. Revise cada advertencia.
🔴 ErrorEl archivo tiene campos inválidos o faltantes. No se recomienda usar este archivo sin corregirlo.
💡 Validaciones realizadas: Se verifican campos obligatorios presentes, formatos de IP y hostname, longitudes máximas, rangos de valores numéricos y coherencia de campos condicionales (ej. certificados requeridos cuando VPN o MQTT están habilitados).
07

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.

Herramientas → Recuperación

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.
Contraseña del ZIP — guárdela antes de exportar: La contraseña del ZIP es única por dispositivo y se genera automáticamente. Guárdela en un lugar seguro antes de exportar el ZIP, ya que sin ella no podrá abrir el respaldo cifrado. Si desinstala la aplicación y elimina la base de datos o la carpeta de respaldos, perderá tanto la contraseña como los archivos de respaldo de forma permanente.
Salt personalizado — no lo cambie sin precaución: La contraseña se deriva a partir de una semilla única del dispositivo combinada con un salt personalizado (Herramientas → Configuración → Backup → Salt personalizado del ZIP). Si el salt se cambia, la contraseña cambia para todos los dispositivos, pero los archivos ZIP ya exportados siguen cifrados con la contraseña anterior y no se podrán abrir con la nueva.

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)
En todos los casos se solicitará la contraseña del archivo ZIP, la cual se obtiene desde Herramientas → Recuperación de archivos seleccionando el dispositivo.

¿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.

💡 Dispositivos sin respaldo: Si un dispositivo muestra el mensaje "No se tiene una copia de seguridad...", significa que aún no se ha realizado el aprovisionamiento BLE con la versión actual de la herramienta. Puede exportar el último conf.json generado, pero no habrá ZIP con certificados disponible.
08

Configuración de la aplicación

Herramientas → Configuració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.

💡 Requisitos de contraseña: La nueva contraseña debe tener al menos 8 caracteres e incluir mayúsculas, minúsculas, un número y un carácter especial. La lista de verificación en pantalla indica cuáles requisitos se cumplen en tiempo real. Al guardar, la sesión se cierra automáticamente para que inicie sesión con los datos actualizados.

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.

No cambie el salt si ya tiene respaldos exportados: Cambiar el salt modifica la contraseña que muestra la aplicación para todos los dispositivos, pero los archivos ZIP ya exportados siguen cifrados con la contraseña anterior. Al guardar un nuevo salt, la aplicación solicita confirmación ingresando la contraseña de la sesión actual para evitar cambios accidentales.

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.

09

Acerca de la aplicación

CampoValor
NombreIndex AMI Configuration Tool
Versión1.0.0 — MVP
Compatible conFirmware Index AMI v1 y v2
PlataformasWindows 10/11 · Linux x64
Desarrollado porNoatec SAS
LicenciaUso interno — Noatec SAS
💡 ¡En Noatec transformamos los negocios con innovación y tecnología!

¿Dudas o problemas? Contáctanos

CanalDato
Teléfono315 559 0927
Correocontacto@noatec.co
💡 Compatibilidad de versiones: Este manual corresponde a la versión 1.0.0 (MVP) de la herramienta. Si su instalación muestra una versión diferente, consulte el manual actualizado disponible en la pantalla de inicio de sesión o contáctenos.
10

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.