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
- Description et caractéristiques principales : deux ou trois lignes sur ce que fait le produit, et jusqu'à cinq caractéristiques qu'un acheteur peut vérifier.
- Caractéristiques électriques : un tableau avec les colonnes Paramètre, Min, Typ, Max, Unité et Conditions d'essai. L'exemple ci-dessous utilise exactement ces colonnes.
- Limites environnementales : températures de fonctionnement et de stockage, plage d'humidité et indice de protection, chacun accompagné d'une note sur la manière dont il a été mesuré.
- Détails mécaniques : dimensions avec référence à un plan, poids, connecteur et détails de montage.
- Détails radio, si le produit en dispose : plage de fréquences, puissance de sortie et portée dans des conditions indiquées.
- Informations de commande : les règles qui relient une référence à une variante.
- Identifiant et révision du document sur chaque page, pour que le lecteur sache quelle version il a en main.
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 technique | Nom tel qu'écrit | Valeur telle qu'écrite | Nom normalisé | Valeur normalisée |
|---|---|---|---|---|
| TH-210 | Courant de veille | 0,4 uA typ | Courant d'alimentation, mode veille | 0,4 µA typ |
| TH-215 | Courant d'alimentation en veille | 400 nA typ | Courant d'alimentation, mode veille | 0,4 µA typ |
| TH-230 | Idd (au repos) | 0,0004 mA typ | Courant d'alimentation, mode veille | 0,4 µA typ |
La même valeur apparaît de trois façons. La règle qui la fixe comporte trois volets :
- Nom : toujours "Courant d'alimentation, mode veille". Jamais "courant de veille", "courant en veille" ni "Idd".
- Unité : µA pour tout courant inférieur à 1 mA, écrit sous forme de nombre simple, sans préfixe de puissance de dix.
- Conditions : tension d'alimentation, température et mode de mesure, toujours dans la colonne Conditions d'essai.
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ètre | Min | Typ | Max | Unité | Conditions d'essai |
|---|---|---|---|---|---|
| Tension d'alimentation, VDD | 1,62 | 3,3 | 3,6 | V | Plage de fonctionnement |
| Courant d'alimentation, mesure | - | 120 | 180 | µA | VDD = 3,3 V, TA = 25 °C, une mesure par seconde, moyenne |
| Courant d'alimentation, mode veille | - | 0,4 | 1,2 | µA | VDD = 3,3 V, TA = 25 °C, entre les mesures |
| Plage de mesure de l'humidité relative | 0 | - | 100 | %RH | Plage complète, VDD = 3,3 V |
| Erreur de mesure de température | -0,5 | 0,1 | 0,5 | °C | 15 à 40 °C ambiante, VDD = 3,3 V |
| Durée de mesure | - | 8 | 12 | ms | Une 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 :
- Unités : un seul symbole par unité, avec un espace avant lui (3,3 V, 120 µA, 12 ms). Choisissez µA et utilisez-le dans chaque tableau, jamais uA dans l'un et µA dans l'autre.
- Symboles : définissez chaque symbole à sa première utilisation. VDD est la tension d'alimentation, TA la température ambiante et RH l'humidité relative.
- Non spécifié : écrivez un tiret et ajoutez la note "- signifie non spécifié" sous le tableau. Ne laissez jamais une cellule vide, car un lecteur ne peut pas distinguer une donnée manquante d'une valeur nulle.
- Conditions : indiquez la tension d'alimentation, la température ambiante et tout mode ou toute temporisation dans le même ordre à chaque fois, par exemple "VDD = 3,3 V, TA = 25 °C, entre les mesures".
- Erreurs : indiquez explicitement le signe. Un minimum de -0,5 °C signifie que la lecture peut être inférieure de 0,5 °C.
- Précision : utilisez le même nombre de décimales dans une colonne, en fonction de la précision des données d'essai.
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évision | Date | Ce qui a changé | Pourquoi cela compte pour le lecteur |
|---|---|---|---|
| Rev A | 2026-02-10 | Premiè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 B | 2026-05-12 | Courant 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 C | 2026-09-30 | Duré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.
| Segment | Code | Signification |
|---|---|---|
| Série | TH-210 | Module de température et d'humidité, documenté dans TH-210-DS |
| Sortie | D | Sortie numérique, I2C |
| Sortie | U | Sortie numérique, UART |
| Câble | 1 | Module nu, sans câble |
| Câble | 2 | Câble de 300 mm |
| Câble | 3 | Câble de 1 m |
| Conditionnement | B | Sachet en vrac, 100 pièces |
| Conditionnement | T | Bande 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
- L'identifiant du document et la lettre de révision figurent sur la couverture et dans le pied de chaque page.
- Chaque ligne électrique contient une valeur ou un tiret. Aucune cellule n'est vide.
- 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.
- Chaque ligne indique ses conditions d'essai, y compris la tension d'alimentation et la température ambiante.
- Les noms de paramètres, les unités et les symboles respectent les règles de notation et la révision précédente.
- Les valeurs environnementales et mécaniques correspondent au plan actuel et aux relevés d'essai.
- Chaque code de commande se décode avec le tableau des références, et chaque variante en stock y figure.
- Chaque valeur modifiée a une ligne dans l'historique des révisions, avec la raison du changement.
- L'ordre des sections et les colonnes des tableaux correspondent au modèle, et non au document précédent.
- Vérifiez les règles qui s'appliquent à votre produit et à votre marché, et confirmez que le document contient les mentions qu'elles exigent.
- 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.