Leopoldo Rodríguez 23ccda9e78 docs: fuentes KISS + hbox-docs

2026-09-28 20:05:35 -06:00

11 KiB

Raw Permalink Blame History

title

Protocolo de diagnóstico remoto — unidades HBOX retiradas

Tarjeta: unidades de la primera generación con firmware v1 (Blackpill + PowerBoost, jun-2026). El orden de trabajo sigue valiendo para cualquier unidad desmontada.

!!! abstract "Para quién · Cuándo · Tiempo · Necesitas" - Para quién: ingeniería en Querétaro y un técnico «manos remotas» en Veracruz - Cuándo: unidades retiradas de las máquinas que no pueden llegar al banco de inmediato. Hoy el procedimiento vigente es diagnóstico en campo → diagnóstico en banco - Tiempo: nivel 0: 20 min por unidad; nivel 1: +10 min; nivel 2: 1 h por unidad - Necesitas: fuente de banco con límite de corriente, teléfono con cámara, cable USB y laptop (nivel 1), escritorio remoto (nivel 2)

Traducido del original en inglés (19-jun-2026).

Fecha: 2026-06-19 · Responsable: Leo Rodríguez Situación: todas las unidades HBOX fueron retiradas de las máquinas. Hay 4 unidades en mano: 3 no funcionan, 1 funciona a medias. Están físicamente en Veracruz; el equipo está en Querétaro → la depuración es remota hasta que se envíen o alguien en sitio actúe como nuestras manos. Firmware en estas unidades = v1 (sin registro térmico del MCU) → la evidencia térmica tiene que salir de la inspección física + una prueba de energizado en banco, no del firmware.

!!! note "La unidad de control" La única unidad que funciona a medias es el control. Cada medición de abajo debe tomarse también en ella, para que las lecturas «malas» de las unidades muertas tengan una línea base contra la cual comparar.

0. Compuerta de decisión (tomar esta decisión primero)

Recomendación: enviar las 4 unidades a Querétaro. Son pequeñas, y depurar a distancia electrónica muerta es lento y rara vez concluyente — una mensajería de 1–2 días compra acceso completo al banco (fuente con límite de corriente, osciloscopio, u-center, reflasheo, prueba térmica prolongada, desarmado). Traer también la unidad que funciona a medias; es la referencia.

Elegir manos remotas solo si el envío está bloqueado (cadena de custodia del cliente, las unidades deben quedarse en sitio, o el retraso de la mensajería es inaceptable). Confirmar con ICAVE quién es dueño de las unidades y si pueden salir de la terminal.

Camino	Cuándo	Costo
Enviar a QRO (recomendado)	las unidades pueden salir de Veracruz	mensajería + 1–2 días
Manos remotas en Veracruz	las unidades deben quedarse; hay un técnico cooperativo en sitio	necesita el protocolo de abajo + su tiempo

De cualquier forma, empezar §2 (análisis del backend) ahora desde Querétaro — no necesita unidades.

1. Qué se puede y qué no se puede saber a distancia

Pregunta	¿Manos remotas?	Cómo
¿La LiPo está inflada / quemada / con fuga?	✅	checklist de fotos (§3 nivel 0)
¿Conectores/SMA flojos, soldadura agrietada?	✅	fotos + prueba de meneo
¿Consume corriente / arranca al energizar?	✅	lectura de corriente de la fuente de banco (§3)
¿Estado del LED al encender?	✅	grabar el LED, decodificar (§4)
V de batería, calidad de fix, estado, paquetes	✅ (nivel 1)	captura del tablero por USB
¿El módem 4G se registra / obtiene fix?	✅ (niveles 1–2)	tablero / u-center / escritorio remoto
¿Llega a nuestro gateway cuando está energizada?	✅	observar htracker para el `cell_id` de esa unidad
Componente exacto fallado / prueba térmica prolongada	❌ (necesita banco)	enviar a QRO

Así que ~80 % del triaje se puede hacer a distancia; solo la confirmación a nivel de componente y la reproducción térmica requieren estrictamente las unidades en QRO.

2. Hacer esto ahora desde Querétaro (sin unidades)

El backend está en nuestro propio servidor — totalmente depurable desde QRO, y según 02-Architecture-Software/backend-review.md puede sacar de Wialon unidades sanas por sí solo.

Separación histórica online/offline. Para los días antes del retiro, comparar el registro de cada unidad en htracker (online al recibir UDP) contra Wialon (online por posiciones recibidas). Una unidad que estaba online en htracker pero offline en Wialon fue una víctima del backend (bloqueo anti-salto / atasco HOL), no hardware muerto — eso replantea cuáles unidades «muertas» son en realidad fallas de hardware.
Logs del gateway alrededor de la ventana de muerte: buscar el aviso anti-salto (¡Filtro Anti-Salto Activado!) repitiéndose para un cell_id (→ bloqueo), y caídas del buffer de recepción UDP con netstat -su (→ atasco HOL).
Reproducir en banco con la unidad que funciona a medias una vez energizada (en VER por manos remotas, o en QRO): apuntarla al gateway y observar si el retranslator la reenvía limpiamente o dispara el filtro.
Disponibilidad del caster (HelgenSRV) + saldo de datos / suspensión por SIM en la ventana.

Este es el trabajo de mayor apalancamiento que se puede hacer hoy y no necesita a nadie en Veracruz.

3. Protocolo de manos remotas (por niveles según lo que tenga la persona en sitio)

Darle al técnico en sitio el nivel que le corresponda. Las instrucciones listas para enviar están en §6b.

Nivel 0 — energía + cámara de teléfono (mínimo)

Para cada unidad, antes de energizar:

Fotografiar: todo el interior, después acercamientos de la LiPo (¿inflada, abombada, marcas cafés/negras, fugas?), del PowerBoost, de cada conector/Dupont, de las uniones de las antenas SMA y de cualquier componente decolorado/quemado.
Prueba de meneo (suave): ¿algún conector Dupont/terminal/SMA se mueve o se cae?
Energizado en banco con fuente con límite de corriente al voltaje normal de la unidad (12 V o 24 V), límite de corriente ~2 A:
- Leer la corriente de arranque y después la estable. Anotar el número.
- 0 mA / se dispara en 0: circuito abierto / etapa de entrada muerta / fusible fundido.
- Llega al límite de corriente / muy caliente: corto → apagar de inmediato.
- ~50–150 mA estables, nada más: solo el MCU, la etapa no se energiza (interruptor de carga / boost / módem).
- Consumo más o menos normal + actividad del LED: arranca — pasar al nivel 1.
- Comparar cada lectura con la unidad que funciona a medias.
Grabar el LED ~60 s desde el encendido (decodificar en §4).

Nivel 1 — nivel 0 + cable USB + laptop

Conectar el USB del Blackpill a la laptop; abrir PuTTY/TeraTerm a 115200. El watchdog v1 imprime un tablero en vivo. Capturar 3–5 min (grabar a archivo) y enviarlo. Leer: BATTERY V, SYSTEM STATE, RTK FIX, PACKETS TX'd, entradas PWR/IGN. (No hay línea de temperatura del MCU — son v1.)
Anotar si PACKETS TX'd incrementa (GNSS+serie vivos) y si RTK FIX llega alguna vez a 4/5 (correcciones llegando = 4G/NTRIP funcionando).

Nivel 2 — nivel 1 + escritorio remoto (AnyDesk/TeamViewer) a la laptop

Se opera desde QRO: leer el tablero en vivo, correr u-center en el ZED-F9P (fix, niveles de satélites, configuración), enviar comandos AT al módem 4G (registro, señal) y, si es útil, reflashear v2 para obtener registro térmico + mejor recuperación.

4. Decodificación rápida del LED (v1)

LED	Estado	Léelo como
Parpadeo rápido	BOOTING	energizada, esperando 4G/GNSS
Fijo encendido	RUNNING, energía de vehículo, RTK fijo	sana
Latido (1 s)	RUNNING en batería	en LiPo, cadencia de 30 s
Parpadeo lento	buscando / sin correcciones	4G/NTRIP no entrega
Apagado (con energía aplicada)	SLEEP / muerta	lógica de batería crítica o no arranca

«Apagado con energía de una buena fuente de banco» en una unidad que debería arrancar = señal fuerte de no arranque / etapa de potencia — correlacionar con la lectura de corriente.

5. Árbol de decisión de triaje por unidad

Energizar con fuente de banco (con límite de corriente)
├─ 0 mA ............................. entrada muerta / fusible fundido / abierto → enviar a QRO
├─ llega al límite / caliente ....... CORTO (¡apagar!) ......................... → enviar a QRO
└─ consume corriente
   ├─ sin LED, sin tablero USB ....... MCU/arranque muerto ...................... → enviar a QRO
   └─ arranca (LED + tablero)
      ├─ PACKETS no incrementa ....... GNSS/serie muertos ....................... nivel 2 / enviar
      ├─ FIX atorado en 0/1 (nunca 4/5) 4G/NTRIP no entrega ..................... revisar módem/SIM/antena
      └─ FIX 4/5 + paquetes OK ....... EL HARDWARE ESTÁ BIEN .................... → víctima del backend (§2)

La última rama es la importante: una unidad retirada que arranca, obtiene fix y transmite en el banco no es la falla — su desaparición de Wialon es entonces del backend (§2), y reinstalarla sin cambios solo repetiría el problema.

6. Seguridad — LiPo dañada por calor (decírselo al técnico en sitio)

!!! danger "Batería de litio" Una LiPo inflada/abombada o caliente es un riesgo de incendio. No cargarla, no perforarla ni seguir energizando una unidad cuya batería esté visiblemente inflada. Desconectarla, ponerla en una bolsa LiPo-safe / ignífuga o un recipiente metálico, mantenerla lejos de cualquier cosa inflamable y ventilar. Fotografiar primero, después aislar. Si está caliente, venteada o huele: detenerse y aislar de inmediato.

6b. Instrucciones para el técnico en sitio (niveles 0/1) — texto listo para enviar

Para cada unidad: (1) Fotos del interior y de cerca de la batería LiPo (¿inflada, manchas cafés/negras, fuga?), del PowerBoost, de cada conector Dupont, de las antenas SMA, y de cualquier componente quemado/decolorado. (2) Prueba de movimiento suave: ¿algún conector se mueve o se cae? (3) Enciéndela con una fuente de banco a su voltaje normal (12 V/24 V), límite de corriente ~2 A, y anota la corriente (arranque y estable). Si llega al límite o se calienta, apágala de inmediato (corto). (4) Graba el LED ~60 s desde el encendido. (5) Si hay laptop: conecta el USB del Blackpill, abre PuTTY/TeraTerm a 115200 y graba 3–5 min del tablero (BATERÍA V, ESTADO, RTK FIX, PAQUETES). Seguridad: una batería inflada o caliente es riesgo de incendio — no la cargues ni la perfores; aíslala en bolsa/recipiente seguro y ventila.

7. Qué enviar de regreso a Querétaro (checklist de captura)

Por unidad, etiquetado con su cell_id/máquina: las fotos, la lectura de corriente (arranque + estable), el video del LED, la captura del tablero USB de 3–5 min y una nota de una línea (¿arranca? ¿fix? ¿paquetes?). Con eso se pueden clasificar las 4 unidades contra el árbol de §5 y la evidencia del backend de §2 — y decidir cuáles de verdad necesitan desarmado en QRO.

Historial de revisiones

Versión	Fecha	Cambios
1.0	2026-06-19	Protocolo original (inglés).
1.1	2026-09-29	Traducción al español, encabezado uniforme y enlaces a los procedimientos vigentes. Sin cambios técnicos.

11 KiB Raw Permalink Blame History Unescape Escape