Working with the Variant Management Dialog

Warianty są tworzone i konfigurowane w oknie dialogowym Variant Management. Aby otworzyć to okno, wybierz Variants z menu Project (skrót: C, V) lub kliknij prawym przyciskiem myszy nazwę projektu w panelu Projects, a następnie wybierz Variants.

Do tego okna można również przejść, klikając prawym przyciskiem myszy umieszczony komponent w edytorze schematów, a następnie wybierając Part Actions » Variants. W takim przypadku okno zostanie wypełnione elementami, które są aktualnie zaznaczone w edytorze schematów.

Okno dialogowe Variant Management jest dostępne, gdy opcja UI.ModernVariantsManager jest wyłączona w oknie dialogowym Advanced Settings. Gdy opcja UI.ModernVariantsManager jest włączona, do tworzenia i konfigurowania wariantów projektu używany jest Variant Manager .

Funkcje okna dialogowego

Okno dialogowe ma dwa główne obszary:

  • Górny obszar Components for project, który wyświetla wszystkie komponenty w projekcie bazowym oraz, jeśli dotyczy, kolumny dla zastosowanych wariantów.

  • Dolny obszar Component Parameters, który przedstawia wszystkie parametry komponentu(ów) aktualnie wybranych w górnym obszarze oraz, jeśli dotyczy, kolumny dla zastosowanych wariantów.

Warianty są tworzone i konfigurowane w oknie dialogowym Variant Management.
Warianty są tworzone i konfigurowane w oknie dialogowym Variant Management.

Kliknij dwukrotnie komponent w oknie dialogowym Variant Management, aby przejść do tego komponentu na schemacie, lub wybierz Cross Probe z menu kontekstowego po kliknięciu prawym przyciskiem myszy.

Tworzenie nowego wariantu

Kliknij przycisk Add Variant button w oknie dialogowym Variant Management, aby utworzyć nowy wariant projektu bazowego. Otworzy się okno dialogowe Edit Project Variant.

Co najmniej należy wprowadzić nazwę wariantu w polu Description, które domyślnie zawiera wpis Variant of <ProjectName>.

Jeśli z projektu mają być generowane warianty produkcyjne, włącz opcję Allow variation of fabrication outputs w oknie dialogowym Edit Project Variant. Jeśli dla projektu zawierającego warianty z komponentami „Not Fitted” mają być generowane dane wyjściowe maski pasty, włącz opcję Allow variation for paste mask . Te komponenty nie będą już miały maski pasty uwzględnionej na swoich padach.

Możesz wybrać, czy dla części alternatywnej należy zmienić jej symbol na schemacie, czy dodać jej footprint do PCB, korzystając z następujących opcji w oknie dialogowym Edit Project Variant:

  • Do not overwrite schematic symbol – po włączeniu dla komponentów, dla których w wariancie wybrano części alternatywne, będą używane symbole bez zmian wariantowych.

    Należy pamiętać, że ta opcja wpływa tylko na reprezentację symbolu na arkuszu schematu. Symbol części alternatywnej jest uwzględniany podczas budowania modelu połączeń projektu. Dlatego komponent bazowy i alternatywny muszą być zgodne pod względem pinów, nawet jeśli opcja jest włączona. Więcej informacji o zgodności pinów znajduje się w sekcji Choosing an Alternate Part.

  • Do not overwrite PCB footprint – po włączeniu dla komponentów, dla których w wariancie wybrano części alternatywne, będą używane footprinty bez zmian wariantowych. Footprint części alternatywnej zastosowanej w wariancie nie zostanie przeniesiony do PCB podczas aktualizacji PCB (nie zostanie wygenerowane ECO dodające footprint do PCB).

Niezależnie od tego, czy te dwa parametry są włączone, czy nie, parametry wybranej części alternatywnej są prezentowane w ActiveBOM.

Możesz również zdefiniować parametry wariantu. Szczegółowe informacje o tym, jak to zrobić i jak parametry na poziomie wariantu wpisują się w hierarchię parametryczną w Altium Designer, znajdziesz w Working with Variant Parameters.

Po zdefiniowaniu wariantu zgodnie z wymaganiami kliknij OK. Po prawej stronie okna dialogowego Variant Management otworzy się dodatkowa kolumna z nazwą nowego wariantu jako nagłówkiem kolumny. Wszystkie komórki będą puste; pusta komórka oznacza, że komponent jest Fitted i niezmieniony względem projektu bazowego. Teraz można skonfigurować komponenty dla nowego wariantu. Poniższy obraz przedstawia projekt, dla którego utworzono dwa warianty: BGA i TSOP.

Obszar 1 przedstawia komponenty w projekcie bazowym; obszar 2 przedstawia komponenty w wariancie BGA; a obszar 3 przedstawia komponenty w wariancie TSOP.
Obszar 1 przedstawia komponenty w projekcie bazowym; obszar 2 przedstawia komponenty w wariancie BGA; a obszar 3 przedstawia komponenty w wariancie TSOP.

Aby ustawić wariant jako aktywny, kliknij jego nazwę w nagłówku kolumny lub kliknij dowolną komórkę tego wariantu.

Okno dialogowe Variant Management zawiera szereg funkcji interfejsu umożliwiających wyświetlanie przydatnych informacji. Są one konfigurowane za pomocą menu kontekstowego wywoływanego prawym przyciskiem myszy.

Right-click context menu, Variant Management dialog

Przydatne polecenia, które nie zostały wcześniej zdefiniowane, obejmują:

  • Columns

    • Hierarchy Path – pokazuje położenie komponentu w hierarchii projektu.

    • Original Library Link – podaje informacje o tym, skąd pochodzi komponent bazowy.

  • Set Selected As – użyj podmenu, aby wybrać typ zmiany wariantowej (Fitted, Not Fitted, Alternate). Można tego użyć zamiast klikania elementu sterującego Ellipsis control used to configure a variation w komórce komponentu. Dostępne tylko po kliknięciu prawym przyciskiem myszy komórki komponentu wariantu.

  • Only Show Varied Parameters – wyświetla tylko komponenty, dla których zastosowano jakąś formę zmiany wariantowej w oknie dialogowym Variant Management.

  • Filter – użyj podmenu, aby określić, które typy zmian wariantowych mają być wyświetlane w oknie dialogowym Variant Management. (Dobrze współpracuje z poleceniem Only Show Varied Parameters.)

Definiowanie zmian komponentów

Po utworzeniu wariantu stan każdego komponentu jest gotowy do modyfikacji wariantowej. Można to zrobić, klikając komórkę komponentu w kolumnie wariantu, aby wyświetlić element sterujący Ellipsis control used to configure a variation, lub klikając komórkę prawym przyciskiem myszy i wybierając odpowiednią pozycję z podmenu kontekstowego Set Selected As .

Element sterujący Ellipsis control used to configure a variation otwiera okno dialogowe Edit Component Variation.

Okno dialogowe Edit Component Variation można również otworzyć z zakładki compiled schematu, klikając prawym przyciskiem myszy komponent ze zdefiniowanym wariantem, a następnie wybierając Part Actions » Choose Alternate Part.

Dostępne są trzy opcje:

  •  Fitted – oryginalny komponent użyty w projekcie bazowym jest również montowany/używany w tym wariancie projektu. W nowo dodanym wariancie wszystkie komponenty są domyślnie ustawione jako fitted, a komórki dla komponentów fitted są puste. Należy pamiętać, że poszczególne parametry komponentu fitted również mogą być modyfikowane wariantowo przez wpisanie nowej wartości parametru w obszarze Component Parameters okna dialogowego dla wariantu.

  • Not Fitted – oryginalny komponent użyty w projekcie bazowym nie jest montowany/używany w tym wariancie projektu. Dla statusu komponentu Not Fitted komórka wyświetla tekst Not Fitted, a dolny obszar Component Parameters okna dialogowego jest pusty.

  • Alternate Part – ta opcja umożliwia wybranie innej (alternatywnej) części. Okno dialogowe zostanie rozszerzone o elementy sterujące umożliwiające przeglądanie i wyszukiwanie wymaganego komponentu zastępczego. Po wybraniu części komórka wyświetli link źródłowy części alternatywnej. Obszar Component Parameters okna dialogowego wyświetli wszystkie parametry części alternatywnej. Więcej informacji znajduje się w następnej sekcji.

Obsługiwane są standardowe techniki wielokrotnego zaznaczania systemu Windows. Użyj ich, aby jednocześnie wybrać i skonfigurować wiele komponentów.

Wybór części alternatywnej

Po wybraniu opcji Alternate Part okno dialogowe Edit Component Variation rozszerza się, aby pokazać bazowe parametry istniejącej części. Użyj przycisku , aby przeglądać i znaleźć wymagany komponent części alternatywnej w oknie dialogowym Replace Component dialog, które jest modalną wersją panelu Components panel. Obsługiwane są wszystkie modele przechowywania komponentów Altium Designer, takie jak biblioteki niezależne, biblioteki bazodanowe, a także komponenty Workspace Library (jak pokazano w poniższym przykładzie).

Po wybraniu części alternatywnej oprogramowanie sprawdza zgodność pinów między wybranym komponentem alternatywnym a oryginalnym komponentem projektu bazowego. Aby były zgodne pod względem pinów, część alternatywna musi mieć taką samą liczbę pinów jak oryginalny komponent, a piny te muszą być identyczne pod względem położenia i typu elektrycznego. Prymitywy graficzne użyte w symbolach obu komponentów nie muszą być zgodne. Jeśli oprogramowanie wykryje, że komponent alternatywny nie jest zgodny pod względem pinów, przed zaakceptowaniem zamiany trzeba zamknąć okno dialogowe Confirm. W takim przypadku należy mieć na uwadze potencjalny wpływ na połączenia oraz to, że podczas walidacji projektu może wystąpić naruszenie błędu (Project » Validate <project name>).

Przykład zmiany wariantowej typu Alternate Part.
Przykład zmiany wariantowej typu Alternate Part.

Nowo zastosowany komponent alternatywny można sprawdzić w przestrzeni projektowej. Więcej informacji znajduje się na stronie Working with Variants in the Design.

Resetowanie i aktualizacja danych wariantu

Zmiany wariantowe projektu skonfigurowane w oknie dialogowym Variant Management są ostatecznie zapisywane w pliku projektu. Obejmuje to stan „Not Fitted”, lokalne zmiany parametrów komponentu Fitted oraz wartości parametrów części alternatywnych. Same części alternatywne są przechowywane w pliku [ProjectName].PrjPcbVariants. Okno dialogowe Variant Management zawiera polecenia resetowania parametrów i aktualizacji komponentów, co pomaga zapewnić synchronizację z źródłowymi bibliotekami komponentów.

Aktualizacja parametru zmodyfikowanego komponentu

Parametry zmodyfikowane lokalnie w oknie dialogowym Variant Management można przywrócić do ich oryginalnej wartości, klikając prawym przyciskiem myszy zmodyfikowany parametr (pokazany pogrubieniem) na liście Variant Parameter, a następnie wybierając Reset Selected z menu kontekstowego – jak pokazano poniżej. Należy pamiętać, że można jednocześnie zaznaczyć wiele parametrów i zresetować je jednym działaniem, albo użyć Reset All, aby zresetować wszystkie parametry tego komponentu.

Wartości zmodyfikowanych parametrów można przywrócić za pomocą polecenia Reset Selected.
Wartości zmodyfikowanych parametrów można przywrócić za pomocą polecenia Reset Selected.

Aktualizacja parametru części alternatywnej

Jeśli parametry komponentu bibliotecznego używanego jako część alternatywna zostały zmienione w bibliotece, możesz bezpośrednio przenieść te zmiany do definicji wariantów w swoim projekcie, klikając prawym przyciskiem myszy na liście Parameter tego wariantu i wybierając z menu Update Values from Library (jak pokazano poniżej). Należy pamiętać, że aktualizuje to parametry; jeśli chcesz zaktualizować grafikę, użyj techniki opisanej poniżej.

Jeśli komponent części alternatywnej został zmodyfikowany w bibliotece, użyj polecenia Update Values from Library, aby odświeżyć kopię używaną w projekcie.
Jeśli komponent części alternatywnej został zmodyfikowany w bibliotece, użyj polecenia Update Values from Library, aby odświeżyć kopię używaną w projekcie.

Po użyciu polecenia Update Values from Library przejdź do komponentu w bibliotece źródłowej i znajdź go w oknie dialogowym Browse Libraries, a następnie kliknij OK, aby otworzyć okno dialogowe Update Project Variants From Library. Zaznacz/odznacz opcje Parameters from Library Component i Variants to Update, a następnie kliknij OK, aby zakończyć proces aktualizacji.

Jeśli komponent wybrany do aktualizacji parametrów jest komponentem Workspace, zostanie otwarta podstawowa modalna wersja panelu Components panel zamiast okna dialogowego Browse Libraries. Przeglądaj lub wyszukaj komponent, kliknij OK, aby otworzyć okno dialogowe Update Project Variants From Library, a następnie wybierz żądane parametry do aktualizacji, jak opisano tutaj.

Aktualizacja zmodyfikowanego wariantowo komponentu z biblioteki źródłowej. Tutaj konfigurujesz, które parametry są aktualizowane i do którego wariantu aktualizacje są stosowane.
Aktualizacja zmodyfikowanego wariantowo komponentu z biblioteki źródłowej. Tutaj konfigurujesz, które parametry są aktualizowane i do którego wariantu aktualizacje są stosowane.

Wszystkie parametry są wyświetlane po lewej stronie okna dialogowego Update Project Variants From Library – w razie potrzeby dowolny parametr można odznaczyć, aby wykluczyć go z procesu aktualizacji. Po prawej stronie okna dialogowego można zmienić docelowy wariant projektu (Project Variant To Update). Domyślnie zostanie wybrany wariant, który był zaznaczony w momencie uruchomienia polecenia Update Values from Library.

Zwróć uwagę, że ten proces aktualizacji parametrów pobiera wartości parametrów bezpośrednio z biblioteki do okna dialogowego Variant Management i nie aktualizuje kopii komponentu przechowywanej w pliku [ProjectName].PrjPcbVariants. Jeśli później wykonasz jedno z poleceń Reset w celu zresetowania wartości parametrów, które pobiera wartości z pliku PrjPcbVariants, może to przywrócić wcześniejszą wartość parametru i nadpisać bieżące zmiany. Aby mieć pewność, że do tego nie dojdzie, zaktualizuj komponent w pliku PrjPcbVariants, korzystając z procesu opisanego poniżej.

Pełna aktualizacja części alternatywnej

Jeśli komponent źródłowy dla części alternatywnej został edytowany w swojej bibliotece, można go zaktualizować w projekcie, uruchamiając okno dialogowe Update from Library dialog.

Uruchamiane z menu Tools w edytorze schematów, to okno dialogowe zawiera opcję Include Variants. Gdy ta opcja jest włączona, lista komponentów zostanie rozszerzona o komponenty użyte jako części alternatywne. Zaznacz na liście komponenty do aktualizacji, a następnie zakończ działanie kreatora, aby zaktualizować wymagane części ze źródła.

Aby w pełni zaktualizować część alternatywną, włącznie z jej grafiką, zaznacz pole wyboru Include Variants i włącz część do aktualizacji.
Aby w pełni zaktualizować część alternatywną, włącznie z jej grafiką, zaznacz pole wyboru Include Variants i włącz część do aktualizacji.

Jeśli w komponentach bibliotecznych używanych w projekcie bazowym wprowadzono zmiany, one również zostaną zaktualizowane w zwykły sposób:

  • za pomocą polecenia Tools » Update from Library w edytorze schematów
  • lub polecenia Tools » Update Schematics w edytorze bibliotek schematów.

Zmiana wielu parametrów dla wielu komponentów

Okno dialogowe Variant Management obsługuje wielokrotny wybór, co oznacza, że w górnej części okna dialogowego (Komponent) można jednocześnie zaznaczyć dowolną liczbę komponentów, a następnie wykonać aktualizacje dla dowolnej liczby parametrów zaznaczonych w dolnej części (Parametry). Okno dialogowe oferuje również filtry (poprzez menu kontekstowe dostępne po kliknięciu prawym przyciskiem), aby jeszcze bardziej zawęzić wybór i wyświetlane dane.

Na przykład, aby zresetować ręcznie zmienione parametry dla wszystkich komponentów we wszystkich wariantach:

  1. W górnej części okna dialogowego (Komponent) użyj opcji menu po kliknięciu prawym przyciskiem Only Show Varied Components w połączeniu z opcjami Filter, aby tylko Show Fitted with Varied Parameters. Lista komponentów powinna teraz wyświetlać wyłącznie te komponenty, które mają ręcznie zmienione parametry.

  2. Kliknij prawym przyciskiem myszy na liście komponentów i wybierz Select All z menu kontekstowego. Wszystkie komponenty aktualnie wyświetlane w górnej części okna dialogowego zostaną zaznaczone.

  3. Następnie kliknij prawym przyciskiem myszy w dolnej części okna dialogowego (Parametry) i wybierz Select All z tego menu kontekstowego. Wszystkie parametry dla wszystkich komponentów zostaną teraz zaznaczone. Zwróć uwagę, że zamiast tego można było wybrać polecenie Select Column, co pozwoliłoby zastosować działanie (takie jak Reset) do komponentów w określonym wariancie (kolumnie).

  4. Kliknij ponownie prawym przyciskiem myszy na liście parametrów i wybierz Reset Selected z menu kontekstowego. Najedź kursorem na poniższy obraz, aby wyświetlić kroki 2, 3 i 4.

Resetowanie wszystkich ręcznie zmienionych parametrów dla wszystkich komponentów we wszystkich wariantach. Najedź kursorem na obraz, aby wyświetlić kroki 2, 3 i 4.
Resetowanie wszystkich ręcznie zmienionych parametrów dla wszystkich komponentów we wszystkich wariantach. Najedź kursorem na obraz, aby wyświetlić kroki 2, 3 i 4.

Jeśli eksperymentowałeś z opcjami filtrów i zastosowałeś różne filtry, przed próbą kolejnej aktualizacji może być konieczne zresetowanie filtra. Aby to zrobić, wyłącz opcję Only Show Varied Components, aby wyczyścić system filtrów, a następnie włącz ją ponownie i w razie potrzeby wyczyść opcje Filter.

Praca z parametrami wariantów

Altium Designer obsługuje parametry na różnych poziomach projektu. Na przykład parametry na poziomie dokumentu można dodać do każdego arkusza schematu na karcie Parameters panelu Properties edytora schematów (dostępnej, gdy nic nie jest zaznaczone). Parametry na poziomie projektu można również dodać do projektu na karcie Parameters okna dialogowego Project Options (Project » Options).

Ponadto parametry można także dodać do wariantu za pomocą okna dialogowego Edit Project Variant. W oknie dialogowym Variant Management wybierz kolumnę wariantu i kliknij przycisk Edit Variant, aby otworzyć to okno dialogowe. Aby dodać nowy parametr, kliknij przycisk Add . Użyj otwartego okna dialogowego Parameter Properties, aby wprowadzić Name  i ustawić Value  nowego parametru, a następnie kliknij OK. Nowy parametr jest teraz wyświetlany w oknie dialogowym Edit Project Variant .

Parametry uwzględnione na różnych poziomach projektu istnieją w hierarchii, co oznacza, że możesz utworzyć parametr o tej samej nazwie na różnych poziomach projektu, przy czym każdy będzie miał inną wartość. Altium Designer rozstrzyga tę sytuację, stosując priorytety w następujący sposób:

  1. Wariant (najwyższy priorytet)
  2. Dokument schematu
  3. Projekt

Ten układ oznacza, że wartość parametru zdefiniowana w dokumencie schematu zastępuje wartość zdefiniowaną w opcjach projektu, a wartość parametru zdefiniowana w wariancie zastępuje wartość zdefiniowaną w dokumencie schematu. Zwróć uwagę, że parametry na poziomie schematu nie są dostępne na PCB ani w BOM. Dla tego typu wyników należy używać parametrów projektu lub wariantu.

Parametr wariantu może być pokazany w dokumencie schematu lub PCB przez umieszczenie specjalnego ciągu. Dowiedz się więcej o Special Strings on a Schematic i Special Strings on a PCB.

Na poniższych ilustracjach parametr o nazwie ProjectTitle został zdefiniowany dla projektu, a także dla każdego wariantu. Film pokazuje zachowanie na PCB podczas używania selektora Variants do wyświetlania projektu bazowego, a następnie każdego wariantu.

Parametr ProjectTitle dodany do projektu (za pomocą okna dialogowego Project Options ) został także dodany do każdego wariantu projektu, ale w każdym przypadku ma inną wartość.
Parametr ProjectTitle dodany do projektu (za pomocą okna dialogowego Project Options ) został także dodany do każdego wariantu projektu, ale w każdym przypadku ma inną wartość.

Na warstwie overlay PCB umieszczono specjalny ciąg .ProjectTitle, który jest automatycznie powiązany z parametrami projektu i wariantu o tej samej nazwie. Na warstwie overlay PCB umieszczono specjalny ciąg .ProjectTitle, który jest automatycznie powiązany z parametrami projektu i wariantu o tej samej nazwie.

Warianty przy użyciu pliku DBLink

Altium Designer obsługuje kilka sposobów przechowywania i pracy z komponentami, w tym użycie pliku DBLink z projektem. Plik DBLink stanowi interfejs między komponentami na schemacie a firmową bazą danych.

Zamiast jedynie tworzyć odwołanie z każdego komponentu do określonego rekordu bazy danych (jak zwykle ma to miejsce przy umieszczaniu komponentu z biblioteki typu DBLib), model DBLink opiera się na inicjowaniu akcji zapytania na podstawie jednego lub większej liczby parametrów komponentu. Oprogramowanie następnie przeszukuje bazę danych w poszukiwaniu rekordu, którego pola zawierają pasujące wartości. Gdy nastąpi dopasowanie, inne wartości pól z tego rekordu (takie jak numer części) mogą zostać zwrócone do komponentu Altium Designer. Mapowanie component parameter-to-database field jest zdefiniowane w dokumencie DBLink, podobnie jak docelowa baza danych.

Dowiedz się więcej o Database Libraries

W projekcie, który nie używa wariantów, akcja zapytania jest wykonywana za pomocą polecenia Update Parameters from Database i może być także wykonana podczas generowania BOM przez włączenie opcji Include Parameters from Database (patrz poniżej), aby wyodrębnić dane komponentów specyficzne dla BOM, takie jak cena.

W przypadku projektu zawierającego warianty parametry używane do zapytania bazy danych są zmieniane w oknie dialogowym Variant Management. Ponieważ te wartości parametrów istnieją tylko w oknie dialogowym Variant Management, polecenie Update Parameters from Database nie jest używane do pobierania informacji z bazy danych. Zamiast tego parametry są pobierane z bazy danych podczas generowania BOM.

Generowanie raportu wariantu

Okno dialogowe Variant Report , dostępne po kliknięciu przycisku Detailed Report na dole okna dialogowego Variant Management, umożliwia skonfigurowanie i wygenerowanie szczegółowego raportu zdefiniowanych wariantów projektu w formacie HTML.

Okno dialogowe Variant Report
Okno dialogowe Variant Report

Błędy wariantów

Ustawienia wariantów są przechowywane w pliku projektu (*.PrjPcb), a dane te są odczytywane, analizowane i ładowane do okna dialogowego Variant Management po jego otwarciu. Jeśli podczas ładowania danych zostaną wykryte problemy, takie jak niezgodności między oznaczeniami komponentów lub identyfikatorami UID komponentów, zostanie otwarte okno dialogowe Information, aby opisać problem.

Information dialog, detailing detected variant errors
Przed kontynuowaniem procesu projektowego należy usunąć niezgodności oznaczeń i UID. Niezgodności UID komponentów są rozwiązywane automatycznie, a poprawki zostaną zachowane po zapisaniu projektu. Zduplikowane oznaczenia należy poprawić na poziomie schematu. Aby je rozwiązać, zweryfikuj projekt (Project » Validate <project name>) i sprawdź panel Messages pod kątem szczegółów ostrzeżeń/błędów.

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Dostępność funkcji

Dostępne dla Ciebie funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, edycji Altium Agile (Agile Teams lub Agile Enterprise) lub Altium Designer (z aktywną subskrypcją).

Jeśli nie widzisz omawianej funkcji w swoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium , aby dowiedzieć się więcej.

Starsza dokumentacja

Dokumentacja Altium Designer nie jest już wersjonowana. Jeśli potrzebujesz dostępu do dokumentacji dla starszych wersji Altium Designer, odwiedź sekcję Starsza dokumentacja na stronie Inne instalatory.

Content