Wordspecs

Blog

Software de fichas técnicas para startups de hardware: mantén coherente cada producto

Beta privada. El acceso es por lista de espera y los planes de pago se abren cuando termine la beta. Apúntate a la lista de espera.

Una startup de hardware suele lanzar su segundo producto con una ficha técnica copiada del primero. Al llegar al cuarto producto, las tablas usan unidades distintas, las secciones aparecen en otro orden y nadie tiene la certeza de qué revisión tiene un cliente. El software de fichas técnicas evita esa deriva al fijar las secciones, las columnas de las tablas y la notación, y al registrar cada revisión.

Qué necesita una ficha técnica

Dónde empieza la deriva

La deriva viene de copiar un archivo antiguo y editarlo. Se añade una columna a una tabla pero no a otra, "mA" pasa a ser "miliamperios", una sección cambia de lugar. Cada cambio es pequeño, pero juntos hacen que una gama de productos parezca improvisada.

El caso más claro es un mismo parámetro escrito de forma distinta en una gama de productos. Estas son tres fichas técnicas de una familia ficticia de sensores, TH-210, TH-215 y TH-230, que describen el mismo estado de bajo consumo entre mediciones:

Ficha técnicaNombre tal como apareceValor tal como apareceNombre normalizadoValor normalizado
TH-210Corriente en reposo0,4 uA típ.Corriente de alimentación, modo reposo0,4 µA típ.
TH-215Corriente de alimentación en espera400 nA típ.Corriente de alimentación, modo reposo0,4 µA típ.
TH-230Idd (reposo)0,0004 mA típ.Corriente de alimentación, modo reposo0,4 µA típ.

El mismo valor aparece de tres formas. La regla que lo corrige tiene tres partes:

Una tabla de características eléctricas de ejemplo

La tabla siguiente corresponde al TH-210, un sensor ficticio de temperatura y humedad. Todos los valores son inventados para este ejemplo, y son coherentes entre sí: en cada fila, el mínimo, el típico y el máximo están en orden.

ParámetroMín.Típ.Máx.UnidadCondiciones de prueba
Tensión de alimentación, VDD1,623,33,6VRango de funcionamiento
Corriente de alimentación, medición-120180µAVDD = 3,3 V, TA = 25 °C, una medición por segundo, media
Corriente de alimentación, modo reposo-0,41,2µAVDD = 3,3 V, TA = 25 °C, entre mediciones
Rango de medición de humedad relativa0-100%RHRango completo, VDD = 3,3 V
Error de medición de temperatura-0,50,10,5°Cde 15 a 40 °C ambiente, VDD = 3,3 V
Tiempo de medición-812msUna lectura de temperatura y una de humedad, VDD = 3,3 V

Reglas de notación que mantienen legible una tabla así:

Historial de revisiones y nomenclatura

Cada revisión del TH-210 registra la fecha, el cambio y por qué importa a quien tiene esa revisión.

RevisiónFechaQué cambióPor qué importa al lector
Rev A2026-02-10Primera publicación. Corriente en reposo típica de 0,6 µA, máxima de 1,5 µA.Línea base. Los diseños basados en ella arrastran la cifra de reposo más alta.
Rev B2026-05-12Corriente de alimentación, modo reposo: típica de 0,6 µA a 0,4 µA, máxima de 1,5 µA a 1,2 µA, tras un cambio de firmware.Las estimaciones de autonomía de batería hechas con la Rev A son pesimistas. Conviene recalcularlas con los valores de la Rev B.
Rev C2026-09-30Tiempo de medición máximo de 10 ms a 12 ms. Se añaden condiciones de prueba al error de medición de temperatura.Los presupuestos de tiempo basados en 10 ms necesitan el nuevo máximo. Las condiciones añadidas indican dónde se aplica la cifra de error.

Conviene nombrar la revisión para que un cliente pueda saber cuál tiene. Hay que poner juntos el ID del documento y la letra, por ejemplo TH-210-DS Rev C, en la portada y en el pie de cada página. El pie importa porque una sola página puede imprimirse o enviarse por correo por separado. La letra avanza con cualquier cambio en un valor, una condición, un código de pedido o un requisito, incluidas las correcciones pequeñas, de modo que dos documentos distintos nunca compartan letra. La fecha se mantiene en la tabla de historial y no en el nombre, porque una fecha puede indicar la fecha de publicación o la de impresión. La letra de revisión no forma parte de la referencia: las unidades vendidas con la Rev A y con la Rev C tienen el mismo código de pedido.

Información de pedido

Una referencia del TH-210 se forma con códigos que se leen de izquierda a derecha: serie, salida, cable y embalaje. Por ejemplo, TH-210-D-2-B es el TH-210 con salida digital I2C, cable de 300 mm y embalaje a granel.

SegmentoCódigoSignificado
SerieTH-210Módulo de temperatura y humedad, documentado en TH-210-DS
SalidaDSalida digital, I2C
SalidaUSalida digital, UART
Cable1Módulo sin cable
Cable2Cable de 300 mm
Cable3Cable de 1 m
EmbalajeBBolsa a granel, 100 uds.
EmbalajeTCinta y carrete, 1000 uds.

No todas las combinaciones están en existencias, así que conviene consultar la lista de existencias antes de presupuestar a un cliente. La letra de revisión nunca aparece en la referencia.

Lista de comprobación previa al lanzamiento

  1. El ID del documento y la letra de revisión aparecen en la portada y en el pie de cada página.
  2. Cada fila eléctrica tiene un valor o un guion. Ninguna celda está vacía.
  3. El mínimo, el típico y el máximo están en orden en cada fila, y cada valor se remonta a un informe de prueba cuyo número figura en el archivo interno.
  4. Cada fila indica sus condiciones de prueba, incluidas la tensión de alimentación y la temperatura ambiente.
  5. Los nombres de parámetros, las unidades y los símbolos coinciden con las reglas de notación y con la revisión anterior.
  6. Las cifras ambientales y mecánicas coinciden con el plano vigente y con los registros de prueba.
  7. Cada código de pedido se descifra con la tabla de referencias, y cada variante en existencias aparece en ella.
  8. Cada valor modificado tiene una fila en el historial de revisiones con el motivo del cambio.
  9. El orden de las secciones y las columnas de las tablas coinciden con la plantilla, no con el documento anterior.
  10. Las normas que se aplican al producto y al mercado se han revisado, y el documento contiene las declaraciones que exigen.
  11. Se ha exportado el PDF y se han comprobado la numeración de páginas, la revisión del pie y los enlaces.

Wordspecs para fichas técnicas

Wordspecs incluye una plantilla de ficha técnica de hardware con campos eléctricos, ambientales, mecánicos y de pedido. La hoja de ejemplo del TH-210 (un sensor ficticio) muestra el diseño. Las plantillas guardadas permiten conservar las columnas de tabla y la redacción propias para cada producto, y el plan Team añade plantillas compartidas e historial de versiones.

Relacionado: qué plantilla encaja con cada documento.

Apuntarme a la lista de espera