Working with the Variant Manager

Der Variant Manager ist eine dokumentbasierte Benutzeroberfläche, mit der Sie Designvarianten Ihres PCB-Designprojekts anzeigen, erstellen und verwalten können. Um auf den Variant Manager zuzugreifen, klicken Sie mit der rechten Maustaste auf den Projekteintrag im Projects-Panel und wählen Variants aus, oder wählen Project » Variants in den Hauptmenüs des Schaltplan- oder PCB-Editors.

Arbeiten mit Varianten

Erstellen einer neuen Variante

Um eine neue Variante hinzuzufügen, verwenden Sie die Schaltfläche Add Variant oben links im Variant Manager, wenn die Registerkarte Variants aktiv ist. Im Rasterbereich erscheint dann eine zusätzliche Variantenspalte mit einem Standardtitel, wie im Bild unten gezeigt. Alle Zellen der neuen Spalte sind leer; eine leere Zelle bedeutet, dass diese Komponente Bestückt ist und gegenüber dem Basisdesign unverändert bleibt.

Eine neue Variante wird standardmäßig mit allen Komponenten als Bestückt hinzugefügt.

Sie können die im Variant Manager angezeigten Varianten über den Dialog Variants Filter filtern, der durch Klicken auf  oben rechts geöffnet wird. Um die angezeigten Varianten zu filtern, aktivieren Sie das Kontrollkästchen der Variante(n), die angezeigt werden sollen. Wenn im Dialog auf OK geklickt wird, werden die Varianten entsprechend den aktivierten Kontrollkästchen gefiltert. Wenn ein Filter angewendet wird, wird die Filterschaltfläche als  angezeigt. Um die Filterung zu entfernen oder zu ändern, klicken Sie auf die Filterschaltfläche, um den Dialog Variants Filter erneut zu öffnen, und aktualisieren dann die Kontrollkästchen. Wenn das Kontrollkästchen Project Variants  aktiviert ist, werden alle Varianten im Projekt angezeigt. 

Konfigurieren von Varianteneigenschaften

Um Variantenoptionen zu ändern, verwenden Sie das Properties-Panel im Modus Variant, den Sie aufrufen können, indem Sie mit der rechten Maustaste auf die Spaltenüberschrift der gewünschten Variante klicken und Properties auswählen.

Öffnen Sie das Properties-Panel im Modus Variant, um die Optionen einer Variante zu ändern.

• Geben Sie im Feld Name einen aussagekräftigen Namen für die Variante an.

  Der Name einer Variante kann auch über den Dialog Rename Variant geändert werden, der geöffnet wird, indem Sie auf die Spaltenüberschrift der Variante klicken, um sie auszuwählen, und dann oben links im Variant Manager auf   klicken oder mit der rechten Maustaste auf die Spaltenüberschrift der Variante klicken und anschließend Rename Variant auswählen.

• Sie können mit den folgenden Optionen festlegen, ob bei einem alternativen Bauteil dessen Symbol im Schaltplan geändert oder dessen Footprint zum PCB hinzugefügt werden soll:

  • Do not overwrite schematic symbol – wenn aktiviert, werden für Komponenten, für die in der Variante alternative Bauteile ausgewählt sind, nicht variierte Symbole verwendet.

    Beachten Sie, dass diese Option nur die Darstellung des Symbols auf dem Schaltplanblatt beeinflusst. Das Symbol des alternativen Bauteils wird beim Aufbau des Design-Konnektivitätsmodells berücksichtigt. Daher müssen Basis- und Alternativkomponenten pin-kompatibel sein, auch wenn die Option aktiviert ist. Weitere Informationen zur Pin-Kompatibilität finden Sie im Abschnitt Defining Component Variations.

  • Do not overwrite PCB footprint – wenn aktiviert, werden für Komponenten, für die in der Variante alternative Bauteile ausgewählt sind, nicht variierte Footprints verwendet. Ein Footprint eines alternativen Bauteils, das auf eine Variante angewendet wurde, wird im Rahmen der PCB-Aktualisierung nicht auf das PCB übertragen (es wird kein ECO zum Hinzufügen des Footprints zum PCB erzeugt).

  Unabhängig davon, ob diese beiden Parameter aktiviert sind oder nicht, werden die Parameter der gewählten Alternative in ActiveBOM korrekt dargestellt.

• Wenn Fertigungsvarianten aus dem Design erzeugt werden sollen, aktivieren Sie die Option Allow variation of fabrication outputs. Wenn in einem Output Job eine Variante für eine Fertigungsausgabe festgelegt ist und diese Variante die Option not nicht aktiviert hat, wird der Variantenname des Jobs rot angezeigt. Beachten Sie, dass der rote Variantenname lediglich eine Warnkennzeichnung ist und die variantenspezifischen Ausgabedateien dennoch erzeugt werden.

  Wenn Pastenmaskenausgaben für ein Design erzeugt werden sollen, das Varianten mit Komponenten vom Typ „Nicht bestückt“ enthält, aktivieren Sie die Option Allow variation for paste mask. Diese Komponenten erhalten dann keine Pastenmaske mehr auf ihren Pads.

  Informationen dazu, wie Varianten zu einer Output-Job-Datei hinzugefügt und darin angezeigt werden, finden Sie auf der Seite Preparing Manufacturing Data with Output Jobs.

• Verwenden Sie den Bereich Variant's Parameters des Panels, um die Liste der Parameter auf Variantenebene festzulegen.

  Ein Variantenparameter kann in einem Schaltplan- oder PCB-Dokument durch Platzieren einer speziellen Zeichenfolge angezeigt werden. Weitere Informationen finden Sie unter Special Strings on a Schematic und Special Strings on a PCB.

  Altium Designer unterstützt Parameter auf verschiedenen Ebenen eines Projekts: Projekt, Schaltplandokument und Variante. Parameter, die auf verschiedenen Ebenen in einem Projekt enthalten sind, existieren in einer Hierarchie. Das bedeutet, dass Sie tatsächlich einen Parameter mit demselben Namen auf verschiedenen Ebenen im Projekt erstellen können, wobei jeder einen anderen Wert hat. Altium Designer löst diese Situation mithilfe von Prioritäten auf folgende Weise:

  1. Variante (höchste Priorität)
  2. Schaltplandokument
  3. Projekt

  Diese Anordnung bedeutet, dass der in einem Schaltplandokument definierte Parameterwert den in den Projektoptionen definierten Wert überschreibt und der in einer Variante definierte Parameterwert wiederum den im Schaltplandokument definierten Wert überschreibt.

Eigenschaften einer Variante

Klicken Sie mit der rechten Maustaste auf eine Zelle und wählen Sie dann Properties , um das Properties -Panel zu öffnen, das die Details des ausgewählten Component/Group anzeigt. Das Component Parameters der Variante kann nach Bedarf bearbeitet werden. 

Die Parameter können auch angezeigt und bearbeitet werden, indem Sie eine Komponente im Raster auswählen und dann den Bereich Parameter erweitern, der unten im Raster erscheint.

Definieren von Komponentenvariationen

Jede Komponente im Basisdesign kann wie folgt konfiguriert werden:

• Fitted – die Standardeinstellung, wenn eine neue Variante erstellt wird.
• Not Fitted – die ursprüngliche Komponente, wie sie im Basisdesign verwendet wird, ist in dieser Variante des Designs nicht bestückt/wird nicht verwendet.
• Bestückt mit geänderten Komponentenparametern, z. B. dem Wert der Komponente.
• Alternate Part – vollständiger Ersatz einer Komponente durch eine andere.

Der Status einer Komponente in einer Designvariante kann geändert werden, indem Sie auf die Komponentenzelle in der Variantenspalte klicken und das Dropdown-Menü der Zelle öffnen, das drei Auswahlmöglichkeiten bietet:

• (Fitted) – die ursprüngliche Komponente, wie sie im Basisdesign verwendet wird, ist auch in dieser Variante des Designs bestückt/wird verwendet. Beachten Sie, dass einzelne Parameter auch bei einer bestückten Komponente variiert werden können – siehe unten.

• Not Fitted – die ursprüngliche Komponente, wie sie im Basisdesign verwendet wird, ist in dieser Variante des Designs nicht bestückt/wird nicht verwendet.

• Alternate Part – diese Option ermöglicht die Auswahl eines anderen (alternativen) Bauteils. Verwenden Sie den Dialog Replace (eine modale Dialogversion des Components Panels), um das gewünschte alternative Bauteil auszuwählen. Sobald dieses Bauteil ausgewählt ist, zeigt die Zelle die ID des alternativen Bauteils an.

  Nach der Auswahl eines alternativen Bauteils prüft die Software die Pin-Kompatibilität zwischen der ausgewählten alternativen Komponente und der ursprünglichen Komponente des Basisdesigns. Um pin-kompatibel zu sein, muss die Alternative dieselbe Anzahl von Pins wie die ursprüngliche Komponente haben, und diese Pins müssen hinsichtlich Position und elektrischem Typ identisch sein. Die in den Symbolen der beiden Komponenten verwendeten grafischen Primitive müssen nicht übereinstimmen. Wenn die Software erkennt, dass die alternative Komponente nicht pin-kompatibel ist, muss ein Dialog Confirm  bestätigt werden, bevor der Ersatz akzeptiert wird. In diesem Fall sollten Sie die möglichen Auswirkungen auf die Verdrahtung berücksichtigen.

Sie können ein alternatives Bauteil auswählen, ohne das Symbol im Schaltplan zu ändern oder ohne einen Footprint zum PCB hinzufügen zu müssen. Aktivieren Sie im Properties -Panel je nach Bedarf die Optionen Do not overwrite schematic symbol  und/oder Do not overwrite PCB footprint. Wenn Letztere aktiviert ist, wird ein Footprint einer alternativen Komponente, die auf eine Variante angewendet wurde, im Rahmen der PCB-Aktualisierung nicht auf das PCB übertragen (es wird kein ECO zum Hinzufügen des Footprints zum PCB erzeugt). Die Parameter der gewählten Alternative werden in ActiveBOM korrekt dargestellt.

Die oben aufgeführten Zustände von Komponenten finden Sie auch, indem Sie im Raster mit der rechten Maustaste klicken, Set Selected As wählen und dann den gewünschten Zustand aus dem zugehörigen Menü auswählen, wie unten gezeigt.

Definieren Sie die Bauteilvariante über das Dropdown-Menü in der Zelle der gewünschten Variantenspalte. Wenn Sie die Option Alternate Part auswählen, verwenden Sie den Dialog Replace, um ein alternatives Bauteil auszuwählen.

Einzelne Parameter können für ein bestücktes oder alternatives Bauteil variiert werden, indem Sie im Bereich Properties einen neuen Parameterwert eingeben. Klicken Sie auf die Zelle eines Bauteils in der gewünschten Variantenspalte und verwenden Sie die Spalte der ausgewählten Variante im Bereich Component Parameters des Fensters Properties in dessen Modus Component for variant, um einen geänderten Parameterwert einzugeben. Für den Parameter Footprint klicken Sie auf das Dropdown-Menü der Zelle, um einen Footprint auszuwählen, wenn dem Bauteil mehrere Footprint-Modelle zugewiesen sind. Ein Parameterwert, der vom Basisdesign abweicht, wird gelb angezeigt, und die Bauteilzelle im Rasterbereich zeigt den Bauteilnamen an.

Beispiel für das Definieren eines alternativen Parameters eines bestückten Bauteils. Geben Sie wie im Bild gezeigt einen neuen Parameterwert ein. Bewegen Sie den Mauszeiger über das Bild, um die Bauteilzelle nach dem Definieren eines neuen Parameterwerts zu sehen.

Aktualisieren eines Parameters eines alternativen Bauteils

Wenn bei einem Bibliotheksbauteil, das als alternatives Bauteil verwendet wird, Parameter in der Bibliothek geändert wurden, können Sie diese Änderungen direkt in die Variantendefinitionen Ihres Projekts übernehmen. Wählen Sie den Befehl Update Values from Library aus dem Kontextmenü per Rechtsklick des Bereichs Parameter unten im Variant Manager oder im Bereich Component Parameters des Fensters Properties, wenn das gewünschte alternative Bauteil im Hauptrasterbereich ausgewählt ist, um alle an einem Bibliotheksbauteil vorgenommenen Parameteränderungen zu übernehmen.

Greifen Sie auf den Befehl Update Values from Library im Variant Manager zu. Hier wird der Zugriff über das Kontextmenü per Rechtsklick des Bereichs Parameter gezeigt, wenn der gewünschte Bauteileintrag ausgewählt ist. Bewegen Sie den Mauszeiger über das Bild, um den Zugriff über das Fenster Properties zu sehen, wenn der Eintrag des alternativen Bauteils ausgewählt ist.

Navigieren Sie über den Dialog Replace zum Bauteil in der Quellbibliothek und klicken Sie auf OK, um den Dialog Update Project Variants From Library zu öffnen. Alle Parameter sind auf der linken Seite des Dialogs Update Project Variants From Library aufgelistet – bei Bedarf kann jeder Parameter abgewählt werden, um ihn vom Aktualisierungsvorgang auszuschließen. Auf der rechten Seite des Dialogs kann die Ziel-Projektvariante geändert werden (Project Variant To Update). Standardmäßig ist die Variante ausgewählt, die ausgewählt war, als der Befehl Update Values from Library aktiviert wurde. Klicken Sie auf OK, um den Aktualisierungsvorgang abzuschließen.

Kopieren einer Variante

Sie können eine Variante mit dem Befehl Make a copy  kopieren. Klicken Sie mit der rechten Maustaste auf die Kopfzeile der Variantennamensspalte und wählen Sie dann die Option Make a copy . Eine neue Spalte mit denselben Daten und demselben Namen (ergänzt um „Copy“) wird hinzugefügt. Mit der Option Rename können Sie der neuen Spalte einen passenden Titel geben.

Entfernen einer Variante

Um die Variante zu löschen, wählen Sie die Kopfzeile aus und verwenden dann das Symbol . Die Möglichkeit, diese oder alle Varianten zu löschen, ist auch im Kontextmenü per Rechtsklick enthalten, wie unten gezeigt. Vor dem Löschen wird zur Bestätigung ein Dialog geöffnet.

Arbeiten mit Gruppen

Um die Verwaltung einer großen Anzahl von Designvarianten zu erleichtern, ermöglicht das Variant Manager auch das Erstellen von Gruppen von Bauteilen aus einem ausgewählten Schaltplandokument, aus Blättern, auf die durch ein ausgewähltes Blattsymbol verwiesen wird, oder aus einer ausgewählten Bauteilklasse mit einer funktionsbasierten Ansicht von Bauteilvariationen. Für jede Gruppe können Sie eine oder mehrere „Optionen“ definieren, die im Wesentlichen eine Variation eines oder mehrerer Bauteile in der Gruppe widerspiegeln. Varianten können dann auf Grundlage dieser definierten Gruppen und Optionen erstellt werden, einschließlich Unterstützung für das Erstellen einer Variantenhierarchie. Wenn eine Änderung erforderlich ist, wird das Bearbeiten eines Werts innerhalb einer Gruppenoption sofort in allen Varianten übernommen, die diese Gruppenoption verwenden.

Der Arbeitsablauf beim Arbeiten mit Gruppen ist wie folgt:

1. Wechseln Sie über das Steuerelement oben im Variant Manager zur Registerkarte Groups.

2. Wählen Sie über das Dropdown-Menü der Schaltfläche Add Group ein Schaltplandokument, ein Blattsymbol oder eine Bauteilklasse aus, für das bzw. die eine Gruppe erstellt werden soll.

   
   Fügen Sie eine Gruppe hinzu, um die weitere Variantenverwaltung auf Grundlage dieser Gruppe zu erleichtern.

3. Eine neue Gruppe wird im linken Bereich des Variant Manager aufgelistet, während die Bauteile der ausgewählten Gruppe rechts angezeigt werden.

   Standardmäßig wird der Name des ausgewählten Schaltplanblatts, Blattsymbols oder der Bauteilklasse der neu erstellten Gruppe zugewiesen. Verwenden Sie die Schaltfläche Rename unten im Bereich der Gruppenliste, um die Gruppe bei Bedarf umzubenennen.

   Verwenden Sie die Schaltfläche Add Option, um eine Option für die aktuell ausgewählte Gruppe hinzuzufügen. Im Rasterbereich erscheint eine zusätzliche Optionsspalte mit einem Standardtitel. Alle Zellen der neuen Spalte sind leer; eine leere Zelle bedeutet, dass dieses Bauteil bestückt und gegenüber dem Basisdesign unverändert ist.

   
   Fügen Sie wie im Bild gezeigt eine Option für die ausgewählte Gruppe hinzu. Bewegen Sie den Mauszeiger über das Bild, um die Standard-Optionsspalte zu sehen.

4. Weisen Sie der neu erstellten Option einen aussagekräftigen Namen zu, indem Sie den Standardnamen ändern. Klicken Sie auf die Spaltenkopfzeile der Option, um sie auszuwählen, und klicken Sie dann auf die Schaltfläche Rename unten im Rasterbereich oder klicken Sie mit der rechten Maustaste auf die Kopfzeile und wählen Sie Rename, um den Dialog zum Eingeben eines neuen Namens zu öffnen.

   
   Vergeben Sie einen aussagekräftigen Namen für eine Option.

5. Konfigurieren Sie über die Bauteilzellen in der Spalte der gewünschten Option die Bauteilvariationen. Der Vorgang ist derselbe wie beim Definieren von Bauteilvariationen für eine Variante.

   
   Konfigurieren Sie Bauteilvariationen für die ausgewählte Option.

   Es wird nicht empfohlen, Bauteilparameter manuell zu ändern. Außerdem werden alternative Bauteile dringend empfohlen. Um alternative Footprints zu verwenden, nutzen Sie beim Arbeiten mit Gruppen ein separates Bauteil.
   Zellinhalte von Variantengruppenoptionen können mit den entsprechenden Befehlen im Kontextmenü per Rechtsklick oder mit den passenden Tastenkombinationen (Ctrl+C, Ctrl+V, Ctrl+X) kopiert, eingefügt oder ausgeschnitten werden.

6. Fügen Sie weitere Optionen für die ausgewählte Gruppe hinzu, indem Sie mit der rechten Maustaste in den Rasterbereich klicken und Add Option auswählen. Konfigurieren Sie die neue Option nach Bedarf.

   
   Fügen Sie nach Bedarf weitere Optionen hinzu und konfigurieren Sie sie.

7. Auf der Registerkarte Variants des Variant Manager werden die Bauteile, für die eine Gruppe erstellt wurde, unter dem entsprechenden Eintrag im Rasterbereich angezeigt. Wählen Sie über das Dropdown-Menü der Zelle für einen Gruppeneintrag eine auf der Registerkarte Groups für diese Gruppe erstellte Option aus. Die für die Bauteile in dieser Gruppe konfigurierten Variationen werden angewendet.

   
   Fügen Sie wie im Bild gezeigt eine Option für die ausgewählte Gruppe hinzu. Bewegen Sie den Mauszeiger über das Bild, um die Standard-Optionsspalte zu sehen.

Kopieren einer Gruppenoption

Um eine Option einer Variantengruppe zu kopieren, klicken Sie auf der Registerkarte Groups mit der rechten Maustaste auf die Spaltenüberschrift <New Option> und wählen dann Make a copy. Eine neue Spalte mit denselben Daten und demselben Namen (ergänzt um „Copy“) wird hinzugefügt. Mit der Option Rename können Sie der neuen Spalte einen passenden Titel geben.

Hinweise

• Wenn Sie Varianten konfigurieren, werden die Einstellungen in der Projektdatei gespeichert. Dazu gehören der Status Not Fitted, lokale Parametervariationen an einem Fitted Bauteil und die Parameterwerte von Alternate Parts. Die alternativen Bauteile werden in der Datei <ProjectName>.PrjPcbVariants gespeichert.
• Variantenspalten können angeheftet werden, damit sie zuerst links von nicht angehefteten Spalten angezeigt werden. Um eine Variantenspalte anzuheften, bewegen Sie den Mauszeiger über ihre Kopfzeile und klicken Sie auf .
• Doppelklicken Sie auf ein Bauteil oder klicken Sie mit der rechten Maustaste darauf und wählen Sie dann die Option Cross Probe, um zu diesem Bauteil im Schaltplan zu springen.
• Verwenden Sie den Befehl Select All aus dem Kontextmenü per Rechtsklick des Rasterbereichs auf der Registerkarte Variants oder im Bereich Parameter , um schnell den gesamten Rasterinhalt auszuwählen.
• Verwenden Sie den Befehl Invert Selection aus dem Kontextmenü per Rechtsklick des Rasterbereichs auf der Registerkarte Variants oder im Bereich Parameter , um schnell nicht ausgewählte Einträge auszuwählen und ausgewählte Einträge abzuwählen.
• Klicken Sie unten links im Variant Manager auf die Schaltfläche View Report, um mit dem sich öffnenden Dialog Variants Report einen detaillierten Variantenbericht im HTML-Format zu erzeugen.
• Klicken Sie mit der rechten Maustaste in den Rasterbereich der Registerkarte Variants oder in den Bereich Parameter  und verwenden Sie die folgenden Befehle des Kontextmenüs, um Berichtsdateien zu erzeugen:
  • Report – klicken Sie hier, um das Dialogfeld Report Preview zu öffnen und einen Ausdruck des Rasters zu erstellen.
  • Save All – klicken Sie hier, um ein Dialogfeld zu öffnen und eine Auflistung aller Komponenten / aller Parameter für die ausgewählte Komponente als tabulatorgetrennte Textdatei zu speichern (*.txt).
  • Save Selected – klicken Sie hier, um ein Dialogfeld zu öffnen und eine Auflistung der ausgewählten Komponenten / ausgewählten Parameter als tabulatorgetrennte Textdatei zu speichern (*.txt).
• Wenn der Schaltplan geändert wird, wird oben in Variant Manager eine entsprechende Benachrichtigung angezeigt. Klicken Sie auf das Steuerelement Refresh neben der Benachrichtigung, um die Daten in Variant Manager zu aktualisieren.
• Die Option Delete, die beim Rechtsklick auf eine Zelle verfügbar ist, kann verwendet werden, um eine Variante, eine Gruppe oder eine Option zu löschen.