Working with the Variant Manager

Variant Manager to interfejs użytkownika oparty na dokumencie, który umożliwia przeglądanie, tworzenie i zarządzanie wariantami projektu Twojego projektu PCB. Aby uzyskać dostęp do Variant Manager, kliknij prawym przyciskiem myszy wpis projektu w panelu Projects i wybierz Variants albo wybierz Project » Variants z głównych menu edytora schematu lub PCB.

Praca z wariantami

Tworzenie nowego wariantu

Aby dodać nowy wariant, użyj przycisku Add Variant znajdującego się w lewym górnym rogu Variant Manager, gdy aktywna jest karta Variants. W obszarze siatki pojawi się dodatkowa kolumna wariantu z domyślnym tytułem, jak pokazano na poniższym obrazie. Wszystkie komórki nowej kolumny będą puste; pusta komórka oznacza, że dany komponent jest zamontowany (Fitted) i niezmieniony względem projektu bazowego.

Nowy wariant jest dodawany z domyślnym ustawieniem Fitted dla wszystkich komponentów.

Możesz filtrować warianty wyświetlane w Variant Manager za pomocą okna dialogowego Variants Filter, do którego uzyskasz dostęp, klikając  w prawym górnym rogu. Aby przefiltrować wyświetlane warianty, zaznacz pole wyboru powiązane z wariantem (wariantami), które mają być wyświetlane. Po kliknięciu OK w oknie dialogowym warianty są filtrowane zgodnie z zaznaczonymi polami. Gdy filtr jest zastosowany, przycisk filtra jest wyświetlany jako . Aby usunąć lub zmienić filtrowanie, kliknij przycisk filtra, aby ponownie otworzyć okno Variants Filter, a następnie zaktualizuj zaznaczenia. Gdy pole wyboru Project Variants  jest włączone, wyświetlane są wszystkie warianty w projekcie. 

Konfigurowanie właściwości wariantu

Aby zmienić opcje wariantu, użyj panelu Properties w trybie Variant, do którego można przejść, klikając prawym przyciskiem nagłówek kolumny wymaganego wariantu i wybierając Properties.

Otwórz panel Properties w trybie Variant, aby zmienić opcje wariantu.

• Zdefiniuj znaczącą nazwę wariantu w polu Name.

  Nazwę wariantu można również zmienić w oknie dialogowym Rename Variant , do którego przechodzi się, klikając nagłówek kolumny wariantu, aby go zaznaczyć, a następnie klikając  w lewym górnym rogu Variant Manager, lub klikając prawym przyciskiem nagłówek kolumny wariantu i wybierając Rename Variant.

• Możesz zdecydować, czy dla części alternatywnej należy zmienić symbol na schemacie lub dodać footprint do PCB, korzystając z następujących opcji:

  • 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 wariantowania.

    Zwróć uwagę, że ta opcja wpływa wyłącznie na reprezentację symbolu na arkuszu schematu. Symbol części alternatywnej jest uwzględniany podczas budowania modelu łączności projektu. Dlatego komponent bazowy i alternatywny muszą być zgodne pinowo, nawet jeśli opcja jest włączona. Więcej informacji o zgodności pinów znajdziesz w sekcji Defining Component Variations.

  • 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 wariantowania. Footprint części alternatywnej zastosowanej w wariancie nie zostanie przeniesiony do PCB w ramach 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 wybranego zamiennika są wiernie prezentowane w ActiveBOM.

• Jeśli z projektu mają być generowane warianty produkcyjne (fabrication variants), włącz opcję Allow variation of fabrication outputs. Jeśli zadanie wyjściowe (output job) ma wskazany wariant dla wyjścia produkcyjnego, a ten wariant not nie ma włączonej tej opcji, nazwa wariantu w zadaniu będzie wyświetlana na czerwono. Zwróć uwagę, że czerwona nazwa wariantu jest jedynie ostrzeżeniem, a pliki wyjściowe specyficzne dla wariantu nadal zostaną wygenerowane.

  Jeśli mają być generowane wyjścia maski pasty (paste mask) dla projektu zawierającego warianty z komponentami „Not Fitted”, włącz opcję Allow variation for paste mask. Te komponenty nie będą już miały maski pasty na swoich padach.

  Informacje o tym, jak dodawać i przeglądać warianty w pliku Output Job, znajdziesz na stronie Preparing Manufacturing Data with Output Jobs.

• Użyj obszaru Variant's Parameters panelu, aby zdefiniować listę parametrów na poziomie wariantu.

  Parametr wariantu może być wyświetlany w dokumencie schematu lub PCB poprzez umieszczenie specjalnego ciągu. Dowiedz się więcej: Special Strings on a Schematic oraz Special Strings on a PCB.

  Altium Designer obsługuje parametry na różnych poziomach projektu: projektu, dokumentu schematu oraz wariantu. Parametry uwzględnione na różnych poziomach projektu tworzą hierarchię, co oznacza, że możesz utworzyć parametr o tej samej nazwie na różnych poziomach projektu, przy czym każdy z nich może mieć inną wartość. Altium Designer rozwiązuje tę sytuację, stosując priorytety w następujący sposób:

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

  Taki układ oznacza, że wartość parametru zdefiniowana w dokumencie schematu nadpisuje wartość zdefiniowaną w opcjach projektu, a wartość parametru zdefiniowana w wariancie nadpisuje wartość zdefiniowaną w dokumencie schematu.

Właściwości wariantu

Kliknij prawym przyciskiem myszy komórkę, a następnie wybierz Properties , aby otworzyć panel Properties wyświetlający szczegóły wybranego Component/Group. Component Parameters wariantu można edytować według potrzeb. 

Parametry można także przeglądać i edytować, zaznaczając komponent w siatce, a następnie rozwijając obszar Parameter , który pojawia się na dole siatki.

Definiowanie wariantów komponentów

Każdy komponent w projekcie bazowym można skonfigurować jako:

• Fitted – ustawienie domyślne przy tworzeniu nowego wariantu.
• Not Fitted – oryginalny komponent użyty w projekcie bazowym nie jest montowany/używany w tym wariancie projektu.
• Montowany (Fitted) ze zmodyfikowanymi parametrami komponentu, takimi jak wartość komponentu.
• Alternate Part – całkowite zastąpienie jednego komponentu innym.

Zmianę stanu komponentu w wariancie projektu można wykonać, klikając komórkę komponentu w kolumnie wariantu i otwierając listę rozwijaną komórki, która oferuje trzy opcje:

• (Fitted) – oryginalny komponent użyty w projekcie bazowym jest również montowany/używany w tym wariancie projektu. Zwróć uwagę, że dla zamontowanego komponentu można także wariantować pojedyncze parametry – zobacz poniżej.

• Not Fitted – oryginalny komponent użyty w projekcie bazowym nie jest montowany/używany w tym wariancie projektu.

• Alternate Part – ta opcja umożliwia wybranie innej (alternatywnej) części. Użyj okna dialogowego Replace (które jest modalną wersją panelu Components ), aby wybrać wymagany zamiennik. Po wybraniu tej części komórka wyświetla identyfikator (ID) części alternatywnej.

  Po wybraniu części alternatywnej oprogramowanie sprawdza zgodność pinów pomiędzy wybranym komponentem alternatywnym a oryginalnym komponentem projektu bazowego. Aby zachować zgodność pinową, zamiennik musi mieć taką samą liczbę pinów jak komponent oryginalny, a piny muszą być identyczne pod względem położenia i typu elektrycznego. Nie jest wymagane, aby graficzne prymitywy użyte w symbolach obu komponentów były takie same. Jeśli oprogramowanie wykryje, że komponent alternatywny nie jest zgodny pinowo, przed zaakceptowaniem zamiany trzeba zamknąć okno dialogowe Confirm . W takim przypadku należy mieć na uwadze potencjalny wpływ na połączenia.

Możesz wybrać część alternatywną bez zmian symbolu na schemacie lub bez konieczności dodawania footprintu do PCB. W panelu Properties  włącz w razie potrzeby opcje Do not overwrite schematic symbol  i/lub Do not overwrite PCB footprint. Gdy ta druga jest włączona, footprint komponentu alternatywnego zastosowanego w wariancie nie zostanie przeniesiony do PCB w ramach aktualizacji PCB (nie zostanie wygenerowane ECO dodające footprint do PCB). Parametry wybranego zamiennika są wiernie prezentowane w ActiveBOM.

Powyższe stany komponentów można również znaleźć, klikając prawym przyciskiem myszy w siatce, wybierając Set Selected As, a następnie wybierając żądany stan z powiązanego menu, jak pokazano poniżej.

Zdefiniuj wariację komponentu, korzystając z listy rozwijanej w komórce wymaganej kolumny wariantu. Podczas wybierania opcji Alternate Part użyj okna dialogowego Replace, aby wybrać część alternatywną.

Poszczególne parametry można zmieniać dla komponentu montowanego (Fitted) lub alternatywnego, wpisując nową wartość parametru w panelu Properties. Kliknij komórkę komponentu w wymaganej kolumnie wariantu i użyj kolumny wybranego wariantu w obszarze Component Parameters panelu Properties w jego trybie Component for variant, aby wpisać zmienioną wartość parametru. Dla parametru Footprint kliknij listę rozwijaną w komórce, aby wybrać footprint, jeśli do komponentu przypisano wiele modeli footprintów. Wartość parametru różniąca się od projektu bazowego będzie pokazana na żółto, a komórka komponentu w obszarze siatki będzie wyświetlać nazwę komponentu.

Przykład definiowania alternatywnego parametru komponentu montowanego. Wpisz nową wartość parametru, jak pokazano na obrazie. Najedź kursorem na obraz, aby zobaczyć komórkę komponentu po zdefiniowaniu nowej wartości parametru.

Aktualizowanie parametru części alternatywnej

Jeśli komponent biblioteczny używany jako część alternatywna (Alternate Part) miał zmienione parametry w bibliotece, możesz przenieść te zmiany bezpośrednio do definicji wariantów w projekcie. Wybierz polecenie Update Values from Library z menu kontekstowego (prawy przycisk) obszaru Parameter na dole Variant Manager lub w obszarze Component Parameters panelu Properties, gdy wymagany komponent alternatywny jest zaznaczony w głównym obszarze siatki, aby przenieść wszelkie zmiany parametrów wprowadzone w komponencie bibliotecznym.

Uzyskaj dostęp do polecenia Update Values from Library w Variant Manager. Pokazano tu dostęp z menu kontekstowego obszaru Parameter, gdy zaznaczony jest wymagany wpis komponentu. Najedź kursorem na obraz, aby zobaczyć dostęp z panelu Properties, gdy zaznaczony jest wpis części alternatywnej.

Przejdź do komponentu w bibliotece źródłowej za pomocą okna dialogowego Replace i kliknij OK, aby otworzyć okno dialogowe Update Project Variants From Library. Wszystkie parametry są wymienione 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) (Project Variant To Update). Domyślnie zostanie wybrany wariant, który był zaznaczony w momencie uruchomienia polecenia Update Values from Library. Kliknij OK, aby zakończyć proces aktualizacji.

Kopiowanie wariantu

Możesz skopiować wariant, używając polecenia Make a copy . Kliknij prawym przyciskiem w nagłówku kolumny nazwy wariantu, a następnie wybierz opcję Make a copy . Zostanie dodana nowa kolumna z tymi samymi danymi i nazwą (z dopiskiem „Copy”). Możesz użyć opcji Rename, aby nadać nowej kolumnie odpowiedni tytuł.

Usuwanie wariantu

Aby usunąć wariant, zaznacz nagłówek, a następnie użyj ikony . Możliwość usunięcia tego wariantu lub wszystkich wariantów jest również dostępna w menu kontekstowym (prawy przycisk), jak pokazano poniżej. Przed usunięciem otworzy się okno dialogowe z prośbą o potwierdzenie.

Praca z grupami

Aby ułatwić zarządzanie dużą liczbą wariantów projektu, Variant Manager umożliwia także tworzenie grup komponentów z wybranego arkusza schematu, arkuszy odwoływanych przez wybrany symbol arkusza (sheet symbol) lub wybranej klasy komponentów, z widokiem wariacji komponentów opartym na funkcji. Dla każdej grupy możesz zdefiniować jedną lub więcej „opcji”, które zasadniczo odzwierciedlają pewną wariację jednego lub wielu komponentów w grupie. Następnie można tworzyć warianty na podstawie zdefiniowanych grup i opcji, z obsługą tworzenia hierarchii wariantów. Gdy wymagana jest zmiana, edycja wartości w opcji grupy jest natychmiast odzwierciedlana we wszystkich wariantach, które używają tej opcji grupy.

Przepływ pracy z grupami wygląda następująco:

1. Przełącz się na kartę Groups, korzystając z kontrolki u góry Variant Manager.

2. Korzystając z menu rozwijanego przycisku Add Group, wybierz dokument schematu, symbol arkusza lub klasę komponentów, dla których ma zostać utworzona grupa.

   
   Dodaj grupę, aby ułatwić dalsze zarządzanie wariantami w oparciu o tę grupę.

3. Nowa grupa zostanie wyświetlona w lewym panelu Variant Manager, natomiast komponenty wybranej grupy zostaną wyświetlone po prawej stronie.

   Domyślnie do nowo utworzonej grupy zostanie przypisana nazwa wybranego arkusza schematu, symbolu arkusza lub klasy komponentów. Użyj przycisku Rename na dole obszaru listy grup, aby w razie potrzeby zmienić nazwę grupy.

   Użyj przycisku Add Option, aby dodać opcję dla aktualnie wybranej grupy. W obszarze siatki pojawi się dodatkowa kolumna opcji z domyślnym tytułem. Wszystkie komórki nowej kolumny będą puste; pusta komórka oznacza, że ten komponent jest montowany (Fitted) i niezmieniony względem projektu bazowego.

   
   Dodaj opcję dla wybranej grupy, jak pokazano na obrazie. Najedź kursorem na obraz, aby zobaczyć domyślną kolumnę opcji.

4. Nadaj sensowną nazwę nowo utworzonej opcji, zmieniając nazwę domyślną. Kliknij nagłówek kolumny opcji, aby ją zaznaczyć, a następnie kliknij przycisk Rename na dole obszaru siatki lub kliknij prawym przyciskiem nagłówek i wybierz Rename, aby otworzyć okno dialogowe i wprowadzić nową nazwę.

   
   Ustaw sensowną nazwę opcji.

5. Korzystając z komórek komponentów w kolumnie wymaganej opcji, skonfiguruj wariacje komponentów. Proces jest taki sam jak podczas definiowania wariacji komponentów dla wariantu.

   
   Skonfiguruj wariacje komponentów dla wybranej opcji.

   Nie zaleca się ręcznej zmiany parametrów komponentów. Dodatkowo zdecydowanie zaleca się stosowanie komponentów alternatywnych. Aby używać alternatywnych footprintów, podczas pracy z grupami użyj osobnego komponentu.
   Zawartość komórek opcji grup wariantów można kopiować, wklejać lub wycinać, używając odpowiednich poleceń w menu kontekstowym (prawy przycisk) lub odpowiednich skrótów (odpowiednio Ctrl+C, Ctrl+V, Ctrl+X).

6. Dodaj kolejne opcje dla wybranej grupy, klikając prawym przyciskiem w obszarze siatki i wybierając Add Option. Skonfiguruj nową opcję zgodnie z potrzebami.

   
   Dodaj i skonfiguruj kolejne opcje zgodnie z potrzebami.

7. Na karcie Variants w Variant Manager komponenty, dla których utworzono grupę, będą widoczne pod odpowiednim wpisem w obszarze siatki. Korzystając z listy rozwijanej w komórce wpisu grupy, wybierz opcję utworzoną dla tej grupy na karcie Groups. Zostaną zastosowane wariacje skonfigurowane dla komponentów w tej grupie.

   
   Dodaj opcję dla wybranej grupy, jak pokazano na obrazie. Najedź kursorem na obraz, aby zobaczyć domyślną kolumnę opcji.

Kopiowanie opcji grupy

Aby skopiować opcję grupy wariantów, na karcie Groups kliknij prawym przyciskiem w nagłówku kolumny <New Option>, a następnie wybierz Make a copy. Zostanie dodana nowa kolumna z tymi samymi danymi i nazwą (z dopiskiem „Copy”). Możesz użyć opcji Rename, aby nadać nowej kolumnie odpowiedni tytuł.

Uwagi

• Podczas konfigurowania wariantów ustawienia są zapisywane w pliku projektu. Obejmuje to stan Not Fitted, lokalne wariacje parametrów dla komponentu Fitted oraz wartości parametrów Alternate Parts. Części alternatywne (Alternate Parts) są przechowywane w pliku <ProjectName>.PrjPcbVariants.
• Kolumny wariantów można przypinać, aby były wyświetlane jako pierwsze, po lewej stronie kolumn nieprzypiętych. Aby przypiąć kolumnę wariantu, najedź kursorem na jej nagłówek i kliknij .
• Kliknij dwukrotnie komponent lub kliknij prawym przyciskiem, a następnie wybierz opcję Cross Probe, aby przejść do tego komponentu na schemacie.
• Użyj polecenia Select All z menu kontekstowego (prawy przycisk) obszaru siatki na karcie Variants lub w obszarze Parameter , aby szybko zaznaczyć całą zawartość siatki.
• Użyj polecenia Invert Selection z menu kontekstowego (prawy przycisk) obszaru siatki na karcie Variants lub w obszarze Parameter , aby szybko zaznaczyć niezaznaczone i odznaczyć zaznaczone wpisy.
• Kliknij przycisk View Report w lewym dolnym rogu Variant Manager, aby wygenerować szczegółowy raport wariantów w formacie HTML, korzystając z otwartego okna dialogowego Variants Report.
• Kliknij prawym przyciskiem myszy w obszarze siatki na karcie Variants lub w Parameter regionie  i użyj poniższych poleceń z menu kontekstowego, aby wygenerować pliki raportów:
  • Report – kliknij, aby otworzyć okno dialogowe Report Preview  i utworzyć wydruk siatki.
  • Save All – kliknij, aby otworzyć okno dialogowe umożliwiające zapis zestawienia wszystkich komponentów / wszystkich parametrów dla wybranego komponentu do pliku tekstowego z polami rozdzielanymi tabulatorami (*.txt).
  • Save Selected – kliknij, aby otworzyć okno dialogowe umożliwiające zapis zestawienia wybranych komponentów / wybranych parametrów do pliku tekstowego z polami rozdzielanymi tabulatorami (*.txt).
• Gdy schemat zostanie zmieniony, u góry Variant Manager zostanie wyświetlone odpowiednie powiadomienie. Kliknij element sterujący Refresh obok powiadomienia, aby zaktualizować dane w Variant Manager.
• Opcja Delete, dostępna po kliknięciu prawym przyciskiem myszy na komórce, może zostać użyta do usunięcia wariantu, grupy lub opcji.