Drogheda/06-Testing-Validation/2026-09-29_Drogheda_HBOX-V5_Configuracion-de-Unidad_ES_v1.0.md

147 lines
9.1 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.

---
title: "HBOX V5 — Configuración de una unidad"
tags: [project-drogheda, hardware, hbox, v5, v5.6, configuracion, ntrip, ethernet, rs485, rs232, bateria, procedimiento]
project: Project Drogheda
author: Helgen Technologies
date: 2026-09-29
version: 1.3
status: ACTIVO — toda unidad V5.5 / V5.6 antes de embarcar o de reinstalar
audience: técnicos de banco
---
# HBOX V5 — Configuración de una unidad
!!! warning "V5.6 y V5.7: su serigrafía trae otros designadores (T43, 22-oct)"
Este procedimiento usa los designadores de la V5.5 (y de la V4), los que trae su serigrafía. La V5.6 y la V5.7 llegan con los de T43 y varios nombres ahora son **otra pieza**: el USB-C de DFU es **J7** (aquí J11) y el zócalo del módem es **J8/J9** (aquí J7/J8). En una V5.6 o una V5.7, busca cada designador en la tabla de abajo antes de medir o conectar. Las notas marcadas «V5.6» ya van en la numeración nueva.
??? info "Designadores de este documento en la V5.6 y la V5.7 (17)"
| Aquí (V5.5) | V5.6 | V5.7 | Pieza |
|---|---|---|---|
| J7 | **J8** | **J8** | XBEE-ROW-1 (VCC/DOUT/DIN) |
| J8 | **J9** | **J9** | XBEE-ROW-2 |
| J9 | **J13** | **J13** | USB-C |
| J11 | **J7** | **J7** | USB-C DFU |
| JP2 | **JP3** | **JP3** | F2:LFP (2-3) (en la V5.5: F2:Li-ion) |
| JP5 | **JP6** | **JP6** | RS485_TERM |
| K1 | **K1** | **K1** | G5V-1 DC5 |
| MOD1 | **MOD1** | **MOD1** | simpleRTK2B-Pro on UNO female headers |
| P4 | **J5** | **J5** | BATT-1S4P+NTC |
| P11 | **J2** | **J2** | CUTOFF-SW |
| P15 | **J11** | **J11** | RS485_OUT |
| P16 | **J12** | **J12** | RS232_OUT |
| SW4G1 | **SW3** | **SW3** | RESET |
| U3 | **U6** | **U6** | SHT40-AD1B |
| U4 | **U12** | **U12** | TMP102 |
| U10 | **U5** | **U5** | SC16IS752IPW |
| U13 | **U11** | **U11** | PCF8574 |
!!! abstract "Para quién · Cuándo · Tiempo · Necesitas"
- Para quién: técnicos de banco.
- Cuándo: unidad V5.5/V5.6 que pasó la [prueba final](v5-prueba-final-unidad.md), antes de embarcar o de reinstalar. Paso 5 de producción, antes del [checklist de puesta en marcha](v5-checklist-puesta-en-marcha.md).
- Tiempo: 30–40 min por unidad, más la espera de RTK FIX.
- Necesitas: laptop con terminal serie a 115200 grabando, 2 cables USB-C con datos, 24 V o arnés GX16 real, [plantilla 4G](../descargas/4G_NTRIP_HelgenSRV-NMEA.example.txt) y el `.local.txt` de ingeniería, configuración F9P, antena GNSS con cielo, 2 antenas LTE, SIM Telcel; si aplica, cable Ethernet y adaptadores USB-RS485 / USB-RS232. Registro: [acta de ensamble](../formularios/ensamble.html) y, si aplica, [acta Ethernet y serie](../formularios/ethernet-serie.html).
Una unidad está configurada cuando cumple las siete filas:
| # | Elemento | Configurado cuando | § |
|---|---|---|---|
| 1 | Módem 4G | Parámetros cargados (APN, caster, mountpoint, ID de estación) y registrado en Telcel | 1 |
| 2 | simpleRTK2B (ZED-F9P) | Configuración Helgen en flash; RTK FIX (`fix=4`) con cielo | 2 |
| 3 | Identidad | Aparece en el monitor como `H00xx` con posición y Salud | 3 |
| 4 | Ethernet (si lo lleva) | Enlace y espejo TCP probados con el build de banco `0.6.1-eth` | 4 |
| 5 | Puertos serie (si los lleva) | `[PASS] SC16IS752` y niveles correctos en P15/P16 | 4 |
| 6 | Paquete de batería | Química = JP2; `ltc=CARGANDO` | 5 |
| 7 | Firmware y consola | Versión vigente y `STAT` limpio | 6 |
## 1. Módem 4G — parámetros
Las claves `$$$AS+…` y la plantilla están en [Descargas](../descargas/index.md#parametros-del-modem-4g-ntrip-master). Los valores reales (caster y APN) los entrega ingeniería para esta unidad; no se guardan ni se reenvían. `AS+K` (ID de estación) es el `H00xx` de la unidad (§3).
1. Módem suelto (antes del ensamble): se carga sobre el simpleRTK2B por el USB XBEE ([módulos §2b](v5-modulos-integracion.md#2b-montaje-y-configuracion)).
2. Unidad ensamblada (módem en J7/J8): terminal en J9 a 115200 (J9 va al USB del módem, `USB_DP/DM` → J7 pines 7/8 según netlist V5.6); mismo procedimiento. <!-- VERIFICAR: que el módem enumere por J9 con la etapa encendida y acepte $$$AS+ por ese puerto; hasta hoy solo se ha configurado por el USB XBEE del simpleRTK2B -->
3. Al terminar, `$$$AS+I=1111` y lee `AS+K`; anótalo en el acta.
4. Retira el cable de J9: con cable, la laptop alimenta el módem y las pruebas de batería y de reset del módem no valen.
- [ ] Todas las líneas contestaron `OK`.
- [ ] Módem registrado en Telcel (LED lento o fijo) en < 2 min.
- [ ] `AS+K` anotado.
## 2. simpleRTK2B — RTK FIX
1. El módulo trae la configuración Helgen de su acta. Si llegó sin acta, cárgala ([módulos §1c](v5-modulos-integracion.md#1c-configuracion-helgen)).
2. Consola del HBOX (J11, 115200), etapa encendida (`stack=ON`): `n` muestra 20 s de `$GNGGA` con `fix=` y `sats=`.
3. Con cielo y módem registrado, espera `fix=4` (típico 1–5 min, máximo 10). `STAT`: `gga=RTK_FIX sats≥10 hdop<1.5`; LED RGB verde.
| `fix=` | Significado | Se embarca |
|---|---|---|
| 0 | Sin fix | No |
| 1 | GPS autónomo (sin correcciones) | No |
| 5 | RTK FLOAT | No, salvo cielo malo documentado |
| 4 | RTK FIX | Sí |
- [ ] `fix=4` estable 5 min; tiempo y satélites anotados.
## 3. Identidad `H00xx`
La identidad en el monitor (monitor.helgen.dev, htracker) sale del módem: el NTRIP Master envía `$GPTXT` con el ID de `AS+K` en el tercer campo y el servidor lo toma como `H00xx`. <!-- VERIFICAR: confirmar con Leo que AS+K se captura literalmente como H00xx (retranslator: parse_gptxt → parts[2]) --> El `H00xx` cambia si se cambia el módem, no la tarjeta. El `$PHID` que manda el espejo Ethernet (UID, fw, tarjeta, MAC) todavía no lo usa el monitor.
1. Con 24 V, etapa ON y módem registrado, en ≤ 2 min el monitor muestra `H00xx` con posición a 1 Hz y Salud (fw, `vbat`, temperaturas, `v5min`).
2. Consola: `modoB=ON relay=… phlg_aire=…` sube de 1 en 1 cada 30 s.
- [ ] `H00xx` visible con Salud y anotado en el acta y en la etiqueta interior (`HBOX5-Exx-Axxx-Rxxxx · H00xx`).
## 4. Ethernet y puertos serie (solo si el panel los lleva)
Prueba, defaults de red, pines de P15/P16 y regla de JP5: [Prueba de Ethernet y puertos serie](v5-prueba-ethernet-serie.md). No hay build de campo con Ethernet: la IP y el servidor son banderas de compilación y el monitor no escucha el espejo.
- [ ] Ethernet probado y registrado, o "no aplica: panel sin RJ45".
- [ ] `[PASS] SC16IS752` en el POST; JP5 abierto/cerrado según la instalación, anotado.
## 5. Batería
Química y JP2: [ensamble §2](v5-ensamble.md#2-tarjeta-sin-energia).
Con 24 V, etapa ON y > 150 s tras el arranque: `STAT … carga=PROVING` → `carga=ON … ltc=CARGANDO`, y el monitor muestra 🔌 CARGANDO. `vbat` sube en la siguiente media hora. Detalle del gobernador: [Descargas](../descargas/index.md).
- [ ] Química = JP2, ambas anotadas.
- [ ] `ltc=CARGANDO` visto.
## 6. Consola final
24 V + ignición, etapa ON ≥ 5 min, cielo, batería conectada. Teclea `s` y lee `STAT`:
| Campo | Debe decir | Si no |
|---|---|---|
| Encabezado (tras reset) | `hbox-v5-bringup` con la versión vigente de [Descargas](../descargas/index.md) | Reflashea |
| `v5=` | `5.2x–5.3x(ok)`, nunca `BAJO` ni `no` | SD-15B a ~5.3 V; arnés |
| `v5min=` | ≥ 4.9 | El riel cae con la ráfaga LTE: fuente / SD-15B |
| `vbat=` | Li-ion 3.6–4.1 · LFP 3.2–3.5 <!-- VERIFICAR: rango LFP con firmware para V5.6 --> | Paquete / P4 |
| `chrg=` · `ltc=` · `carga=` | `chg` · `CARGANDO` · `ON` (tras ~150 s) | §5 |
| `flt=` | `none` | `FAULT`: LTC4040 / NTC del paquete |
| `tair=` / `rh=` · `tbat=` · `tmcu=` | Plausibles (< 45 °C en banco), no `n/d` | I²C: U3 / U4 |
| `i2cerr=` | `0` | Soldadura U3 / U4 / U13 / U10 |
| `stack=` · `modo=` | `ON` · `AUTO` | `MAN`: teclea `A` |
| `gga=` · `sats=` | `RTK_FIX` · ≥ 10 | §2 |
| `modoB=` · `phlg_aire=` | `ON` · sube cada 30 s | K1 / módem |
| `rtcm_age=` | Pocos segundos (no `rtcm=none`) | No llegan correcciones: §1 |
| `modem=` | `vivo` (tras 2 min de gracia) | `SOSPECHOSO`: módem oscuro; SW4G1 y revisa |
| `rec=` | `0`, sin `LIMP` | NMEA intermitente: MOD1 / UART1 |
| `eth=` (solo `-eth`) | `CONECTADO ip=…` con cable; `off` sin 5 V | §4 |
V5.6: su firmware (`MODEM_EN`, `tchg`, `tcell`, `tmodem`) aún no existe; hasta entonces se prueba con el binario V5 vigente y esos campos no aparecen. <!-- VERIFICAR: versión y nombre del binario V5.6 cuando se publique -->
- [ ] `STAT` limpio y encabezado de versión pegados en el acta.
- [ ] Etiquetas exterior e interior con `HBOX5-Exx-Axxx-Rxxxx` y `H00xx`.
- [ ] P11 en OFF para almacenar o embarcar.
## Historial de revisiones
| Versión | Fecha | Cambios |
|---|---|---|
| 1.0 | 2026-09-29 | Primera versión: define "unidad configurada" para V5.5/V5.6. |
| 1.1 | 2026-09-29 | Edición breve. Parámetros del módem → Descargas; Ethernet/serie y JP5 → prueba de Ethernet y serie; química/JP2 → ensamble §2; tabla de firmware → Descargas. |
| 1.2 | 2026-09-29 | Ethernet con el build de banco 0.6.1-eth. |
| 1.3 | 2026-10-22 | Aviso y tabla de equivalencias para la V5.6 y la V5.7, que traen los designadores de T43 (22-oct). El cuerpo conserva la numeración de la V5.5. |
Versiones anteriores en git.