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

Descargas: 0.5.3 (ventana 2 min) para V4 y V5; 0.5.2 a superseded

Browse Source
This commit is contained in:
Leopoldo Rodríguez 2026-09-25 13:17:15 -06:00
parent d62026374c
commit e777692c27
9 changed files with 28 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/descargas/SHA256SUMS.txt
View File

@ -1,7 +1,9 @@
a68a87ff1f6b34a8284e9e5e32c95da7bb8d8adc071c5fd64412a3e744e46b28 hbox-tarjetaV3_4.0.0.bin
fa2b7554099b332c70ab18cde24b30a4f0a46ac01987466e491c69b308783a5a hbox-tarjetaV4_0.5.2.bin
a9b0d6c1c640ebc9a132236ca465cad04e8eed99962b7dc6024b6ee8b765d2d6 hbox-v5-bringup_0.5.2.bin
162a8d4f17af36e9cbacf7751ec230a21161ce92c0446564d01a06aa2588789e hbox-tarjetaV4_0.5.3.bin
2c5349a9a096929c33a09307640359c523421b226b9db3602279127de19eff95 hbox-v5-bringup_0.5.3.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
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

BIN
docs/descargas/hbox-tarjetaV4_0.5.3.bin Executable file
View File

Binary file not shown.

BIN
docs/descargas/hbox-v5-bringup_0.5.3.bin Executable file
View File

Binary file not shown.

27
docs/descargas/index.md
View File

@ -29,20 +29,20 @@ Cada carga se registra en el **[acta de reflasheo](../formularios/reflasheo.html
| Tarjeta | MCU | Código fuente | **Binario vigente** | Estado |
|---|---|---|---|---|
| **V3** — EinarBoard 1.0, las 3 unidades en campo | Blackpill en zócalo (F411CE) | `blackpillrtkcode_v4` (4.0.0) | [`hbox-tarjetaV3_4.0.0.bin`](hbox-tarjetaV3_4.0.0.bin) | ⚠ compilado, **sin prueba de banco** |
| **V4** — `hbox-watchdog-v4` | Blackpill en zócalo + PCF8574 · W5500 · SC16IS752 | `hbox_v5_bringup` + `board_v4.h` | [`hbox-tarjetaV4_0.5.2.bin`](hbox-tarjetaV4_0.5.2.bin) | ⚠ compilado 24-sep, **sin prueba de banco** |
| **V5** — `hbox-watchdog-v5`, lote de 15 | STM32F411RET6 soldado | `hbox_v5_bringup` (0.5.2) | [`hbox-v5-bringup_0.5.2.bin`](hbox-v5-bringup_0.5.2.bin) | ⚠ **vigente desde 24-sep** — reporte cada 10 min en batería; 0.5.1 fue la última en campo |
| **V4** — `hbox-watchdog-v4` | Blackpill en zócalo + PCF8574 · W5500 · SC16IS752 | `hbox_v5_bringup` + `board_v4.h` | [`hbox-tarjetaV4_0.5.3.bin`](hbox-tarjetaV4_0.5.3.bin) | ⚠ compilado 25-sep, **sin prueba de banco** |
| **V5** — `hbox-watchdog-v5`, lote de 15 | STM32F411RET6 soldado | `hbox_v5_bringup` (0.5.3) | [`hbox-v5-bringup_0.5.3.bin`](hbox-v5-bringup_0.5.3.bin) | ⚠ **vigente desde 25-sep** — ventana de 2 min cada 10 min en batería; 0.5.1 fue la última en campo |
Los tres reportan al servidor **la misma trama**: `$PHLG` de 29 campos cada 30 s y un `$PHEV` por cada
cambio de estado, en banda por el módem (Modo B). Es exactamente lo que el monitor desplegado parsea hoy
(`retranslator.py`: 20 campos base + 4 de v3 + 5 de 0.5.1, y `$PHEV`), así que las tres tarjetas se ven
igual en la columna *Salud*.
!!! warning "0.5.2 (V4 y V5) cambia cómo se ve la unidad en el monitor cuando está en batería"
Con 0.5.2 la unidad **apaga el módem entre reportes** mientras está en batería: enciende ~90–180 s cada
!!! warning "0.5.3 (V4 y V5) cambia cómo se ve la unidad en el monitor cuando está en batería"
Con 0.5.3 la unidad **apaga el módem entre reportes** mientras está en batería: enciende ~120–180 s cada
10 min, manda posición y `$PHLG` con `pwr=BATT`, avisa `DUTY_SLEEP next=<s>` y se calla. Para que ese
silencio **no aparezca como desconexión** (ni dispare el correo del notifier, ni cuente como caída), el
`retranslator.py` del servidor debe llevar el soporte `DUTY` (24-sep). **Desplegar primero el servidor,
después flashear 0.5.2.** Con la V3 (4.0.0) no cambia nada: sigue reportando continuo en batería.
después flashear 0.5.3.** Con la V3 (4.0.0) no cambia nada: sigue reportando continuo en batería.
!!! note "V4 = la V5 en un Blackpill"
Cotejada pad por pad en `hbox-watchdog-v4.kicad_pcb` contra `board_v5.h`: mismas redes, mismos pines
@ -65,31 +65,32 @@ No se flashean. Están para identificar lo que una tarjeta vieja pueda traer y p
| Archivo | Por qué se retiró |
|---|---|
| [`superseded/hbox-tarjetaV3_3.0.4.bin`](superseded/hbox-tarjetaV3_3.0.4.bin) | Misma lógica que las unidades en campo (3.0.3) pero **sin telemetría en banda**: el monitor no ve nada en *Salud*. Sustituida por 4.0.0. |
| [`superseded/hbox-v5-bringup_0.5.1.bin`](superseded/hbox-v5-bringup_0.5.1.bin) · [`superseded/hbox-tarjetaV4_0.5.1.bin`](superseded/hbox-tarjetaV4_0.5.1.bin) | Última versión de campo antes del reporte cada 10 min en batería (en batería dejaba la etapa encendida hasta vaciar el paquete). Sirve para volver atrás si 0.5.2 da problemas en banco. |
| [`superseded/hbox-v5-bringup_0.5.2.bin`](superseded/hbox-v5-bringup_0.5.2.bin) · [`superseded/hbox-tarjetaV4_0.5.2.bin`](superseded/hbox-tarjetaV4_0.5.2.bin) | Primera versión con reporte cada 10 min en batería, ventana mínima de 90 s: **insuficiente para que el módem entregara la posición**. Sustituida por 0.5.3 (120 s). |
| [`superseded/hbox-v5-bringup_0.5.1.bin`](superseded/hbox-v5-bringup_0.5.1.bin) · [`superseded/hbox-tarjetaV4_0.5.1.bin`](superseded/hbox-tarjetaV4_0.5.1.bin) | Última versión de campo antes del reporte cada 10 min en batería (en batería dejaba la etapa encendida hasta vaciar el paquete). Sirve para volver atrás si 0.5.3 da problemas en banco. |
| [`superseded/hbox-v5-bringup_0.4.0.bin`](superseded/hbox-v5-bringup_0.4.0.bin) | Versión de V5 sin `$PHLG` en banda. Sustituida por 0.5.1. |
### Firmware de bring-up — EinarBoard v5
| Archivo | Versión | SHA-256 | Uso |
|---|---|---|---|
| [**hbox-v5-bringup_0.5.2.bin**](hbox-v5-bringup_0.5.2.bin) | **0.5.2** (2026-09-24) — **campo + Modo B + reporte cada 10 min en batería** — ⚠ sin prueba de banco; requiere servidor con soporte `DUTY` | `a9b0d6c1c640ebc9…` | Sección 5 del [procedimiento de prueba y flasheo v5](../procedimientos/v5-prueba-y-flasheo.md) y sección 5 del [ensamble](../procedimientos/v5-ensamble.md) (modo de banco `P` / `n`) |
| [**hbox-v5-bringup_0.5.3.bin**](hbox-v5-bringup_0.5.3.bin) | **0.5.3** (2026-09-25) — **campo + Modo B + ventana de 2 min cada 10 min en batería** — ⚠ sin prueba de banco; requiere servidor con soporte `DUTY` | `2c5349a9a096929c…` | Sección 5 del [procedimiento de prueba y flasheo v5](../procedimientos/v5-prueba-y-flasheo.md) y sección 5 del [ensamble](../procedimientos/v5-ensamble.md) (modo de banco `P` / `n`) |
Flasheo por DFU en **J11** (mantener **SW2**, pulsar y soltar **SW1**, soltar SW2):
```bash
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.5.2.bin
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.5.3.bin
```
o con **STM32CubeProgrammer** → USB → Connect → Download del `.bin` en `0x08000000`.
!!! success "A/B 0.4.0 vs 0.5.1 — cerrado el 19-sep"
El 18-sep por la tarde se reportó que con 0.5.1 la etapa RTK no encendía. **Resuelto:** 0.5.1 ensambla,
enciende y reporta telemetría completa en el monitor desplegado. **Se embarcó con 0.5.1; desde el 24-sep la vigente es 0.5.2.** `0.4.0`
enciende y reporta telemetría completa en el monitor desplegado. **Se embarcó con 0.5.1; desde el 25-sep la vigente es 0.5.3.** `0.4.0`
queda en `superseded/` solo como referencia.
!!! note "Tarjetas ya flasheadas con cualquier versión anterior"
Re-flashear con **0.5.2** por el mismo procedimiento DFU. **La primera línea de la consola tras reset dice la versión**
(`hbox-v5-bringup 0.5.2 built …`): si la línea `STAT` no termina en `stack=…`, la tarjeta sigue con 0.1.1.
Re-flashear con **0.5.3** por el mismo procedimiento DFU. **La primera línea de la consola tras reset dice la versión**
(`hbox-v5-bringup 0.5.3 built …`): si la línea `STAT` no termina en `stack=…`, la tarjeta sigue con 0.1.1.
!!! tip "Consola 0.5.x"
Líneas `EVT` en cada cambio (stack, ignición, 5 V, cargador, NMEA, fix), `STAT` con nombres cada 5 s y `$PHLG` cada 10 s
@ -102,7 +103,7 @@ o con **STM32CubeProgrammer** → USB → Connect → Download del `.bin` en `0x
hablar 60 s; LIMP tras 3 ciclos), LEDs de carga y color de estado, corte térmico 60 °C y corte de batería 3.40 V.
**El cargador sigue APAGADO: el paquete es de un solo uso hasta el firmware de producción.** Anotarlo en el acta de la unidad.
**0.5.2 — batería:** con 5 V perdidos la etapa ya no queda encendida hasta vaciar el paquete: ventana de reporte de 90–180 s
**0.5.2/0.5.3 — batería:** con 5 V perdidos la etapa ya no queda encendida hasta vaciar el paquete: ventana de reporte de 120–180 s
cada 10 min (`DUTY_WAKE` / `DUTY_SLEEP next=<s>` / `DUTY_SKIP` / `DUTY_END`), ventilador y LEDs apagados en reposo, protecciones
de batería (< 3.40 V) y temperatura (≥ 60 °C) por encima del ciclo. El MCU sigue despierto: el ahorro es la etapa (~2.3 W).
@ -148,7 +149,7 @@ Es el firmware que gobierna la unidad en la máquina, distinto del de bring-up d
| Tarjeta | Archivo | Estado |
|---|---|---|
| **V3** — flota desplegada | [`hbox-tarjetaV3_4.0.0.bin`](hbox-tarjetaV3_4.0.0.bin) · 64 352 B · `a68a87ff…` | ⚠ compilado 19-sep, falta prueba de banco. El «4» es la versión del firmware, **no** la tarjeta |
| **V4** | [`hbox-tarjetaV4_0.5.2.bin`](hbox-tarjetaV4_0.5.2.bin) · 81 772 B · `fa2b7554099b332c…` | ⚠ compilado 24-sep, falta prueba de banco. Es 0.5.2 para Blackpill (`-DHBOX_BOARD_V4`), DFU **solo con USB** |
| **V4** | [`hbox-tarjetaV4_0.5.3.bin`](hbox-tarjetaV4_0.5.3.bin) · 81 932 B · `162a8d4f17af36e9…` | ⚠ compilado 25-sep, falta prueba de banco. Es 0.5.3 para Blackpill (`-DHBOX_BOARD_V4`), DFU **solo con USB** |
!!! danger "Mientras diga «pendiente», no hay binario aprobado"
No flashees una unidad V3 o V4 con un archivo que no esté publicado aquí con su SHA-256. Los

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

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

8
docs/procedimientos/reflasheo-unidades.md
View File

@ -38,8 +38,8 @@ cuando debería estar cortada.
| Generación de tarjeta | Binario | Estado |
|---|---|---|
| **V3** — EinarBoard 1.0 (RTK-003, RTK-006, RTK-014), Blackpill | `hbox-tarjetaV3_4.0.0.bin` | ⚠ publicado, sin prueba de banco |
| **V4** — Blackpill + PCF8574/W5500/SC16IS752 | `hbox-tarjetaV4_0.5.2.bin` | ⚠ publicado, sin prueba de banco (mismo código que V5 + `board_v4.h`) |
| **V5** — MCU soldado, lote de 15 | `hbox-v5-bringup_0.5.2.bin` | ⚠ vigente 24-sep (reporte cada 10 min en batería); antes flashear, servidor con soporte `DUTY` |
| **V4** — Blackpill + PCF8574/W5500/SC16IS752 | `hbox-tarjetaV4_0.5.3.bin` | ⚠ publicado, sin prueba de banco (mismo código que V5 + `board_v4.h`) |
| **V5** — MCU soldado, lote de 15 | `hbox-v5-bringup_0.5.3.bin` | ⚠ vigente 25-sep (ventana de 2 min cada 10 min en batería); antes flashear, servidor con soporte `DUTY` |
Si el renglón dice *pendiente*, **no hay binario aprobado todavía**: el flasheo de esa generación
está detenido hasta que ingeniería lo publique (§6).
@ -151,8 +151,8 @@ arduino-cli compile \
--fqbn "STMicroelectronics:stm32:GenF4:pnum=BLACKPILL_F411CE,usb=CDCgen,xserial=generic,rtlib=nanofp" \
--build-property "build.extra_flags=-DHBOX_BOARD_V4" \
--output-dir release/ hbox_v5_bringup/
mv release/hbox_v5_bringup.ino.bin release/hbox-tarjetaV4_0.5.2.bin
shasum -a 256 release/hbox-tarjetaV4_0.5.2.bin | tee -a release/SHA256SUMS
mv release/hbox_v5_bringup.ino.bin release/hbox-tarjetaV4_0.5.3.bin
shasum -a 256 release/hbox-tarjetaV4_0.5.3.bin | tee -a release/SHA256SUMS
```
**El destino de tarjeta ya viene bien por omisión:** el propio `.ino` trae `TARGET_EINARBOARD 1` y

14
docs/procedimientos/v5-prueba-final-unidad.md
View File

@ -1,7 +1,7 @@
# HBOX v5 — Prueba final de unidad ensamblada con firmware 0.5.x (field-minimum + telemetría y eventos)
# HBOX v5 — Prueba final de unidad ensamblada con firmware 0.5.1 (field-minimum + telemetría y eventos)
**Alcance:** unidad completa (EinarBoard V5 + ArduSimple + módem 4G + batería + antenas) dentro del HBOX, antes de embarcar.
**Firmware:** `hbox-v5-bringup_0.5.2.bin` (SHA-256 `a9b0d6c1…`; V4: `hbox-tarjetaV4_0.5.2.bin`, `fa2b7554…`) — descarga en <https://drogheda.helgen.online/descargas/>. La sección de respaldo cambia con 0.5.2: ver la nota al final de esa sección.
**Firmware:** `hbox-v5-bringup_0.5.1.bin` (SHA-256 `e1f35108…`) — descarga en <https://drogheda.helgen.online/descargas/>.
**Duración:** ~45 min por unidad (P1–P6). Registrar todo en el acta de ensamble (`HBOX5-Exx-Axxx-Rxxxx`).
!!! warning "Lo que 0.5.1 NO hace"
@ -51,16 +51,6 @@ Con la etapa ON: **desconectar el 24 V** (se va el 5 V del SD-15B). Esperar 5 mi
| `STAT … stack=ON backup=Ns nmea=` **sigue contando** 5 min · `fan` según termostato (normalmente OFF) | `nmea` se detiene → SW_BAT/L6 (pista 0.3 mm, auditoría EMC) o paquete flojo en P4 |
| al reconectar: `EVT V5 PRESENTE` → `EVT BACKUP fin dur≈300s nmea_durante=N … SOSTUVO` | — |
!!! note "Con 0.5.2 la P3 se ve distinta — y dura 13 min, no 6"
Con **0.5.2** la etapa ya **no** sigue encendida en batería. Lo esperado al desconectar el 24 V:
`EVT V5 PERDIDO` → `BACKUP inicio … modo reporte cada 10 min` → la etapa sigue ON entre **90 y 180 s**
(ventana de reporte) → `DUTY reposo: ventana Ns fix=… → etapa OFF, despierta en Ns` → `STAT … stack=OFF`,
LED corto cada 5 s, ventilador OFF. **Esperar 10 min desde el inicio de la ventana:** `DUTY despertar #1` →
etapa ON → nueva ventana → reposo. Solo entonces reconectar el 24 V: `EVT V5 PRESENTE` → `DUTY fin: 5 V
volvió — 1 ventanas, 0 omitidas` → `BACKUP fin`. Si la etapa **no se apaga** tras 180 s, el binario no es
0.5.2 (leer la primera línea de la consola). En el monitor la unidad debe quedar **en amarillo "batería",
no en rojo "desconectada"** durante el reposo — si aparece desconectada, el servidor no tiene el soporte `DUTY`.
## P4 — Cielo abierto: primer RTK (10 min)
Con antena GNSS con cielo despejado y base activa (`$$$AS+` configurado):

6
scripts/sync-docs.sh
View File

@ -22,12 +22,14 @@ declare -a MAP=(
"03-Architecture-Hardware/kicad/docs/GIT-GUIDE_Colaboradores-Externos_ES.md|docs/git/guia-git-es.md"
"03-Architecture-Hardware/kicad/docs/GIT-GUIDE_External-Collaborators_EN.md|docs/git/git-guide-en.md"
# Descargas para técnicos (firmware de bring-up v5)
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.2.bin|docs/descargas/hbox-v5-bringup_0.5.2.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.3.bin|docs/descargas/hbox-v5-bringup_0.5.3.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.2.bin|docs/descargas/superseded/hbox-v5-bringup_0.5.2.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.5.1.bin|docs/descargas/superseded/hbox-v5-bringup_0.5.1.bin"
"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.5.2.bin|docs/descargas/hbox-tarjetaV4_0.5.2.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.5.3.bin|docs/descargas/hbox-tarjetaV4_0.5.3.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.5.2.bin|docs/descargas/superseded/hbox-tarjetaV4_0.5.2.bin"
"04-Source-Code/firmware/release/hbox-tarjetaV4_0.5.1.bin|docs/descargas/superseded/hbox-tarjetaV4_0.5.1.bin"
"04-Source-Code/firmware/hbox_v5_bringup/README.md|docs/descargas/hbox-v5-bringup-README.md"
)