Importing Existing Libraries to Your Connected Workspace

Altium Designer, w połączeniu z Twoim połączonym Workspace, zapewnia usprawniony i w dużym stopniu zautomatyzowany proces szybkiego importu istniejących bibliotek do tego Workspace. Interfejs tego procesu – Library Importer – oferuje rozwiązanie „jednym kliknięciem”, które automatycznie analizuje wybrane biblioteki i importuje je do Workspace, z którym jesteś aktualnie połączony.

Obsługując wszystkie typy bibliotek związane ze starszymi metodologiami zarządzania komponentami (SchLib, PcbLib, IntLib, DbLib, SVNDbLib), Library Importer to dedykowane rozwiązanie do szybkiego budowania firmowej biblioteki komponentów Workspace tak, abyś mógł korzystać z jej licznych zalet – wysokiej integralności, scentralizowanego przechowywania i zarządzania, łatwości ponownego użycia projektów oraz informacji o łańcuchu dostaw w czasie rzeczywistym.

Library Importer oferuje minimalistyczny Simple tryb interfejsu, w którym wybrane biblioteki komponentów oparte na bazie danych i plikach są importowane do komponentów Workspace w jednym kroku, a importer automatycznie zajmuje się klasyfikacją typów, docelowym folderem źródłowym, uwzględnieniem parametrów i typem wartości oraz przeniesieniem wszystkich istotnych danych. Interfejs jest dostępny także w trybie Advanced, który zapewnia pełny podgląd proponowanego importu biblioteki oraz dostęp do powiązanych danych i ustawień. I choć domyślnie import jest procesem „jednym kliknięciem”, importer oferuje również zaawansowane opcje konfiguracji w panelu Properties panel, zapewniając większą kontrolę nad tym, jak dokładnie import jest wykonywany.

Co jest importowane?

Wszystkie informacje obecne w oryginalnej bibliotece źródłowej są importowane do komponentów Workspace, w tym wszystkie odwoływane modele dziedzinowe (symbole schematowe, footprinty PCB, modele symulacyjne), informacje parametryczne, przypisane Part Choices, pliki not katalogowych (datasheet) itd. W razie potrzeby tworzone są również Component Templates, które następnie można dopracować i wykorzystać przy kolejnych importach bibliotek.

Jeśli Twoje oryginalne komponenty mają zdefiniowanych wiele footprintów PCB, Library Importer przeniesie te modele i zachowa bieżący domyślny footprint. A jeśli pracujesz wyłącznie z bibliotekami PCB – a Twoim jedynym obszarem zainteresowania jest układ PCB – wówczas Library Importer obsługuje import tylko tych bibliotek lub można go przełączyć w tryb importu wyłącznie modeli, w którym określone typy modeli są importowane z bibliotek zintegrowanych lub bazodanowych. Biblioteki zawierające wiele typów komponentów (biblioteki monolityczne) są również automatycznie wykrywane i przetwarzane.

Ponieważ proces importu bibliotek musi obsługiwać źródła bazodanowe i plikowe, które mogą stosować różne standardy formatowania, zautomatyzowane procesy analizy wykrywają typy komponentów w bibliotece źródłowej (rezystor, kondensator itd.) oraz nazwy parametrów i typy ich wartości (wolty, omy itd.). System przeprowadza i obsługuje szereg walidacji, na przykład aby upewnić się, że nie ma zduplikowanych identyfikatorów dla wynikowych komponentów biblioteki Workspace, albo aby nie tworzyć zduplikowanych modeli czy szablonów komponentów oraz by takie elementy były ponownie wykorzystywane (linkowane) między komponentami tam, gdzie to potrzebne. A jeśli pojawią się problemy, system je oznaczy i zaproponuje sposoby ich rozwiązania, dążąc do jak najszybszego i możliwie płynnego przywrócenia importu na właściwy tor.

Typy bibliotek, które można importować, to:

  • Biblioteka schematowa (*.SchLib).

  • Biblioteka footprintów PCB (*.PcbLib).

  • Biblioteka zintegrowana (*.IntLib)

  • Biblioteka bazodanowa (*.DbLib).

  • Biblioteka bazodanowa SVN (*.SVNDbLib).

Import informacji o mapowaniu pinów (dla modeli symulacyjnych) nie jest obecnie obsługiwany.

Dostęp do Library Importer

Library Importer jest dostępny, gdy jesteś połączony z Workspace. Aby uzyskać dostęp do importera w trybie Simple :

  • W panelu Components panel wybierz opcję Import Library z menu  . Jeśli w kolumnie Categories panelu (lub w górnym menu rozwijanym, gdy panel jest w trybie kompaktowym) jest aktualnie zaznaczona biblioteka bazodanowa lub plikowa, Library Importer otworzy się dla tej biblioteki. Gdy wybrany jest typ komponentu biblioteki Workspace, zostanie otwarte standardowe okno dialogowe Windows Open, aby przejść do pliku biblioteki i wybrać go do importu.

    Biblioteki bazodanowe i plikowe, które są aktualnie dostępne dla oprogramowania, można przeglądać i zarządzać nimi w oknie Libraries Preferences dialog, do którego przechodzi się z opcji Libraries Preferences w menu przycisku  w panelu Components panel.

    Możesz także przeglądać i zarządzać aktualnie zainstalowanymi bibliotekami plikowymi na stronie Data Management – File-based Libraries page w oknie Preferences dialog.

  • Kliknij prawym przyciskiem myszy plik biblioteki w panelu Projects panel i wybierz Import Library z menu kontekstowego.

  • Wybierz Tools » Import Library w edytorze symboli schematowych lub footprintów PCB, gdy otwarty jest lokalny plik biblioteki.

  • Wybierz File » Import Library lub Tools » Import Library w Database Library Editor.

  • W oknie Libraries Preferences dialog wybierz wpis biblioteki na karcie Installed i kliknij kontrolkę Import .

  • Przeciągnij i upuść plik biblioteki z folderu Windows do panelu Explorer panel.

Tryb Simple udostępnia opcje natychmiastowego importu wybranej biblioteki () lub otwarcia Library Importer w pełnym trybie GUI ().

Library Importer po uruchomieniu w trybie importu „jednym kliknięciem” Simple.
Library Importer po uruchomieniu w trybie importu „jednym kliknięciem” Simple.

Aby bezpośrednio uzyskać dostęp do Library Importer w trybie interfejsu Advanced, wybierz File » Library Importer z menu głównego.

Library Importer po uruchomieniu w pełnym trybie interfejsu Advanced również obsługuje proces importu „jednym kliknięciem”.
Library Importer po uruchomieniu w pełnym trybie interfejsu Advanced również obsługuje proces importu „jednym kliknięciem”.

Tryb Simple

Tryb Simple w Library Importer wstępnie wybiera wszystkie aspekty procesu importu na podstawie analizy biblioteki źródłowej i połączonego Workspace. Następnie okno Library Importer dialog prezentuje podsumowanie struktury importu, w tym łączną liczbę dla każdego typu elementu. Import biblioteki jest wykonywany jako pojedynczy krok poleceniem .

Ten prosty tryb interfejsu będzie odpowiedni dla większości typowych formatów bibliotek źródłowych, które zwykle zawierają popularne typy komponentów (rezystory, kondensatory, układy scalone itd.) oraz ustandaryzowane wartości parametrów. Podczas wstępnej analizy system wnioskuje typ komponentów w bibliotece na podstawie słów kluczowych w oznaczeniu (Designator) lub parametrach (LD?, LED itd.), a następnie lokalizuje odpowiadający Component Template w docelowym Workspace (LED). Ten Template jest stosowany do importu tych komponentów i określa ustawienia importu, takie jak folder docelowy (Components/LED), mapowanie parametrów, jednostki wartości parametrów itd. Odpowiednie szablony są dostępne w Workspace, jeśli podczas aktywacji Altium 365 Workspace lub instalacji Altium On-Prem Enterprise Server wybrano opcję danych przykładowych.

Wyniki importu biblioteki, jako nowo utworzone komponenty Workspace, można zobaczyć zarówno w panelu Explorer, jak i Components. Importowane komponenty zawierają wszystkie modele, parametry zinterpretowane przez zastosowane Component Template(s), Part Choices wynikające z danych źródłowych Supplier Link oraz wszelkie linki referencyjne lub pliki.

Wszelkie Component Templates utworzone przez Library Importer są dostępne w folderze Managed Content\Templates\Component Templates panelu Explorer.

Jeśli z jakiegoś powodu – na przykład z powodu niezadowalającego wyniku importu – chcesz usunąć zestaw komponentów, te zaznaczone w panelu Components panel można czysto usunąć, wybierając opcję Delete z menu kontekstowego po kliknięciu prawym przyciskiem myszy. Wraz z wybranymi komponentami można również usunąć powiązane z nimi modele (jeśli nie są używane przez inne komponenty).

Istotne uwagi dotyczące procesu importu bibliotek:

  • Biblioteki monolityczne (zawierające wiele typów komponentów) są automatycznie dzielone na podgrupy, gdzie każda grupa reprezentuje typ komponentu znaleziony w tej bibliotece. Grupy są przetwarzane jako osobne biblioteki.

  • Biblioteka źródłowa z nierozpoznawalnym (niewykrytym) typem komponentu zostanie zaimportowana bez interpretacji, jako nieprzypisane typy komponentów w folderze Components/Uncategorized Workspace. Przed uruchomieniem importu można to rozwiązać, stosując Designator Mapping lub Parameter Grouping w trybie Advanced (pełny interfejs). Alternatywnie możesz kontynuować import i później zmodyfikować ustawienia komponentu oraz jego folder w panelu Explorer panel.
  • Proces importu bibliotek obejmuje automatyczny etap Validation komponentów. Komponenty, które wywołają błąd walidacji, zostaną pominięte.
  • Jeśli w importowanej bibliotece źródłowej zostaną wykryte zduplikowane modele, tylko jeden z tych modeli zostanie zaimportowany i podlinkowany do wynikowych komponentów w docelowym Workspace. Odpowiednie powiadomienie zostanie wyświetlone u góry okna Library Importer dialog.
  • Wszelkie błędy napotkane przez proces można wyświetlić w Importing Report, dostępnym z przycisku po zakończeniu importu .

Tryb Advanced

Pełny interfejs GUI Library Importer jest prezentowany w trybie Advanced, który oferuje szczegółową kontrolę nad zarządzaniem bibliotekami, typami komponentów i parametrami komponentów. W połączeniu z panelem Properties panel import bibliotek komponentów do Workspace można skonfigurować zgodnie z Twoimi potrzebami. Zwróć uwagę, że ustawienia importera można zapisać i przywrócić poprzez eksport/import plików konfiguracyjnych.

Tryb zaawansowany jest włączany, gdy Library Importer zostanie otwarty z polecenia File » Library Importer lub gdy w trybie prostym zostanie wybrany przycisk . Biblioteki są dodawane do sekcji SOURCE LIBRARIES importera (jeśli nie jest jeszcze wypełniona) przez przeciągnięcie i upuszczenie pliku biblioteki na ten obszar, kliknięcie prawym przyciskiem myszy na <All Libraries>, a następnie wybranie Add Library z menu kontekstowego, albo przez wybranie przycisku .

Sekcja Import Preview wyświetla grupy typów komponentów zidentyfikowane na podstawie bibliotek źródłowych – jako Types () lub proponowane Folder Structure () – i zawiera widok siatki tych komponentów oparty na parametrach (Components). Wartości parametrów w siatce można edytować na bieżąco, co eliminuje konieczność otwierania i edycji biblioteki źródłowej. Dolny obszar Details zawiera dodatkowe informacje pochodzące z aktualnie wybranego komponentu – Part Choices, Models oraz Datasheets.

Możesz zmienić typ komponentu, klikając prawym przyciskiem myszy typ na liście Types i wybierając polecenie Change Component Type.

Niezależnie od szczegółowych opcji i danych prezentowanych w interfejsie, widok Advanced importera może być używany w taki sam sposób jak widok Simple – wystarczy kliknąć przycisk , aby uruchomić proces importu bez ingerencji. Podobnie jak w procesie widoku Simple, importer przeanalizował bibliotekę, określił typy zawartych w niej komponentów i zastosował właściwy Component Template. Z kolei szablon określa docelowy folder w Workspace, zastosowane Naming Schemes i Lifecycle Definitions oraz mapowanie/interpretację parametrów.

  • Użyj przycisku (lewy górny róg), aby odświeżyć Library Importer. Spowoduje to ponowne wczytanie wszystkich bibliotek źródłowych oraz danych Workspace, aby uwzględnić wszelkie zmiany, które zaszły od momentu otwarcia importera.
  • Użyj pola Search field (prawy górny róg), aby filtrować wpisy Components według dopasowanej wartości parametru.

Biblioteki monolityczne

Biblioteki źródłowe zawierające wiele typów komponentów są wykrywane przez procedury analizy importera i rozdzielane na podgrupy sub-bibliotek, które można przetwarzać jako osobne biblioteki typów. Wykrywanie typu komponentu opiera się na oznaczeniach (Designators) komponentów źródłowych (R?, C? itd.) oraz na słowach kluczowych (Resistor, Res itd.) zawartych w pozostałych głównych parametrach komponentu (Description, ID itd.).

W pokazanym poniżej przykładzie biblioteka źródłowa (ProjectABC.IntLib) została automatycznie „podzielona” zgodnie z wykrytymi typami komponentów (Capacitors, Resistors itd.), które można wybierać w kolumnie Folder Structure (lub kolumnie Types) w celu podglądu składowych wpisów komponentów w siatce Components.

Typy komponentów, które obecnie nie istnieją w Workspace, ale mają zostać utworzone podczas importu, są oznaczone ikoną .

Zwróć uwagę, że sposób prezentacji listy Components można zmienić na kilka sposobów:

  • Kliknij nagłówek kolumny, aby posortować listę według tej kolumny parametru, a następnie kliknij ponownie, aby odwrócić kolejność.

  • Z menu kontekstowego nagłówka (prawy przycisk myszy):

    • Wybierz Clear Sorting, aby przywrócić domyślną kolejność listy (według kolumny Name w porządku rosnącym).

    • Wybierz Best Fit, aby dopasować szerokość wybranej kolumny do jej zawartości.

    • Wybierz Select Best Fit All Columns, aby dopasować wszystkie dostępne kolumny do szerokości ich zawartości.

    • Wybierz Select Columns, aby otworzyć okno dialogowe Select Columns, w którym można włączać/wyłączać kolumny parametrów oraz zmieniać ich pozycje na liście.

  • Kliknij ikonę filtra () w nagłówku, aby ograniczyć listę do dostępnej wartości parametru w kolumnie, wartości pustych/niepustych lub ustawienia filtra Custom. Zastosowany filtr jest widoczny na dole listy, gdzie można go włączyć/wyłączyć (za pomocą powiązanego pola wyboru), zmodyfikować w Filter Editor lub usunąć. Wybranie All poprzez ikonę filtra nagłówka () również usunie zastosowany filtr.

Komponenty bez kategorii

Jeśli jeden wpis podgrupy biblioteki ma nazwę Uncategorized (i jest wyświetlany jako Uncategorized w obszarze Types lub Folder Structure oraz opatrzony ikoną ), oznacza to, że importer nie był w stanie wykryć i przypisać typu do tej grupy komponentów – Component Type jest w praktyce ustawiony na None. W tym przypadku niewykryte komponenty (układy logiczne inwerterów) używają nierozpoznanego prefiksu oznaczenia (Designator) (U?), a ich parametry nie zawierają wykrytych słów kluczowych, takich jak IC, logic itd.

Jeśli import zostanie uruchomiony, komponenty zostaną zaimportowane jako typ bez kategorii, bez interpretacji. Jednak jeśli uwzględniono jakiekolwiek kluczowe/standardowe parametry (takie jak Resistance, Capacitance, Tolerance itd.), importer automatycznie ustawi dla nich odpowiedni typ jednostki parametru (Ohm, Farad, Percent itd.).

Problem można rozwiązać, ręcznie mapując oznaczenia (designators) używane dla tych komponentów na żądany typ komponentu w oknie dialogowym Library Splitting, do którego przechodzi się z przycisku – dostępnego po wybraniu biblioteki źródłowej (ProjectABC.IntLib). Okno dialogowe Library Splitting, z wartościami domyślnymi, udostępnia elementy sterujące do ustawienia niestandardowych opcji grupowania biblioteki dla komponentów bez kategorii na podstawie mapowania oznaczeń według typów komponentów oraz dzielenia opartego na parametrach.

Po wybraniu opcji Map Designators  w oknie dialogowym wybierz z listy rozwijanej Component Type opcję typu komponentu, która dotyczy komponentów bez kategorii (uwzględnione są wszystkie dostępne typy komponentów). Zatwierdź ukończone mapowanie typu i oznaczeń (typ komponentu Logic do oznaczeń U?) przyciskiem .

Po określeniu typu komponentu przez zastosowane mapowanie importer użyje pasującego Component Template (Logic), aby skonfigurować import biblioteki zgodnie z ustawieniami szablonu (folder, nazewnictwo itd.).

  • Okno dialogowe Library Splitting zawiera także opcję grupowania rozdzielonych komponentów według określonej wartości parametru (na przykład z parametru Category lub Component_Type), jeśli jest ona zdefiniowana w bibliotece źródłowej. Aby to zrobić, wybierz opcję Parameter Grouping w oknie dialogowym, a następnie odpowiedni parametr z menu rozwijanego.
  • Alternatywnie, Component Type biblioteki można wybrać ręcznie w sekcji General panelu Properties panel.
  • Aby zmienić Component Type pojedynczego wpisu na liście Components, kliknij w jego komórkę Component Type, a następnie wybierz alternatywny typ z listy rozwijanej lub kliknij prawym przyciskiem myszy typ komponentu i wybierz Change Component Type z menu kontekstowego.

Zwróć uwagę, że dzięki elastyczności ustawień Library Importer nowy (bez kategorii) typ biblioteki komponentów można zaimportować wraz z całą infrastrukturą wymaganą do przyszłych importów tego typu biblioteki. Wybierając odpowiednią konfigurację importu – nowy Component Type, Component Template, folder docelowy, mapowanie parametrów oraz typy jednostek wartości parametrów – jedynym wymaganiem przy kolejnym imporcie tego typu biblioteki jest wybranie wcześniej zdefiniowanego Component Type. Wybrany Component Type określi wtedy wszystkie pozostałe aspekty importu.

Wyklucz z importera

Możesz także wykluczyć określone typy komponentów z importu. Aby wykluczyć typ komponentu, na liście Types kliknij prawym przyciskiem myszy typ komponentu, który chcesz wykluczyć, a następnie wybierz Exclude from Importer z menu kontekstowego – w razie potrzeby zmień wyświetlanie kolumny z Folder Structure na Types ().

Wykluczony typ komponentu będzie wyszarzony na liście Types. Aby wyświetlić wykluczony(e) komponent(y) w siatce, kliknij Show Excluded Component (n), gdzie n oznacza liczbę wykluczonych komponentów.

Dołącz do importera

Jeśli wykluczyłeś typ komponentu z importu, używając opisanego powyżej polecenia Exclude from Importer, a jednak musisz go uwzględnić, kliknij prawym przyciskiem myszy wyszarzony typ komponentu na liście Types (lub Folder Structure), a następnie wybierz Include to Importer z menu kontekstowego. Typ komponentu ponownie będzie wyświetlany na liście Types, co oznacza, że nie jest wykluczony.

Błędy i ostrzeżenia walidacji

Komponenty, które nie zostaną poprawnie zaimportowane do Workspace lub nie zostaną zaimportowane wcale, są oznaczane tagami ostrzeżeń lub błędów w zaawansowanym interfejsie, gdy Library Importer jest uruchamiany () lub gdy wykonywana jest walidacja importu (). Walidacja sprawdza także puste ścieżki folderów Workspace, konfliktujące parametry systemowe oraz zduplikowane modele. Błąd krytyczny zablokuje import.

Podczas próby wykonania importu panel Messages jest wypełniany wykrytymi naruszeniami, a okno dialogowe oferuje wybór: porzucić import lub kontynuować z bieżącą konfiguracją importu. W tym drugim przypadku nieprawidłowe komponenty nie są importowane albo proces importu zakończy się niepowodzeniem.

W przypadku anulowanego importu lub uruchomienia ręcznej walidacji, wszystkie komponenty, które nie przejdą kontroli importu, zostają powiązane z ikonami błędów/ostrzeżeń oraz dodatkowymi informacjami w dolnym obszarze Details. Ikony w kolumnie podglądu Status wskazują konkretne wpisy komponentów, które naruszają reguły kontroli importu.

Poniżej wymieniono dostępne, wbudowane kontrole walidacji.

Kontrole definiowane przez użytkownika są konfigurowane w obszarze Import Checks panelu Properties. Użyj menu rozwijanego Report Mode, aby wybrać inny poziom raportowania dla powiązanego typu naruszenia. Poniżej wymieniono te kontrole.

Rozwiązywanie błędów i ostrzeżeń

Błędy parametrów, takie jak w pokazanym tu przykładzie, gdzie wartości Forward Voltage komponentu nie da się zinterpretować jako poprawnego napięcia, można rozwiązać poprzez:

  • Edycję problematycznej wartości parametru (Value) – zlokalizuj i edytuj jego komórkę do zgodnego formatu.

  • Zmianę zmapowanej jednostki parametru Type, określonej przez zastosowany Component Template, z Voltage na nieinterpretowaną Text – wybierz bibliotekę źródłową w interfejsie importera, a następnie zmień Forward Voltage Type na liście panelu Properties panel Parameter Mapping (na karcie General).

  • Usunięcie komponentu z procesu importu – kliknij prawym przyciskiem myszy jego wpis i wybierz opcję Exclude from Importer .

Błąd brakującego pliku, taki jak pokazany tu niemożliwy do zlokalizowania plik noty katalogowej (Datasheet), można rozwiązać poprzez:

  • Oczywiste rozwiązanie polegające na zlokalizowaniu i przywróceniu brakującego pliku w oczekiwanej lokalizacji.
  • Wyłączenie importu plików not katalogowych – zmień opcję Migrate w sekcji panelu Properties panel Datasheet (na karcie Advanced).
  • Wykluczenie komponentu z procesu importu biblioteki – jak opisano powyżej.

Użyj pola Search (w prawym górnym rogu), jeśli chcesz znaleźć konkretne wpisy komponentów. Wyszukiwanie filtruje listę elementów według dopasowanych wartości parametrów dla aktualnie wybranego typu komponentu – wybierz All w Types (Folder Structure), aby wyszukiwanie dotyczyło wszystkich komponentów w dostępnych bibliotekach źródłowych.

Import biblioteki schematów

Jeśli podczas próby importu biblioteki schematów napotkasz błąd „model not found” (taki jak Footprint <footprint name> not found in available libraries), oznacza to, że Library Importer nie może zlokalizować modeli podłączonych do komponentów w SCHLIB.

W trybie Simple Mode takie błędy będą pokazane w opartym na HTML Importing Report, dostępnym z przycisku , który jest dostępny po uruchomieniu importu. W trybie Advanced Mode błędy są wskazywane ikonami statusu w głównym interfejsie () oraz jako wpisy w panelu Messages – dzieje się tak podczas wykonywania sprawdzenia walidacji () lub podczas próby importu biblioteki ().

Brakujące footprinty są poprawnie wykrywane przez proces walidacji, który udostępnia także opcję Choose a Library w raporcie błędów (w menu rozwijanym Details). W przypadku, gdy wykryto brak więcej niż jednego footprintu komponentu, okno dialogowe Apply PcbLib Selection udostępnia opcje użycia wskazanego PcbLib dla tego przypadku lub dla wszystkich komponentów z brakującymi footprintami.

Innym sposobem rozwiązania (lub uniknięcia) tego problemu jest upewnienie się, że wymagane pliki bibliotek modeli są dostępne z poziomu Altium Designer. Biblioteki instaluje się na stronie Data Management – File-based Libraries page w oknie dialogowym Preferences.

Alternatywnie, jeśli nie chcesz instalować wielu bibliotek modeli, musisz zlokalizować je w domyślnej ścieżce bibliotek programu (lub edytować tę ścieżkę) i sprawdzić, czy dla komponentów biblioteki schematów wskazano źródłową bibliotekę modeli:

  • Uwzględnij bibliotekę modeli w domyślnej lokalizacji ścieżki wyszukiwania oprogramowania. Dodaj bibliotekę modeli, na przykład odpowiadającą jej bibliotekę PCB, do lokalizacji określonej przez domyślną ścieżkę bibliotek systemu. Aby sprawdzić tę lokalizację, zobacz wpis Library Path na stronie System – Default Locations page w oknie dialogowym Preferences. Jeśli plik biblioteki został dodany/skopiowany do tej lokalizacji ścieżki, może być konieczne ponowne uruchomienie Altium Designer, aby zarejestrować zmianę.
  • Określ docelową nazwę biblioteki modeli dla komponentów biblioteki schematów. Aby biblioteka modeli, do której odwołuje się komponent biblioteki schematów, była znana dla Library Importer, określ jej nazwę w oknie dialogowym biblioteki PCB Model dialog.

Zwróć uwagę, że nie jest konieczne, a nawet nie jest pożądane, importowanie biblioteki PCB razem z odpowiadającą jej biblioteką schematów, ponieważ wymagany import modeli i ich powiązanie zostaną wykonane przez sam Library Importer. Proces importera identyfikuje, lokalizuje i przenosi właściwy(e) model(e) dla każdego komponentu, aby utworzyć ujednolicony komponent w docelowym Workspace.

Wykrywanie duplikatów

Library Importer zawiera również mechanizmy zapobiegające tworzeniu zduplikowanych komponentów w docelowym Workspace. Jest to realizowane podczas walidacji poprzez porównanie parametrów identyfikatora komponentu oraz Part Choices z biblioteki źródłowej z tymi samymi danymi komponentów w docelowym Workspace oraz w bibliotekach źródłowych przeznaczonych do importu. Przy domyślnych ustawieniach importera krok walidacji () oznaczy komunikat Warning, gdy zostanie wykryty ten sam komponent Name lub wpis Part Choices (wskazujący na potencjalny duplikat komponentu). Wyświetlane ostrzeżenie/błąd zawiera typ naruszenia duplikacji (parametr lub Part Choice), nazwę naruszającego komponentu bibliotecznego oraz komponent (wg ID), z którym występuje konflikt.

Dwa potencjalne duplikaty wykryte przez proces Validate, gdzie Name komponentu (górny obraz) lub jego Part Choice (dolny obraz) już istnieją w komponentach Workspace.
Dwa potencjalne duplikaty wykryte przez proces Validate, gdzie Name komponentu (górny obraz) lub jego Part Choice (dolny obraz) już istnieją w komponentach Workspace.

Nazwa i para wartość–nazwa parametru używana do wykrywania naruszeń duplikacji jest określana w obszarze Duplicates Detection panelu Properties, na karcie Advanced. Użyj menu rozwijanego Unique Field (domyślnie ustawionego na Name), aby wybrać spośród parametrów dostępnych w bibliotece źródłowej. Ten wybór jest szczególnie przydatny w konfiguracjach bibliotek firmowych, które używają zastrzeżonego pola identyfikatora powiązanego z szerszym systemem przedsiębiorstwa.

Wykryte naruszenie duplikacji, w którym wartość określonego parametru (ERP-REF) jest taka sama dla komponentu z biblioteki lokalnej i komponentu w Workspace.
Wykryte naruszenie duplikacji, w którym wartość określonego parametru (ERP-REF) jest taka sama dla komponentu z biblioteki lokalnej i komponentu w Workspace.

Inny typ flagi statusu może zostać ustawiony dla naruszeń duplikacji poprzez wybranie alternatywnego Report Mode w obszarze Import Checks na karcie General panelu Properties.

Wykrywanie duplikatów jest wykonywane również dla modeli symboli komponentów. Jeśli importowane komponenty mają w bibliotekach źródłowych modele symboli o tej samej geometrii, zostanie zaimportowany tylko jeden z tych modeli.

Ta funkcja jest dostępna, gdy opcja LibraryMigrator.DuplicatedModelCheck jest włączona w oknie dialogowym Advanced Settings dialog.

Biblioteki modeli pojedynczych

Zautomatyzowane wykrywanie duplikatów jest również używane do przetwarzania bibliotek źródłowych, które stosują wspólny model symbolu dla wszystkich komponentów. Takie biblioteki zwykle składają się z jednego typu komponentu o różnych wariantach i wartościach, na przykład rezystorów w określonym formacie obudowy, gdzie symbol dla każdego jest standardową grafiką modelu.

Ten stan pojedynczego, wspólnego modelu jest wykrywany przez Library Importer, który następnie konfiguruje import tak, aby przenieść jeden model symbolu mający zastosowanie do wszystkich importowanych komponentów – zamiast odpowiadającego, indywidualnie nazwanego symbolu dla każdego komponentu. Importowany symbol przyjmuje nazwę jednego z symboli przeznaczonych do importu, a wszystkie parametry komponentów pozostają niezmienione.

Zaimportowany symbol biblioteczny (który ma nazwę ogólną i puste pole Description) można edytować zgodnie z potrzebami. W panelu Components panel użyj opcji Edit z menu kontekstowego (prawy przycisk myszy), aby wywołać tę akcję. W trakcie procesu wybierz opcję Update items related to <symbol ID> w oknie dialogowym Create Revisions for Item, aby upewnić się, że zaimportowane komponenty używają nowej rewizji symbolu.

Scalanie typów komponentów

Zakres typów komponentów zarejestrowanych w systemie – lub w praktyce w podłączonym Workspace – można przeglądać i zarządzać nim na stronie Data Management – Component Types page  w oknie dialogowym Preferences. Typy są wyświetlane wraz z powiązanym Template komponentu oraz Folder Workspace i będą obejmować wszelkie nowe typy utworzone, gdy Library Importer zaimportuje pliki bibliotek do Workspace.

Utworzenie wielu nowych typów komponentów może typowo wystąpić, gdy konfiguracja Library Importer użyła Parameter Grouping (wartości wskazanego parametru komponentu) do określenia typu dla każdego importowanego komponentu. Na przykład parametr Categories może mieć wartość Resistor-0608 dla jednej kolekcji importowanych komponentów i Resistor-0402 dla innej itd. W takim przypadku wszystkie najlepiej byłoby zgrupować pod jednym typem komponentu Resistors do przyszłego użycia.

Zamiast ręcznie zmieniać wszystkie typy komponentów w takich okolicznościach, strona Component Types page w Preferences umożliwia scalenie wybranych wpisów typu w jeden, wskazany wpis. Aby dowiedzieć się więcej, zapoznaj się z sekcją Merging Component Types na stronie Component Types.

Wynikiem takiego scalenia jest to, że gdy Resistors zostanie wybrany jako importowany typ komponentu w Library Importer, zostanie on zastosowany również wtedy, gdy jako alternatywę wybierzesz dowolny z połączonych szablonów (Resistor_0402 itd.).

Import tylko modeli

Library Importer można przełączyć w specjalny tryb importu Models Only, który wykrywa i przetwarza dostępne modele komponentów w bibliotece źródłowej.

Ta funkcja jest dostępna, gdy opcja LibraryMigrator.ModelsOnlyMode jest włączona w oknie dialogowym Advanced Settings dialog.

W trybie Models Only proces analizy importera wykryje wszystkie modele Symbol, Footprint i Simulation dostępne w bibliotece źródłowej (IntLib, SchLib, PcbLib itd.), a następnie zaimportuje te modele do Workspace, używając domyślnych lokalizacji systemu, schematów nazewnictwa oraz definicji cyklu życia.

Gdy Library Importer zostanie przełączony do trybu Advanced () lub otwarty w trybie Advanced (File » Library Importer), dostępne są pełne szczegóły proponowanego importu modeli. Obszar Import Preview  pokazuje Folder Structure, które zostaną użyte w docelowym Workspace, i które można zmodyfikować względem ustawień domyślnych w polu Folder dla każdego typu modelu w panelu Properties. Zastosowane schematy nazewnictwa oraz definicję cyklu życia dla każdego modelu można wybrać spośród dostępnych typów systemowych (zob. Properties panel poniżej).

Import modeli komponentów do Workspace można w razie potrzeby ograniczyć według typu, wyłączając (lub włączając) określone typy modeli w panelu Properties za pomocą powiązanych przycisków .

Po skonfigurowaniu Library Importer wybierz przycisk , aby zakończyć import wymienionych modeli komponentów. Wyniki można przejrzeć w pliku dziennika importu, oferowanym przez Library Importer okno dialogowe postępu (), lub przeglądając zaimportowane modele w panelu Components panel.

Import tylko komponentów

Podobnie jak w trybie importu Models Only opisanym powyżej, Library Importer można przełączyć w specjalny tryb importu Components Only, który umożliwia import dostępnych komponentów z biblioteki źródłowej bez ich powiązanych modeli.

Ta funkcja jest dostępna, gdy opcja LibraryMigrator.ReleaseComponentsWithoutModels jest włączona w oknie dialogowym Advanced Settings dialog.

W trybie Components Only proces analizy importera wykryje wszystkie komponenty, parametry oraz Part Choices w bibliotece źródłowej, a następnie zaimportuje te komponenty do Workspace, używając domyślnej lokalizacji systemu, schematu nazewnictwa oraz definicji cyklu życia.

Gdy Library Importer zostanie przełączony do trybu Advanced () lub otwarty w trybie Advanced (File » Library Importer), dostępne są pełne szczegóły proponowanego importu komponentów. Zastosowany folder, schematy nazewnictwa oraz definicję cyklu życia można wybrać spośród dostępnych typów systemowych (zob. Properties panel poniżej).

Po skonfigurowaniu Library Importer wybierz przycisk , aby zakończyć import wymienionych komponentów. W Workspace zostaną utworzone wyłącznie elementy komponentów, bez żadnych powiązanych modeli. Wyniki można przejrzeć w pliku dziennika importu, oferowanym przez Library Importer okno dialogowe postępu (), lub przeglądając zaimportowane komponenty w panelu Components panel

Panel Properties

Powiązane ustawienia panelu Properties zapewniają zaawansowaną kontrolę nad konfiguracją importu dla wybranej biblioteki (lub podgrupy bibliotek). Panel można otworzyć w trybie Advanced Library Importer, wybierając opcję Properties z menu przycisku  (w prawym dolnym rogu obszaru roboczego), klikając przycisk  w prawym górnym rogu widoku Library Importer lub klikając przycisk  obok <All Libraries> albo konkretnego wpisu kategorii na liście Source Libraries.

Ustawienia opcji panelu są określane przez domyślne ustawienia systemowe lub te wskazane przez zastosowany Component Template, który z kolei jest ustawiany na podstawie wykrytego typu komponentu w bibliotece – LED w pokazanym tutaj przykładzie. Ustawienia są również edytowalne przez użytkownika, co pozwala dostosować proces importu do potrzeb, i mogą zostać przywrócone za pomocą łącza Reset to Default (w prawym górnym rogu).

Sekcje kart General w panelu są następujące:

  • General:
    • Component Type – typ komponentu wykryty przez importer dla wybranej biblioteki, a w konsekwencji szablon, który zostanie zastosowany (zob. Component Template poniżej). Zastąp to ustawienie, edytując pole (co utworzy nowy component type) albo wybierając alternatywny typ z opcji listy rozwijanej (lub przez przycisk ) – to kolejny sposób na rozwiązanie problemu uncategorized component issue. Wybierz opcję [LibraryName], aby ustawić typ jako nazwę wybranej biblioteki.
    • Component Template – Workspace Component Template, który zostanie zastosowany do importowanych komponentów, a w konsekwencji także do ich ustawienia Component Type. Zastąp to ustawienie, wybierając alternatywny szablon z opcji listy rozwijanej (lub przez przycisk ). Ustaw tę opcję na [Create new], aby automatycznie utworzyć szablon wyprowadzony z parametrów biblioteki źródłowej oraz bieżących ustawień Library Importer, albo wybierz [No Template], aby zapobiec zastosowaniu lub utworzeniu szablonu.

      Zwróć uwagę, że ustawienia Component Type i Component Template są w praktyce powiązane, gdy są ustawione na dostępny Typ/Szablon – na przykład, jeśli jedno z nich zostanie ustawione na Capacitors, drugie zostanie automatycznie ustawione na Capacitors. Jeśli jednak w tym przypadku ustawienie Component Template zostanie zmienione na [Create New], zostanie utworzony kolejny szablon Capacitors (nazwany z odpowiednim sufiksem wersji/revizji), aby spełnić bieżące ustawienia. Istniejące Component Template nie są modyfikowane przez proces importu.
  • Parameter Mapping – dopasowanie parametrów pomiędzy parametrami biblioteki a tymi w zastosowanym szablonie komponentu (lub ustawieniami domyślnymi, gdy szablon nie jest dostępny), a także Typ wartości dla każdego parametru (Tekst lub typ uwzględniający jednostki). Użyj opcji listy rozwijanej w kolumnie Source Library Parameter, aby zmienić mapowanie, oraz opcji menu w kolumnie Type, aby nadpisać istniejące ustawienie określone przez szablon lub wartości domyślne. Wybierz opcję <Skip>, aby nie uwzględniać parametru. Każdy parametr, który nie został automatycznie dopasowany do parametru biblioteki źródłowej (jest ustawiony przez system na <Skip>), można ręcznie zmapować do odpowiedniego parametru szablonu – na przykład parametr źródłowy ROHS może zostać wybrany tak, aby odpowiadał parametrowi RoHS Compliant zdefiniowanemu przez szablon Workspace. Nazwy parametrów można edytować, a zestawy parametrów można dodawać, edytować i usuwać. Bazowe parametry komponentu (ID, Name, Description) mogą zostać przemapped, ale poza tym są tylko do odczytu.

    Dla parametru Workspace ID parametr biblioteki źródłowej jest ustawiony na <Auto>. Skutkuje to automatycznym tworzeniem identyfikatorów komponentów na podstawie Naming Template określonego w sekcji Component panelu, znajdującej się na karcie Advanced panelu. Mapowanie ID można zmienić tak, aby używało dowolnego parametru w bibliotece źródłowej (unikalnego dla każdego wpisu komponentu), wybierając alternatywę z listy rozwijanej Source Library Parameter. Zwróć uwagę, że bazowe parametry komponentu (ID, Name, Description) mogą zostać przemapped, ale poza tym są tylko do odczytu.
  • Part Choice Mapping – lista parametrów numerów części producenta lub łączy do dostawców rozpoznawanych przez importer, które zostaną użyte do wyprowadzenia wpisów Part Choices dla importowanych komponentów. Użyj opcji listy rozwijanej, aby przedefiniować mapowanie, albo dodawaj i usuwaj zestawy mapowań. Zwróć uwagę, że domyślnie parametry numerów części producenta i łączy do dostawców nie są uwzględniane (są pomijane) w procesie importu. Gdy do komponentu bibliotecznego dołączono wiele łączy do dostawców, jako odniesienie do głównego dostawcy (Supplier 1 / Supplier Part Number 1) używane jest dla wpisów pola Part Choices.
  • Import Checks – wyświetl lub ustaw reakcję importera (błąd/ostrzeżenie) na naruszenia reguł walidacji importu. Użyj listy rozwijanej Report Mode, aby zmienić reakcję i ikonę dla wpisu Violation Type. Zwróć uwagę, że jeśli wybrany jest tryb raportowania Fatal Error, zablokuje on proces importu po wykryciu tego naruszenia.

Karta Advanced panelu oferuje ustawienia dla wszystkich elementów obiektów danych importera, zgodnie z domyślnymi ustawieniami systemu lub zastosowanym Component Template. Obejmują one modele komponentów, pliki datasheet oraz wszelkie utworzone Component Template. Z wyjątkiem opcji Datasheet (przełącznik włącz/wyłącz) ustawienia dla każdego obiektu importu obejmują:

  • Folder – docelowy folder Workspace dla importowanego obiektu, który można edytować ręcznie (np. aby utworzyć nowy folder docelowy) lub wybrać za pomocą przycisku przeglądania ().
  • Naming Scheme – specyfikację nazewnictwa obiektu w Workspace, zdefiniowaną przez Component Template lub – przy braku aktywnego szablonu – schemat ustawiony dla folderu docelowego (albo wprowadzony ręcznie). Użyj listy rozwijanej, aby wybrać spośród dostępnych Naming Schemes. Zwróć uwagę, że zmiana ścieżki folderu docelowego (Folder) może wiązać się ze zmianą zastosowanego Naming Scheme, zgodnie z ustawieniami samego folderu lub zastosowanego/powiązanego Component Template.
  • Revision Naming Scheme – układ nazewnictwa używany dla Workspace revisions obiektu, ustawiony przez zastosowany szablon lub wybrany z opcji listy rozwijanej danego wpisu. Dostępne będą tylko te schematy, które są włączone w systemie.
  • Lifecycle DefinitionLifecycle system używany dla obiektu, ustawiony przez zastosowany szablon lub wybrany z opcji listy rozwijanej danego wpisu. Dostępne będą tylko te definicje, które są włączone w systemie.
Sekcja obiektu Component zawiera ustawienie dla Duplicates Detection, jak opisano powyżej.

Konfiguracja eksportu-importu

Library Importer oferuje możliwość wyeksportowania szczegółowego pliku tekstowego, który zapisuje bieżącą konfigurację, obejmującą wszystkie konfigurowalne ustawienia importu, takie jak ścieżki docelowe, mapowanie parametrów, schemat nazewnictwa, definicje cyklu życia, docelowe typy komponentów itd.

Plik konfiguracji importera jest zapisywany z polecenia File » Export » Importer Config jako typ pliku *.lmcfg i może zostać przywrócony w dowolnym momencie poprzez opcję menu File » Import » Importer Config .

Możliwość przywrócenia konfiguracji jest szczególnie przydatna, gdy źródłowa baza danych lub biblioteka plikowa została zaktualizowana i te zmiany trzeba zaimportować do Workspace. Jeśli konfiguracja została wyeksportowana podczas pierwszego importu biblioteki, przywrócona (zaimportowana) konfiguracja odtworzy dokładnie te same ustawienia, które zostały użyte, co gwarantuje spójny schemat transferu danych dla tej biblioteki (lub bibliotek).

Zwróć uwagę, że wyeksportowany (zapisany) plik Importer Configuration zawiera odwołania do plików bibliotek, które były otwarte jako biblioteki źródłowe w momencie eksportu konfiguracji. Gdy ten plik Importer Configuration zostanie następnie zaimportowany (ponownie wczytany), co najmniej jedna z bibliotek wskazanych w konfiguracji musi być dostępna – tzn. musi być aktualnie dostępna jako biblioteka źródłowa w Library Importer.
AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Content