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

Antes de tocar una unidad, abre su expediente en 🗂 Expediente de una unidad (escribe el H00xx) y lee las actas anteriores.
Sigue el procedimiento de la sección que corresponda (abajo). No cambies el orden de los pasos.
Al terminar, llena el acta (▶) del procedimiento que hiciste. Sin acta, el trabajo no existe.
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)

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).

6.2 KiB Raw Blame History