hbox-docs/docs/diagnostico/procedimiento-diagnostico-campo.md

Diagnóstico de unidades HBOX en campo — procedimiento

Para: técnicos de campo (Alan, Daniel) · Versión: 1.0 · 18-sep-2026 · Responsable: Leo Rodríguez

El acta se llena en el teléfono, en la máquina: ▶ Abrir el acta de diagnóstico en campo

---

1. Qué se espera de ti (y qué no)

No se espera que encuentres la causa de la falla. Eso se determina en el banco de Querétaro, con instrumentos que no existen en el patio.

Lo que sí depende de ti, y que nadie más puede hacer, es traer la evidencia completa del estado en que estaba la unidad. Esa es toda tu misión, y es más valiosa de lo que parece:

!!! danger "La regla que más se rompe y más caro sale" Una unidad reiniciada antes de leerla ya no se puede diagnosticar. El HBOX guarda en su memoria la temperatura máxima que ha alcanzado, cuántas veces se ha tenido que recuperar y por qué arrancó la última vez. Todo eso se borra al cortarle la corriente. Si llegas y lo primero que haces es desconectarlo "a ver si así revive", destruiste el único dato que explicaba la falla — y la unidad vuelve a fallar dentro de un mes sin que sepamos por qué.

Por eso el procedimiento dice: **no cortes la energía hasta terminar el paso 5.**

2. Qué llevar

Herramienta	Para qué	¿Obligatoria?
Teléfono con cámara y datos	El acta y las fotos	Sí
Multímetro	Decidir si la falla es del gabinete o del HBOX	Sí
Laptop + cable USB (micro-USB)	La captura serial: el dato más valioso de la visita	Muy recomendada
Desarmadores / llave del gabinete	Abrir	Sí
Etiquetas y plumón	Marcar la unidad que se desmonta	Sí
Bolsa antiestática	Transportar la unidad desmontada	Sí
Termómetro infrarrojo	Medir la temperatura interior del gabinete	Deseable — cuesta poco y mide la hipótesis térmica

3. Seguridad

1. Nunca trabajes sobre un RTG o equipo energizado sin el permiso y el bloqueo (LOTO) del terminal. Si el equipo está operando, no subas: agenda con el supervisor de ICAVE.
2. Batería de litio. Hinchada, caliente o con olor: no sigas desarmando, no la perfores, sepárala de la electrónica, foto y aviso el mismo día. Una batería hinchada no viaja en avión.
3. No abras el gabinete bajo lluvia ni si está mojado por fuera.
4. El gabinete puede tener 24 V: no es peligroso para la vida, pero un corto sí puede quemar la tarjeta. Mide con la máquina apagada siempre que puedas.

4. Los pasos, en orden

Paso	Qué haces	Por qué importa
1	Anotas por qué vienes y qué dijo el operador	La hora en que dejó de reportar acota la causa
2	Fotos con el gabinete cerrado: máquina, gabinete, antenas	Sol, altura, antena floja o robada se ven aquí
3	Cuentas los destellos del LED en 10 segundos	Es el diagnóstico gratis que la unidad te está dando
4	Abres, hueles, tocas, revisas la batería	Calor y agua dejan rastro visible
5	Captura por USB a 115200 baudios, 3 minutos	Saca la memoria de la unidad antes de perderla
6	Ahora sí puedes cortar la energía y probar	Ya está toda la evidencia guardada
7	Clasificas, decides cómo queda y firmas	Convierte tu visita en un dato comparable

5. Tabla del LED — qué te está diciendo la unidad

Mira el LED 10 segundos con el reloj y cuenta cuántas veces prende. No lo estimes: 5 destellos y 10 destellos en 10 segundos significan cosas opuestas.

Lo que ves	Destellos en 10 s	Estado interno	Qué significa
Apagado, nunca prende	0	sin energía o MCU muerto	No le llega corriente, o el HBOX ya no enciende. El multímetro decide cuál.
Fijo encendido	—	RUN + vehículo + enlace OK	La unidad está sana. Si no la ves en el sistema, el problema está en el servidor.
Destello muy cortito cada 4 s	~2, muy breves	SLEEP	Se durmió por batería baja. Lleva tiempo sin corriente de la máquina.
Prende 1 s / apaga 1 s (latido)	5	RUN sin energía de vehículo	El HBOX vive pero está en su batería: la máquina no le da 24 V. La falla está aguas arriba.
Parpadeo parejo 1 por segundo	10	RUN + enlace degradado	Las correcciones llegan a ratos. Antenas, señal, SIM.
Dos destellos juntos y pausa	~7	RUN + enlace en las últimas	Prácticamente sin correcciones.
Parpadeo rápido continuo	no se cuentan	arrancando o reiniciándose	Puede estar reiniciándose en bucle. Solo la captura USB lo confirma.

6. Medidas esperadas

Con la punta negra en el chasis/negativo del gabinete:

Dónde mides	Esperado	Si sale mal
Entrada de la máquina al gabinete	12 V o 24 V según el equipo	La máquina no está alimentando el gabinete
Salida de la fuente Mean Well	23 – 26 V	Fuente muerta o entrada ausente
GX16 pines 1-2 (lo que le llega al HBOX)	23 – 26 V	Esta es la medida clave — ver abajo
GX16 pin 3 (ignición), máquina encendida	12 – 24 V	Señal de ignición perdida

!!! tip "La medida que parte el diagnóstico en dos" Hay 24 V en el GX16 y el LED sigue apagado → la falla es del HBOX → se desmonta y se envía. No hay 24 V en el GX16 → la falla es del gabinete o de la máquina (breaker, fusible, fuente, cable) → el HBOX probablemente está sano; no lo desmontes.

7. La captura por USB

Es el paso que más nos sirve y el que más se salta. Vale la pena cargar la laptop.

1. Conecta el USB del Blackpill a la laptop.
2. Abre el puerto serie nuevo a 115200 baudios (PuTTY, TeraTerm o el monitor de Arduino).
3. Activa "guardar a archivo" (log to file).
4. Déjalo correr 3 minutos.
5. Presiona RESET y graba también el arranque.
6. Guarda el archivo con el nombre de la unidad.

Verás líneas así:

BOOT,1240,fw=3.0.3,reset=WDG
TLM,182000,RUN,DEGR,1,11,4210,1HZ,3.92,5.02,1,1,58,81,0,3,1,900,44,38,57,…

Los cuatro campos que debes anotar aunque no puedas copiar la línea completa:

Campo	Qué es	Por qué importa
tmax	La temperatura máxima que ha visto la unidad	Confirma o descarta la hipótesis térmica de un plumazo
rec	Cuántas veces se ha tenido que recuperar sola	Un número alto = falla intermitente, no muerte súbita
vbat	Voltaje de la batería	Diferencia "batería agotada" de "batería dañada"
veh	1 = le llega corriente de la máquina, 0 = no	Resuelve solo la mitad de los casos

Y de la línea BOOT, el campo reset= dice por qué arrancó la última vez (corte de energía, watchdog, brownout). Es la causa de muerte escrita por la propia unidad.

8. Catálogo de clasificaciones

Elige lo que observaste, no lo que supones. No está claro es una respuesta válida y útil; inventar una causa nos hace perder semanas.

Clasificación	Qué la sustenta	Qué pasa después
Sin corriente desde la máquina o el gabinete	0 V en el GX16	Se corrige en sitio (breaker, fusible, cable)
El HBOX no enciende aunque le llega 24 V	24 V en el GX16 + LED apagado	Desmontar y enviar a QRO
Enlace 4G: no hay datos ni correcciones	LED 1 Hz o doble destello	Se revisa SIM, antenas y servidor antes de tocar hardware
Antena suelta, rota o faltante	Foto del conector	Se corrige en sitio
Batería dañada	Hinchada, caliente o con fuga	Aislar hoy; no enviar por avión
Daño por calor	Quemado, derretido, decolorado	Evidencia directa para el rediseño térmico
Agua adentro del gabinete	Encharcado o empañado	Se revisa sellado y prensaestopas
Daño mecánico o golpe	Foto	Se revisa el montaje
La unidad se ve sana — parece el servidor	LED fijo y captura sana	No desmontar. Ingeniería revisa el backend
No está claro — se necesita banco	Todo lo demás	Desmontar y enviar

9. Qué pasa cuando envías el acta

1. Queda guardada en el servidor con tu nombre, la hora y las fotos.
2. Aparece en el tablero de campo, que ingeniería revisa en Querétaro.
3. La siguiente persona que abra el acta de esa unidad verá tu visita antes de empezar.

Puedes llenar el acta sin señal: se guarda sola en el teléfono. Las fotos y el envío necesitan datos — si falla, vuelve a intentar desde el mismo formulario cuando tengas señal, no vuelvas a empezar.

!!! note "Para ingeniería" Cada visita es un registro independiente (ACTAS_REPETIBLES), no se bloquea por serie. Las fotos se guardan en /srv/projects/drogheda/adjuntos/diagnostico-campo/<serie>/. El índice por tipo está en /srv/projects/drogheda/actas/diagnostico-campo/_indice.csv.