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
- Descripción y características principales: dos o tres líneas sobre lo que hace el producto, y hasta cinco características que un comprador puede verificar.
- Características eléctricas: una tabla con las columnas Parámetro, Mín., Típ., Máx., Unidad y Condiciones de prueba. El ejemplo siguiente usa exactamente estas columnas.
- Límites ambientales: temperatura de funcionamiento y de almacenamiento, rango de humedad y grado de protección IP, cada uno con una nota sobre cómo se midió.
- Detalles mecánicos: dimensiones con una referencia al plano, peso, conector y datos de montaje.
- Datos de radio, cuando el producto tiene radio: rango de frecuencias, potencia de salida y alcance en las condiciones indicadas.
- Información de pedido: las reglas que asocian una referencia con una variante.
- ID del documento y revisión en cada página, para que el lector sepa qué versión tiene.
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écnica | Nombre tal como aparece | Valor tal como aparece | Nombre normalizado | Valor normalizado |
|---|---|---|---|---|
| TH-210 | Corriente en reposo | 0,4 uA típ. | Corriente de alimentación, modo reposo | 0,4 µA típ. |
| TH-215 | Corriente de alimentación en espera | 400 nA típ. | Corriente de alimentación, modo reposo | 0,4 µA típ. |
| TH-230 | Idd (reposo) | 0,0004 mA típ. | Corriente de alimentación, modo reposo | 0,4 µA típ. |
El mismo valor aparece de tres formas. La regla que lo corrige tiene tres partes:
- Nombre: siempre "Corriente de alimentación, modo reposo". Nunca "corriente en reposo", "espera" ni "Idd".
- Unidad: µA para cualquier corriente inferior a 1 mA, escrita como número simple, sin prefijo de potencia de diez.
- Condiciones: tensión de alimentación, temperatura y cómo se realizó la medición, siempre en la columna Condiciones de prueba.
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ámetro | Mín. | Típ. | Máx. | Unidad | Condiciones de prueba |
|---|---|---|---|---|---|
| Tensión de alimentación, VDD | 1,62 | 3,3 | 3,6 | V | Rango de funcionamiento |
| Corriente de alimentación, medición | - | 120 | 180 | µA | VDD = 3,3 V, TA = 25 °C, una medición por segundo, media |
| Corriente de alimentación, modo reposo | - | 0,4 | 1,2 | µA | VDD = 3,3 V, TA = 25 °C, entre mediciones |
| Rango de medición de humedad relativa | 0 | - | 100 | %RH | Rango completo, VDD = 3,3 V |
| Error de medición de temperatura | -0,5 | 0,1 | 0,5 | °C | de 15 a 40 °C ambiente, VDD = 3,3 V |
| Tiempo de medición | - | 8 | 12 | ms | Una lectura de temperatura y una de humedad, VDD = 3,3 V |
Reglas de notación que mantienen legible una tabla así:
- Unidades: un símbolo por unidad, con un espacio antes (3,3 V, 120 µA, 12 ms). Conviene usar µA en todas las tablas, nunca uA en una y µA en otra.
- Símbolos: define cada símbolo en su primera aparición. VDD es la tensión de alimentación, TA es la temperatura ambiente y RH es la humedad relativa.
- No especificado: se escribe un guion y se añade bajo la tabla la nota "- significa no especificado". Nunca se deja una celda vacía, porque el lector no puede distinguir un dato que falta de un valor cero.
- Condiciones: indicar siempre en el mismo orden la tensión de alimentación, la temperatura ambiente y cualquier modo o temporización, por ejemplo "VDD = 3,3 V, TA = 25 °C, entre mediciones".
- Errores: indicar el signo de forma explícita. Un mínimo de -0,5 °C significa que la lectura puede ser 0,5 °C inferior.
- Precisión: dentro de cada columna, el mismo número de decimales, acorde con la precisión de los datos de prueba.
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ón | Fecha | Qué cambió | Por qué importa al lector |
|---|---|---|---|
| Rev A | 2026-02-10 | Primera 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 B | 2026-05-12 | Corriente 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 C | 2026-09-30 | Tiempo 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.
| Segmento | Código | Significado |
|---|---|---|
| Serie | TH-210 | Módulo de temperatura y humedad, documentado en TH-210-DS |
| Salida | D | Salida digital, I2C |
| Salida | U | Salida digital, UART |
| Cable | 1 | Módulo sin cable |
| Cable | 2 | Cable de 300 mm |
| Cable | 3 | Cable de 1 m |
| Embalaje | B | Bolsa a granel, 100 uds. |
| Embalaje | T | Cinta 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
- El ID del documento y la letra de revisión aparecen en la portada y en el pie de cada página.
- Cada fila eléctrica tiene un valor o un guion. Ninguna celda está vacía.
- 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.
- Cada fila indica sus condiciones de prueba, incluidas la tensión de alimentación y la temperatura ambiente.
- Los nombres de parámetros, las unidades y los símbolos coinciden con las reglas de notación y con la revisión anterior.
- Las cifras ambientales y mecánicas coinciden con el plano vigente y con los registros de prueba.
- Cada código de pedido se descifra con la tabla de referencias, y cada variante en existencias aparece en ella.
- Cada valor modificado tiene una fila en el historial de revisiones con el motivo del cambio.
- El orden de las secciones y las columnas de las tablas coinciden con la plantilla, no con el documento anterior.
- Las normas que se aplican al producto y al mercado se han revisado, y el documento contiene las declaraciones que exigen.
- 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.