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

descargas: bring-up 0.2.1 (78b34f46), 0.2.0 retired

Browse Source
This commit is contained in:
Leopoldo Rodríguez 2026-09-17 18:51:53 -06:00
parent 1a31352bda
commit 24c57308b7
5 changed files with 26 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/descargas/SHA256SUMS.txt
View File

@ -1 +1 @@
8491625d494f9ee19a2cc0a7b00d62cc4ba5c08f0ada16572ac163ee10bf1e77 hbox-v5-bringup_0.2.0.bin 78b34f4603550c05fd4fd739a13fc20556d5e04816324271b9ef0f85b49ce092 hbox-v5-bringup_0.2.1.bin

18
docs/descargas/hbox-v5-bringup-README.md
View File

@ -1,7 +1,7 @@
# hbox_v5_bringup — EinarBoard v5 first-flash bring-up firmware # hbox_v5_bringup — EinarBoard v5 first-flash bring-up firmware
Bench-proves a newly assembled v5 board over USB-C **J11** only. Never powers the RTK stack. Bench-proves a newly assembled v5 board over USB-C **J11** only. Never powers the RTK stack.
Bench mode (0.2.0): `P`+`Y` stack ON/OFF, `n` NMEA monitor (fix 4 = RTK FIX). Bench mode: `P`+`Y` stack ON/OFF, `n` NMEA monitor (fix 4 = RTK FIX). Console (0.2.1): CR+LF lines, `EVT` on every state change, named `STAT` every 5 s, `$PHLG` every 10 s in the fleet v3.x layout (server-parseable).
Checks: HSE 25 MHz + USB CDC · LSE Y4 · I2C: PCF8574 0x20 / SHT40 0x44 / TMP102 0x48 / Checks: HSE 25 MHz + USB CDC · LSE Y4 · I2C: PCF8574 0x20 / SHT40 0x44 / TMP102 0x48 /
SC16IS752 0x4D · gauge + RGB LED walk · ADC · digital inputs. Prints PASS/FAIL, then a SC16IS752 0x4D · gauge + RGB LED walk · ADC · digital inputs. Prints PASS/FAIL, then a
`STAT` line every 2 s. Console commands: `r` rerun · `g` gauge walk · `i` I2C scan · `h` help. `STAT` line every 2 s. Console commands: `r` rerun · `g` gauge walk · `i` I2C scan · `h` help.
@ -23,18 +23,28 @@ generic variant defaults to HSI, which is not accurate enough for USB.
## Flash (DFU, J11) ## Flash (DFU, J11)
Hold **SW2** (BOOT0) → tap **SW1** (RESET) → release SW2 → device `0483:DF11` appears. Hold **SW2** (BOOT0) → tap **SW1** (RESET) → release SW2 → device `0483:DF11` appears.
```bash ```bash
dfu-util -a 0 -s 0x08000000:leave -D release/hbox-v5-bringup_0.2.0.bin dfu-util -a 0 -s 0x08000000:leave -D release/hbox-v5-bringup_0.2.1.bin
``` ```
or STM32CubeProgrammer → USB → Connect → Download `release/hbox-v5-bringup_0.2.0.bin` @ `0x08000000`. or STM32CubeProgrammer → USB → Connect → Download `release/hbox-v5-bringup_0.2.1.bin` @ `0x08000000`.
## Release ## Release
| File | Version | SHA-256 (first 16) | Size | | File | Version | SHA-256 (first 16) | Size |
|---|---|---|---| |---|---|---|---|
| **`release/hbox-v5-bringup_0.2.0.bin`** | **0.2.0 (2026-09-17) — USE THIS** | `8491625d494f9ee1` | 64 780 B | | **`release/hbox-v5-bringup_0.2.1.bin`** | **0.2.1 (2026-09-17) — USE THIS** | `78b34f4603550c05` | 70 084 B |
| `release/superseded/hbox-v5-bringup_0.2.0.bin` | 0.2.0 — superseded (LF-only console, no EVT/$PHLG) | `8491625d494f9ee1` | 64 780 B |
| `release/hbox-v5-bringup_0.1.1.bin` | 0.1.1 — superseded (no bench mode) | `91ca6f87a86686be` | 55 104 B | | `release/hbox-v5-bringup_0.1.1.bin` | 0.1.1 — superseded (no bench mode) | `91ca6f87a86686be` | 55 104 B |
| `release/hbox-v5-bringup_0.1.0.bin` | 0.1.0 — SUPERSEDED (no float printf, ETH_CS driven) | `1a9a77ae479c8f86` | 41 040 B | | `release/hbox-v5-bringup_0.1.0.bin` | 0.1.0 — SUPERSEDED (no float printf, ETH_CS driven) | `1a9a77ae479c8f86` | 41 040 B |
## Changelog ## Changelog
- **0.2.1** (2026-09-17): console made monitorable — every line ends CR+LF (no more PuTTY staircase); `EVT up=…` line on every
state change (stack ON/OFF with reason and the expected voltages, ignition edge, 5 V present/lost, charger status/fault edges,
first NMEA frame / NMEA lost >5 s, GGA fix-quality change, stack refused/cancelled); `STAT` every 5 s with named values
(`ign=ON`, `chrg=idle`, `flt=none`, `tntc=n/c`, `i2cerr=`, `t_on=`, `nmea=`/`bad=`); `$PHLG` every 10 s + after each stack change,
**same 24-field layout + XOR checksum as fleet fw v3.x** (verified against `htracker/retranslator.py::_parse_phlg`; `fw=0.2.1-bu`,
`state=BENCH|RUN`, `link=SRCH|DEGR|OK`); NMEA checksum verified (bad frames counted as `rxbad`); `P` arms non-blocking (10 s window),
`Y` confirms; new commands `t` ($PHLG now), `l` (field legend), `v` (multimeter checkpoints for the stack gate: SYS5V/PWR_CTRL/GATE_LS/SW_5V);
stack auto-OFF if 5 V is lost; `v5=…(BAJO)` + EVT when VEH5V drops under 4.6 V (LTC4040 PFI zone: PFI divider R51 270k/R52 100k
→ 4.44 V falling, backup VSYS 4.79 V via R53 499k/R54 100k) — the 24-Jul modem-hiccup mechanism, now visible in the log. Build: no-op ctags + explicit definition order (arduino/ctags unreachable from the build host).
- **0.2.0** (2026-09-17): bench mode for the assembled unit — `P`+`Y` powers the RTK stack (only with 5 V on P2), - **0.2.0** (2026-09-17): bench mode for the assembled unit — `P`+`Y` powers the RTK stack (only with 5 V on P2),
`P` again turns it off; `n` streams `$GxGGA` from the simpleRTK2B UART1 (PA3, 115200) for 20 s with fix/sats/HDOP; `P` again turns it off; `n` streams `$GxGGA` from the simpleRTK2B UART1 (PA3, 115200) for 20 s with fix/sats/HDOP;
`STAT` shows `stack=` and the last GGA. Charge stays disabled, K1 released. Uses the core's `Serial2` (USART2). `STAT` shows `stack=` and the last GGA. Charge stays disabled, K1 released. Uses the core's `Serial2` (USART2).

BIN
docs/descargas/hbox-v5-bringup_0.2.0.bin → docs/descargas/hbox-v5-bringup_0.2.1.bin
View File

Binary file not shown.

14
docs/descargas/index.md
View File

@ -7,18 +7,24 @@ Archivos que el técnico necesita en el banco. Verificar el SHA-256 antes de fla
| Archivo | Versión | SHA-256 | Uso | | Archivo | Versión | SHA-256 | Uso |
|---|---|---|---| |---|---|---|---|
| [**hbox-v5-bringup_0.2.0.bin**](hbox-v5-bringup_0.2.0.bin) | **0.2.0** (2026-09-17) | `8491625d494f9ee1…` ([SHA256SUMS](SHA256SUMS.txt)) | 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.2.1.bin**](hbox-v5-bringup_0.2.1.bin) | **0.2.1** (2026-09-17) | `78b34f4603550c05…` ([SHA256SUMS](SHA256SUMS.txt)) | 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): Flasheo por DFU en **J11** (mantener **SW2**, pulsar y soltar **SW1**, soltar SW2):
```bash ```bash
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.2.0.bin dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.2.1.bin
``` ```
o con **STM32CubeProgrammer** → USB → Connect → Download del `.bin` en `0x08000000`. o con **STM32CubeProgrammer** → USB → Connect → Download del `.bin` en `0x08000000`.
!!! note "Tarjetas ya flasheadas con 0.1.1" !!! note "Tarjetas ya flasheadas con 0.1.1 / 0.2.0"
Re-flashear con 0.2.0 por el mismo procedimiento DFU antes del ensamble: 0.1.1 no tiene el modo de banco. Re-flashear con 0.2.1 por el mismo procedimiento DFU. **La primera línea de la consola tras reset dice la versión**
(`hbox-v5-bringup 0.2.1 built …`): si la línea `STAT` no termina en `stack=…`, la tarjeta sigue con 0.1.1.
!!! tip "Consola 0.2.1"
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
(misma trama de salud que lee el servidor). Teclear `l` para la leyenda y `v` para los puntos de medición de la etapa RTK.
Para encender la etapa RTK: `P` y luego `Y` (requiere 5 V en P2).
!!! warning "Solo para la tarjeta v5" !!! warning "Solo para la tarjeta v5"
Este firmware **no** es el de producción: solo prueba la tarjeta (reloj, USB, cristales, I²C, Este firmware **no** es el de producción: solo prueba la tarjeta (reloj, USB, cristales, I²C,

2
scripts/sync-docs.sh Executable file → Normal file
View File

@ -21,7 +21,7 @@ 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_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" "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) # Descargas para técnicos (firmware de bring-up v5)
"04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.2.0.bin|docs/descargas/hbox-v5-bringup_0.2.0.bin" "04-Source-Code/firmware/hbox_v5_bringup/release/hbox-v5-bringup_0.2.1.bin|docs/descargas/hbox-v5-bringup_0.2.1.bin"
"04-Source-Code/firmware/hbox_v5_bringup/release/SHA256SUMS|docs/descargas/SHA256SUMS.txt" "04-Source-Code/firmware/hbox_v5_bringup/release/SHA256SUMS|docs/descargas/SHA256SUMS.txt"
"04-Source-Code/firmware/hbox_v5_bringup/README.md|docs/descargas/hbox-v5-bringup-README.md" "04-Source-Code/firmware/hbox_v5_bringup/README.md|docs/descargas/hbox-v5-bringup-README.md"
) )