--- title: Guía para el ingeniero — qué hacer en drogheda.helgen.online project: Project Drogheda date: 2026-09-29 tags: [project-drogheda, procedimientos, sitio, ingeniero] --- # Guía para el ingeniero — qué hacer en drogheda.helgen.online El sitio es el **puesto de trabajo documental** del HBOX: ahí están los procedimientos, los binarios de firmware, los manuales de cada tarjeta y las **actas** que dejan constancia de cada trabajo. Nada se hace "de memoria": cada tarjeta, módulo o unidad que pasa por tus manos termina con un acta guardada en el sitio. !!! note "Acceso" Usuario y contraseña te los entrega Leo. Cámbiala la primera vez en **👤 Mi cuenta**. El sitio es interno: no compartas ligas ni descargas fuera de Helgen. ## 1. Regla de oro 1. **Antes de tocar** una unidad, abre su expediente en **🗂 Expediente de una unidad** (escribe el H00xx) y lee las actas anteriores. 2. **Sigue el procedimiento** de la sección que corresponda (abajo). No cambies el orden de los pasos. 3. **Al terminar, llena el acta** (▶) del procedimiento que hiciste. Sin acta, el trabajo no existe. 4. Si algo no cuadra con el procedimiento (valor fuera de rango, paso imposible), **no improvises**: anótalo en "Observaciones" del acta y avisa a Leo. ## 2. Qué abrir según la situación | Situación | Sección del sitio | Qué haces | Acta | |---|---|---|---| | Llegan tarjetas nuevas de JLC (lote V5.6) | 🏭 Producción — lote v5 → **1 · Prueba y flasheo** | Inspección, flasheo con el binario de **📥 Descargas** (verifica el SHA-256), autoprueba PASS | ▶ Acta de tarjeta V5 | | Montar simpleRTK2B y módem 4G | Producción → **2 · Módulos RTK y 4G** | Configurar módulos, verificar fix RTK y registro 4G | ▶ Acta ArduSimple · ▶ Acta módem 4G · ▶ Acta de integración | | Armar la unidad en el gabinete | Producción → **3 · Ensamble** | Arneses según **🔩 Pinout de arneses** (V5.6: **Pinout de conectores V5.6** en 🛠 Hardware), paquete de batería de la química correcta (JP2) | ▶ Acta de ensamble | | Dejarla lista para embarcar | Producción → **4 · Prueba final** y **5 · Configuración de la unidad** | Parámetros 4G/NTRIP (plantilla, nunca credenciales en el sitio), identidad H00xx en el monitor, Ethernet y puertos serie **solo si el cliente los usa** | ▶ Acta de tarjeta / integración | | El cliente usa Ethernet o RS-485/RS-232 | 🔬 Taller → **🔌 Prueba: Ethernet y puertos serie** | Prueba de banco con el binario `-eth`, cable directo a la laptop, `nc -lk 5010` | ▶ Acta: Ethernet y puertos serie | | Enviar o recibir unidades | 📦 Ciclo de vida | Acta de envío al salir; acta de recepción **por cada caja** antes de ir al puerto | ▶ Envío · ▶ Recepción · ▶ Daño | | Instalar en el puerto | Producción → **6 · Checklist de puesta en marcha** + 📕 **Manual del cliente (PDF)** | Montaje, antenas, 24 V, LEDs, aparece en el monitor, prueba de 5 min en batería; entrega el PDF al cliente | ▶ Acta de diagnóstico en campo (tipo instalación) | | Una unidad falla en la máquina | 🚜 Campo → **Cómo se diagnostica en campo** | Diagnóstico por LEDs y monitor; no abras la tarjeta en sitio | ▶ Acta de diagnóstico en campo | | La unidad llega al taller | 🔬 Taller → **Cómo se diagnostica en banco** → **Reflasheo** → **Prueba: módem 4G en batería** | Banco con fuente ≥ 5.2 V o paquete conectado; reflasheo con SHA-256 verificado; prueba de batería si el reporte es "se apaga en batería" | ▶ Acta de banco · ▶ Acta de reflasheo · ▶ Acta de prueba de batería | | Necesitas un pinout, un voltaje, un jumper, una dirección I²C | 🛠 **Hardware** → Hoja de datos EinarBoard V5.6 · Pinout V5.6 / 📘 **Manuales por tarjeta** | Consulta; no adivines valores | — | | Tienes una V3 o V4 en la mesa | 📘 Manuales por tarjeta → V3 / V4 | Firmware correcto por tarjeta (`hbox-tarjetaV3_4.0.0`, `hbox-tarjetaV4_0.6.0`): **nunca** cruces binarios entre tarjetas | ▶ Acta de prueba V4 / reflasheo | ## 3. Descargas: cómo usarlas bien - Usa **solo** los binarios de la tabla verde de **📥 Descargas**. La carpeta `superseded/` es histórico: no se instala en unidades. - Antes de flashear, compara el SHA-256 del archivo con el de `SHA256SUMS.txt` (el procedimiento de reflasheo dice cómo). - El archivo de parámetros 4G del sitio es una **plantilla**. Las credenciales reales (APN, caster) las carga Leo o están en el servidor; nunca las escribas en un acta ni en el sitio. ## 4. Lo que no se hace - No cambies la química del paquete (Li-ion 18650 en V5.5, LFP-HT 26650 en V5.6) sin verificar el puente **JP2** de la tarjeta: química y puente cruzados es una falla, no una opción. - No cierres **JP5** (terminación RS-485) en las dos puntas del mismo bus. - No pruebes Ethernet ni el módem con la tarjeta solo en batería en el banco: fuente de 5 V ≥ 5.2 V o paquete conectado. - No apagues y prendas el stack RTK con la unidad en batería "para ver si vuelve": en V5.5 el módem se queda a oscuras (solo RESET 4G o 24 V lo reviven). Está en el procedimiento de banco. - No edites procedimientos por tu cuenta: si un paso está mal, díselo a Leo con el número de paso. ## 5. Cuando algo falta en el sitio Escríbele a Leo con: la página, el paso, qué esperabas y qué encontraste. Las páginas se corrigen en el repositorio `Drogheda` y se vuelven a publicar; tú no necesitas tocar Git. --- ## Anexo (solo quien publica el sitio — Leo) ```bash cd ~/Documents/Claude/Projects/Drogheda/hbox-docs ./scripts/sync-docs.sh # copia desde el repo lo que está en la lista MAP (política de publicación) mkdocs build --strict # tiene que terminar sin WARNING ./scripts/deploy.sh # rsync del sitio + backend al servidor # nuevos tipos de acta: actualizar ACTAS_REPETIBLES en /etc/systemd/system/actas-hbox.service # (ya incluye prueba-ethernet-serie en backend/actas-hbox.service y DESPLIEGUE.md), luego # sudo systemctl daemon-reload && sudo systemctl restart actas-hbox git add -A && git commit -m "docs: manuales por tarjeta, datasheet V5.6, configuración/Ethernet/serie, manual de cliente v2.0, guía del ingeniero" && git push ``` | Versión | Fecha | Cambio | |---|---|---| | 1.0 | 2026-09-29 | Primera versión (sitio con manuales por tarjeta, hoja de datos V5.6 y procedimientos 5/6). |