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](../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. Antes de ir — permiso de acceso y de qué máquina hablamos

Dos cosas tienen que estar resueltas **antes** de salir. Sin ellas la visita no se hace.

### 2.1 De qué máquina estamos hablando

En ICAVE nadie conoce el equipo por el número del HBOX: lo conocen por la **máquina**
(`FL-JUN-060`, `RT-ZPMC-20`, `HS-WES-62`). El permiso se pide por máquina, el operador te
lleva a una máquina y el acta se cruza por máquina.

Las tres unidades v3 desplegadas y en qué máquina va cada una:

| Máquina (como la nombra ICAVE) | Equipo | Unidad HBOX | Estado hoy |
|---|---|---|---|
| `FL-JUN-060` | Montacargas | **RTK-014** | **Instalada.** Dejó de reportar el 17-sep. Nadie la ha tocado — evidencia intacta |
| `RT-ZPMC-20` | RTG | **RTK-003** | Desmontada, en el escritorio del taller |
| `HS-WES-62` | Tractoplana | **RTK-006** | Desmontada, en el escritorio del taller |

Solo `FL-JUN-060` necesita permiso de acceso: las otras dos ya están en el taller y se revisan en banco.

!!! warning "No confundir los números"
    Estas unidades de campo son **`RTK-006`** (tres dígitos). Los módems 4G del HBOX v5 son
    **`RTK-0006`** (cuatro dígitos) y viven en otra acta. Son cosas distintas.

Por eso, antes de pedir el acceso hay que **saber en qué máquina está montada la unidad** que
queremos revisar. Si el registro no lo dice o hay duda, se confirma con ICAVE en el mismo correo.
Y si al llegar la unidad resulta estar en **otra** máquina de la que dice la lista, eso se anota
en el acta: el registro estaba mal y hay que corregirlo.

### 2.2 El correo de solicitud de acceso

Lo manda **Operaciones (Adriana)** al contacto de ICAVE, con copia a Agustín Alfonseca,
Leon David Piña, Leo y los técnicos que van a subir. Modelo:

> **Asunto:** Solicitud de acceso a la unidad `FL-JUN-060` — revisión de equipo HBOX
>
> Estimado **[nombre]**:
>
> Buen día.
>
> Por medio del presente, solicito de tu apoyo para que se nos proporcione acceso a la unidad
> **`FL-JUN-060`**, con la finalidad de realizar una revisión del equipo HBOX instalado en dicha unidad.
>
> La actividad será llevada a cabo por los técnicos **Alán Basurto y Daniel Martínez**, quienes
> realizarán las verificaciones correspondientes para asegurar el correcto funcionamiento del sistema.
>
> Quedamos atentos a tus comentarios y al apoyo para coordinar el acceso en el horario que mejor
> se adapte a la operación.
>
> Muchas gracias. Saludos cordiales.

Lo único que cambia entre visitas es **el número de la unidad** y, si aplica, **los nombres de
los técnicos**. Una máquina por correo: mezclar dos en el mismo correo enreda la autorización.

### 2.3 La regla

| Situación | ¿Se sube a la máquina? |
|---|---|
| Correo contestado y horario acordado | **Sí**, con la máquina detenida y bloqueada (LOTO) |
| Autorización de palabra del supervisor en sitio | Sí, pero se anota quién autorizó y a qué hora |
| Sin respuesta al correo | **No.** Se revisa desde el piso lo que se alcance y se reagenda |
| La unidad ya está desmontada, en el taller | No aplica: no hay máquina de por medio |

Una revisión incompleta se repite la semana que entra. Un accidente en un patio de maniobras, no.

## 3. 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 |

## 4. 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.

## 5. Los pasos, en orden

| Paso | Qué haces | Por qué importa |
|---|---|---|
| **0** | **Permiso de acceso a la máquina** y confirmar en cuál está montada | Sin autorización no hay visita; sin máquina no hay permiso |
| 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 |

## 6. 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.** |

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

## 8. 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.

## 9. 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 |

## 10. 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`.