Working with Design Object Parameters

Parameter werden für Objekte, Dokumente und Projekte verwendet, um dem Design detaillierte Informationen hinzuzufügen. Eine Komponente ist im obigen Bild dargestellt.

Parameter werden als Eigenschaften des übergeordneten Objekts hinzugefügt oder automatisch eingeschlossen und nicht unabhängig wie eine Textzeichenfolge platziert. Die verfügbaren Parametertypen lassen sich grob in Systemparameter und Benutzerparameter einteilen, wobei Letztere manuell hinzugefügt werden.

Bezeichner- und Systemparameter

In einem Schaltplan platzierte Objekte enthalten automatisch eine Reihe wichtiger Systemparameter. Diese liefern die grundlegenden Objektinformationen, die vom System verwendet werden, um Name, Typ und Datenquelle des übergeordneten Objekts zu unterscheiden. Zu den inhärenten Systemparametern für Objekte gehören unter anderem die Eigenschaften Comment, Description und Design Item ID (Bibliotheksreferenz). Auf Objektsystemparameter kann im Abschnitt General des Properties panel (unter der Registerkarte General) zugegriffen werden, wenn ein übergeordnetes Objekt ausgewählt ist (). Wenn ein einzelner Parameter im Designbereich sichtbar und ausgewählt ist, kann über den zugehörigen Modus des Properties panel darauf zugegriffen werden, wie unten beschrieben().

Benutzerparameter

Parameter können zu jedem der folgenden Designobjekte hinzugefügt werden.

Benutzerparameter sind im Bereich Parameters des Properties panel oder im modalen Dialog verfügbar, wenn das übergeordnete Objekt ausgewählt ist. Parameter können sowohl hinzugefügt als auch bearbeitet werden. Ausnahmen sind Projektparameter (über den Project Options dialog) und Komponenten-Pin-Parameter (über die Pin Properties oder die modale Ansicht des Pin dialog). Wenn ein einzelner Parameter im Designbereich sichtbar und ausgewählt ist, kann über den zugehörigen Modus des Properties panel oder modalen Dialogs darauf zugegriffen werden, wie unten beschrieben.

Erstens: Komponenten-Benutzerparameter im Properties panel (Bereich Parameters). Zweitens: ein einzelner Systemparameter im Properties panel.

Grafische Bearbeitung

Sichtbare Parameterzeichenfolgen können grafisch direkt im Designbereich bearbeitet werden.

Klicken Sie auf einen Parameter und ziehen Sie ihn, um ihn neu zu positionieren. So bearbeiten Sie die Parameterzeichenfolge direkt an Ort und Stelle:

1. Ziehen Sie den Mauszeiger bei gedrückter Maustaste um das Parameterobjekt.

2. Nach der Auswahl wird das Objekt durch einen grünen Rahmen hervorgehoben.

3. Wählen Sie Enter , um mit der Bearbeitung des Textes zu beginnen.

4. Wenn die Bearbeitung abgeschlossen ist, drücken Sie erneut Enter oder klicken Sie außerhalb der Zeichenfolge, um den In-Place-Bearbeitungsmodus zu verlassen.

Eine Parameterzeichenfolge kann direkt im Designbereich ausgewählt und bearbeitet werden. Wählen Sie die gesamte Zeichenfolge aus, um sie zu überschreiben.

Parameter, die im Designbereich sichtbar und auswählbar sind, können an eine neue Position gezogen und dabei gedreht werden. Klicken Sie auf die Parameterzeichenfolge und ziehen Sie sie, verwenden Sie die Tasten Spacebar und Shift+Spacebar, um sie in 90°-Schritten zu drehen, und klicken Sie dann, um die neue Position/Ausrichtung zu bestätigen.

Siehe Parameter String Positioning unten für Informationen zu Komponentenparametern Autopositioning und zugehörigen Optionen im Properties panel.

Gesperrte Parameter

Ein Parameter, der einem Component Part untergeordnet ist, kann gesperrt werden, was bedeutet, dass seine Name und Value Zeichenfolgen nicht bearbeitet werden können. Dies kann erfolgen durch:

• Umschalten des Sperrsymbols (), das seinem Eintrag im Bereich Parameters im Properties panel oder modalen Dialog seines übergeordneten Objekts zugeordnet ist, oder

• Aktivieren der Option Lock Parameter im Properties panel, wenn der Parameter direkt im Designbereich ausgewählt ist.

Nach dem Sperren kann die Parameterzeichenfolge weder im Properties panel noch im modalen Dialog (unter Parameters für das übergeordnete Objekt) oder im Designbereich mittels In-Place-Bearbeitung bearbeitet werden.

Komponentenparameter

Komponentenparameter, die offensichtlichsten und am häufigsten verwendeten Schaltplanparameter, umfassen zusätzliche Sätze dedizierter Parameter und Funktionen, die die Möglichkeiten zur Definition von Komponentenobjekten erweitern.  

Definieren von Parametern in der Schaltplanbibliothek

Die untergeordneten Parameter eines übergeordneten Komponentenobjekts können vor der Platzierung in einem Schaltplan in der Quellbibliothek der Komponente definiert werden. Das Properties panel wird verwendet, um Parameter für einen Komponenteneintrag im Schematic Library-Editor auf dieselbe Weise zu bearbeiten und hinzuzufügen wie bei der Arbeit mit Parametern im Schematic editor.

Wenn ein Dokument einer Schaltplankomponentenbibliothek geöffnet ist, wählen Sie einen Komponenteneintrag im SCH Library panel aus, um im Properties panel auf dessen Parametereigenschaften zuzugreifen.

Greifen Sie auf die Eigenschaften einer Bibliothekskomponente zu, indem Sie ihren Eintrag im SCH Library panel auswählen.

Designator und Comment einer Bibliothekskomponente sind im Designbereich des Schematic Library-Editors standardmäßig nicht sichtbar, können jedoch durch Aktivieren der Option Show Comment/Designator im Library Options mode of the Properties panel (Tools » Document Options) eingeschaltet werden – verfügbar, wenn im Designbereich keine Objekte ausgewählt sind.

Parameter, die einer Bibliothekskomponente gehören, werden mit demselben Verfahren definiert und bearbeitet wie bei platzierten Schaltplankomponenten. Die Taste Tab kann verwendet werden, um Parameter während der Platzierung eines Objekts im Designbereich direkt zu erstellen oder zu bearbeiten. Auf Parameter wird über das Properties panel oder den modalen Dialog zugegriffen, wobei die zentralen Systemparameter unter der Registerkarte General des Panels verfügbar sind und Benutzerparameter unter dem Dropdown-Menü Parameters des Panels hinzugefügt/bearbeitet werden.

Der Designator-Parameter

Im Schematic Library-Editor erhält ein Komponentenparameter Designator typischerweise ein geeignetes Präfix gefolgt von einem Fragezeichen. Wenn die Komponente aus der Bibliothek in einem Schaltplan platziert wird, wird das Fragezeichen vom Annotation tool des Schematic-Editors erkannt und während der Projektannotation durch ein geeignetes numerisches Suffix ersetzt.

Der Schaltplaneditor enthält außerdem eine einfache Auto-Inkrement-Funktion für den Designator, die beim Platzieren mehrerer Instanzen desselben Bauteils verwendet werden kann. Um diese zu nutzen, drücken Sie Tab, während die erste Komponente am Cursor hängt, um die Platzierung anzuhalten, und geben Sie dann im Properties-Bereich einen geeigneten Designator ein, zum Beispiel R1. Nachfolgende Komponenten erhalten dann die Designatoren R2, R3 usw. 

Beim Platzieren mehrteiliger Komponenten und wenn der anfängliche Designator auf diese Weise zugewiesen wird, wird automatisch ein Partsuffix hinzugefügt, zum Beispiel U3A, U3B usw. Wenn der anfängliche Designator nicht zugewiesen wird, haben alle Teile dasselbe Suffix. Dies kann mit der Annotierungsfunktion des Schaltplaneditors behoben werden. Das Partsuffix kann alphabetisch oder numerisch sein, wie durch die Option Alpha Numeric Suffix auf der Seite Schematic - General im Dialog Preferences festgelegt.

Positionierung von Parameter-Strings

Das Standardverhalten eines Komponenten-Parameter-Strings besteht darin, ihn beim Drehen einer Komponente während oder nach der Platzierung automatisch zu positionieren (d. h. die Ausrichtung beizubehalten). Wenn dieses Verhalten nicht erforderlich ist, deaktivieren Sie für den Komponentenparametereintrag die Option Autoposition im Bereich Parameters des Fensters Properties. Um auf die Option zuzugreifen, wählen Sie den Parameter in der Liste aus und klicken dann auf Other. Beachten Sie, dass während der Komponentenplatzierung die Tasten Spacebar und Shift+Spacebar zum Drehen verwendet werden. Ein platziertes Komponentenobjekt kann über das Menü Rotation im Bereich Location des Fensters Properties gedreht werden oder indem Sie die Komponente auswählen und dann Spacebar oder Shift+Spacebar drücken.

Klicken Sie auf einen sichtbaren Parameter und ziehen Sie ihn, um ihn im Schaltplan manuell neu zu positionieren; die Standard-Tastenkürzel für die Ausrichtung gelten dabei ebenfalls. Wenn die Option Autoposition für diesen Parameter deaktiviert ist and die Option Mark Manual Parameters auf der Seite Schematic - Graphical Editing im Dialog Preferences aktiviert ist, werden manuell verschobene Parameter durch einen Punkt in der linken unteren Ecke ihres Auswahlrahmens gekennzeichnet.

Komponentenparameter für spezielle Zwecke

Komponentenparameter für spezielle Zwecke stehen zur Verfügung, um Verknüpfungen zu zugehörigen URL-Zielen oder dateibasierter Dokumentation herzustellen. Für eine ausgewählte Komponente werden diese hinzugefügt, indem Sie im Bereich Add des Fensters Properties auf Parameters klicken und dann im Dropdown Link auswählen, oder auf der Registerkarte Parameters für dedizierte Hilfelinks, die mit der Taste F1 aktiviert werden.

Link-Parameter

Die Link-Funktion ermöglicht die Definition und Darstellung benannter Links zu beliebig vielen Referenz-URLs oder Dokumenten.

Um einen Referenzlink für eine Komponente hinzuzufügen, wählen Sie die Komponente im Arbeitsbereich aus und klicken dann unter dem Bereich Parameters des Fensters Properties auf Links . Wählen Sie Link aus dem Dropdown-Menü Add unten im Bereich Parameters . Geben Sie den Name des Links und den Value (Ziel-URL oder Dateipfad) in das Raster ein. Auf den Link kann dann zugegriffen werden, indem Sie im Arbeitsbereich mit der rechten Maustaste auf die Komponente klicken und den Link-<name> aus dem Untermenü References auswählen.

Die Komponentenlinks, wie sie im Fenster und im Arbeitsbereich dargestellt werden, basieren intern auf Name/Wert-Paaren im Format ComponentLinknDescription/ComponentLinknURL (wobei n die Nummer des Links in der Liste ist, basierend auf der Reihenfolge der Erstellung). Weitere Details finden Sie im Eintrag Parameter Table Editor für diese Komponente.

Der Parameter HelpURL

Ähnlich wie der Link-Parameter ermöglicht der Parameter HelpURL die Definition eines Links von einer Komponente zu einem externen Dokument, etwa einer PDF-Datei oder einer Webseiten-URL. Wenn er als Komponentenparameter hinzugefügt wurde, wird der Link aktiviert, wenn die Taste F1 über der Komponente auf dem Schaltplanblatt gedrückt wird oder wenn die Komponente im Fenster Libraries ausgewählt ist. Beachten Sie, dass diese Aktion die normale Funktion der Taste F1 überschreibt, die auf die entsprechende Seite in der Altium-Onlinedokumentation verweist.

Der Hilfelink wird als Benutzerparameter im Fenster Properties hinzugefügt, wenn eine Komponente im Arbeitsbereich ausgewählt ist. Klicken Sie unter dem Bereich Parameters des Fensters Properties auf Parameters  und wählen Sie dann Parameter  aus dem Dropdown-Menü Add unten im Bereich Parameters . Geben Sie "HelpURL" als Parameter-Name und den Zielpfad/die Ziel-URL als Parameter-Value ein.

Beim Festlegen des Werts für den Parameter kann es sich um eine URL, einen absoluten Pfad zu einem Dokument oder einfach nur um den Dokumentnamen handeln. Wenn F1 gedrückt wird, während sich der Cursor über dem platzierten Komponentenobjekt befindet, oder wenn die Option References » Help aus dem Kontextmenü verwendet wird, wird wie folgt nach der Hilfe-Referenz gesucht:

• Wenn ein Pfad angegeben ist, wird zuerst an diesem Speicherort gesucht.
• Wenn das Dokument an diesem Speicherort nicht gefunden werden kann oder kein Pfad angegeben ist, wird der Ordner \Help der Softwareinstallation durchsucht.
• Wenn das Ziel eine URL ist, wird die Webseite je nach Status der Option Open internet links in external Web browser auf der Seite System - View im Dialog Preferences im internen Browser der Software oder in einem externen Browser geöffnet.

Indirektion – ein Parameter als String-Wert

Die meisten Komponentenparameter können auf einem Schaltplanblatt angezeigt werden, indem das Sichtbarkeitssymbol () (sofern verfügbar) im Fenster Properties aktiviert wird. Kennungs- und Systemparameter sind auf der Registerkarte General des Fensters verfügbar, und Benutzerparameter sind im Bereich Parameters des Fensters zugänglich.

Andere Parameter, wie Dokument- und Projektparameter, können jedoch nicht direkt auf dem Schaltplanblatt angezeigt werden, sondern lassen sich mit einer Technik, die als String Indirection bekannt ist, in ein Standard-Textobjekt einfügen. Bei der Indirektion ist der Werteintrag für ein String-Objekt der Name eines verfügbaren Parameters (z. B. eines Dokument- oder Projektparameters), dem ein Gleichheitszeichen vorangestellt ist, zum Beispiel =Title.

Die Software erkennt solche Strings automatisch und prüft, ob ein verfügbarer Parametername vorhanden ist, der mit dem Werteintrag des platzierten Textobjekts übereinstimmt. Das Beispiel Title wird als Dokumentparameter gefunden, wodurch der Text-String den Wert des Titelparameters interpretiert und anzeigt, zum Beispiel MyDocument. Ein Parametername kann einem ausgewählten Text-String-Wert durch In-Place-Bearbeitung zugewiesen werden (d. h. durch Eingabe von =Title) oder, als aussagekräftigerer Ansatz, durch Verwendung des Dropdown-Menüs Text im Fenster Properties panel, um aus den verfügbaren Parameter-Strings auszuwählen.

Spezielle Strings

Parameter-Strings, die als indirekte Strings verfügbar sind (siehe oben), werden als special strings bezeichnet. Der von diesen Strings dargestellte Wert wird aktiv aus Vorlagen oder System- und Quelldaten abgeleitet, sodass zum Beispiel der spezielle String =Time die aktuelle Systemzeit erkennt und anzeigt und =DocumentName den aktuellen Dateinamen des Schaltplandokuments anzeigt (z. B. MySchematic.SchDoc).

Es steht eine große Anzahl vordefinierter spezieller Strings zur Verfügung. Weitere Informationen zu diesen speziellen Strings finden Sie auf der Seite Working with Text Objects on a Schematic. Jeder benutzerdefinierte Dokument- oder Projektparameter kann ebenfalls als spezieller String verwendet und auf einen Text-String auf dem Schaltplanblatt „indirekt“ angewendet werden.

Parameter haben eine Hierarchie. Das bedeutet, dass Sie einen Parameter mit demselben Namen auf verschiedenen Ebenen des Projekts erstellen können, jeweils mit unterschiedlichen Werten. Für einen Komponentenparameter löst Altium Designer dies auf folgende Weise auf:

1. Komponentenparameter (höchste Priorität)

2. Variante

3. Schaltplandokument

4. Blattsymbol (um den Wert des Parameters des obigen Blattsymbols zu sehen, wählen Sie die Registerkarte Compiled unten im Arbeitsbereich aus)

5. Projekt

Die meisten Optionen/Steuerelemente in diesem Fenster sind selbsterklärend und erfordern keine weitere Erläuterung. Eine davon wird unten beschrieben.

• Allow Synchronization with Database (nur Dialog Preferences ) – aktivieren, um mit der Datenbank zu synchronisieren. Diese Option wird verwendet, um zu steuern, ob der Kommentar aktualisiert werden kann. Standardmäßig sind diese Optionen aktiviert, damit die Synchronisierung mit der Quellbibliothek/Datenbank immer zulässig ist. Sie können diese Option deaktivieren, um zu verhindern, dass dieser Kommentar in einen Aktualisierungsvorgang einbezogen wird.

Die meisten Optionen/Felder im Dialog sind selbsterklärend. Erläuterungen zu denjenigen, die es nicht sind, finden Sie unten.

• Remove Columns - klicken Sie, um Spalten zu entfernen. Diese Option ist nur für Spalten mit statischen Informationen verfügbar.

• Add Column - klicken Sie, um eine Spalte hinzuzufügen. Der Dialog Add Parameter wird geöffnet, in dem Sie den Parameternamen definieren können.

• Reset Column Order - klicken Sie, um die Spalten in alphabetischer Reihenfolge anzuzeigen.

• Accept Changes (Create ECO) - um diese Änderungen auf die Komponenten anzuwenden, muss ein ECO (Engineering Change Order) erzeugt werden. Klicken Sie, um den Dialog Engineering Change Order zu öffnen. 

Rechtsklick-Menü

• Revert - klicken Sie, um Bearbeitungen für die ausgewählten Zellen rückgängig zu machen.

• Add - klicken Sie, um Informationen zur ausgewählten Zelle hinzuzufügen. Verwenden Sie das daraufhin angezeigte Dropdown-Menü, um die gewünschten Informationen auszuwählen.

• Rename Column - klicken Sie, um den Dialog Rename Existing Parameter dialog zu öffnen, in dem Sie einen vorhandenen Parameter umbenennen können.

• Remove Columns - klicken Sie, um die ausgewählte Spalte zu löschen.

• Report - klicken Sie, um den Dialog Report Preview zum Erzeugen eines Berichts zu öffnen.

• Cross Probe - klicken Sie, um das ausgewählte Objekt per Cross-Probing hervorzuheben. Das ausgewählte Objekt wird im Schaltplanblatt hervorgehoben.

Hinweise

• Sie können Spalten im Rasterbereich per Drag-and-Drop verschieben, um die Anzeigereihenfolge der Spalten zu ändern. Die neue Reihenfolge wird in der Projektdatei gespeichert, sodass sie beim nächsten Öffnen des Dialogs beibehalten wird.

• Parameter können auf folgende Weise vor Aktualisierungen geschützt werden:

  • Auf der Ebene einzelner Komponentenparameter aktivieren Sie die Option Lock Parameter im Modus Component des Panels Properties (zum Öffnen doppelklicken Sie auf eine Komponente). Die Option Allow Synchronization With Database wird auch verwendet, um zu steuern, ob der Kommentar aktualisiert werden kann. Standardmäßig ist diese Option aktiviert, damit stets eine Synchronisierung mit der Quellbibliothek/Datenbank möglich ist. Sie können diese Option deaktivieren, um zu verhindern, dass der Kommentar in einen Aktualisierungsvorgang einbezogen wird.
  • Auf der Ebene der Datenbankverknüpfung enthält der Bereich Field Mapping des entsprechenden Dokuments für die Datenbankverknüpfung (Datei *.DbLink, *.DbLib oder *.SvnDbLib) eine Reihe von Optionen, die steuern, ob Parameter aktualisiert werden können, darunter Update Values, Add to Design und Remove from Design.