Wordspecs

Blog

Logiciel de fiches techniques pour startups du hardware : gardez chaque produit cohérent

Bêta privée. L'accès se fait par liste d'attente, et les offres payantes ouvrent à la fin de la bêta. Rejoignez la liste d'attente.

Une startup du hardware livre souvent son deuxième produit avec une fiche technique copiée du premier. Au quatrième produit, les tableaux utilisent des unités différentes, les sections apparaissent dans un autre ordre et personne n'est sûr de la révision que possède un client. Un logiciel de fiches techniques empêche cette dérive en fixant les sections, les colonnes des tableaux et la notation, et en enregistrant chaque révision.

Ce qu'une fiche technique doit contenir

D'où vient la dérive

La dérive vient de la copie d'un ancien fichier que l'on modifie. Une colonne est ajoutée à un tableau et pas à un autre, "mA" devient "milliampères", une section change de place. Chaque changement est petit, et ensemble ils donnent à une gamme de produits un air improvisé.

Le cas le plus net est un même paramètre écrit différemment dans toute une gamme. Voici trois fiches techniques pour une famille fictive de capteurs, TH-210, TH-215 et TH-230, qui décrivent toutes le même état basse consommation entre deux mesures :

Fiche techniqueNom tel qu'écritValeur telle qu'écriteNom normaliséValeur normalisée
TH-210Courant de veille0,4 uA typCourant d'alimentation, mode veille0,4 µA typ
TH-215Courant d'alimentation en veille400 nA typCourant d'alimentation, mode veille0,4 µA typ
TH-230Idd (au repos)0,0004 mA typCourant d'alimentation, mode veille0,4 µA typ

La même valeur apparaît de trois façons. La règle qui la fixe comporte trois volets :

Un exemple de tableau des caractéristiques électriques

Le tableau ci-dessous concerne le TH-210, un capteur fictif de température et d'humidité. Toutes les valeurs sont inventées pour cet exemple, et elles sont cohérentes entre elles : dans chaque ligne, le minimum, le typique et le maximum se suivent dans l'ordre.

ParamètreMinTypMaxUnitéConditions d'essai
Tension d'alimentation, VDD1,623,33,6VPlage de fonctionnement
Courant d'alimentation, mesure-120180µAVDD = 3,3 V, TA = 25 °C, une mesure par seconde, moyenne
Courant d'alimentation, mode veille-0,41,2µAVDD = 3,3 V, TA = 25 °C, entre les mesures
Plage de mesure de l'humidité relative0-100%RHPlage complète, VDD = 3,3 V
Erreur de mesure de température-0,50,10,5°C15 à 40 °C ambiante, VDD = 3,3 V
Durée de mesure-812msUne lecture de température et une lecture d'humidité, VDD = 3,3 V

Règles de notation qui gardent un tableau de ce type lisible :

Historique des révisions et nommage

Chaque révision de TH-210 consigne la date, la modification et sa raison pour le lecteur qui détient cette révision.

RévisionDateCe qui a changéPourquoi cela compte pour le lecteur
Rev A2026-02-10Première version. Courant de veille typique 0,6 µA, maximum 1,5 µA.Référence. Les conceptions réalisées avec elle reprennent la valeur de veille la plus élevée.
Rev B2026-05-12Courant d'alimentation, mode veille : typique passé de 0,6 µA à 0,4 µA, maximum de 1,5 µA à 1,2 µA, après une modification du micrologiciel.Les estimations d'autonomie faites à partir de Rev A sont pessimistes. Recalculez-les avec les valeurs de Rev B.
Rev C2026-09-30Durée de mesure maximum portée de 10 ms à 12 ms. Conditions d'essai ajoutées à l'erreur de mesure de température.Les budgets de temps fondés sur 10 ms doivent intégrer le nouveau maximum. Les conditions ajoutées indiquent où s'applique la valeur d'erreur.

Nommez la révision pour qu'un client puisse savoir laquelle il détient. Placez l'identifiant du document et la lettre ensemble, par exemple TH-210-DS Rev C, sur la couverture et dans le pied de page de chaque page. Le pied de page compte, car une seule page peut être imprimée ou envoyée par e-mail isolément. Augmentez la lettre pour toute modification d'une valeur, d'une condition, d'un code de commande ou d'une exigence, y compris les petites corrections, afin que deux documents différents ne partagent jamais une lettre. Conservez la date dans le tableau d'historique plutôt que dans le nom, car une date peut désigner une date de publication ou une date d'impression. La lettre de révision ne fait pas partie du numéro de référence : les unités vendues en Rev A et en Rev C ont le même code de commande.

Informations de commande

Un numéro de référence TH-210 se compose de codes lus de gauche à droite : série, sortie, câble, puis conditionnement. Par exemple, TH-210-D-2-B désigne le TH-210 avec sortie numérique I2C, un câble de 300 mm et un conditionnement en vrac.

SegmentCodeSignification
SérieTH-210Module de température et d'humidité, documenté dans TH-210-DS
SortieDSortie numérique, I2C
SortieUSortie numérique, UART
Câble1Module nu, sans câble
Câble2Câble de 300 mm
Câble3Câble de 1 m
ConditionnementBSachet en vrac, 100 pièces
ConditionnementTBande et bobine, 1000 pièces

Toutes les combinaisons ne sont pas en stock : vérifiez la liste des références disponibles avant de chiffrer un client. La lettre de révision n'apparaît jamais dans le numéro de référence.

Liste de contrôle avant publication

  1. L'identifiant du document et la lettre de révision figurent sur la couverture et dans le pied de chaque page.
  2. Chaque ligne électrique contient une valeur ou un tiret. Aucune cellule n'est vide.
  3. Le minimum, le typique et le maximum se suivent dans l'ordre sur chaque ligne, et chaque valeur renvoie à un rapport d'essai dont le numéro est consigné dans votre dossier interne.
  4. Chaque ligne indique ses conditions d'essai, y compris la tension d'alimentation et la température ambiante.
  5. Les noms de paramètres, les unités et les symboles respectent les règles de notation et la révision précédente.
  6. Les valeurs environnementales et mécaniques correspondent au plan actuel et aux relevés d'essai.
  7. Chaque code de commande se décode avec le tableau des références, et chaque variante en stock y figure.
  8. Chaque valeur modifiée a une ligne dans l'historique des révisions, avec la raison du changement.
  9. L'ordre des sections et les colonnes des tableaux correspondent au modèle, et non au document précédent.
  10. Vérifiez les règles qui s'appliquent à votre produit et à votre marché, et confirmez que le document contient les mentions qu'elles exigent.
  11. Exportez le PDF et vérifiez les numéros de page, la révision dans le pied de page et les liens.

Wordspecs pour les fiches techniques

Wordspecs comprend un modèle de fiche technique matérielle avec des champs électriques, environnementaux, mécaniques et de commande. La fiche d'exemple du TH-210 (un capteur fictif) montre la mise en page. Les modèles enregistrés vous permettent de garder vos propres colonnes et votre propre rédaction pour chaque produit, et l'offre Team ajoute les modèles partagés et l'historique des versions.

À lire aussi : quel modèle convient à quel document.

Rejoindre la liste d'attente