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
- Beschreibung und Hauptmerkmale: zwei oder drei Zeilen dazu, was das Produkt tut, und bis zu fünf Merkmale, die ein Käufer prüfen kann.
- Elektrische Kennwerte: eine Tabelle mit den Spalten Parameter, Min, Typ, Max, Einheit und Prüfbedingungen. Das vollständige Beispiel unten verwendet genau diese Spalten.
- Umgebungsgrenzen: Betriebs- und Lagertemperatur, Feuchtebereich und Schutzart, jeweils mit einer Angabe, wie gemessen wurde.
- Mechanische Angaben: Abmessungen mit Verweis auf die Zeichnung, Gewicht, Steckverbinder und Montageangaben.
- Funkangaben, sofern das Produkt über Funk verfügt: Frequenzbereich, Sendeleistung und Reichweite unter angegebenen Bedingungen.
- Bestellinformationen: die Regeln, nach denen eine Artikelnummer einer Variante zugeordnet wird.
- Dokument-ID und Revision auf jeder Seite, damit die Leserschaft weiß, welche Version sie vor sich hat.
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:
| Datenblatt | Name wie geschrieben | Wert wie geschrieben | Vereinheitlichter Name | Vereinheitlichter Wert |
|---|---|---|---|---|
| TH-210 | Schlafstrom | 0,4 uA typ | Stromaufnahme, Schlafmodus | 0,4 µA typ |
| TH-215 | Standby-Stromaufnahme | 400 nA typ | Stromaufnahme, Schlafmodus | 0,4 µA typ |
| TH-230 | Idd (idle) | 0,0004 mA typ | Stromaufnahme, Schlafmodus | 0,4 µA typ |
Derselbe Wert erscheint auf drei Arten. Die Regel, die das behebt, hat drei Teile:
- Name: immer "Stromaufnahme, Schlafmodus". Nie "Schlafstrom", "Standby" oder "Idd".
- Einheit: µA für jeden Strom unter 1 mA, geschrieben als einfache Zahl ohne Vorsatz für Zehnerpotenzen.
- Bedingungen: Versorgungsspannung, Temperatur und wie die Messung erfolgte, immer in der Spalte Prüfbedingungen.
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.
| Parameter | Min | Typ | Max | Einheit | Prüfbedingungen |
|---|---|---|---|---|---|
| Versorgungsspannung, VDD | 1,62 | 3,3 | 3,6 | V | Betriebsbereich |
| Stromaufnahme, Messung | - | 120 | 180 | µA | VDD = 3,3 V, TA = 25 °C, eine Messung pro Sekunde, Mittelwert |
| Stromaufnahme, Schlafmodus | - | 0,4 | 1,2 | µA | VDD = 3,3 V, TA = 25 °C, zwischen den Messungen |
| Messbereich relative Feuchte | 0 | - | 100 | %RH | Gesamter Bereich, VDD = 3,3 V |
| Messfehler Temperatur | -0,5 | 0,1 | 0,5 | °C | 15 bis 40 °C Umgebung, VDD = 3,3 V |
| Messdauer | - | 8 | 12 | ms | Eine Temperatur- und eine Feuchtemessung, VDD = 3,3 V |
Schreibregeln, die eine Tabelle wie diese lesbar halten:
- Einheiten: ein Symbol pro Einheit, mit einem Leerzeichen davor (3,3 V, 120 µA, 12 ms). Wählen Sie µA und verwenden Sie es in jeder Tabelle, nie uA in der einen und µA in der anderen.
- Symbole: definieren Sie jedes Symbol bei der ersten Verwendung. VDD ist die Versorgungsspannung, TA ist die Umgebungstemperatur, RH ist die relative Feuchte.
- Nicht angegeben: schreiben Sie einen Strich und fügen Sie unter der Tabelle die Anmerkung "- bedeutet nicht angegeben" hinzu. Lassen Sie nie eine Zelle leer, weil die Leserschaft fehlende Daten nicht von einer Null unterscheiden kann.
- Bedingungen: schreiben Sie Versorgungsspannung, Umgebungstemperatur und jede Betriebsart oder Zeitangabe jedes Mal in derselben Reihenfolge, zum Beispiel "VDD = 3,3 V, TA = 25 °C, zwischen den Messungen".
- Fehler: schreiben Sie das Vorzeichen ausdrücklich. Ein Minimum von -0,5 °C bedeutet, dass der Messwert um bis zu 0,5 °C zu niedrig liegen kann.
- Genauigkeit: verwenden Sie innerhalb einer Spalte dieselbe Anzahl an Nachkommastellen, passend zur Genauigkeit der Testdaten.
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.
| Revision | Datum | Was sich geändert hat | Bedeutung für die Leserschaft |
|---|---|---|---|
| Rev A | 2026-02-10 | Erstveröffentlichung. Schlafstrom typisch 0,6 µA, maximal 1,5 µA. | Ausgangsstand. Darauf aufbauende Designs übernehmen den höheren Schlafstromwert. |
| Rev B | 2026-05-12 | Stromaufnahme, 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 C | 2026-09-30 | Messdauer 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.
| Bestandteil | Code | Bedeutung |
|---|---|---|
| Serie | TH-210 | Temperatur- und Feuchtemodul, dokumentiert in TH-210-DS |
| Ausgang | D | Digitaler Ausgang, I2C |
| Ausgang | U | Digitaler Ausgang, UART |
| Kabel | 1 | Nacktes Modul, ohne Kabel |
| Kabel | 2 | 300-mm-Kabel |
| Kabel | 3 | 1-m-Kabel |
| Verpackung | B | Schüttbeutel, 100 Stück |
| Verpackung | T | Gurt 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
- Dokument-ID und Revisionsbuchstabe stehen auf dem Deckblatt und in jeder Fußzeile.
- Jede Zeile der elektrischen Kennwerte hat einen Wert oder einen Strich. Keine Zelle ist leer.
- 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.
- Jede Zeile nennt ihre Prüfbedingungen, einschließlich Versorgungsspannung und Umgebungstemperatur.
- Parameternamen, Einheiten und Symbole entsprechen den Schreibregeln und der vorherigen Revision.
- Umwelt- und mechanische Angaben stimmen mit der aktuellen Zeichnung und den Prüfprotokollen überein.
- Jeder Bestellcode lässt sich mit der Artikelnummern-Tabelle auflösen, und jede lagerhaltige Variante steht darin.
- Jeder geänderte Wert hat eine Zeile im Revisionsverlauf mit dem Grund der Änderung.
- Reihenfolge der Abschnitte und Tabellenspalten entsprechen der Vorlage, nicht dem vorherigen Dokument.
- 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.
- 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.