Manual de integración de terminales Linux A10-T

Estado de integración de xTMSAgent, 26 de septiembre de 2026. Esta guía documenta cómo la terminal Linux UIC A10-T conecta e interactúa con UIC Connect TMS. El procedimiento oficial de instalación A10-T se agregará cuando el instalador y proceso de campo estén finalizados.

1. Componentes y responsabilidad

xTMSAgent es el agente residente. Inicia y supervisa la aplicación de pagos, controla el servicio de comunicaciones A10, mantiene MQTT autenticado, reporta telemetría/inventario, procesa comandos TMS e intercambia parámetros con pagos mediante un puente local de archivos.

El modelo del portal es la familia genérica UIC / A10-T / Linux. El equipo también reporta el modelo completo, por ejemplo A10-TKR42NDBKT0NU1; ambos aparecen en detalles. Compatibilidad y paquetes usan el modelo del portal.

2. Secuencia de inscripción

1. Un SuperAdmin crea/selecciona UIC A10-T y registra la serie exacta bajo el cliente correcto.
2. Un paquete xTMSAgent protegido y específico del cliente entrega configuración de servidor/cliente/bootstrap, nunca el secreto individual.
3. Al iniciar, xTMSAgent arranca CommServer antes de la inscripción. El operador puede usar F2 Config para Ethernet, Wi-Fi o celular.
4. El agente lee serie SDK y modelo completo y reclama únicamente el registro ya creado mediante /device-iot/enroll.
5. TMS entrega ID, secreto, época y prefijo. El agente guarda atómicamente /home/user1/.xtms/enrollment.json con modo 0600 y elimina bootstrap.
6. Genera/aprovisiona certificado IoT, confirma posesión de clave y conecta MQTT.
7. La primera conexión autenticada marca Aprovisionado y cierra nuevas descargas de inscripción.

La terminal no crea ni asigna su registro. Una serie ausente/incorrecta muestra Enrollment pending y reintenta cada 60 segundos o al usar Retry/Enter. Configuración de comunicaciones sigue disponible.

3. Estado de instalación

Las instrucciones de producción A10-T quedan reservadas para otra revisión. No considere updateTMS.sh, una copia por consola serial o credenciales copiadas manualmente como diseño de campo. En laboratorio, updateTMS.sh solo instala el paquete firmado; xTMSAgent realiza inscripción y certificados después del arranque.

Hasta aprobar el instalador:

• proteja el bootstrap específico del cliente;
• firme con la clave A10 aprobada;
• instale bajo /home/user1 por la ruta oficial del fabricante;
• nunca incluya un secreto individual en un paquete reutilizable;
• conserve /home/user1/.xtms en actualizaciones normales;
• limite permisos de inscripción, clave IoT y configuración al usuario del agente.

4. Configuración de comunicaciones

CommServer admite Ethernet, Wi-Fi y celular según hardware/firmware. Inicia antes de la inscripción. Guardar es explícito: salir con Cancelar no debe mostrar CONFIG UPDATED ni alterar valores; solo la opción Guardar confirma. Los avisos deben cerrarse con una tecla.

Verifique IP/DNS, hora UTC, confianza/nombre HTTPS/MQTT y puertos 5102/5883. La IP pública del portal es la observada por TMS y puede diferir de las IP locales por NAT/proxy.

5. Telemetría e inventario

El reporte incluye:

• serie del fabricante, marca UIC, familia A10-T y modelo completo;
• versión Linux/firmware, versión xTMSAgent y uptime;
• estado Ethernet/Wi-Fi/celular, IP/MAC de interfaces e IP pública observada;
• almacenamiento libre/total y memoria disponible/total;
• capacidades e inventario de aplicaciones de usuario.

Pagos normalmente reside en ./userappl. El inventario usa cfg/appname.txt como nombre, cfg/version.txt como versión y el ID configurado (normalmente PAYMENT_APP). Archivos faltantes producen ausencia/desconocido, no datos inventados.

A10-T no reporta ubicación actualmente. Un operador con escritura de Dispositivos puede asignarla por dirección, mapa o coordenadas. Si un futuro agente reporta coordenadas válidas, estas prevalecen.

6. MQTT, resultados y puente local

xTMSAgent usa los mismos tópicos MQTTS por dispositivo y descarga HTTPS autenticada que Android. Valida ID, época y vencimiento y registra trabajo antes de efectos. Telemetría/resultados permanecen en outbox hasta recibir confirmación de almacenamiento TMS.

Pagos escribe estado, solicitudes de configuración y reportes mediante archivos puente. Las respuestas se escriben en el archivo de parámetros y bridge/parameters_response.json. El agente revisa bridge/payment_status.json; actualizaciones pueden rechazarse mientras hay transacciones/lote abiertos.

Operaciones: Solicitar estado, Enviar mensaje, Reiniciar, instalar/desinstalar la aplicación firmada A10. Escritorio remoto no está implementado para A10-T.

7. Ciclo del paquete de aplicación

El portal recibe el prodapp.tarball.tar.gz firmado. El archivo externo contiene app.tar.gz y app.tar.gz.sign; el interno contiene appl.out, cfg/version.txt y se recomienda cfg/appname.txt. El portal valida estructura/SHA-256 y conserva bytes exactos. La API de actualización A10 verifica firma e instalación.

Para instalar, xTMSAgent descarga por HTTPS, valida hash, exige estado seguro de pagos y llama os_update_application sobre ./userappl. Encola el resultado verificado y reinicia para activar y reportar inventario nuevo.

Para desinstalar, coordina cierre de pagos, elimina/recrea userappl, reporta ausencia y reinicia. UIC Connect muestra éxito únicamente con evidencia del equipo.

8. Lista de aceptación

• Serie exacta registrada y modelo genérico UIC A10-T.
• F2 Config disponible antes de inscripción; Cancelar no guarda.
• Inscripción modo 0600 y bootstrap eliminado.
• Certificado IoT Aprovisionado y equipo En línea.
• Modelo completo, SO/versión, agente y uptime visibles.
• Almacenamiento y memoria muestran disponible/libre y total.
• IP/MAC de interfaces e IP pública presentes cuando aplica.
• Inventario userappl usa appname/version.
• Solicitar estado y Enviar mensaje completan con resultado almacenado.
• Instalación/desinstalación descartable reinicia y actualiza inventario.

9. Solución de problemas