Volver a los proyectos
Especificaciones del proyecto
Símbolos esquemáticos81
Footprints PCB106
Controles automatizados de CI6 verificaciones deterministas
Revisión en AltiumLista de 4 puntos basada en datasheets
LicenciaCERN-OHL-P-2.0

El problema

Una proporción alta de los respins costosos de PCB empieza mucho antes del ruteo: nace en la librería de componentes. Un pin invertido en un símbolo esquemático, una marca de pin 1 espejada, un taladro subdimensionado en un conector de potencia o un land pattern descargado sin verificar pueden convertir dos semanas de fabricación en tarjetas inservibles.

Al mismo tiempo, las librerías nativas de Altium Designer (.SchLib y .PcbLib) son archivos binarios compuestos y opacos. Un git diff convencional no muestra si un pad se desplazó 0.2 mm, si un binario se corrompió al guardarse o si se colaron archivos temporales e historiales automáticos de Altium en un commit.

A lo largo de varios años de proyectos de hardware (2019–2026) reuní mis componentes reutilizables en Personal-Altium-Library, publicados bajo licencia CERN-OHL-P-2.0. Para que un repositorio binario de EDA resulte confiable tanto para uso propio como para otros ingenieros, combiné los archivos de librería con un flujo de validación en dos capas inspirado en la disciplina de entregas de software.

Qué cubre la librería

El repositorio mantiene dos librerías de Altium cuyos tamaños exactos y resúmenes SHA-256 quedan registrados en library-manifest.json:

  • AltiumLibraryDDT.SchLib (396,800 bytes) — 81 símbolos esquemáticos.
  • AltiumLibraryDDT.PcbLib (36,292,608 bytes) — 106 footprints PCB.

Según docs/INVENTORY.md, el catálogo agrupa bloques reales de proyectos de hardware en lugar de piezas sintéticas: pasivos SMD en encapsulados 0402/0603/1206, diodos de alto voltaje, borneras y headers con shroud, módulos inalámbricos (ESP32-DEVKITC-32D, ESP8266_ESP-12, HM-10), módulos de potencia (LM2596, MT3608, Mini-360), sensores de celda de carga y corriente (HX711, ACS758LCB-050B), relés (G5LE) y conectores micro-SD.

Validación en dos capas para archivos binarios de EDA

Como la automatización en CI no reemplaza el ojo de un ingeniero electrónico revisando cobre en Altium, docs/VALIDATION.md separa lo que la máquina puede garantizar de lo que exige revisión manual dentro de la herramienta EDA.

Capa 1: Integridad automática del repositorio (CI)

Ejecutar python3 scripts/validate_repository.py en local y en GitHub Actions (quality.yml) aplica seis verificaciones deterministas en cada push y pull request:

  1. Existen los archivos requeridos de proyecto, licencia y aviso de ingeniería.
  2. Tanto .SchLib como .PcbLib conservan firmas válidas de archivo compuesto binario (detectando de inmediato commits truncados o corruptos).
  3. Los tamaños en bytes y checksums SHA-256 coinciden exactamente con library-manifest.json.
  4. Los conteos declarados (81 símbolos y 106 footprints) coinciden con el inventario en docs/INVENTORY.md.
  5. Todos los enlaces internos de documentación en Markdown resuelven sin errores.
  6. Se bloquea el ingreso de respaldos, cachés y archivos autogenerados por Altium.

Cuando un componente se agrega o modifica intencionalmente, scripts/update_manifest.py actualiza el manifiesto —y la política prohíbe aceptar un cambio de hash sin comprobar primero qué entradas específicas cambiaron.

Capa 2: Compuerta manual de ingeniería en Altium

Antes de aceptar un símbolo o footprint modificado, docs/VALIDATION.md exige un lista de 4 puntos dentro de Altium:

  • Integridad de librería: Abrir y guardar ambas librerías sin advertencias de conversión o reparación y correr las validaciones internas.
  • Revisión de esquemático: Contrastar cada número de pin, nombre, tipo eléctrico, pin oculto de alimentación, designador y vínculo de footprint directamente contra el datasheet vigente del fabricante.
  • Revisión de footprint: Verificar geometría de pads, numeración, taladros, thermal pads, solder mask, pasta, serigrafía, courtyard, indicador de pin 1 y altura del modelo 3D frente al land pattern recomendado y las tolerancias del fabricante de PCB.
  • Revisión de integración: Colocar el símbolo en un esquemático temporal, transferirlo a una PCB temporal, comprobar cada mapeo pin-a-pad, correr ERC y DRC e inspeccionar ambas caras en 2D y 3D.

Aprendizaje clave

La confiabilidad en hardware conectado empieza por hábitos sobrios y repetibles: manifiestos versionados, verificación contra datasheet y límites honestos sobre lo que la automatización cubre y lo que no. Personal-Altium-Library funciona a la vez como recurso abierto y como muestra concreta de cómo estructuro una revisión de PCB antes de liberar Gerbers a fabricación.

Fuentes

Ver consultoría