Helgen-Services/hbox-docs
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

descargas: 0.6.1 retirada (su $PHLG no pasa por el módem), 0.6.0 vigente otra vez; notas de versión

Browse Source
This commit is contained in:
Leopoldo Rodríguez 2026-09-29 14:25:05 -06:00
parent 999010818b
commit 71c825b992
20 changed files with 103 additions and 79 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/descargas/SHA256SUMS.txt
View File

@ -1,6 +1,6 @@
a68a87ff1f6b34a8284e9e5e32c95da7bb8d8adc071c5fd64412a3e744e46b28 hbox-tarjetaV3_4.0.0.bin
ef43a901ae9a875e6346ae8f84cc5f150a2419ff7cd577fe8f69780236840757 hbox-tarjetaV4_0.6.1.bin
6fbbc583ac2415a742ed062c1208d4a807e61085eb2615d76e4c6da400961ad2 hbox-v5-bringup_0.6.1.bin
1458470bbdd95b490969976402bf2144a773a991b7650c55e3281687ba77b2e3 hbox-tarjetaV4_0.6.0.bin
8a0ee4839763eae8c96e990eb471dae30f0a491bfb9bd81fdfb39ee69436790a hbox-v5-bringup_0.6.0.bin
035ebeb348461765f099341603a9e99b94512f8477509efb78aa7caf953f4c2f superseded/hbox-tarjetaV3_3.0.4.bin
4528187f9d675bca8114583d44eccf4d2149d847f7e5fc402631d8811ee39282 superseded/hbox-tarjetaV4_0.5.1.bin
fa2b7554099b332c70ab18cde24b30a4f0a46ac01987466e491c69b308783a5a superseded/hbox-tarjetaV4_0.5.2.bin
@ -11,7 +11,7 @@ c96041aea04b1e6500ec45b558bdfcf5db94d102666a71f1b3c9d2364e40572a superseded/hbo
5c8726da662cd047d83740a5afee92974e5e941c5dd294769cd3508d81723217 superseded/hbox-tarjetaV4_0.5.7.bin
2e04b65f8ef1636d76f070e49e050c5d7ff6f60620eebaa452ec26baf9e9e7ab superseded/hbox-tarjetaV4_0.5.8.bin
582969957a1d67ce80e9e7a603dd66af4fcffeb82930f9e508fd360d6a289f9c superseded/hbox-tarjetaV4_0.5.9.bin
1458470bbdd95b490969976402bf2144a773a991b7650c55e3281687ba77b2e3 superseded/hbox-tarjetaV4_0.6.0.bin
ef43a901ae9a875e6346ae8f84cc5f150a2419ff7cd577fe8f69780236840757 superseded/hbox-tarjetaV4_0.6.1.bin
a8de74b3d7768e9d5656ae0bff05475445c0cd2599ecfdc4ab081e517ed3d6ef superseded/hbox-v5-bringup_0.4.0.bin
e1f351084e803306c376989b284ca0f9f9f1a3445e59494f8a5ff7a9652ad44c superseded/hbox-v5-bringup_0.5.1.bin
a9b0d6c1c640ebc9a132236ca465cad04e8eed99962b7dc6024b6ee8b765d2d6 superseded/hbox-v5-bringup_0.5.2.bin
@ -22,4 +22,4 @@ aed644c28fc3a098eedda55c7b4c2108b8ca9afcf0763b9bf85a7a2e1b4dd715 superseded/hbo
1acd5f46ddb76f1423d5a0550a2a827b4e04d4a0223b0999cb574302e4e61696 superseded/hbox-v5-bringup_0.5.7.bin
5b0cbf271711c72d10a795b4c1f96f97bc520cc50c8a24c2188e95fb33005760 superseded/hbox-v5-bringup_0.5.8.bin
98b12de64339ed34c45b59e48139d57304281e1041d11564c741407b960150e0 superseded/hbox-v5-bringup_0.5.9.bin
8a0ee4839763eae8c96e990eb471dae30f0a491bfb9bd81fdfb39ee69436790a superseded/hbox-v5-bringup_0.6.0.bin
6fbbc583ac2415a742ed062c1208d4a807e61085eb2615d76e4c6da400961ad2 superseded/hbox-v5-bringup_0.6.1.bin

0
docs/descargas/superseded/hbox-tarjetaV4_0.6.0.bin → docs/descargas/hbox-tarjetaV4_0.6.0.bin
View File

0
docs/descargas/superseded/hbox-v5-bringup_0.6.0.bin → docs/descargas/hbox-v5-bringup_0.6.0.bin
View File

24
docs/descargas/index.md
View File

@ -36,10 +36,13 @@ Un binario por tarjeta. El nombre lleva la tarjeta y eso manda; el número de ve
| Tarjeta | MCU | Código fuente | Binario vigente | Estado |
|---|---|---|---|---|
| V3 — EinarBoard 1.0, 3 unidades en campo ([manual](../manuales/manual-tarjeta-V3.md)) | Blackpill en zócalo (F411CE) | `blackpillrtkcode_v4` (4.0.0) | [`hbox-tarjetaV3_4.0.0.bin`](hbox-tarjetaV3_4.0.0.bin) · 64 352 B · `a68a87ff…` | Compilado 19-sep, sin prueba de banco |
| V4 — `hbox-watchdog-v4` ([manual](../manuales/manual-tarjeta-V4.md)) | Blackpill + PCF8574 · W5500 · SC16IS752 | `hbox_v5_bringup` + `board_v4.h` (`-DHBOX_BOARD_V4`) | [`hbox-tarjetaV4_0.6.1.bin`](hbox-tarjetaV4_0.6.1.bin) · 93 096 B · `ef43a901ae9a875e…` | Compilado 28-sep, sin prueba de banco (primero H0027). DFU solo con USB; puente U13-P7 → SW4G1 opcional ([procedimiento V4](../procedimientos/v4-prueba-fw-0.5.6.md)) |
| V5 — `hbox-watchdog-v5`, lote de 15 ([manual](../manuales/manual-tarjeta-V5.md)) | STM32F411RET6 soldado | `hbox_v5_bringup` (0.6.1) | [`hbox-v5-bringup_0.6.1.bin`](hbox-v5-bringup_0.6.1.bin) · 93 584 B · `6fbbc583ac2415a7…` | Vigente desde 29-sep, sin prueba de banco (primero H0008). Uso: [prueba y flasheo §5](../procedimientos/v5-prueba-y-flasheo.md) y [ensamble §5](../procedimientos/v5-ensamble.md) |
| V4 — `hbox-watchdog-v4` ([manual](../manuales/manual-tarjeta-V4.md)) | Blackpill + PCF8574 · W5500 · SC16IS752 | `hbox_v5_bringup` + `board_v4.h` (`-DHBOX_BOARD_V4`) | [`hbox-tarjetaV4_0.6.0.bin`](hbox-tarjetaV4_0.6.0.bin) · 88 556 B · `1458470bbdd95b49…` | Vigente otra vez desde el 29-sep: 0.6.1 se retiró ([por qué](notas-de-version.md#por-que-se-retiro-061)). DFU solo con USB; puente U13-P7 → SW4G1 opcional ([procedimiento V4](../procedimientos/v4-prueba-fw-0.5.6.md)) |
| V5 — `hbox-watchdog-v5`, lote de 15 ([manual](../manuales/manual-tarjeta-V5.md)) | STM32F411RET6 soldado | `hbox_v5_bringup` (0.6.0) | [`hbox-v5-bringup_0.6.0.bin`](hbox-v5-bringup_0.6.0.bin) · 89 028 B · `8a0ee4839763eae8…` | Vigente otra vez desde el 29-sep: 0.6.1 se retiró. Uso: [prueba y flasheo §5](../procedimientos/v5-prueba-y-flasheo.md) y [ensamble §5](../procedimientos/v5-ensamble.md) |
0.6.1 CAMPO (V4 y V5): cargador con gobernador (hasta 0.5.9 estaba apagado, paquete de un solo uso) que desde 0.6.1 ya no corta la carga por las ráfagas del módem; `$PHLG` de 36 campos. En batería la etapa y el módem siguen encendidos y reportando igual que en 24 V (la V5.5 no arranca el módem en frío sobre el boost, ver [módem en batería](../procedimientos/prueba-bateria-modem.md#3-hallazgos-2527-sep)); ningún ciclo de etapa en batería; corte a 3.40 V; reset del MCU al volver el 5 V tras ≥ 10 s de respaldo; vigilancia del módem solo diagnóstica (`modem=` en `STAT`); teclas `C`/`M`/`R`. 0.5.1 fue la última embarcada antes de 0.6.0. Qué cambió en cada versión y por qué: **[notas de versión](notas-de-version.md)**.
0.6.0 CAMPO (V4 y V5): cargador con gobernador (hasta 0.5.9 estaba apagado, paquete de un solo uso); en batería la etapa y el módem siguen encendidos y reportando igual que en 24 V (la V5.5 no arranca el módem en frío sobre el boost, ver [módem en batería](../procedimientos/prueba-bateria-modem.md#3-hallazgos-2527-sep)); ningún ciclo de etapa en batería; corte a 3.40 V; reset del MCU al volver el 5 V tras ≥ 10 s de respaldo; vigilancia del módem solo diagnóstica (`modem=` en `STAT`); teclas `C`/`M`/`R`. 0.5.1 fue la última embarcada antes de 0.6.0. Qué cambió en cada versión y por qué: **[notas de versión](notas-de-version.md)**.
!!! danger "0.6.1 retirada (29-sep): no la flashees"
Su `$PHLG` de 36 campos (125–131 caracteres) no pasa por el módem 4G NTRIP Master, que descarta las líneas largas: el monitor se queda sin Salud ni Energía (batería, carga, temperaturas). El gobernador de 0.6.1 sí funcionaba. 0.6.2 lleva el mismo gobernador, el `$PHLG` de siempre (29 campos) y el estado del gobernador en una sentencia corta aparte; se publica después de probarla en H0027. Detalle: [notas de versión](notas-de-version.md#por-que-se-retiro-061).
!!! warning "No se cruzan"
- `hbox-v5-bringup_…` (F411RE soldado) en una V3 o V4: otro MCU y otro mapa de pines. La V4 usa `hbox-tarjetaV4_…`.
@ -47,7 +50,7 @@ Un binario por tarjeta. El nombre lleva la tarjeta y eso manda; el número de ve
- Nada de `superseded/`: se guarda solo por trazabilidad.
- Nada que no esté publicado aquí con su SHA-256. Los `.bin` de V3 y V4 no viven en el repositorio; se compilan, se prueban en banco y se publican ([reflasheo §5](../procedimientos/reflasheo-unidades.md#5-para-ingenieria-generar-y-publicar-un-binario)).
Las tres tarjetas mandan la misma trama: `$PHLG` cada 30 s y un `$PHEV` por cambio de estado, en banda por el módem (Modo B). V3 4.0.0 y V4/V5 hasta 0.6.0: 29 campos; V4/V5 0.6.1: 36 (los mismos 29 + 7 del gobernador de carga, al final). El monitor los parsea igual (`retranslator.py`: 20 campos base + 4 de v3 + 5 de 0.5.1 + 7 de 0.6.1, y `$PHEV`) y las tres se ven igual en Salud; un servidor sin el parser de 0.6.1 ignora los 7 campos nuevos.
Las tres tarjetas mandan la misma trama: `$PHLG` de 29 campos cada 30 s y un `$PHEV` por cambio de estado, en banda por el módem (Modo B). El monitor la parsea igual (`retranslator.py`: 20 campos base + 4 de v3 + 5 de 0.5.1, y `$PHEV`) y las tres se ven igual en Salud. Ninguna línea en banda puede pasar de lo que deja pasar el módem: hasta 105 caracteres está probado; las de 125 o más (el `$PHLG` de 0.6.1) se pierden.
!!! warning "V3 4.0.0: todavía no en unidades de campo"
Compila y pasa el simulador, pero no ha corrido en una EinarBoard 1.0 real. Solo en la mesa de ingeniería hasta que se pruebe en banco (RTK-003 o RTK-006) y se quite este aviso. 4.0.0 activa Modo B por omisión (el MCU queda en línea con el enlace de correcciones), así que la primera prueba es en par: el binario publicado y uno sin Modo B sobre la misma unidad. Si el fix RTK cae al energizar K1, o `v5min` se hunde en ese instante, sospecha de la bobina de K1 llevando el riel al PFI del LTC4040.
@ -61,7 +64,7 @@ Las tres tarjetas mandan la misma trama: `$PHLG` cada 30 s y un `$PHEV` por camb
No se podía encender el cargador sin más: en V5.5/V4 `RS1` 8 mΩ → límite de entrada del LTC4040 ≈ 3.1 A (más que los 3 A del SD-15B) y `R50` 825 Ω → 2.4 A de carga; paquete vacío + etapa + ráfaga LTE hunden el riel hasta el PFI del LTC4040 y la unidad entra en bucle (incidente de flota 10-ago). H0008 amaneció a 3.50 V tras una noche en batería y seguía "sin cargar" en 24 V.
El gobernador (0.6.1) carga solo con etapa ON en 24 V; nunca en los primeros 120 s tras boot ni tras cada STACK ON; arranca tras 30 s con la media del riel ≥ 5.05 V; corta si una muestra baja de 4.70 V (DURO) o si la media de 200 ms queda bajo 4.90 V durante 1 s o baja de 4.85 V (SOSTENIDO), con enfriamiento de 60 s a 30 min; quitar el 24 V no cuenta como corte; inhibe con celda ≥ 45 °C; rearma el safety timer del LTC4040 solo entre 3.00 y 3.80 V y nunca con FALLA. En fuente débil carga por ciclos: más lento, pero el módem nunca paga. Eventos `CHG_ON/CHG_SHED/CHG_OFF/CHG_RAIL/CHG_FAULT/CHG_HOT/CHG_COOL/CHG_PULSE`; `STAT` → `carga=FASE … ltc=CARGANDO|no cortes= media= duty= cargado= caida= vdda=`; tecla `C` = veto. En el monitor, columna Energía: la fase del gobernador (espera de arranque, comprobando riel, espera tras corte…), 🔌 CARGANDO, «cargó N %» y «casi lleno». `PHLG_FW` = `0.6.1`. Prueba de banco: [módem en batería §1](../procedimientos/prueba-bateria-modem.md#1-cargador-061). Si corta sin parar: ruta de 5 V débil hasta P2 ([regla](notas-de-version.md#el-limite-de-la-ruta-de-5-v)) o fuente sin margen de corriente (el SD-15B da 3 A; carga + etapa piden ~2.8 A). La V5.6 (`RS1` 10 mΩ, `R50` 1.5 kΩ) pide mucho menos. Qué hacía 0.6.0 y por qué se cambió: [notas de versión](notas-de-version.md).
El gobernador de 0.6.0 (vigente) carga solo con etapa ON en 24 V; nunca en los primeros 120 s tras boot ni tras cada STACK ON; arranca tras 30 s de riel ≥ 5.05 V; corta al instante si una muestra baja de 4.90 V, con enfriamiento de 60 s a 30 min; inhibe con celda ≥ 45 °C; rearma el safety timer del LTC4040. Con la ruta de 5 V justa (riel cerca de 5.0 V al cargar) cualquier ráfaga del módem corta la carga: la batería carga poco y el monitor casi nunca muestra 🔌 CARGANDO. Eventos `CHG_ON/CHG_SHED/CHG_OFF/CHG_HOT/CHG_COOL/CHG_PULSE`; `STAT` → `carga=FASE … ltc=CARGANDO|no cortes=`; tecla `C` = veto. El monitor muestra 🔌 CARGANDO solo con `chg=1` en `$PHLG`. 0.6.2 (en preparación) corrige los cortes y manda el estado del gobernador al monitor ([notas de versión](notas-de-version.md)); su prueba de banco: [módem en batería §1](../procedimientos/prueba-bateria-modem.md#1-cargador-062). Si corta sin parar: ruta de 5 V débil hasta P2 ([regla](notas-de-version.md#el-limite-de-la-ruta-de-5-v)) o fuente sin margen de corriente (el SD-15B da 3 A; carga + etapa piden ~2.8 A). La V5.6 (`RS1` 10 mΩ, `R50` 1.5 kΩ) pide mucho menos.
### Monitor con builds de ciclo
@ -76,10 +79,10 @@ Cotejada pad por pad (`hbox-watchdog-v4.kicad_pcb` contra `board_v5.h`): mismas
DFU por J11 (mantén SW2, pulsa y suelta SW1, suelta SW2):
```bash
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.6.1.bin
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.6.0.bin
```
o STM32CubeProgrammer → USB → Connect → Download en `0x08000000`. Tarjetas con cualquier versión anterior se reflashean igual. Al arrancar, la consola imprime la versión (`hbox-v5-bringup 0.6.1 built …`); si `STAT` no trae `stack=`, la tarjeta sigue con 0.1.1.
o STM32CubeProgrammer → USB → Connect → Download en `0x08000000`. Tarjetas con cualquier versión anterior se reflashean igual. Al arrancar, la consola imprime la versión (`hbox-v5-bringup 0.6.0 built …`); si `STAT` no trae `stack=`, la tarjeta sigue con 0.1.1.
Consola: `EVT` en cada cambio (etapa, ignición, 5 V, cargador, NMEA, fix), `STAT` cada 5 s y `$PHLG` cada 10 s. `l` = leyenda, `v` = puntos de medición de la etapa RTK, `P` y luego `Y` = encender la etapa (requiere 5 V en P2).
@ -92,7 +95,7 @@ No se flashean. Sirven para identificar lo que trae una tarjeta vieja o para vol
| Archivo | Por qué se retiró |
|---|---|
| [`superseded/hbox-tarjetaV3_3.0.4.bin`](superseded/hbox-tarjetaV3_3.0.4.bin) | Lógica de campo (3.0.3) sin telemetría en banda: el monitor no ve Salud. Sustituida por 4.0.0. |
| [`superseded/hbox-v5-bringup_0.6.0.bin`](superseded/hbox-v5-bringup_0.6.0.bin) · [`superseded/hbox-tarjetaV4_0.6.0.bin`](superseded/hbox-tarjetaV4_0.6.0.bin) | Con la ruta de 5 V justa (riel cerca de 5.0 V al cargar) el gobernador cortaba la carga en cada ráfaga del módem, porque bastaba una muestra bajo 4.90 V: la batería casi no cargaba y el monitor casi nunca mostraba 🔌 CARGANDO. Sustituida por 0.6.1 ([notas de versión](notas-de-version.md)). |
| [`superseded/hbox-v5-bringup_0.6.1.bin`](superseded/hbox-v5-bringup_0.6.1.bin) · [`superseded/hbox-tarjetaV4_0.6.1.bin`](superseded/hbox-tarjetaV4_0.6.1.bin) | No usar. Su `$PHLG` de 36 campos no pasa por el módem: el monitor pierde Salud y Energía. El gobernador corregido vuelve en 0.6.2 ([notas de versión](notas-de-version.md#por-que-se-retiro-061)). |
| [`superseded/hbox-v5-bringup_0.5.9.bin`](superseded/hbox-v5-bringup_0.5.9.bin) · [`superseded/hbox-tarjetaV4_0.5.9.bin`](superseded/hbox-tarjetaV4_0.5.9.bin) | Sin cargador (paquete de un solo uso). 0.6.0 añade el gobernador y nada más. |
| [`superseded/hbox-v5-bringup_0.5.8.bin`](superseded/hbox-v5-bringup_0.5.8.bin) · [`superseded/hbox-tarjetaV4_0.5.8.bin`](superseded/hbox-tarjetaV4_0.5.8.bin) | No usar. Recovery activo en batería: el silencio del ahorro provocaba "RTK perdido" y, probablemente, un ciclo de etapa que dejaba el módem oscuro hasta un reset (noche 26/27-sep). |
| [`superseded/hbox-v5-bringup_0.5.7.bin`](superseded/hbox-v5-bringup_0.5.7.bin) · [`superseded/hbox-tarjetaV4_0.5.7.bin`](superseded/hbox-tarjetaV4_0.5.7.bin) | Despertar de batería por reset del MCU: en banco no enciende el módem en batería (brown-out del boost); solo servía al volver el 5 V. |
@ -106,8 +109,8 @@ No se flashean. Sirven para identificar lo que trae una tarjeta vieja o para vol
??? note "Historial por versión, 0.4.0 → 0.6.1"
- Desde 0.4.0: AUTO de fábrica (la etapa RTK enciende sola 3 s después de ver 5 V en P2); watchdog 16 s; ventilador (política v3.0.3); recuperación de enlace (ciclo de etapa si el F9P calla 60 s; LIMP tras 3 ciclos); LEDs de carga y color de estado; corte térmico 60 °C; corte de batería 3.40 V. Anota la versión en el acta.
- 0.6.1 CAMPO: 0.6.0 con el gobernador corregido: sin cortes por las ráfagas del módem, quitar el 24 V no cuenta como corte, prueba de la ruta de 5 V (`CHG_RAIL`), ADC calibrado con VREFINT; `$PHLG` de 36 campos. Detalle: [notas de versión](notas-de-version.md).
- 0.6.0 CAMPO (retirada): 0.5.9 + gobernador de carga; con la ruta de 5 V justa cortaba la carga en cada ráfaga del módem.
- 0.6.1 (retirada el 29-sep): gobernador corregido, pero con un `$PHLG` de 36 campos que el módem descarta; el monitor se quedaba sin Salud. Ese gobernador vuelve en 0.6.2. [Notas de versión](notas-de-version.md#por-que-se-retiro-061).
- 0.6.0 CAMPO (vigente): 0.5.9 + gobernador de carga; con la ruta de 5 V justa corta la carga en cada ráfaga del módem (lo corrige 0.6.2).
- 0.5.9 CAMPO: sin ciclo ni ahorro en batería (`ENABLE_DUTY 0`, `ENABLE_BATT_SAVER 0`); ningún ciclo de etapa en batería (`RECOVERY_ABORT`); reset del MCU al volver el 5 V tras ≥ 10 s; un reset en batería deja la etapa apagada hasta que vuelva el 5 V; vigilancia del módem: `STAT` con `rtcm_age= sta= rtcm_last= sag5= sagb= flat= modem=vivo|SOSPECHOSO|?`, eventos `MODEM_DARK`/`MODEM_BACK`/`MODEM_WATCH`. Con esos números se calibra 0.5.10.
- 0.5.8 CAMPO (retirada): nunca apaga el módem en batería (un módem ya encendido aguanta el paso de 24 V a batería); ráfaga de posición de ~8 s cada 10 min y `$PHLG` cada 3 min (`SAVER_ON`, `DUTY_SLEEP`/`DUTY_WAKE`, `ahorro=`); autonomía estimada ~30–35 h; recovery aún activo en batería.
- 0.5.7: cada despertar de batería (≥ 10 min tras la última ventana) y cada regreso del 5 V es un reset del MCU (`NVIC_SystemReset`, igual que P10): arranque en ~4 s; se pierden uptime y contadores. Tecla `R`. Un reset por SW1/P10 en batería abre ventana en 60 s y `P` se acepta en batería con vbat ≥ 3.60 V.
@ -166,5 +169,6 @@ Lista y comandos: [reflasheo §5](../procedimientos/reflasheo-unidades.md#5-para
| 1.8 | 2026-09-29 | Historial por versión en cajas plegables; enlaces a manuales. |
| 1.9 | 2026-09-29 | Edición breve. Una sola tabla de binarios vigentes; verificación SHA-256 con encabezado propio; tabla de parámetros del módem completa (antes en la configuración de la unidad); lista de publicación → reflasheo §5. |
| 2.0 | 2026-09-29 | Firmware 0.6.1 vigente en V4 y V5; 0.6.0 a `superseded/`; `$PHLG` de 36 campos; gobernador 0.6.1; [notas de versión](notas-de-version.md). |
| 2.1 | 2026-09-29 | 0.6.1 retirada (su `$PHLG` no pasa por el módem): 0.6.0 vigente otra vez; 0.6.2 en preparación. |
Versiones anteriores en git.

43
docs/descargas/notas-de-version.md
View File

@ -11,24 +11,34 @@ version: "1.0"
Un solo código fuente (`hbox_v5_bringup`) para las dos tarjetas: la V5 usa `hbox-v5-bringup_X.Y.Z.bin` y la V4 `hbox-tarjetaV4_X.Y.Z.bin`. La V3 tiene firmware propio (4.0.0) y no entra aquí. Binarios, SHA-256 y reglas de flasheo: [Descargas](index.md).
!!! abstract "Las tres versiones en una línea"
!!! abstract "Las versiones en una línea"
- **0.5.9**: en batería no se apaga ni cicla la etapa, pero **no carga**. La batería es de un solo uso.
- **0.6.0**: **carga**, con un gobernador que protege al módem. Pero con la ruta de 5 V justa cortaba la carga en cada ráfaga del módem, y el monitor casi nunca mostraba 🔌 CARGANDO.
- **0.6.1**: el gobernador distingue una ráfaga del módem de una fuente que no aguanta. El monitor ve en qué fase está el gobernador y las cargas cortas.
- **0.6.1** (retirada al día siguiente): el gobernador distingue una ráfaga del módem de una fuente que no aguanta. Pero su `$PHLG` era demasiado largo para el módem y el monitor se quedó sin Salud ni Energía.
- **0.6.2** (en preparación): el gobernador de 0.6.1 con el `$PHLG` de siempre y el estado del gobernador en una sentencia corta aparte.
## Estado al 29-sep-2026
| Versión | Fecha | Estado | Binarios |
|---|---|---|---|
| **0.6.1** | 28-sep | Vigente. **Sin prueba de banco todavía**: primero H0027 (V4) y H0008 (V5.5), después campo | [V5](hbox-v5-bringup_0.6.1.bin) · [V4](hbox-tarjetaV4_0.6.1.bin) |
| 0.6.0 | 27-sep | Retirada. Carga, pero con cortes; una unidad con 0.6.0 se reflashea a 0.6.1 | [V5](superseded/hbox-v5-bringup_0.6.0.bin) · [V4](superseded/hbox-tarjetaV4_0.6.0.bin) |
| 0.6.2 | — | En preparación: se publica después de probarla en H0027 | — |
| 0.6.1 | 28-sep | **Retirada el 29-sep: no flashear.** Su telemetría no llega al monitor ([por qué](#por-que-se-retiro-061)) | [V5](superseded/hbox-v5-bringup_0.6.1.bin) · [V4](superseded/hbox-tarjetaV4_0.6.1.bin) |
| **0.6.0** | 27-sep | **Vigente otra vez.** Carga, pero con la ruta de 5 V justa se corta con las ráfagas del módem | [V5](hbox-v5-bringup_0.6.0.bin) · [V4](hbox-tarjetaV4_0.6.0.bin) |
| 0.5.9 | 27-sep | Retirada. No carga | [V5](superseded/hbox-v5-bringup_0.5.9.bin) · [V4](superseded/hbox-tarjetaV4_0.5.9.bin) |
El servidor ya está listo para 0.6.1: htracker `4f11886`, desplegado el 29-sep, lee los 36 campos del `$PHLG`. Un servidor anterior ignora los 7 campos nuevos y muestra la unidad como si tuviera 0.6.0.
## Por qué se retiró 0.6.1
El módem 4G NTRIP Master reenvía al monitor solo líneas NMEA completas hasta cierto largo y descarta, sin aviso, las más largas. El `$PHLG` de 0.6.0 mide 99–107 caracteres y pasa. El de 0.6.1, con sus 7 campos nuevos, mide 125–131 y no llega nunca.
Lo confirmó el banco del 29-sep con H0027 en 0.6.1. La consola mostraba el `$PHLG` saliendo cada 30 s (`phlg_aire` subía). En el historial crudo del servidor llegaron todas las sentencias del GPS y los `$PHEV` cortos, pero ningún `$PHLG`, ni siquiera cortado. H0018, con 0.6.0 y el mismo modelo de módem, entregaba su `$PHLG` de 102–105 caracteres cada 30 s. El servidor no tiene límite de largo.
Consecuencia: una unidad con 0.6.1 manda posición y eventos, pero el monitor no ve batería, carga ni temperaturas. El gobernador en sí funcionaba bien (carga continua, sin cortes, aviso de ruta de 5 V débil).
0.6.2 vuelve al `$PHLG` de 29 campos de 0.6.0 y manda el estado del gobernador en una sentencia corta aparte, de unos 40–55 caracteres. El servidor la une a la salud de la unidad. Además trae una prueba desde la consola para medir el largo máximo que deja pasar el módem.
## Comparación rápida
| | 0.5.9 | 0.6.0 | 0.6.1 |
| | 0.5.9 | 0.6.0 | 0.6.1 → 0.6.2 |
|---|---|---|---|
| Cargador (LTC4040) | Apagado por firmware (`CHRG_EN` alto) | Encendido por un gobernador | Gobernador corregido |
| Cuándo arranca la carga | Nunca | 24 V + etapa ON, ≥ 120 s tras el arranque y tras cada STACK ON, riel ≥ 5.05 V durante 30 s | Igual, midiendo la media del riel en 200 ms |
@ -37,13 +47,15 @@ El servidor ya está listo para 0.6.1: htracker `4f11886`, desplegado el 29-sep,
| Espera tras un corte | — | 60 s, se duplica en cada corte, tope 30 min | Igual, pero solo por cortes contados |
| Pulso de rearranque del LTC4040 | — | vbat < 3.90 V, 1 cada 30 min | Solo entre 3.00 y 3.80 V, nunca con FALLA del cargador |
| PFI que supone el firmware | — | 4.60 V (el de la V3) | 4.40 V (el real de V4 / V5.5) |
| `$PHLG` | 29 campos, `0.5.9-fm` | 29 campos, `0.6.0` | 36 campos, `0.6.1` |
| Monitor, columna Energía | «cargador OFF (fw)» | 🔌 CARGANDO solo si la muestra de cada 30 s cae cargando; si no, «sin cargar» (o ✅ CARGADA con ≥ 3.97 V y 5 V del vehículo) | Fase del gobernador («espera de arranque 2:30», «corte por riel»…), «cargó N %», «casi lleno», ✅ CARGADA |
| `$PHLG` | 29 campos, `0.5.9-fm` | 29 campos, `0.6.0` | 0.6.1: 36 campos (el módem los descarta). 0.6.2: 29 campos + sentencia corta del gobernador |
| Monitor, columna Energía | «cargador OFF (fw)» | 🔌 CARGANDO solo si la muestra de cada 30 s cae cargando; si no, «sin cargar» (o ✅ CARGADA con ≥ 3.97 V y 5 V del vehículo) | 0.6.1: nada (no llega el `$PHLG`). 0.6.2: fase del gobernador («espera de arranque 2:30», «corte por riel»…), «cargó N %», «casi lleno», ✅ CARGADA |
| En batería | Etapa y módem encendidos, sin ciclos de etapa; corte a 3.40 V | Igual | Igual |
| Al volver el 24 V tras ≥ 10 s en batería | Reset del MCU | Igual | Igual |
| Build de banco con Ethernet | `0.6.0-eth` (sin cargador) | `0.6.0-eth` (con gobernador) | `0.6.1-eth` (ya no repite el DHCP cada 5 s) |
## 0.6.1: el gobernador ya no corta la carga por las ráfagas del módem (28-sep)
## 0.6.1 → 0.6.2: el gobernador ya no corta la carga por las ráfagas del módem
0.6.1 salió el 28-sep y se retiró el 29-sep por la telemetría ([arriba](#por-que-se-retiro-061)). 0.6.2 lleva exactamente este gobernador; lo único que cambia es cómo viajan sus datos al monitor.
### Qué pasaba con 0.6.0
@ -56,8 +68,8 @@ El monitor lee `CHRG_STAT` (campo 22 del `$PHLG`) una vez cada 30 s y casi nunca
- **Corte en dos niveles.** DURO: una muestra rápida bajo **4.70 V**, que es la fuente colapsando (sobrecarga, hiccup); se corta en esa misma muestra, todavía 0.3 V sobre el PFI. SOSTENIDO: la **media de 200 ms** bajo **4.90 V durante 1 s seguido**, o una sola media bajo **4.85 V**; eso es la fuente o el cable sin fuerza para la carga. Las ráfagas del módem ya no cortan, ni solas ni cuando una ventana de 200 ms junta varias. La prueba de 30 s antes de arrancar (≥ 5.05 V) usa la misma media.
- **PFI real: 4.40 V.** En V4 y V5.5 el LTC4040 pasa el consumo de la tarjeta al paquete (boost) cuando el riel baja de 4.40 V (R51 270 k / R52 100 k), no en los 4.60 V de la V3 que suponía 0.6.0 (`BOARD_PFI_FALL_V` en `board_v4.h` / `board_v5.h`).
- **Quitar el 24 V no cuenta como corte.** Un corte solo cuenta si 3 s después sigue habiendo 5 V. Si no, sale `CHG_OFF BATT` y la espera no se duplica. Una fuente que se cae y vuelve en menos de 3 s sí cuenta: no sostuvo la carga.
- **Prueba de la ruta de 5 V (`CHG_RAIL`).** 5 s después de cada arranque de la carga el firmware mide cuánto bajó el riel. Lo esperado es menos de 0.10 V; más de 0.15 V es una ruta de 5 V débil hasta P2 (cable, conector o fuente). Sale como evento, en `STAT caida=` y en el `$PHLG` (`cdrop`).
- **Siete campos nuevos al final del `$PHLG` (30–36)**, para que el monitor vea el gobernador y las cargas cortas entre dos reportes:
- **Prueba de la ruta de 5 V (`CHG_RAIL`).** 5 s después de cada arranque de la carga el firmware mide cuánto bajó el riel. Lo esperado es menos de 0.10 V; más de 0.15 V es una ruta de 5 V débil hasta P2 (cable, conector o fuente). Sale como evento, en `STAT caida=` y en los datos del gobernador (`cdrop`).
- **Siete datos nuevos del gobernador**, para que el monitor vea su fase y las cargas cortas entre dos reportes. En 0.6.1 iban al final del `$PHLG` (campos 30–36), y por eso el módem lo descartaba; en 0.6.2 van en una sentencia corta aparte:
| Campo | Nombre | Qué es |
|---|---|---|
@ -127,14 +139,14 @@ Con más resistencia, los cortes SOSTENIDOS empiezan antes de ese punto, cuando
### Cómo se probó y qué falta
- Simulador en PC (`tools/hostsim_v5` del repositorio de firmware): compila el sketch sin cambios contra un modelo eléctrico de la entrada de 5 V calibrado con H0027 y revisa 21 escenarios, con un invariante de seguridad del cargador en cada vuelta del lazo. 0.6.0 reproduce el síntoma: 6 cortes y 0 % del tiempo cargando en 40 min. 0.6.1: 0 cortes, 100 %. También cubre desconexión, hiccup, caída sostenida, batería mala, pausa NTC, veto, autoprueba `r`, ciclo de etapa, vuelta del reloj y VDDA de 3.25 V.
- **Falta la prueba de banco** ([módem en batería §1](../procedimientos/prueba-bateria-modem.md#1-cargador-061), vale también para la V4): H0027 30 min cargando sin cortes con el paquete bajo 3.5 V, quitar el 24 V ~5 s y volver a ponerlo, bajar la fuente a ~4.85 V en P2, y una noche con H0027 a 5.40 V y H0008 en 24 V. Las dos deben amanecer en «casi lleno» o ✅ CARGADA, sin cortes nuevos durante la noche.
- **La prueba de banco se hace con 0.6.2** ([módem en batería §1](../procedimientos/prueba-bateria-modem.md#1-cargador-062), vale también para la V4). Primero, que el monitor muestre la fase del gobernador; después: H0027 30 min cargando sin cortes con el paquete bajo 3.5 V, quitar el 24 V ~5 s y volver a ponerlo, bajar la fuente a ~4.85 V en P2, y una noche con H0027 a 5.40 V y H0008 en 24 V. Las dos deben amanecer en «casi lleno» o ✅ CARGADA, sin cortes nuevos durante la noche.
### Archivos
### Archivos de 0.6.1 (retirados, no usar)
| Archivo | Tarjeta | Tamaño | SHA-256 |
|---|---|---|---|
| [`hbox-v5-bringup_0.6.1.bin`](hbox-v5-bringup_0.6.1.bin) | V5.5 (V5.6 solo con paquete Li-ion) | 93 584 B | `6fbbc583ac2415a742ed062c1208d4a807e61085eb2615d76e4c6da400961ad2` |
| [`hbox-tarjetaV4_0.6.1.bin`](hbox-tarjetaV4_0.6.1.bin) | V4 | 93 096 B | `ef43a901ae9a875e6346ae8f84cc5f150a2419ff7cd577fe8f69780236840757` |
| [`superseded/hbox-v5-bringup_0.6.1.bin`](superseded/hbox-v5-bringup_0.6.1.bin) | V5.5 (V5.6 solo con paquete Li-ion) | 93 584 B | `6fbbc583ac2415a742ed062c1208d4a807e61085eb2615d76e4c6da400961ad2` |
| [`superseded/hbox-tarjetaV4_0.6.1.bin`](superseded/hbox-tarjetaV4_0.6.1.bin) | V4 | 93 096 B | `ef43a901ae9a875e6346ae8f84cc5f150a2419ff7cd577fe8f69780236840757` |
Compilados del commit `708ee0a` del repositorio de firmware (arduino-cli 1.3.1, STM32duino 3.0.0). Detalle técnico: `CHANGELOG.md` del firmware, sección 0.6.1. Los umbrales de batería son de Li-ion (flotación 4.00 V, corte 3.40 V, LEDs, monitor). Una V5.6 con el paquete LFP-HT necesita un build propio con flotación 3.50 V y esos umbrales recalculados; la [ECO V5.6](../hardware/v56-eco.md) lo prevé como 0.7.0.
@ -205,3 +217,4 @@ Detalle de cada versión anterior: [Descargas → versiones superadas](index.md#
| Versión | Fecha | Cambios |
|---|---|---|
| 1.0 | 2026-09-29 | Primera versión: 0.5.9, 0.6.0 y 0.6.1. |
| 1.1 | 2026-09-29 | 0.6.1 retirada: su `$PHLG` no pasa por el módem. 0.6.0 vigente otra vez; 0.6.2 en preparación. |

0
docs/descargas/hbox-tarjetaV4_0.6.1.bin → docs/descargas/superseded/hbox-tarjetaV4_0.6.1.bin
View File

0
docs/descargas/hbox-v5-bringup_0.6.1.bin → docs/descargas/superseded/hbox-v5-bringup_0.6.1.bin
View File

4
docs/formularios/ethernet-serie.html
View File

@ -27,7 +27,7 @@ Acta.render({
subtitulo: 'V5.5 / V5.6. Procedimiento: Taller → Ethernet y puertos serie.',
textoOK: 'PRUEBA COMPLETA',
intro: 'W5500 (J10) y SC16IS752 con RS-485 (P15) y RS-232 (P16). Ethernet solo con el build de banco <code>0.6.1-eth</code>; lazo y eco serie solo con un build posterior (0.6.1 no los trae). '
+ '<b>Reglas:</b> nunca Ethernet en batería o solo por USB · 5 V ≥ 5.2 V · al terminar, de vuelta a <code>0.6.1</code> de campo. '
+ '<b>Reglas:</b> nunca Ethernet en batería o solo por USB · 5 V ≥ 5.2 V · al terminar, de vuelta al binario de campo vigente (<code>0.6.0</code>). '
+ 'Laptop en 192.168.7.1/24 con <code>nc -lk 5010</code>; consola HBOX (J11, 115200) grabando a archivo; teclas <code>s</code> STAT · <code>E</code> Ethernet on/off.',
secciones: [
@ -90,7 +90,7 @@ Acta.render({
items: [
{ tipo:'archivo', clave:'log', req:true, etiqueta:'eth-serie-consola', txt:'Log completo de consola' },
{ tipo:'foto', clave:'f_banco', etiqueta:'banco', txt:'Banco: J10, clemas y JP5.' },
{ tipo:'check', clave:'reflash', txt:'De vuelta a <code>hbox-v5-bringup_0.6.1.bin</code>, anotado en el acta de reflasheo.' },
{ tipo:'check', clave:'reflash', txt:'De vuelta al binario V5 vigente de Descargas (<code>hbox-v5-bringup_0.6.0.bin</code>), anotado en el acta de reflasheo.' },
{ tipo:'radio', clave:'accion', req:true, guardaEn:'accion', txt:'Resultado',
opciones:['APROBADA — Ethernet y serie OK','APROBADA — solo Ethernet (serie no aplica / pendiente build con lazo)','APROBADA — solo serie','FALLA Ethernet','FALLA serie','FALLA ambos'] },
{ tipo:'texto', clave:'observaciones', rows:'4', txt:'Observaciones', ph:'síntoma, punto del árbol de fallas, valores fuera de rango' },

16
docs/formularios/v4.html
View File

@ -48,11 +48,11 @@ Acta.render({
tecnicoDesdeUsuario: true,
nombres: { alan: 'Alán Basurto', daniel: 'Daniel Martínez', leo: 'Leo Rodríguez', jesus: 'Jesús' },
etiquetaSerie: 'Tarjeta V4',
titulo: 'Acta de prueba — EinarBoard V4 con firmware 0.6.1',
titulo: 'Acta de prueba — EinarBoard V4 con firmware 0.6.0',
subtitulo: 'Un acta por tarjeta (V4-01 … V4-15) · ~1 h',
textoOK: 'APROBADA',
intro: 'Llénala mientras avanzas por el procedimiento '
+ '<a href="../procedimientos/v4-prueba-fw-0.5.6/">V4 — preparación y prueba con 0.6.1</a>. '
+ '<a href="../procedimientos/v4-prueba-fw-0.5.6/">V4 — preparación y prueba con 0.6.0</a>. '
+ 'Graba la consola desde el primer minuto; al final se sube completa. '
+ 'Si una etapa no pasa, marca «me detengo»: lo que sigue se oculta, llenas el Cierre y envías como <b>FALLA</b>. '
+ 'Sin número de serie: el siguiente V4 libre del <a href="../tablero.html">tablero</a>. La serie PRUEBA sirve para practicar.',
@ -123,23 +123,23 @@ Acta.render({
opciones:['Completa — sigo al flasheo', PASO_NO] },
] },
{ titulo: '4 · Flasheo de 0.6.1', si: prepOK,
{ titulo: '4 · Flasheo de 0.6.0', si: prepOK,
sub: 'Sin 24 V, batería desconectada, cable normal en la Blackpill. '
+ 'DFU: mantén BOOT0, pulsa y suelta NRST, suelta BOOT0 → STM32 BOOTLOADER (0483:DF11). '
+ '<code>dfu-util -a 0 -s 0x08000000:leave -D hbox-tarjetaV4_0.6.1.bin</code>',
+ '<code>dfu-util -a 0 -s 0x08000000:leave -D hbox-tarjetaV4_0.6.0.bin</code>',
items: [
{ tipo:'check', clave:'s3_00_sha', req:true,
txt:'<code>hbox-tarjetaV4_0.6.1.bin</code> de Descargas (no el de V5); SHA-256 empieza con <code>ef43a901</code> y termina con <code>36840757</code>.' },
txt:'<code>hbox-tarjetaV4_0.6.0.bin</code> de Descargas (no el de V5 ni el 0.6.1 retirado); SHA-256 empieza con <code>1458470b</code> y termina con <code>ba77b2e3</code>.' },
{ tipo:'radio', clave:'s3_01_dfu', req:true, txt:'Dónde se flasheó',
opciones:['En la tarjeta','Fuera del zócalo (en la tarjeta no apareció STM32 BOOTLOADER)','No logré flashear'] },
{ tipo:'check', clave:'s3_02_orient', req:true, si: v => empieza(v, 's3_01_dfu', 'Fuera'),
txt:'Reinsertada sin energía: USB-C del lado de E-CSn; B12 en E-CSn y R en NRST.' },
{ tipo:'texto', clave:'s3_03_fw', rows:'1', req:true, si: flasheada, txt:'Firmware (línea BOOT o banner)',
ph:'hbox-v5-bringup 0.6.1 built …' },
ph:'hbox-v5-bringup 0.6.0 built …' },
{ tipo:'check', clave:'s3_04_board', req:true, si: flasheada,
txt:'Segunda línea: <code>board=EinarBoard v4 (HBOX v4)</code> (si dice v5, binario equivocado: reflashea).' },
{ tipo:'radio', clave:'s3_05_tests', req:true, si: flasheada,
txt:'Final de los tests de arranque (r los repite; t imprime <code>$PHLG,0.6.1,</code>)',
txt:'Final de los tests de arranque (r los repite; t imprime <code>$PHLG,0.6.0,</code>)',
opciones:['>>> BOARD OK','>>> BOARD CHECK FAILED'] },
{ tipo:'texto', clave:'s3_06_fails', rows:'3', req:true, si: v => flasheada(v) && v.s3_05_tests === '>>> BOARD CHECK FAILED',
txt:'Líneas [FAIL] completas', ph:'[FAIL] …' },
@ -169,7 +169,7 @@ Acta.render({
{ tipo:'radio', clave:'s4_04_modem', req:true,
txt:'Módem registrado y UART del simpleRTK2B en parpadeo rápido',
opciones:['Sí','No'] },
{ tipo:'radio', clave:'s4_05_monitor', req:true, txt:'Monitor: unidad con 0.6.1 y ⚡',
{ tipo:'radio', clave:'s4_05_monitor', req:true, txt:'Monitor: unidad con 0.6.0 y ⚡',
opciones:['Sí','No'] },
{ tipo:'check', clave:'s4_06_sin_usb', req:true,
txt:'Todo con el cable sin 5 V y sin USB en el simpleRTK2B ni en J9.' },

13
docs/hardware/v56-datasheet.md
View File

@ -2,7 +2,7 @@
title: "EinarBoard V5.6 (HBOX V5) — Hoja de datos de ingeniería"
project: Project Drogheda
date: 2026-09-29
version: "1.1"
version: "1.2"
status: BORRADOR para revisión de ingeniería — V5.6 con ECO aplicada en esquemático; PCB pendiente de *Update PCB*
tags: [project-drogheda, hardware, einarboard, v5.6, datasheet, hbox]
author: Helgen Technologies
@ -33,7 +33,7 @@ V5.6 = V5.5 (15 pzas, JLC 22-ago-2026) + ECO 27/28-sep: riel del módem en `SYS5
| Proyecto KiCad | `03-Architecture-Hardware/kicad/hbox-watchdog-v5.*` (V5.5 y V5.6 comparten proyecto; V5.6 = ECO aplicada al esquemático el 28-sep; PCB pendiente de *Update PCB from Schematic*; etiqueta git `v5.5-as-fabbed` guarda el estado del lote anterior) | Informe de cambios §9 |
| MCU | U16 **STM32F411RET6** LQFP-64 soldado (ya no hay Blackpill en zócalo) · HSE Y3 25 MHz · LSE Y4 32.768 kHz · SYSCLK 96 MHz, USB 48 MHz | `board_v5.h`, `.ino` |
| Módulos en zócalo | **MOD1** simpleRTK2B (u-blox ZED-F9P, formato UNO) · **J7/J8** 4G NTRIP Master (formato XBee, paso 2.00 mm) | netlist |
| Firmware | `hbox_v5_bringup` **0.6.1** (`hbox-v5-bringup_0.6.1.bin`), consola USB CDC en J11. Umbrales de batería de Li-ion (flotación 4.00 V, corte 3.40 V, LEDs, monitor): con el paquete LFP-HT hace falta un build propio con flotación 3.50 V y esos umbrales recalculados (0.7.0 en la ECO, §H) | `README.md` |
| Firmware | `hbox_v5_bringup` **0.6.0** vigente (`hbox-v5-bringup_0.6.0.bin`; 0.6.1 retirada, 0.6.2 en preparación), consola USB CDC en J11. Umbrales de batería de Li-ion (flotación 4.00 V, corte 3.40 V, LEDs, monitor): con el paquete LFP-HT hace falta un build propio con flotación 3.50 V y esos umbrales recalculados (0.7.0 en la ECO, §H) | `README.md` |
| Lote V5.5 | 15 pzas, JLCPCB 22-ago-2026 | FACTS / procedimiento v5 |
| Lote V5.6 | Por pedir (semana del 29-sep-2026); BOM 94 LCSC comprobados para 30 tarjetas | Informe §10 |
| Componentes / nets | 252 componentes · 237 nets en la netlist V5.6 | netlist |
@ -255,13 +255,13 @@ Pinout completo pin a pin (generado de la netlist): [Pinout de arneses y conecto
| USB J11 / J9 | 5 V | — | 5.5 V; ESD PESD5V0S1BA (J11) / USBLC6-2SC6 (J9) | netlist |
| Bus RS-485 | — | — | Terminación 120 Ω opcional (JP5); SP3485 ±7 V modo común (datasheet) | netlist |
## 9. Interfaz de firmware (`hbox_v5_bringup` 0.6.1)
## 9. Interfaz de firmware (`hbox_v5_bringup` 0.6.x)
| Ítem | Valor |
|---|---|
| Consola | USB CDC en **J11**, 115200 (el baud no importa en CDC), líneas CR+LF. Primera línea: `hbox-v5-bringup 0.6.1 built …`, luego `board=EinarBoard v5 (HBOX v5)` |
| Consola | USB CDC en **J11**, 115200 (el baud no importa en CDC), líneas CR+LF. Primera línea: `hbox-v5-bringup 0.6.x built …`, luego `board=EinarBoard v5 (HBOX v5)` |
| Compilación | `arduino-cli` STM32duino 3.x, FQBN `GenF4:pnum=GENERIC_F411RETX,usb=CDCgen,xserial=generic,rtlib=nanofp`, `-DHSE_VALUE=25000000UL`; variante Ethernet de banco `-DENABLE_ETH=1` (0.6.1-eth); `-DENABLE_CHARGE=0` = cargador siempre OFF (0.5.x) |
| Flasheo | DFU por J11: SW2 pulsado → SW1 pulsar/soltar → soltar SW2 → `dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.6.1.bin` (o STM32CubeProgrammer, USB, `0x08000000`) |
| Flasheo | DFU por J11: SW2 pulsado → SW1 pulsar/soltar → soltar SW2 → `dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.6.0.bin` (o STM32CubeProgrammer, USB, `0x08000000`) |
| Modo por defecto | **AUTO** (flash byte `0x5A` = MANUAL): la etapa se enciende sola 3 s después de haber 5 V en P2; respaldo continuo en batería; reset del MCU al volver el 5 V tras ≥ 10 s de respaldo |
| Watchdog | IWDG 16 s |
@ -296,7 +296,7 @@ Pinout completo pin a pin (generado de la netlist): [Pinout de arneses y conecto
`STAT up= vbat= v5=(ok|BAJO|no) ign= chrg= flt= tntc= tbat= tair= rh= tmcu= i2cerr= stack= modo= fan= rec= [LIMP] [backup=] [duty=…] carga=FASE [+CALIENTE][+OP] pin= ltc= cortes=n(duro/sost) media= duty= cargado= [caida=] vdda= modoB= relay= phlg_aire= v5min= vbatmin= bkp= mrst= [eth=… ip= lineas= bytes= drop= conn=] [t_on= nmea= bad= gga= sats= hdop= age= rtcm_age= sta= rtcm_last= sag5= sagb= flat= modem=]`
Fases del gobernador de carga (`carga=`, 0.6.1): `HOLDOFF` (< 120 s tras boot/STACK ON) · `NOTRUN` · `PWRCYC` · `BATT` · `WAIT` (riel bajo 5.05 V, o espera tras una caída sin corriente de carga) · `PROVING n/30s` · `ON` · `SHED` (3 s mientras se clasifica un corte) · `COOLDOWN faltan s` (tras un corte contado). Umbrales: arranque con la media de 200 ms ≥ 5.05 V durante 30 s; corte DURO con una muestra rápida < 4.70 V, SOSTENIDO con la media de 200 ms < 4.90 V durante 1 s o < 4.85 V; enfriamiento 60 s → 30 min (se duplica por corte contado); celda ≥ 45 °C inhibe. PFI real 4.40 V. Detalle: [notas de versión](../descargas/notas-de-version.md).
Fases del gobernador de carga (`carga=`, 0.6.1 y 0.6.2; 0.6.0 corta con una sola muestra bajo 4.90 V): `HOLDOFF` (< 120 s tras boot/STACK ON) · `NOTRUN` · `PWRCYC` · `BATT` · `WAIT` (riel bajo 5.05 V, o espera tras una caída sin corriente de carga) · `PROVING n/30s` · `ON` · `SHED` (3 s mientras se clasifica un corte) · `COOLDOWN faltan s` (tras un corte contado). Umbrales: arranque con la media de 200 ms ≥ 5.05 V durante 30 s; corte DURO con una muestra rápida < 4.70 V, SOSTENIDO con la media de 200 ms < 4.90 V durante 1 s o < 4.85 V; enfriamiento 60 s → 30 min (se duplica por corte contado); celda ≥ 45 °C inhibe. PFI real 4.40 V. Detalle: [notas de versión](../descargas/notas-de-version.md).
### 9.4 Trama `$PHLG` (cada 10 s en consola, cada 30 s en banda; checksum XOR)
@ -343,5 +343,6 @@ Fuente: Informe de cambios §1 (tabla antes → después), §2–§3 (partes y p
|---|---|---|
| 1.0 | 2026-09-29 | Primera versión (V5.6 con ECO en esquemático; PCB pendiente) |
| 1.1 | 2026-09-29 | Firmware 0.6.1: consola, `STAT`, fases y umbrales del gobernador de carga; el lazo serie no está en 0.6.1; con paquete LFP-HT hace falta otro build (flotación 3.50 V y umbrales de batería de LFP). |
| 1.2 | 2026-09-29 | 0.6.0 vigente otra vez (0.6.1 retirada: su telemetría no pasaba por el módem); §9 describe 0.6.x. |
Ver también: [manual V5](../manuales/manual-tarjeta-V5.md) · [pinout V5.6](v56-pinout.md) · [informe de cambios](v56-cambios-esquematico.md) · [ECO](v56-eco.md) · [instrucciones de layout](v56-layout-instrucciones.md).

2
docs/index.md
View File

@ -131,6 +131,6 @@ La lupa busca por unidad (H00xx), conector (P15, J10), evento (MODEM_DARK) o pro
| <span class="badge-v55">V5.5</span> | 15 unidades en campo · fw 0.6.0 |
| <span class="badge-v56">V5.6</span> | Esquemático cerrado · PCB en layout · pedido pendiente |
| <span class="badge-v6">v6</span> | En diseño (GNSS + 4G a bordo) — no pedir |
| <span class="badge-fw">firmware 0.6.1</span> | Publicado 29-sep, pendiente de prueba de banco (H0027, H0008) · [notas de versión](descargas/notas-de-version.md) |
| <span class="badge-fw">firmware 0.6.2</span> | En preparación; 0.6.1 retirada el 29-sep (su telemetría no pasaba por el módem) · [notas de versión](descargas/notas-de-version.md) |
Reglas de trabajo: [Guía del ingeniero](guia-ingeniero.md). Fuente: repositorio Drogheda. Contacto: leo@helgen.tech

9
docs/manuales/index.md
View File

@ -2,7 +2,7 @@
title: "Manuales por tarjeta"
project: Project Drogheda
date: 2026-09-29
version: "1.2"
version: "1.3"
tags: [project-drogheda, hardware, einarboard, manual, indice]
author: Helgen Technologies
---
@ -14,9 +14,9 @@ Cada manual cubre cómo reconocer la tarjeta, conectores, puentes, botones, LEDs
| Tarjeta | Nombre | Estado (sep-2026) | Firmware | Proyecto KiCad | Manual |
|---|---|---|---|---|---|
| V3 | EinarBoard 1.0 (Blackpill en zócalo) | 10 pzas jul-2026; 3 unidades en campo (RTK-003/006/014); registro congelado | `hbox-tarjetaV3_4.0.0.bin` | `hbox-watchdog-v3-PROD` | [Manual V3](manual-tarjeta-V3.md) |
| V4 | EinarBoard 2.0 (Blackpill + Ethernet + serie) | Fabricada ago-2026; en prueba con 0.6.1 | `hbox-tarjetaV4_0.6.1.bin` | `hbox-watchdog-v4` | [Manual V4](manual-tarjeta-V4.md) |
| V5.5 | EinarBoard 4.0 (serigrafía) / HBOX v5, MCU soldado | 15 pzas 22-ago-2026; en ensamble y campo | `hbox-v5-bringup_0.6.1.bin` | `hbox-watchdog-v5` (tag `v5.5-as-fabbed`) | [Manual V5](manual-tarjeta-V5.md) |
| V5.6 | HBOX v5 + ECO 27/28-sep (módem controlado por MCU, LFP, sensores) | Esquemático cerrado; PCB en layout; pedido pendiente | `hbox-v5-bringup_0.6.1.bin` solo con paquete Li-ion; firmware propio de V5.6 previsto en 0.7.0 | `hbox-watchdog-v5` | [Manual V5](manual-tarjeta-V5.md) §9 |
| V4 | EinarBoard 2.0 (Blackpill + Ethernet + serie) | Fabricada ago-2026; en prueba con 0.6.0 | `hbox-tarjetaV4_0.6.0.bin` | `hbox-watchdog-v4` | [Manual V4](manual-tarjeta-V4.md) |
| V5.5 | EinarBoard 4.0 (serigrafía) / HBOX v5, MCU soldado | 15 pzas 22-ago-2026; en ensamble y campo | `hbox-v5-bringup_0.6.0.bin` | `hbox-watchdog-v5` (tag `v5.5-as-fabbed`) | [Manual V5](manual-tarjeta-V5.md) |
| V5.6 | HBOX v5 + ECO 27/28-sep (módem controlado por MCU, LFP, sensores) | Esquemático cerrado; PCB en layout; pedido pendiente | `hbox-v5-bringup_0.6.0.bin` solo con paquete Li-ion; firmware propio de V5.6 previsto en 0.7.0 | `hbox-watchdog-v5` | [Manual V5](manual-tarjeta-V5.md) §9 |
| v6 | GNSS + 4G a bordo | En diseño; no pedir | — | `hbox-watchdog-v6` | [Manual v6](manual-tarjeta-v6.md) |
Documentos de ingeniería: [Tarjetas y hardware](../hardware/index.md).
@ -28,3 +28,4 @@ Documentos de ingeniería: [Tarjetas y hardware](../hardware/index.md).
| 1.0 | 2026-09-29 | Primera versión. |
| 1.1 | 2026-09-29 | Edición breve; estado V5.6 alineado con la portada. |
| 1.2 | 2026-09-29 | Firmware vigente 0.6.1 en V4 y V5.5 (V5.6 solo con paquete Li-ion); enlace a las notas de versión. |
| 1.3 | 2026-09-29 | Vuelve a 0.6.0: 0.6.1 retirada (su telemetría no pasaba por el módem); 0.6.2 en preparación. |

9
docs/manuales/manual-tarjeta-V4.md
View File

@ -2,7 +2,7 @@
title: "Manual de tarjeta — EinarBoard V4 (EinarBoard 2.0)"
project: Project Drogheda
date: 2026-09-29
version: "1.2"
version: "1.3"
tags: [project-drogheda, hardware, einarboard, v4, manual, tecnicos, blackpill]
author: Helgen Technologies
audience: técnicos de banco y de campo
@ -19,7 +19,7 @@ Blackpill en zócalo + Ethernet y puertos serie. Es el diseño de la V5 con el M
| Tamaño | 155 × 100 mm (20 mm más ancha que la V3, lado derecho) |
| MCU | WeAct Blackpill STM32F411CEU6 en zócalos J1/J2 (J1 con pads renumerados: corrige la errata E-J1 de la V3) |
| Fabricación | JLCPCB, orden preparada 02/03-ago-2026 (lote Y5) <!-- VERIFICAR: número de tarjetas fabricadas y fecha de entrega --> |
| Firmware | `hbox-tarjetaV4_0.6.1.bin` (mismo sketch `hbox_v5_bringup` compilado con `-DHBOX_BOARD_V4` para Blackpill). SHA-256 `ef43a901ae9a875e…`. Cambios por versión: [notas de versión](../descargas/notas-de-version.md) |
| Firmware | `hbox-tarjetaV4_0.6.0.bin` (mismo sketch `hbox_v5_bringup` compilado con `-DHBOX_BOARD_V4` para Blackpill). SHA-256 `1458470bbdd95b49…`. 0.6.1 se retiró el 29-sep. Cambios por versión: [notas de versión](../descargas/notas-de-version.md) |
| Paquete | Li-ion 18650 1S4P · JP2 en 1-2 (`F2:Li-ion`) · R55 10 k |
<!-- foto: vista superior V4 con Blackpill sentado, RJ45 arriba-izquierda, clemas P15/P16 abajo, P14 a la derecha -->
@ -101,12 +101,12 @@ Iguales a la V5 (mismo firmware): teclas `h l r s t i g v P Y n A B M R C`, lín
## 8. Limitaciones conocidas (iguales a V5.5)
- Módem oscuro en batería: no arranca sobre el boost; solo SW4G1 (o el puente 0.5.6 + `M`) o los 24 V lo reviven. Firmware ≥ 0.5.9: sin ciclos de etapa en batería; reset del MCU al volver el 5 V.
- Cargador: apagado en firmware < 0.6.0; desde 0.6.0 un gobernador lo habilita con 24 V y riel estable, y 0.6.1 ya no lo corta por las ráfagas del módem. Con cable o fuente débiles hasta P2 la carga avanza despacio o se estanca ([límite de la ruta de 5 V](../descargas/notas-de-version.md#el-limite-de-la-ruta-de-5-v)).
- Cargador: apagado en firmware < 0.6.0; desde 0.6.0 un gobernador lo habilita con 24 V y riel estable; con la ruta de 5 V justa, 0.6.0 corta la carga en cada ráfaga del módem y 0.6.2 (en preparación) lo corrige. Con cable o fuente débiles hasta P2 la carga avanza despacio o se estanca ([límite de la ruta de 5 V](../descargas/notas-de-version.md#el-limite-de-la-ruta-de-5-v)).
- Ethernet y serie sin prueba en hardware real.
## 9. Procedimientos relacionados
[V4 — preparación y prueba con firmware 0.6.1](../procedimientos/v4-prueba-fw-0.5.6.md) · [Política de ventilador (banco)](../procedimientos/fan-policy-bench-test.md) · [Acta V4](../formularios/v4.html) · [Reflasheo de unidades](../procedimientos/reflasheo-unidades.md) · [Prueba módem en batería](../procedimientos/prueba-bateria-modem.md) · [Manual V5](manual-tarjeta-V5.md).
[V4 — preparación y prueba con firmware 0.6.0](../procedimientos/v4-prueba-fw-0.5.6.md) · [Política de ventilador (banco)](../procedimientos/fan-policy-bench-test.md) · [Acta V4](../formularios/v4.html) · [Reflasheo de unidades](../procedimientos/reflasheo-unidades.md) · [Prueba módem en batería](../procedimientos/prueba-bateria-modem.md) · [Manual V5](manual-tarjeta-V5.md).
## Historial de revisiones
@ -115,5 +115,6 @@ Iguales a la V5 (mismo firmware): teclas `h l r s t i g v P Y n A B M R C`, lín
| 1.0 | 2026-09-29 | Primera versión. |
| 1.1 | 2026-09-29 | Edición breve; puente y flasheo remiten al procedimiento V4 (el manual listaba 1N5819, que el procedimiento prohíbe). |
| 1.2 | 2026-09-29 | Firmware 0.6.1. |
| 1.3 | 2026-09-29 | Vuelve a 0.6.0 (0.6.1 retirada). |
Versiones anteriores en git.

9
docs/manuales/manual-tarjeta-V5.md
View File

@ -2,7 +2,7 @@
title: "Manual de tarjeta — EinarBoard V5 (V5.5 y V5.6)"
project: Project Drogheda
date: 2026-09-29
version: "1.2"
version: "1.3"
tags: [project-drogheda, hardware, einarboard, v5, v5.5, v5.6, manual, tecnicos]
author: Helgen Technologies
audience: técnicos de banco y de campo
@ -16,7 +16,7 @@ Valores de ingeniería: [hoja de datos V5.6](../hardware/v56-datasheet.md). Pin
|---|---|---|
| Estado | 15 tarjetas fabricadas (JLCPCB, 22-ago-2026), en ensamble y en campo | Esquemático listo (ECO 27/28-sep); PCB y pedido pendientes |
| Proyecto KiCad | `kicad/hbox-watchdog-v5.*` (etiqueta git `v5.5-as-fabbed`) | `kicad/hbox-watchdog-v5.*` (ECO aplicada) |
| Firmware | `hbox-v5-bringup_0.6.1.bin` | `hbox-v5-bringup_0.6.1.bin` solo con paquete Li-ion; el firmware propio de V5.6 (control del módem, paquete LFP) está previsto en 0.7.0 |
| Firmware | `hbox-v5-bringup_0.6.0.bin` | `hbox-v5-bringup_0.6.0.bin` solo con paquete Li-ion; el firmware propio de V5.6 (control del módem, paquete LFP) está previsto en 0.7.0 |
| Paquete de batería | Li-ion 18650 1S4P · JP2 en 1-2 · R55 10 k | LFP-HT 26650 · JP2 en 2-3 · R55 5.6 k · NTC B3380 |
## 1. Identificación
@ -93,7 +93,7 @@ V5.5 igual al [pinout V5.6](../hardware/v56-pinout.md) salvo lo listado en §9.
## 6. Flasheo
DFU por J11, solo USB, sin P1/P2 ni batería: mantén SW2, pulsa y suelta SW1, suelta SW2 (`STM32 BOOTLOADER`, `0483:DF11`). Procedimiento completo: [prueba y flasheo §5](../procedimientos/v5-prueba-y-flasheo.md#5-flasheo-por-usb-dfu-j11-5-min). Binario: [Descargas](../descargas/index.md). La consola debe decir `hbox-v5-bringup 0.6.1` y `board=EinarBoard v5 (HBOX v5)`.
DFU por J11, solo USB, sin P1/P2 ni batería: mantén SW2, pulsa y suelta SW1, suelta SW2 (`STM32 BOOTLOADER`, `0483:DF11`). Procedimiento completo: [prueba y flasheo §5](../procedimientos/v5-prueba-y-flasheo.md#5-flasheo-por-usb-dfu-j11-5-min). Binario: [Descargas](../descargas/index.md). La consola debe decir `hbox-v5-bringup 0.6.0` y `board=EinarBoard v5 (HBOX v5)`.
Nunca flashees `blackpillrtkcode` (V3) en una V5: usa PB12–PB15 como LEDs y en la V5 son el SPI del W5500.
@ -157,7 +157,7 @@ En V5.6 el escaneo I²C (`i`) muestra además 0x49 (U18, sensor del módem).
## 11. Limitaciones de la V5.5
- Módem oscuro en batería: si el módem se apaga en batería (ciclo de etapa, brown-out) no arranca sobre el boost del LTC4040; solo lo reviven SW4G1 o los 24 V. Por eso el firmware ≥ 0.5.9 nunca cicla la etapa en batería y resetea el MCU al volver el 5 V ([hallazgos](../procedimientos/prueba-bateria-modem.md#3-hallazgos-2527-sep)).
- Hasta 0.5.9 el cargador estaba apagado por firmware. Desde 0.6.0 carga con 24 V, etapa ON > 120 s y riel ≥ 5.05 V. 0.6.0, con la ruta de 5 V justa, cortaba la carga en cada ráfaga del módem; 0.6.1 la corta solo si el riel no la sostiene (media de 200 ms bajo 4.90 V durante 1 s o bajo 4.85 V, o una muestra bajo 4.70 V). Reflashea unidades con firmware anterior ([notas de versión](../descargas/notas-de-version.md)).
- Hasta 0.5.9 el cargador estaba apagado por firmware. Desde 0.6.0 carga con 24 V, etapa ON > 120 s y riel ≥ 5.05 V. 0.6.0 (vigente), con la ruta de 5 V justa, corta la carga en cada ráfaga del módem; 0.6.2 (en preparación; 0.6.1 se retiró) la corta solo si el riel no la sostiene (media de 200 ms bajo 4.90 V durante 1 s o bajo 4.85 V, o una muestra bajo 4.70 V). Reflashea unidades con firmware anterior ([notas de versión](../descargas/notas-de-version.md)).
- La consola no sabe si el módem está vivo: `modem=vivo|SOSPECHOSO|?` es una inferencia por RTCM y caídas del riel.
- Ethernet y serie no se han probado en hardware real (sep-2026).
- Y2: la pieza dice 3.6864; el esquemático V5.6 dice `1.8432MHz` <!-- VERIFICAR el campo Value en KiCad; la pieza LCSC C2238 es de 3.6864 MHz -->.
@ -171,5 +171,6 @@ Procedimientos V5: [Producción](../produccion/index.md) · [Taller](../taller/i
| 1.0 | 2026-09-29 | Primera versión (V5.5 fabricada + V5.6 en esquemático). |
| 1.1 | 2026-09-29 | Edición breve; flasheo, química/JP2 y JP5 remiten a su procedimiento. |
| 1.2 | 2026-09-29 | Firmware 0.6.1: cargador, Ethernet de banco `0.6.1-eth`; el lazo serie no está en 0.6.1; en V5.6, 0.6.1 solo con paquete Li-ion. |
| 1.3 | 2026-09-29 | Vuelve a 0.6.0 (0.6.1 retirada: su telemetría no pasaba por el módem); 0.6.2 en preparación. |
Versiones anteriores en git.

7
docs/procedimientos/prueba-bateria-modem.md
View File

@ -4,7 +4,7 @@ tags: [project-drogheda, hbox, procedimiento, bateria, modem, ltc4040, v5, v4, f
date: 2026-09-26
project: Project Drogheda
author: Helgen Technologies
version: 1.4
version: 1.5
---
# Prueba de banco — módem 4G en modo batería
@ -18,9 +18,9 @@ version: 1.4
!!! danger "No se hace"
No cambies el firmware, no muevas JP2/JP3/JP4 ni el trimmer del SD-15B: la prueba vale porque la unidad está como en campo. Nunca conectes la fuente de banco a P4 con la batería puesta.
## 1. Cargador (0.6.1)
## 1. Cargador (0.6.2)
Misma unidad, paquete bajo (menos de 3.5 V), antes de la corrida en batería. Vale también para la V4, con la consola en el cable sin 5 V del [procedimiento V4](v4-prueba-fw-0.5.6.md). Qué cambió en el gobernador y por qué: [notas de versión](../descargas/notas-de-version.md).
Misma unidad, paquete bajo (menos de 3.5 V), antes de la corrida en batería. Vale también para la V4, con la consola en el cable sin 5 V del [procedimiento V4](v4-prueba-fw-0.5.6.md). Es la prueba del gobernador corregido de 0.6.2 (el de 0.6.1, que se retiró por la telemetría): con 0.6.0, vigente, la carga se corta con las ráfagas del módem si el riel queda cerca de 5.0 V. Qué cambió en el gobernador y por qué: [notas de versión](../descargas/notas-de-version.md).
1. 24 V + etapa ON, consola abierta. Los primeros 120 s `STAT` dice `carga=HOLDOFF`; luego `carga=PROVING n/30s` y a los ~150 s `EVT up=… CARGA ON: riel 5.xx V estable 30 s`. 5 s después, `EVT up=… CARGA: riel 5.2x -> 5.0x V con el cargador (caida 0.xx V)`: anota la caída (esperado < 0.10 V; con más de 0.15 V añade `RUTA DE 5 V DEBIL`). Siguiente `STAT`: `ltc=CARGANDO`; el monitor muestra 🔌 CARGANDO o «cargó N %».
2. 30 min sin tocar, multímetro en P2 (anota el mínimo). En `STAT`: `cortes=0`, `duty=` cerca de 100 % y `cargado=` subiendo; `vbat` inicial y final (debe subir). Las ráfagas del módem ya no cortan la carga.
@ -139,5 +139,6 @@ Todo va en el [acta de la prueba](../formularios/prueba-bateria.html): configura
| 1.2 | 2026-09-29 | Reordenado: estado actual primero. |
| 1.3 | 2026-09-29 | Edición breve; los hallazgos 26/27-sep viven aquí (Descargas solo los resume). |
| 1.4 | 2026-09-29 | §1 para el gobernador 0.6.1: 30 min sin cortes, desconexión, corte SOSTENIDO, noche y regla de la ruta de 5 V; pulso `MODEM_RST` a 5 s. |
| 1.5 | 2026-09-29 | §1 pasa a 0.6.2 (0.6.1 retirada: su `$PHLG` no pasaba por el módem). |
Versiones anteriores en git.

19
docs/procedimientos/v4-prueba-fw-0.5.6.md
View File

@ -1,13 +1,13 @@
---
title: "V4 — preparación y prueba con firmware 0.6.1"
title: "V4 — preparación y prueba con firmware 0.6.0"
tags: [project-drogheda, hbox, procedimiento, v4, firmware, bateria, modem, dfu]
date: 2026-09-26
project: Project Drogheda
author: Helgen Technologies
version: 1.4
version: 1.5
---
# V4 — preparación y prueba con firmware 0.6.1
# V4 — preparación y prueba con firmware 0.6.0
!!! abstract "Para quién · Cuándo · Tiempo · Necesitas"
- Para quién: técnico de banco.
@ -17,7 +17,7 @@ version: 1.4
Orden: tres preparativos (puente de reset del módem; interruptores del simpleRTK2B, cable sin 5 V y batería), flasheo, y tres pruebas (24 V, batería, regreso de 24 V). Conectores y botones: [manual V4](../manuales/manual-tarjeta-V4.md). En V5.5 la prueba equivalente es [módem 4G en batería](prueba-bateria-modem.md).
El procedimiento se escribió para 0.5.6. Puente, `M`, `R` y DFU solo con USB no cambian con 0.6.1. Qué cambió en cada versión: [notas de versión](../descargas/notas-de-version.md).
El procedimiento se escribió para 0.5.6. Puente, `M`, `R` y DFU solo con USB no cambian con 0.6.0. 0.6.1 se retiró (su telemetría no pasaba por el módem); 0.6.2 está en preparación. Qué cambió en cada versión: [notas de versión](../descargas/notas-de-version.md).
!!! warning "Reglas"
- Todo cambio de hardware (soldar, mover interruptores, poner o quitar módulos) sin energía: sin 24 V, batería desconectada, sin USB.
@ -61,12 +61,12 @@ Batería: mide en su conector; debe tener ≥ 3.80 V (3.14 V, como en el último
## Flasheo
Archivo [`hbox-tarjetaV4_0.6.1.bin`](../descargas/hbox-tarjetaV4_0.6.1.bin) (0.6.1), nunca el `hbox-v5-bringup_…`. SHA-256: `ef43a901ae9a875e6346ae8f84cc5f150a2419ff7cd577fe8f69780236840757` ([cómo verificar](../descargas/index.md#verifica-el-sha-256)).
Archivo [`hbox-tarjetaV4_0.6.0.bin`](../descargas/hbox-tarjetaV4_0.6.0.bin) (0.6.0), nunca el `hbox-v5-bringup_…` ni el 0.6.1 de `superseded/`. SHA-256: `1458470bbdd95b490969976402bf2144a773a991b7650c55e3281687ba77b2e3` ([cómo verificar](../descargas/index.md#verifica-el-sha-256)).
1. Sin 24 V y con la batería desconectada, cable normal a la Blackpill.
2. DFU: mantén BOOT0, pulsa y suelta NRST, suelta BOOT0. Debe aparecer `STM32 BOOTLOADER` (0483:DF11).
3. `dfu-util -a 0 -s 0x08000000:leave -D hbox-tarjetaV4_0.6.1.bin` (o STM32CubeProgrammer → USB → Connect → Download en `0x08000000`).
4. Consola a 115200: `hbox-v5-bringup 0.6.1`, `board=EinarBoard v4 (HBOX v4)` y `>>> BOARD OK`. Si no viste el arranque: `t` (la línea empieza con `$PHLG,0.6.1,`) y `r` repite los tests.
3. `dfu-util -a 0 -s 0x08000000:leave -D hbox-tarjetaV4_0.6.0.bin` (o STM32CubeProgrammer → USB → Connect → Download en `0x08000000`).
4. Consola a 115200: `hbox-v5-bringup 0.6.0`, `board=EinarBoard v4 (HBOX v4)` y `>>> BOARD OK`. Si no viste el arranque: `t` (la línea empieza con `$PHLG,0.6.0,`) y `r` repite los tests.
5. Retira el cable normal. Desde aquí, solo el cable sin 5 V.
Sin `STM32 BOOTLOADER` tras dos intentos: el USB también alimenta el W5500, cuya interrupción llega a `BOOT1`. Sin energía, saca la Blackpill, flashéala suelta y reinsértala con su USB-C del lado de la etiqueta E-CSn (B12 en E-CSn, pin R en NRST). Si no coincide, no la energices.
@ -77,7 +77,7 @@ Sin `STM32 BOOTLOADER` tras dos intentos: el USB también alimenta el W5500, cuy
2. P2 (salida del SD-15B): 5.1–5.3 V. Con 0 V detente: SD-15B o arnés.
3. `s`: `v5=5.xx(ok)`, `stack=ON`, `mrst=1` o más; al poco, `modoB=ON` y `gga=` con satélites.
4. Puente: multímetro en el pad RESET de SW4G1 contra GND (alto con el módem encendido). Teclea `M`: baja de 0.4 V medio segundo (usa MIN/MAX), los LEDs del módem se apagan y vuelven, y la consola dice `MODEM_RST operador`. No baja: diodo al revés o sin soldar. Se queda en 0.4–0.7 V: el diodo no es Schottky.
5. Espera registro del módem y LEDs UART del simpleRTK2B en parpadeo rápido (correcciones). En el monitor: `0.6.1` y ⚡ VEHÍCULO; a los ~2.5 min Energía pasa de «espera de arranque» y «comprobando riel» a 🔌 CARGANDO (o «casi lleno» / ✅ CARGADA con la batería llena).
5. Espera registro del módem y LEDs UART del simpleRTK2B en parpadeo rápido (correcciones). En el monitor: `0.6.0` y ⚡ VEHÍCULO; a los ~2.5 min Energía pasa a 🔌 CARGANDO (o ✅ CARGADA con la batería llena), aunque con 0.6.0 la carga puede cortarse con las ráfagas del módem.
6. Opcional: con el módem oscuro en 24 V, `R` (reset por software) debe encenderlo.
Si algo falla, no pases a batería: marca "me detengo" en el acta y ve al cierre.
@ -85,7 +85,7 @@ Si algo falla, no pases a batería: marca "me detengo" en el acta y ve al cierre
## Prueba B — En batería
!!! note "Pendiente de ingeniería"
Los pasos 2–5 describen el ciclo de 10 min de 0.5.6–0.5.7. Desde 0.5.9 la etapa y el módem siguen encendidos en batería, sin ventanas (ver [Descargas](../descargas/index.md)). Con 0.6.1 registra en el acta lo que ocurra y avisa a ingeniería.
Los pasos 2–5 describen el ciclo de 10 min de 0.5.6–0.5.7. Desde 0.5.9 la etapa y el módem siguen encendidos en batería, sin ventanas (ver [Descargas](../descargas/index.md)). Con 0.6.0 registra en el acta lo que ocurra y avisa a ingeniería.
1. Con todo funcionando, quita 24 V (la batería queda) y anota la hora: `V5 PERDIDO` y `BACKUP inicio … modo reporte cada 10 min`. La etapa sigue unos 2 min.
2. `DUTY reposo … etapa OFF` y `STACK OFF reason=duty_sleep`. A los 30 s mide:
@ -131,5 +131,6 @@ Todo va en el [acta de prueba V4](../formularios/v4.html), con el log completo d
| 1.2 | 2026-09-29 | SHA-256 de 0.6.0 corregido; encabezado uniforme. |
| 1.3 | 2026-09-29 | Edición breve; tabla de versiones → Descargas; aviso de que la Prueba B describe el ciclo de 0.5.6–0.5.7. |
| 1.4 | 2026-09-29 | Firmware 0.6.1: archivo, SHA-256, consola y monitor; pulso `MODEM_RST` a 5 s; enlace a las notas de versión. |
| 1.5 | 2026-09-29 | Vuelve a 0.6.0: 0.6.1 retirada (su `$PHLG` no pasaba por el módem). |
Versiones anteriores en git.

7
docs/procedimientos/v5-prueba-ethernet-serie.md
View File

@ -4,7 +4,7 @@ tags: [project-drogheda, hardware, hbox, v5, v5.6, ethernet, w5500, rs485, rs232
project: Project Drogheda
author: Helgen Technologies
date: 2026-09-29
version: 1.2
version: 1.3
status: ACTIVO — obligatoria en al menos una V5.5 antes de pedir la V5.6; después, en toda unidad con RJ45 o clemas serie
audience: técnicos de banco
---
@ -41,7 +41,7 @@ audience: técnicos de banco
2. `dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.6.1-eth.bin` o STM32CubeProgrammer.
3. Terminal en J11: primera línea `hbox-v5-bringup 0.6.1-eth`; la ayuda (`h`) lista `E=Ethernet on/off`.
El build `-eth` es solo de banco: al terminar reflashea el binario V5 vigente de [Descargas](../descargas/index.md) (hoy `hbox-v5-bringup_0.6.1.bin`; ver C).
El build `-eth` es solo de banco: al terminar reflashea el binario V5 vigente de [Descargas](../descargas/index.md) (hoy `hbox-v5-bringup_0.6.0.bin`; ver C).
### A3. Secuencia
@ -173,7 +173,7 @@ Hasta que salga el build con lazo el resultado se registra como "presencia + niv
## C. Cierre
- [ ] Si la unidad se embarca, reflashea el binario V5 vigente (`hbox-v5-bringup_0.6.1.bin`) y anótalo en el [acta de reflasheo](../formularios/reflasheo.html).
- [ ] Si la unidad se embarca, reflashea el binario V5 vigente de Descargas (hoy `hbox-v5-bringup_0.6.0.bin`) y anótalo en el [acta de reflasheo](../formularios/reflasheo.html).
- [ ] Retira cable y adaptadores; tapas ciegas en J10/P15/P16 que el panel no use.
- [ ] Envía el [acta Ethernet y puertos serie](../formularios/ethernet-serie.html) con los dos logs.
@ -192,5 +192,6 @@ Hasta que salga el build con lazo el resultado se registra como "presencia + niv
| 1.0 | 2026-09-29 | Primera versión: Ethernet con `0.6.0-eth` y puertos serie (presencia, niveles, lazo y eco para 0.6.1). |
| 1.1 | 2026-09-29 | Edición breve; recibe de la configuración de la unidad la tabla de conexión, la regla de JP5 y los defaults de Ethernet. |
| 1.2 | 2026-09-29 | Build de banco 0.6.1-eth (el 0.6.0-eth se bloqueaba sin DHCP). Lazo y eco serie: build posterior (0.6.1 salió como arreglo del cargador). |
| 1.3 | 2026-09-29 | Binario de campo vigente otra vez 0.6.0 (0.6.1 retirada). El build de banco sigue siendo `0.6.1-eth`: Ethernet funciona, pero su `$PHLG` por 4G no llega al monitor. |
Versiones anteriores en git.

2
docs/taller/index.md
View File

@ -12,7 +12,7 @@ Unidad o tarjeta en la mesa. Antes de tocarla, abre su [expediente](../unidad.ht
| Reflasheo | Después de subir la captura del diagnóstico | [Reflasheo de unidades](../procedimientos/reflasheo-unidades.md) | [Reflasheo y configuración](../formularios/reflasheo.html) |
| Módem 4G en batería | Validar firmware o unidad que no reporta en batería | [Módem 4G en batería](../procedimientos/prueba-bateria-modem.md) | [Módem en batería](../formularios/prueba-bateria.html) |
| Ethernet y puertos serie | El cliente usa Ethernet, RS-485 o RS-232 | [Ethernet y puertos serie](../procedimientos/v5-prueba-ethernet-serie.md) | [Ethernet y serie](../formularios/ethernet-serie.html) |
| Tarjeta V4 | Preparación y prueba con 0.6.1 | [Preparación y prueba V4](../procedimientos/v4-prueba-fw-0.5.6.md) | [Prueba V4](../formularios/v4.html) |
| Tarjeta V4 | Preparación y prueba con 0.6.0 | [Preparación y prueba V4](../procedimientos/v4-prueba-fw-0.5.6.md) | [Prueba V4](../formularios/v4.html) |
- [Manual V5](../manuales/manual-tarjeta-V5.md) · [Manual V4](../manuales/manual-tarjeta-V4.md) · [Pinout V5.6](../hardware/v56-pinout.md)
- [Tablero de producción](../tablero.html)

2
mkdocs.yml
View File

@ -91,7 +91,7 @@ nav:
- "Prueba: Ethernet y puertos serie":
- procedimientos/v5-prueba-ethernet-serie.md
- "Acta: Ethernet y puertos serie": formularios/ethernet-serie.html
- "V4 — preparación y prueba con 0.6.1":
- "V4 — preparación y prueba con 0.6.0":
- procedimientos/v4-prueba-fw-0.5.6.md
- "Acta de prueba V4": formularios/v4.html

8
scripts/sync-docs.sh
View File

@ -27,8 +27,8 @@ declare -a MAP=(
# Descargas para técnicos (firmware de bring-up v5)
# Versión nueva: su .bin va a docs/descargas/ y la anterior a docs/descargas/superseded/. El script no borra:
# el .bin anterior que quedó en docs/descargas/ se mueve a mano (mv) a superseded/.
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.6.1.bin|docs/descargas/hbox-v5-bringup_0.6.1.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.6.0.bin|docs/descargas/superseded/hbox-v5-bringup_0.6.0.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.6.0.bin|docs/descargas/hbox-v5-bringup_0.6.0.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.6.1.bin|docs/descargas/superseded/hbox-v5-bringup_0.6.1.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.9.bin|docs/descargas/superseded/hbox-v5-bringup_0.5.9.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.8.bin|docs/descargas/superseded/hbox-v5-bringup_0.5.8.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.7.bin|docs/descargas/superseded/hbox-v5-bringup_0.5.7.bin"
@ -41,8 +41,8 @@ declare -a MAP=(
"04-Source-Code/firmware/hbox_v5_bringup/release/superseded/hbox-v5-bringup_0.4.0.bin|docs/descargas/superseded/hbox-v5-bringup_0.4.0.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV3_3.0.4.bin|docs/descargas/superseded/hbox-tarjetaV3_3.0.4.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV3_4.0.0.bin|docs/descargas/hbox-tarjetaV3_4.0.0.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.6.1.bin|docs/descargas/hbox-tarjetaV4_0.6.1.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.6.0.bin|docs/descargas/superseded/hbox-tarjetaV4_0.6.0.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.6.0.bin|docs/descargas/hbox-tarjetaV4_0.6.0.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.6.1.bin|docs/descargas/superseded/hbox-tarjetaV4_0.6.1.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.5.9.bin|docs/descargas/superseded/hbox-tarjetaV4_0.5.9.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.5.8.bin|docs/descargas/superseded/hbox-tarjetaV4_0.5.8.bin"
# Documentación 2026-09-29: datasheet, pinout V5.6, manuales por tarjeta, procedimientos de configuración/Ethernet/serie, manual de cliente