Revisiones y cambios
Control de revisiones hardware: guía práctica para equipos de electrónica
Por qué el hardware necesita su propio enfoque, qué significa congelar de verdad, un proceso de cinco reglas y un ejemplo a lo largo de dieciocho meses.
Qué es el control de revisiones de hardware
El control de revisiones de hardware consiste en identificar cada estado de un diseño, congelar los estados que se fabrican, y mantener juntos los documentos que describen cada estado — de forma que puedas contestar, en cualquier momento futuro, qué era exactamente una tarjeta concreta.
No es control de versiones en el sentido del software. No hay ramas, no hay mezclas, y los archivos son en su mayoría binarios. Lo que sí toma prestado del software es la idea de que un estado liberado tiene que ser identificable e inmutable.
Por qué el hardware necesita su propio enfoque
Tres diferencias hacen que las herramientas de software encajen mal.
Los artefactos no son texto. Comparar dos esquemáticos línea a línea no significa nada. Dos rutados que se diferencian en una pista movida producen archivos completamente distintos.
No hay mezcla. Dos ingenieros no pueden editar un rutado a la vez y combinar los resultados. El trabajo de hardware se serializa de una forma en que el de software no.
Una revisión tiene consecuencias físicas. Una versión de software se puede revertir. Cuatrocientas tarjetas no. Esa asimetría es la razón de que los procesos de hardware pongan el peso en la aprobación antes de liberar, y no en corregir después.
Las tres cosas que se revisan
Confundirlas es la fuente más común de desorden, y cada una tiene su propio artículo porque cada una lo merece.
| Qué | Cambia cuando | Ejemplo |
|---|---|---|
| Revisión de PCB | cambia la placa desnuda: cobre, huellas, contorno | Rev B → Rev C |
| Revisión de tarjeta montada | cambia lo que se monta sin cambiar la placa | Rev C-1 → Rev C-2 |
| Revisión de BOM | cambia la lista de piezas | rev 3 → rev 4 |
Una sola revisión de PCB lleva normalmente varias revisiones de BOM a lo largo de su vida. Una sustitución no obliga a una placa nueva.
Qué significa «congelar» de verdad
Una revisión congelada es la que no se puede editar. No «no se debería»: no se puede.
Ésta es la parte que separa un control de revisiones real de un convenio de nombres. Si la carpeta de la revisión que se fabricó sigue siendo escribible, entonces un año después no puedes estar seguro de que siga conteniendo lo que se fabricó. Alguien puede haber corregido una errata, sustituido un archivo o hecho limpieza. Normalmente con buena intención.
Una vez congelada una revisión, una corrección produce una revisión nueva. La primera vez parece pesado, y es justo de lo que se trata: el registro de lo que se fabricó tiene que ser más duradero que la comodidad de editarlo.
Un proceso mínimo que funciona
Para un equipo pequeño esto basta, y es bastante mejor que nada:
- Cada revisión liberada tiene un identificador que vive en los datos, no
sólo en un nombre de archivo.
- El identificador aparece dentro de los archivos: en la serigrafía si cabe,
en el plano de fabricación, en la BOM, en la nota de entrega.
- Los paquetes liberados son de sólo lectura. Con el mecanismo que tengas:
un directorio que nadie edita, un archivo comprimido, una etiqueta.
- Una persona aprueba cada entrega, y su nombre queda registrado con la
fecha.
- Los cambios entre revisiones se escriben, una línea por cambio, con el
motivo.
Cinco reglas. Ninguna necesita software para empezar, y las cinco sobreviven a que llegue software después.
Qué debe contener una entrega
Una entrega es un conjunto de documentos con nombre que describen en conjunto un estado fabricable:
- paquete de fabricación: Gerbers, taladros, stackup, plano de fabricación;
- paquete de montaje: BOM, centroide, plano de montaje;
- el esquemático en PDF, para personas y no para herramientas;
- una nota de entrega con qué cambió y por qué;
- la identidad: revisión de tarjeta, identificador de entrega, fecha, quién
aprobó.
Todo lo que lleva dentro comparte el mismo identificador. Nada cambia después de emitirla.
De dónde salen los esquemas de revisión, y por qué varían
No hay convención universal, y los equipos que discuten entre letras y números suelen estar discutiendo sobre nada.
Patrones habituales:
- Letras para placas, números para documentos. Rev C de la tarjeta, rev 4 de
la BOM. Hace que las dos se distingan a simple vista, que es la ventaja principal.
- Numeración con prefijo de prototipo.
P1,P2, y1.0en la primera
producción. Comunica madurez.
- Por fecha. Inequívoco, sin discusiones de secuencia, pero no da ninguna
pista de cuánto cambió.
Elige uno, escríbelo y aplícalo con coherencia. El esquema importa muchísimo menos que la coherencia, y muchísimo menos que si el identificador está guardado en los datos o sólo en un nombre de archivo.
Un ejemplo
La ORION CONTROL UNIT, producto ficticio, tarjeta principal, a lo largo de dieciocho meses:
| Revisión | Cambio | Qué se movió |
|---|---|---|
| Rev A | primer prototipo, 5 tarjetas | — |
| Rev A, BOM rev 2 | C12–C18 pasan a X7R tras ensayos de temperatura | sólo la BOM |
| Rev B | corregida la partición del plano de masa, J1 movido 2 mm | PCB, Gerbers, plano de montaje |
| Rev B, BOM rev 3 | aprobada segunda fuente para R22 | sólo la BOM |
| Rev C | J1 sustituido: el original quedó EOL, otra huella | PCB, Gerbers, BOM rev 4, plano |
| Rev C-2 | R7 pasa a DNP en la variante de exportación | BOM rev 5, centroide, plano — no el PCB |
Datos de muestra. Fíjate en el patrón: de seis cambios, dos necesitaron placa nueva. El resto cambió la lista de piezas o lo que se monta, que es exactamente por qué las revisiones de BOM y de PCB tienen que ser números separados.
Errores habituales
La revisión vive sólo en el nombre del archivo. Los archivos se copian y se renombran. Los datos no.
Reutilizar un designador tras retirarlo. Una R7 retirada en la rev C no debe volver en la rev D significando otra cosa.
Editar un paquete liberado. Aunque sea una corrección trivial. Destruye la única garantía que la entrega ofrecía.
No dejar constancia del porqué. «Rev C» sin nota significa que dentro de dos años la única forma de entender el cambio es comparar los Gerbers y adivinar.
Revisarlo todo a la vez. Si cada cambio de BOM obliga a una revisión de PCB, la gente deja de emitir revisiones. Deja que los relojes corran por separado.
Aprobación de nadie. Si no hay un nombre, no hay decisión: hay un archivo que apareció.
El proceso de arriba funciona sobre el papel, y muchos equipos lo llevan en una unidad compartida. Lo que una unidad compartida no puede hacer es impedirte editar un paquete liberado, ni decirte qué BOM pertenece a la revisión que se entregó.
En XKEMA cada elemento lleva su propia cadena de versiones, una versión aprobada queda congelada con una huella verificable de lo que se aprobó, y dos versiones se pueden comparar: filas de BOM, páginas de PDF, geometría Gerber.