# Descargas

Archivos que el técnico necesita en el banco. Verificar el SHA-256 antes de flashear
(`shasum -a 256 archivo` en macOS, `sha256sum archivo` en Linux, `certutil -hashfile archivo SHA256` en Windows).

## Firmware de bring-up — EinarBoard v5

| Archivo | Versión | SHA-256 | Uso |
|---|---|---|---|
| [**hbox-v5-bringup_0.4.0.bin**](hbox-v5-bringup_0.4.0.bin) | **0.4.0** (2026-09-17) | `a8de74b3d7768e9d…` ([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):

```bash
dfu-util -a 0 -s 0x08000000:leave -D hbox-v5-bringup_0.4.0.bin
```

o con **STM32CubeProgrammer** → USB → Connect → Download del `.bin` en `0x08000000`.

!!! note "Tarjetas ya flasheadas con 0.1.1 / 0.2.0 / 0.2.1 / 0.3.0"
    Re-flashear con 0.4.0 por el mismo procedimiento DFU. **La primera línea de la consola tras reset dice la versión**
    (`hbox-v5-bringup 0.4.0 built …`): si la línea `STAT` no termina en `stack=…`, la tarjeta sigue con 0.1.1.

!!! tip "Consola 0.4.0"
    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 "0.4.0 = firmware de campo mínimo — AUTO de fábrica"
    Desde 0.4.0 el modo AUTO es el **de fábrica**: la etapa RTK se enciende sola 3 s después de ver 5 V en P2 — no hace falta consola
    ni teclear `A`. Incluye watchdog 16 s, ventilador (política v3.0.3), recuperación de enlace (ciclo de etapa si el F9P deja de
    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. Si se pierde el 5 V, la etapa **sigue encendida desde la batería**
    y la consola registra `EVT BACKUP inicio` / `BACKUP fin` con duración y tramas NMEA: esa es la prueba de respaldo.
    Se apaga sola si vbat < 3.40 V o temperatura > 50 °C. `A` de nuevo regresa a MANUAL. El cargador sigue apagado en todos los modos.

!!! warning "Solo para la tarjeta v5"
    Este firmware **no** es el de producción: solo prueba la tarjeta (reloj, USB, cristales, I²C,
    LEDs, ADC) sin encender la etapa RTK ni el cargador. **Nunca flashear `blackpillrtkcode_v3`
    (v3.0.3) en una v5.**

Notas de compilación y cambios: [README del firmware de bring-up](hbox-v5-bringup-README.md).

## Firmware de campo — tarjetas V3 y V4

Es el firmware que gobierna la unidad en la máquina (`blackpillrtkcode_v3` / `v4`), distinto del de
bring-up del v5. Se usa en el [reflasheo en taller](../procedimientos/reflasheo-unidades.md).

| Generación | Archivo | Estado |
|---|---|---|
| **V3** — flota desplegada (RTK-003, RTK-006, RTK-014) | `hbox-fw-v3_X.Y.Z.bin` | ⬜ **pendiente de publicar** |
| **V4** | `hbox-fw-v4_X.Y.Z.bin` | ⬜ **pendiente de publicar** |

!!! 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
    binarios de estas generaciones **no viven en el repositorio** (están en `.gitignore`): tienen que
    compilarse, probarse en banco y publicarse. El procedimiento de generación está en el
    [reflasheo §6](../procedimientos/reflasheo-unidades.md).

!!! warning "Un binario no sirve para otra generación"
    La polaridad del control de carga está **invertida** entre la tarjeta de producción y la de
    protoboard. Flashear el binario equivocado puede dejar la batería cargando justo cuando el
    firmware cree estarla protegiendo por temperatura — la falla #1 del RCA de junio.

## Parámetros del módem 4G NTRIP Master

La configuración se envía por el puerto USB **XBEE** del simpleRTK2B Pro a 115200 baudios, línea por
línea (solo las que empiezan con `$$$AS+`). Cada una debe contestar `OK`.

| Archivo | Qué es |
|---|---|
| [**4G_NTRIP_HelgenSRV-NMEA.example.txt**](4G_NTRIP_HelgenSRV-NMEA.example.txt) | **Plantilla** con todos los parámetros y sus nombres, con los valores sensibles en blanco |

!!! danger "El archivo con los valores reales no está aquí, y es a propósito"
    El archivo lleno contiene **usuario y contraseña del caster NTRIP y de la APN**. Publicarlo en el
    sitio sería ponerlo al alcance de cualquiera que tenga una cuenta de técnico, y meterlo al
    repositorio rompe un invariante del proyecto (*sin secretos en el repo, nunca*).

    **Cómo se obtiene:** pídelo a ingeniería para la unidad que vas a configurar. Llega por un canal
    directo, se usa y no se guarda en el equipo ni se reenvía.

Referencia rápida de los parámetros que más se consultan:

| Comando | Qué configura |
|---|---|
| `AS+I=1111` | Entra a modo configuración |
| `AS+A` · `AS+Q` · `AS+q` | APN: host, usuario, contraseña |
| `AS+S` · `AS+P` | Caster NTRIP: host y puerto |
| `AS+U` · `AS+M` | Caster: `usuario:contraseña` y mountpoint |
| `AS+B` | Velocidad del puerto (115200) |
| `AS+K` | **ID de estación** del módulo — se anota en el acta |
| `AS+r` · `AS+h` | Servidor secundario: IP y puerto |

## Firmware y configuración del simpleRTK2B Pro (ZED-F9P)

| Archivo | Estado | Notas |
|---|---|---|
| Configuración del ZED-F9P (u-center `.txt`) | ⬜ **pendiente de publicar** | UART1 a 115200 (es lo que lee la tarjeta) y UART2 a la velocidad del módem |
| Firmware del ZED-F9P (u-blox) | Se descarga de u-blox | Anotar la versión instalada con **UBX-MON-VER** |

Para leer o cargar la configuración: u-center → *Tools → Receiver Configuration*. Después de cargar,
**guardar en FLASH** y reconectar para confirmar que sobrevive al reinicio — una configuración que
solo quedó en RAM se pierde al primer corte de energía, y así perdimos tiempo en junio.

## Herramientas

- **STM32CubeProgrammer** (Windows/macOS/Linux): https://www.st.com/en/development-tools/stm32cubeprog.html
- **dfu-util** (macOS: `brew install dfu-util`; Linux: `apt install dfu-util`)
- Terminal serie: CoolTerm, `screen /dev/tty.usbmodem* 115200`, o el monitor serie de Arduino IDE