Praca z blokami wielokrotnego użytku i fragmentami kodu (stary panel ponownego użycia projektu)

Jeśli Twoje projekty często zawierają wspólne „sekcje” układów, Altium Designer zapewnia prosty i wygodny sposób zapisywania oraz ponownego wykorzystywania fragmentów projektu — zarówno opartych na Workspace, jak i lokalnych, plikowych. Takie sekcje można dodawać do dowolnego projektu PCB bez konieczności rozpoczynania pracy od zera za każdym razem. To świetna funkcja dla często używanych fragmentów i mniejszych sekcji układów, które chcesz wykorzystywać ponownie. System pozwala zapisać dowolny wybór:

• Układów na pojedynczym arkuszu schematu (schematic snippet).

• Układów w projekcie PCB, w tym komponentów i tras połączeń (PCB snippet).

Po połączeniu z Workspace możesz utworzyć pojedynczy obiekt — Reuse Block — który może zawierać zarówno układ schematyczny, jak i jego fizyczną reprezentację dla PCB. Gdy taki blok ponownego użycia zostanie umieszczony na arkuszu schematu, jego fizyczna reprezentacja zostanie automatycznie umieszczona w dokumencie PCB podczas procesu ECO.

Panel Design Reuse jest centralnym miejscem do tworzenia, zarządzania i używania bloków ponownego użycia oraz snippetów — zarówno opartych na Workspace, jak i lokalnych, plikowych.

Panel Design Reuse

Do panelu można uzyskać dostęp na następujące sposoby:

• Kliknij przycisk Panels w prawym dolnym rogu obszaru projektowego, a następnie kliknij Design Reuse.
• Wybierz View » Panels » Design Reuse z menu głównego.
• Wybierz Place » Reuse Block z menu głównego.

Górne menu rozwijane panelu zawiera listę wszystkich dostępnych folderów aktualnie istniejących w podłączonym Workspace, które zawierają bloki ponownego użycia i snippety oparte na Workspace. Liczba obok nazwy każdego folderu pokazuje, ile bloków ponownego wykorzystania projektu i snippetów zawiera ten folder oraz jego podfoldery. Wybierz folder z listy rozwijanej, aby wyświetlić w głównej części panelu bloki ponownego użycia i snippety zawarte w tym folderze oraz jego podfolderach. Wybierz wpis podłączonego Workspace z listy rozwijanej, aby wyświetlić wszystkie dostępne bloki ponownego użycia i snippety.

Użyj przycisków filtrowania w wyskakującym oknie ikony , aby pokazywać/ukrywać zawartość określonych typów (Reuse Blocks, Schematic Snippets, PCB Snippets) w panelu. Użyj kontrolki Sort By, aby wybrać preferowaną opcję sortowania.

Użyj opcji filtrowania i sortowania, aby skonfigurować sposób wyświetlania zawartości w panelu

Aby wyszukać dostępne bloki ponownego użycia i snippety w wybranym folderze według nazwy lub opisu, wpisz frazę w polu Search, aby skutecznie filtrować i zawężać listę zgodnie z własnymi potrzebami.

Każdy blok ponownego użycia i snippet jest prezentowany w głównej części panelu w postaci kafelka zawierającego następujące dane:

• Obraz podglądu – można go kliknąć, aby przełączać między stanem normalnym a pełnoskalowym. W przypadku bloku ponownego użycia użyj przycisku  ​ , aby przełączać między podglądem jego dokumentów PCB i schematu;

• Ikona typu –  ​ dla bloku ponownego użycia,  ​ dla snippetu schematu,  ​ dla snippetu PCB;

• Nazwa i opis (jeśli zdefiniowano);

• Identyfikator najnowszej rewizji, data utworzenia i autor bloku ponownego użycia lub snippetu schematu/PCB w Workspace.

Informacje o bloku ponownego użycia lub snippecie oraz elementy sterujące dla nich są prezentowane w kafelku w panelu.

Tworzenie bloku ponownego użycia

Nowy blok ponownego użycia można utworzyć na następujące sposoby:

1. Wybierz polecenie tworzenia nowego bloku ponownego użycia:

   • Z panelu Design Reuse, klikając przycisk  u góry panelu.

   • Za pomocą polecenia File » New » Reuse Block z menu głównego.

   • Z panelu Explorer panel, klikając przycisk  znajdujący się w prawym górnym rogu panelu podczas przeglądania folderu typu Design Reuse Blocks.

2. Tymczasowa edytowalna struktura bloku ponownego użycia, przypominająca projekt PCB, zostanie otwarta w panelu Projects panel (pod wpisem Workspace, z którym jesteś aktualnie połączony), a tymczasowy edytor schematu zostanie otwarty w głównym oknie projektu, gotowy do zdefiniowania dokumentu schematu bloku ponownego użycia. Użyj standardowych poleceń i technik rozmieszczania, aby zdefiniować dokument schematu bloku ponownego użycia.

3. Po zakończeniu użyj polecenia Design » Update PCB Document oraz procesu ECO, aby przenieść zarejestrowany schemat do dokumentu PCB bloku ponownego użycia, a następnie wprowadź wymagane zmiany w tym dokumencie (określenie położeń komponentów, trasowanie itp.). Do definiowanego bloku ponownego użycia można dodać wiele dokumentów PCB. Aby to zrobić, użyj polecenia Add New to Project » PCB z menu prawego przycisku myszy wpisu bloku ponownego użycia w panelu Projects.

   

   Użyj polecenia Rename z menu prawego przycisku myszy wpisu dodanego dokumentu PCB w panelu Projects, aby nadać mu znaczącą nazwę. Użyj polecenia Design » Update z menu głównego edytora schematu, aby zaktualizować wymagany dokument PCB.

   Gdy zarówno dokument schematu, jak i dokument PCB bloku ponownego użycia są już zdefiniowane, zapisz blok ponownego użycia do Workspace za pomocą polecenia Save to Server z menu kontekstowego wpisu bloku ponownego użycia w panelu Projects lub kontrolki Save to Server po prawej stronie wpisu.

   Ponieważ bloki ponownego użycia są przechowywane w podłączonym Workspace, powinny korzystać z komponentów z tego Workspace. Dzięki temu uzyskasz pełne korzyści z systemu zawartości udostępnianego przez Workspace.

   • Zarówno dokument schematu, jak i dokument PCB bloku ponownego użycia muszą zawierać co najmniej jeden komponent, aby można było je zapisać do Workspace.

   • Jeśli dokumenty schematu i PCB bloku ponownego użycia nie są zsynchronizowane (wykryto różnice między dokumentami schematu i PCB), podczas próby zapisania bloku ponownego użycia do Workspace zostanie wyświetlone okno ostrzeżenia. Możesz anulować zapis, aby wrócić do bloku ponownego użycia i usunąć różnice, albo kontynuować zapis.

4. Zostanie wyświetlone okno dialogowe New Reuse Block, w którym możesz zdefiniować Name, Description oraz folder Workspace Folder , do którego zostanie zapisany nowy blok ponownego użycia.

   
   Okno dialogowe New Reuse Block

   Options and Controls of the New Reuse Block Dialog

   • Name – wprowadź nazwę nowego bloku ponownego użycia lub snippetu.
   • Description – użyj tego pola, aby wprowadzić znaczący opis tego, co reprezentuje ten blok ponownego użycia lub snippet.
   • Folder – folder Workspace, w którym ten blok ponownego użycia lub snippet będzie przechowywany. Kliknij , aby otworzyć okno dialogowe Choose Folder i wybrać lub utworzyć inny folder.

5. Po kliknięciu OK blok ponownego użycia zostanie zapisany do Workspace, a jego tymczasowa struktura zostanie zamknięta.

Zapisany blok ponownego użycia można następnie znaleźć w panelu Design Reuse, gdy folder, do którego został zapisany (lub wpis podłączonego Workspace), zostanie wybrany z górnej listy rozwijanej. Aby nowy blok ponownego użycia pojawił się w panelu, może być wymagane użycie polecenia Refresh z menu przycisku .

Zmiana nazwy bloku ponownego użycia

Po utworzeniu Reuse Block można w razie potrzeby zmienić jego nazwę na bardziej odpowiednią. Aby zmienić nazwę Reuse Block, użyj polecenia Rename , dostępnego z podmenu  oraz z menu kontekstowego wywoływanego prawym przyciskiem myszy panelu Design Reuse . W otwartym oknie dialogowym Rename Reuse Block wprowadź nowy tytuł, a następnie kliknij OK. Nazwa Reuse Block zostanie zmieniona na żądaną, jak pokazano na poniższych ilustracjach.

Tworzenie snippetu

Nowy snippet schematu lub PCB można szybko utworzyć na podstawie istniejącego układu na arkuszu schematu lub w dokumencie PCB:

1. Zaznacz wymagany układ w edytorze schematu lub PCB.

2. Kliknij prawym przyciskiem myszy i wybierz Snippets » Create Snippet from selected objects z menu kontekstowego albo wybierz polecenie Tools » Convert » Create Snippet from selected objects z menu głównego.

3. Zostanie wyświetlone okno dialogowe New Schematic Snippet lub New PCB Snippet, w którym możesz zdefiniować nazwę, opis, miejsce zapisu (Workspace lub folder lokalny) oraz folder, do którego zostanie zapisany nowy snippet.

   Podczas zapisywania snippetu do folderu lokalnego kliknij przycisk  po prawej stronie pola Path w oknie dialogowym, aby uzyskać dostęp do okna dialogowego Choose Snippet Folder, które umożliwia wybranie istniejącego lokalnego folderu snippetów, do którego snippet zostanie zapisany, lub utworzenie nowego podfolderu w istniejącym lokalnym folderze snippetów.

   Informacje o organizowaniu lokalnych snippetów w folderach znajdują się w sekcji Local Snippet Organization poniżej.

4. Po kliknięciu OK snippet zostanie zapisany.

Zapisany snippet można następnie znaleźć w panelu Design Reuse, gdy w górnej liście rozwijanej wybrany jest wpis połączonego Workspace (lub folder, do którego został zapisany).

Snippet można utworzyć z zestawu zaznaczonych obiektów. Tutaj pokazano tworzenie snippetu schematu. Najedź kursorem na obraz, aby zobaczyć tworzenie snippetu PCB.

Aby nowy blok wielokrotnego użytku pojawił się w panelu, może być wymagane użycie polecenia Refresh z menu przycisku  panelu.

Aby uzyskać dostęp do lokalnych snippetów z panelu Design Reuse, opcja Local Snippets musi być włączona w menu .

Snippet oparty na Workspace można również utworzyć z istniejącego lokalnego snippetu, klikając przycisk  w kafelku snippetu (lub klikając prawym przyciskiem myszy w dowolnym miejscu kafelka) i wybierając z menu polecenie Save to Server. W wyświetlonym oknie dialogowym New Schematic Snippet lub New PCB Snippet zdefiniuj Name, Description oraz Workspace Folder , do którego snippet zostanie zapisany.

Lokalny snippet można zapisać do połączonego Workspace za pomocą polecenia Save to Server.

Organizacja lokalnych snippetów

Panel Design Reuse umożliwia organizowanie lokalnych snippetów w foldery snippetów, tak aby powiązane snippety mogły być grupowane razem, co ułatwia ich odnajdywanie. Foldery snippetów to istniejące foldery systemu Windows, których nie można tworzyć z poziomu panelu Design Reuse. Zamiast tego są one „otwierane” lub „zamykane” podczas przeglądania zawartych w nich lokalnych snippetów. Foldery te można tworzyć wyłącznie bezpośrednio na dysku twardym lub w sieci, poza Altium Designer.

Foldery snippetów można otwierać i zamykać z poziomu okna dialogowego Available Snippets Folders, do którego można uzyskać dostęp, klikając przycisk  w prawym górnym rogu panelu Design Reuse i wybierając z menu polecenie Snippet Folders. Kliknij Open Folder, aby przejść do wymaganego folderu na dysku twardym lub w sieci. Wybrany folder zostanie dodany do listy w oknie dialogowym i będzie następnie widoczny na liście rozwijanej u góry panelu Design Reuse.

Aby usunąć folder snippetów z listy (czyli zasadniczo zamknąć go z perspektywy przeglądania), wybierz folder z listy, a następnie kliknij Remove Folder. Użyj przycisków Move Up i Move Down, aby zmienić kolejność, w jakiej lokalne snippety będą prezentowane w panelu Design Reuse, gdy w liście rozwijanej panelu wybrany jest wpis Local.

Umieszczanie bloków wielokrotnego użytku i snippetów

Aby umieścić blok wielokrotnego użytku lub snippet w projekcie, kliknij w jego kafelku i kliknij przycisk , kliknij przycisk w jego kafelku, lub kliknij prawym przyciskiem myszy w dowolnym miejscu kafelka i wybierz jedno z następujących poleceń:

• Place – wybierz, aby umieścić blok wielokrotnego użytku lub snippet bezpośrednio w aktywnym dokumencie schematu lub PCB.
• Place as Sheet Symbol – gdy aktywny jest dokument schematu, wybierz, aby umieścić blok wielokrotnego użytku lub snippet schematu jako symbol arkusza na arkuszu schematu. Zawartość bloku wielokrotnego użytku lub snippetu schematu zostanie umieszczona na automatycznie utworzonym podrzędnym arkuszu schematu, do którego odwołuje się umieszczony symbol arkusza.

Umieść blok wielokrotnego użytku lub snippet za pomocą menu przycisku Place w jego kafelku w panelu. Tutaj pokazano wybranie polecenia Place, w którym blok wielokrotnego użytku / snippet schematu jest umieszczany na aktywnym arkuszu schematu. Najedź kursorem na obraz, aby zobaczyć wybór polecenia Place as Sheet Symbol, w którym blok wielokrotnego użytku / snippet schematu jest umieszczany na arkuszu podrzędnym, do którego odwołuje się umieszczony symbol arkusza.

Kliknij kontrolkę Show more w kafelku bloku wielokrotnego użytku, aby wyświetlić sekcję PCB, która zawiera listę dokumentów PCB tego bloku wielokrotnego użytku. Wybierz wymagany dokument PCB z listy, a blok wielokrotnego użytku zostanie umieszczony wraz z tym dokumentem. Wybrany dokument PCB jest pokazywany w obszarze podglądu kafelka bloku wielokrotnego użytku, gdy do podglądu wybrano PCB.

Wybierz dokument PCB, który ma zostać umieszczony wraz z blokiem wielokrotnego użytku, aby wyświetlić jego podgląd.

Po umieszczeniu dokumentu schematu bloku wielokrotnego użytku jego dokument PCB można umieścić w dokumencie PCB za pomocą procesu ECO. W edytorze schematów użyj polecenia Design » Update PCB Document z menu głównego, a następnie zweryfikuj i wykonaj zmiany za pomocą okna dialogowego Engineering Change Order. Dokument PCB zostanie umieszczony w dokumencie PCB jako unia i będzie można nim zarządzać z poziomu trybu Unions mode of the PCB panel.

Gdy wybrany komponent schematu lub PCB jest częścią bloku wielokrotnego użytku umieszczonego w projekcie, możesz sprawdzić jego właściwości, klikając łącze Reuse Block dostępne w panelu Properties . W panelu zostaną wyświetlone właściwości nadrzędnego bloku wielokrotnego użytku tego komponentu. Aby wrócić do właściwości pierwotnie wybranego komponentu, użyj łącza Component.

Uzyskaj dostęp do właściwości bloku wielokrotnego użytku z poziomu komponentu, który jest częścią tego bloku wielokrotnego użytku. Powyższe obrazy przedstawiają dostęp do właściwości z komponentu schematu. Najedź kursorem na obraz, aby zobaczyć dostęp z komponentu PCB.

Edycja bloków wielokrotnego użytku i snippetów

Aby edytować blok wielokrotnego użytku lub snippet oparty na Workspace, kliknij przycisk w jego kafelku (lub kliknij prawym przyciskiem myszy w dowolnym miejscu kafelka) i wybierz z menu polecenie Edit .

Otwórz do edycji blok wielokrotnego użytku lub snippet oparty na Workspace za pomocą polecenia Edit z jego kafelka w panelu.

Otworzy się edytor tymczasowy, a dokument (zawierający źródłowy blok wielokrotnego użytku/snippet) znajdujący się w najnowszej rewizji elementu Workspace zostanie otwarty do edycji. Wprowadź wymagane zmiany, a następnie zapisz dokument do kolejnej rewizji bloku wielokrotnego użytku/snippetu za pomocą polecenia File » Save to Server z menu głównego lub polecenia Save to Server z menu kontekstowego wpisu bloku wielokrotnego użytku/snippetu w panelu Projects panel.

Właściwości (Name, Description i Path) lokalnego snippetu można edytować w oknie dialogowym Snippet Properties, do którego można uzyskać dostęp, klikając przycisk  w kafelku lokalnego snippetu (lub klikając prawym przyciskiem myszy w dowolnym miejscu kafelka) i wybierając z menu polecenie Edit Properties.

Edytuj właściwości lokalnego snippetu za pomocą okna dialogowego Snippet Properties, dostępnego z panelu Design Reuse.

Usuwanie bloków wielokrotnego użytku i snippetów

Aby usunąć blok wielokrotnego użytku lub snippet, kliknij przycisk  w kafelku snippetu (lub kliknij prawym przyciskiem myszy w dowolnym miejscu kafelka) i wybierz z menu polecenie Delete.

• W przypadku bloku wielokrotnego użytku lub snippetu opartego na Workspace pojawi się okno dialogowe Delete Items, w którym należy potwierdzić usunięcie. Działanie to jest w rzeczywistości „miękkim usunięciem”, w wyniku którego blok wielokrotnego użytku lub snippet zostanie przeniesiony do obszaru Trash Workspace. Trash to zasadniczo kosz, do którego można przenieść dowolną zawartość Workspace (poprzez miękkie usunięcie). Jest on odizolowany od reszty Workspace. W przypadku bloku wielokrotnego użytku możesz również zdecydować o usunięciu powiązanej zawartości tego bloku (np. snippetów schematu i PCB).

  
  Wykonaj miękkie usunięcie bloku wielokrotnego użytku lub snippetu za pomocą polecenia Delete z jego kafelka w panelu.

• W przypadku lokalnego snippetu pojawi się okno dialogowe Confirm, aby potwierdzić usunięcie. Działanie to usunie pliki snippetu z dysku twardego.