Wordspecs

Blog

Datenblatt-Software für Hardware-Startups: jedes Produkt konsistent halten

Private Beta. Der Zugang läuft über die Warteliste, und die kostenpflichtigen Tarife starten, wenn die Beta endet. Tragen Sie sich auf die Warteliste ein.

Ein Hardware-Startup liefert sein zweites Produkt oft mit einem Datenblatt aus, das vom ersten kopiert wurde. Beim vierten Produkt verwenden die Tabellen unterschiedliche Einheiten, die Abschnitte stehen in anderer Reihenfolge, und niemand ist sicher, welche Revision ein Kunde hat. Datenblatt-Software verhindert dieses Abdriften, indem sie Abschnitte, Tabellenspalten und Schreibweise festlegt und jede Revision festhält.

Was ein Datenblatt braucht

Wo das Abdriften beginnt

Abdriften entsteht, wenn man eine alte Datei kopiert und bearbeitet. Eine Spalte kommt in einer Tabelle hinzu, in einer anderen nicht, aus "mA" wird "Milliampere", ein Abschnitt wandert. Jede Änderung ist klein, zusammen lassen sie eine Produktlinie improvisiert wirken.

Der deutlichste Fall ist ein Parameter, der über eine Produktlinie hinweg unterschiedlich geschrieben wird. Hier sind drei Datenblätter für eine fiktive Sensorfamilie, TH-210, TH-215 und TH-230, die alle denselben Stromsparzustand zwischen den Messungen beschreiben:

DatenblattName wie geschriebenWert wie geschriebenVereinheitlichter NameVereinheitlichter Wert
TH-210Schlafstrom0,4 uA typStromaufnahme, Schlafmodus0,4 µA typ
TH-215Standby-Stromaufnahme400 nA typStromaufnahme, Schlafmodus0,4 µA typ
TH-230Idd (idle)0,0004 mA typStromaufnahme, Schlafmodus0,4 µA typ

Derselbe Wert erscheint auf drei Arten. Die Regel, die das behebt, hat drei Teile:

Eine vollständige Tabelle der elektrischen Kennwerte

Die Tabelle unten gilt für TH-210, einen fiktiven Temperatur- und Feuchtesensor. Alle Werte sind für dieses Beispiel erfunden, aber in sich stimmig: In jeder Zeile stehen Minimum, Typ und Maximum in der richtigen Reihenfolge.

ParameterMinTypMaxEinheitPrüfbedingungen
Versorgungsspannung, VDD1,623,33,6VBetriebsbereich
Stromaufnahme, Messung-120180µAVDD = 3,3 V, TA = 25 °C, eine Messung pro Sekunde, Mittelwert
Stromaufnahme, Schlafmodus-0,41,2µAVDD = 3,3 V, TA = 25 °C, zwischen den Messungen
Messbereich relative Feuchte0-100%RHGesamter Bereich, VDD = 3,3 V
Messfehler Temperatur-0,50,10,5°C15 bis 40 °C Umgebung, VDD = 3,3 V
Messdauer-812msEine Temperatur- und eine Feuchtemessung, VDD = 3,3 V

Schreibregeln, die eine Tabelle wie diese lesbar halten:

Revisionsverlauf und Benennung

Jede Revision von TH-210 hält das Datum, die Änderung und fest, warum sie für jemanden wichtig ist, der diese Revision besitzt.

RevisionDatumWas sich geändert hatBedeutung für die Leserschaft
Rev A2026-02-10Erstveröffentlichung. Schlafstrom typisch 0,6 µA, maximal 1,5 µA.Ausgangsstand. Darauf aufbauende Designs übernehmen den höheren Schlafstromwert.
Rev B2026-05-12Stromaufnahme, Schlafmodus: typisch von 0,6 µA auf 0,4 µA, maximal von 1,5 µA auf 1,2 µA, nach einer Firmware-Änderung.Schätzungen der Batterielaufzeit, die auf Rev A beruhen, sind zu pessimistisch. Rechnen Sie sie mit den Werten aus Rev B neu.
Rev C2026-09-30Messdauer maximal von 10 ms auf 12 ms. Prüfbedingungen beim Messfehler Temperatur ergänzt.Zeitbudgets auf Basis von 10 ms brauchen das neue Maximum. Die ergänzten Bedingungen zeigen, wo der Fehlerwert gilt.

Benennen Sie die Revision so, dass ein Kunde erkennen kann, welche er besitzt. Setzen Sie Dokument-ID und Buchstaben zusammen, zum Beispiel TH-210-DS Rev C, auf das Deckblatt und in die Fußzeile jeder Seite. Die Fußzeile ist wichtig, weil eine einzelne Seite allein gedruckt oder per E-Mail verschickt werden kann. Erhöhen Sie den Buchstaben bei jeder Änderung an einem Wert, einer Bedingung, einem Bestellcode oder einer Anforderung, auch bei kleinen Korrekturen, damit zwei verschiedene Dokumente nie denselben Buchstaben tragen. Halten Sie das Datum in der Verlaufstabelle statt im Namen fest, denn ein Datum kann ein Veröffentlichungsdatum oder ein Druckdatum bedeuten. Der Revisionsbuchstabe ist kein Teil der Artikelnummer: Geräte, die als Rev A und als Rev C verkauft werden, haben denselben Bestellcode.

Bestellinformationen

Eine TH-210-Artikelnummer besteht aus Codes, die von links nach rechts gelesen werden: Serie, Ausgang, Kabel, dann Verpackung. Zum Beispiel ist TH-210-D-2-B der TH-210 mit digitalem I2C-Ausgang, einem 300-mm-Kabel und einer Schüttverpackung.

BestandteilCodeBedeutung
SerieTH-210Temperatur- und Feuchtemodul, dokumentiert in TH-210-DS
AusgangDDigitaler Ausgang, I2C
AusgangUDigitaler Ausgang, UART
Kabel1Nacktes Modul, ohne Kabel
Kabel2300-mm-Kabel
Kabel31-m-Kabel
VerpackungBSchüttbeutel, 100 Stück
VerpackungTGurt und Rolle, 1000 Stück

Nicht jede Kombination ist auf Lager, prüfen Sie daher die Lagerliste, bevor Sie einem Kunden ein Angebot machen. Der Revisionsbuchstabe erscheint nie in der Artikelnummer.

Prüfliste vor der Veröffentlichung

  1. Dokument-ID und Revisionsbuchstabe stehen auf dem Deckblatt und in jeder Fußzeile.
  2. Jede Zeile der elektrischen Kennwerte hat einen Wert oder einen Strich. Keine Zelle ist leer.
  3. Minimum, Typ und Maximum stehen in jeder Zeile in der richtigen Reihenfolge, und jeder Wert lässt sich auf einen Prüfbericht zurückführen, dessen Nummer in Ihrer internen Akte festgehalten ist.
  4. Jede Zeile nennt ihre Prüfbedingungen, einschließlich Versorgungsspannung und Umgebungstemperatur.
  5. Parameternamen, Einheiten und Symbole entsprechen den Schreibregeln und der vorherigen Revision.
  6. Umwelt- und mechanische Angaben stimmen mit der aktuellen Zeichnung und den Prüfprotokollen überein.
  7. Jeder Bestellcode lässt sich mit der Artikelnummern-Tabelle auflösen, und jede lagerhaltige Variante steht darin.
  8. Jeder geänderte Wert hat eine Zeile im Revisionsverlauf mit dem Grund der Änderung.
  9. Reihenfolge der Abschnitte und Tabellenspalten entsprechen der Vorlage, nicht dem vorherigen Dokument.
  10. Prüfen Sie die Vorschriften, die für Ihr Produkt und Ihren Markt gelten, und bestätigen Sie, dass das Dokument alle erforderlichen Angaben enthält.
  11. Exportieren Sie das PDF und prüfen Sie Seitenzahlen, die Revision in der Fußzeile und die Links.

Wordspecs für Datenblätter

Wordspecs enthält eine Vorlage für Hardware-Datenblätter mit Feldern für Elektrik, Umgebung, Mechanik und Bestellung. Das TH-210-Beispielblatt (ein fiktiver Sensor) zeigt das Layout. Mit gespeicherten Vorlagen behalten Sie Ihre eigenen Tabellenspalten und Formulierungen für jedes Produkt, und der Team-Tarif ergänzt geteilte Vorlagen und Versionsverlauf.

Dazu passend: welche Vorlage zu welchem Dokument passt.

Auf die Warteliste