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

157 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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](../formularios/diagnostico.html)**
---
## 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](tablero-campo.html)**, 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`.