Modifying Symbols & Footprints

Created: Sierpień 30, 2024 | Updated: Sierpień 30, 2024

Oprócz utrzymywania zawartości w samej bazie danych istnieje również potrzeba utrzymywania odwoływanych symboli i modeli — w razie potrzeby. Obejmuje to wprowadzanie modyfikacji do symboli schematowych oraz modelu(-i) footprintu. A w przypadku standardowej biblioteki bazodanowej (DbLib) — także definicji w plikach modeli symulacyjnych.

Oba typy bibliotek bazodanowych — standardowe i z kontrolą wersji — umożliwiają dostęp do odwoływanego symbolu i modelu footprintu w celu edycji, bezpośrednio z głównego widoku dokumentu DbLib/SVNDbLib, gdy jest on otwarty jako aktywny dokument. Poniższe sekcje pokazują, jak to zrobić — jest to nieco bardziej złożone, ale też nieco bardziej rozbudowane, w przypadku użycia SVNDbLib.

Zwróć uwagę, że do edycji za pośrednictwem odpowiedniego (i aktywnego) pliku biblioteki bazodanowej można uzyskać dostęp tylko do symbolu oraz domyślnego footprintu dla rekordu komponentu. Pamiętaj, że domyślny model footprintu to ten wpisany w Database Field Name, który jest mapowany do Design Parameter [Footprint Ref].

Podczas używania DbLib

Aby otworzyć do edycji plik biblioteki odwoływanego symbolu/modelu footprintu komponentu, kliknij prawym przyciskiem myszy wpis komponentu w Table Browser, a następnie wybierz z menu kontekstowego odpowiednie polecenie — Open Symbol lub Open Footprint. Zostanie otwarty właściwy plik biblioteki, a symbol/footprint zostanie pokazany jako aktywny obiekt w przestrzeni projektowej, gotowy do wprowadzenia zmian.

Otwarta biblioteka będzie tą, w której znajduje się odwoływany symbol/footprint — albo wskazaną wprost, jeśli w bazie danych znajdują się informacje o bibliotece, albo (jeśli ich nie ma) wyznaczoną na podstawie zdefiniowanych ścieżek na karcie Symbol and Model Search Paths w oknie dialogowym Database Library Options dialog (upewnij się też, że odpowiednia biblioteka faktycznie znajduje się pod zadeklarowaną ścieżką). Wróć do sekcji Specifying Symbol and Model Library Locations for a Database Library.

Po wprowadzeniu wymaganych zmian zapisz plik biblioteki.

Przykład uzyskania dostępu do odwoływanego symbolu komponentu z bazy danych bezpośrednio z poziomu DbLib.

Do pliku biblioteki źródłowej można też uzyskać dostęp poza plikiem DbLib. Użyj polecenia File » Open w edytorze bibliotek, aby przejść do i otworzyć wymaganą bibliotekę, albo przeciągnij i upuść plik biblioteki z Eksploratora Windows bezpośrednio do Altium Designer.

Podczas używania SVNDbLib

Jak wspomniano, możliwość dostępu do symboli i modeli odwoływanych przez komponenty bazodanowe (i udostępnianych przez plik SVNDbLib) oraz ich edycji jest nieco bardziej złożona, ale też bardziej rozbudowana. Modyfikacje są wprowadzane w lokalnych kopiach roboczych bibliotek przechowywanych w repozytorium SVN.

Określanie lokalnego obszaru roboczego

Aby modyfikować symbole komponentów i modele footprintów, musisz pobrać (check out) pliki z repozytorium do lokalnego katalogu roboczego. Wskaż wymagany katalog na stronie Data Management - SVN Libraries page w oknie dialogowym Preferences. Zdefiniowana jest domyślna lokalizacja folderu roboczego — \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Zmień ją w razie potrzeby, klikając przycisk , aby wskazać istniejący folder, lub wpisując ścieżkę do folderu bezpośrednio.

Folder wskazany jako lokalny katalog roboczy powinien służyć wyłącznie do przechowywania kopii plików objętych kontrolą wersji. Inne pliki, takie jak *.SVNDbLib, *.mdb i *.xls, powinny znajdować się w innym katalogu, ponieważ nie są objęte kontrolą wersji.

Określanie lokalnego katalogu roboczego.

Domyślna lokalizacja folderu roboczego fizycznie nie istnieje domyślnie. Zostanie utworzona podczas pobierania (check out) plików z repozytorium. Tak samo będzie, jeśli wskażesz folder (poprzez bezpośrednie wpisanie ścieżki), który obecnie nie istnieje.

Aby szybko pobrać (check out) wszystkie biblioteki symboli i modeli footprintów z repozytorium do wskazanego lokalnego folderu roboczego, uruchom polecenie Check Out All Working Folders z głównego menu Tools edytora SVNDatabaseLib. Pobierane foldery będą tymi określonymi w obszarze Models Location na karcie SVN Repository w oknie dialogowym Database Library Options dialog.

Przykład symboli i footprintów — przechowywanych w repozytorium SVN i określonych jako część Database Library Options — pobranych (check out) do lokalnego folderu roboczego.

Wprowadzanie zmian

Po pobraniu bibliotek symboli i modeli footprintów do wyznaczonego lokalnego folderu roboczego możesz wprowadzać modyfikacje w razie potrzeby. Obejmuje to modyfikowanie lokalnej kopii symboli schematowych i modeli footprintów, a następnie zatwierdzanie (commit) tych zmian z powrotem do repozytorium SVN.

Podobnie jak w DbLib, dostępne są następujące metody uzyskania dostępu do symbolu/modelu w celu edycji:

W dokumencie SVNDbLib kliknij prawym przyciskiem myszy wpis komponentu w Table Browser, a następnie wybierz z menu kontekstowego odpowiednie polecenie — Open Symbol lub Open Footprint.

Otwarta lokalna biblioteka będzie tą, w której znajduje się odwoływany symbol/footprint — albo wskazaną wprost, jeśli w bazie danych znajdują się informacje o bibliotece, albo (jeśli ich nie ma) wyznaczoną na podstawie zdefiniowanych lokalizacji modeli na karcie SVN Repository w oknie dialogowym Database Library Options dialog. Wróć do sekcji Specifying Symbol and Model Library Locations for a Database Library.

Jeśli SVNDbLib zostanie dodany do listy Available File-based Libraries, możesz uzyskać dostęp do poleceń edycji bezpośrednio z panelu Components panel. Wybierz wymagany wpis komponentu, a następnie użyj polecenia Edit Symbol (w menu kontekstowym po kliknięciu prawym przyciskiem myszy dla obszaru Components ) lub polecenia Edit Footprint (w menu kontekstowym po kliknięciu prawym przyciskiem myszy dla obszaru Models ), odpowiednio.
Użyj polecenia File » Open w edytorze bibliotek, aby przejść do i otworzyć wymaganą bibliotekę (w lokalnym folderze roboczym).
Przeciągnij i upuść plik biblioteki (z lokalnego folderu roboczego) z Eksploratora Windows bezpośrednio do Altium Designer.

W każdym przypadku, po wprowadzeniu wymaganych zmian, zapisz plik biblioteki.

Jednak głównym interfejsem pomiędzy folderami i plikami pobranymi (check out) do lokalnego folderu roboczego a samym repozytorium jest panel Storage Manager panel. Gdy plik SVNDbLib jest aktywnym dokumentem, panel Storage Manager zostanie wypełniony folderami symboli i modeli pobranymi do lokalnego folderu roboczego. Dokładnie wyświetlane foldery będą tymi określonymi w obszarze Model Locations na karcie SVN Repository w oknie dialogowym Database Library Options.

Panel Storage Manager odzwierciedla lokalny folder roboczy — pod warunkiem, że plik SVNDbLib jest aktywnym dokumentem w Altium Designer. Panel Storage Manager odzwierciedla lokalny folder roboczy — pod warunkiem, że plik SVNDbLib jest aktywnym dokumentem w Altium Designer.

Aby otworzyć plik biblioteki do edycji, kliknij prawym przyciskiem myszy jego wpis w obszarze All Files panelu i wybierz Open z wyświetlonego menu kontekstowego. Wprowadź wymagane zmiany i zapisz plik standardowo, używając powiązanego, standardowego polecenia Save w danym edytorze.

Zatwierdzanie zmian do repozytorium

Panel page: Storage Manager

Chociaż istnieją różne sposoby otwierania biblioteki do edycji, zatwierdzanie (commit) wszelkich wprowadzonych zmian — z poziomu within Altium Designer — można wykonać wyłącznie za pośrednictwem panelu Storage Manager panel.

W Altium Designer kontrolki do zatwierdzania (commit) do repozytorium oraz aktualizowania (update) z repozytorium są dostępne wyłącznie poprzez panel Storage Manager. Oczywiście możesz też wykonywać commit, update oraz sprawdzać modyfikacje poza Altium Designer, korzystając z funkcji i możliwości zewnętrznego klienta SVN.

Jedną z najważniejszych rzeczy, o których należy pamiętać podczas korzystania z panelu Storage Manager , jest odświeżanie statusu połączenia pomiędzy lokalnymi folderami/plikami roboczymi (wyświetlanymi w panelu) a odpowiadającymi im folderami/plikami w repozytorium kontroli wersji. Dla pojedynczo wybranej biblioteki realizuje się to poleceniem Refresh, dostępnym w menu po kliknięciu prawym przyciskiem myszy w obszarze All Files panelu. Aby szybko odświeżyć status całego folderu, użyj skrótu klawiaturowego Ctrl+F5.

Odświeżanie statusu bibliotek źródłowych staje się jeszcze ważniejsze w środowisku wieloosobowym, gdzie kilka osób może odpowiadać za utrzymanie repozytorium źródłowych plików symboli i modeli.

Wpisy statusu istotne podczas pracy z lokalnymi bibliotekami symboli i modeli to:

Ikona	Status	Opis
	`No modification`	Lokalna kopia biblioteki jest identyczna jak w repozytorium. Możesz swobodnie otworzyć plik i wprowadzać modyfikacje.
	`Out of date`	Lokalna kopia pliku (w folderze roboczym) jest starsza niż jej odpowiednik w repozytorium, a więc jest nieaktualna. Zanim będziesz mógł/mogła modyfikować i zatwierdzać własne zmiany, musisz pobrać najnowszą wersję pliku z repozytorium — aktualizując swoją lokalną kopię roboczą. Użyj polecenia Update (w menu kontekstowym po kliknięciu prawym przyciskiem myszy), aby pobrać najnowszy plik z repozytorium.
	`Modified`	Lokalna kopia pliku została zmodyfikowana w Altium Designer i zapisana do folderu roboczego. Aby wypchnąć lokalne zmiany do repozytorium, kliknij prawym przyciskiem myszy wpis pliku i wybierz z menu kontekstowego polecenie Commit. Po zatwierdzeniu w repozytorium status wróci do `No modification`.
	`Conflict`	Plik został zatwierdzony przez innego użytkownika Altium Designer, zanim zatwierdzisz własną edytowaną i zapisaną wersję tego pliku. Użyj polecenia Update lub Resolve , aby określić, która wersja pliku stanie się najnowszą rewizją w repozytorium.
	`Locked`	Plik został zablokowany przez Ciebie lub przez innego użytkownika. Zablokowanego pliku nie można zaktualizować do nowej rewizji w repozytorium przez innego użytkownika (chyba że zostanie wymuszone odblokowanie). Ten stan może współwystępować z innymi ikonami, np. dla `Modified` lub `No Modification` , gdy te warunki statusu również mają zastosowanie.

Aby uzyskać więcej informacji o pracy z kontrolą wersji, zobacz Using External Version Control.

Fizyczne porównanie rewizji

Porównanie fizyczne można wykonać pomiędzy dowolnymi dwiema rewizjami tego samego symbolu (biblioteki modeli). Pozwala to w przejrzysty, wizualny sposób zobaczyć zmiany, które zostały wprowadzone — pomiędzy kolejnymi lub niekolejnymi rewizjami pliku.

W panelu Storage Manager panel porównanie wykonuje się z poziomu obszaru VCS Revisions znajdującego się na dole panelu.

Panel Storage Manager prezentuje dwa widoki historii wybranego pliku, z oddzielnymi obszarami dla VCS Revisions oraz Local History.

Porównanie można wykonać pomiędzy dowolnymi dwiema rewizjami. Korzystając z techniki zaznaczania w systemie Windows, wybierz dwie rewizje biblioteki, które chcesz porównać, w obszarze VCS Revisions panelu, kliknij prawym przyciskiem myszy i wybierz Compare.

Po wywołaniu polecenia Compare dwie wybrane rewizje dokumentu zostaną otwarte obok siebie w obszarze roboczym, zostanie wykonane porównanie graficzne, a wszelkie wykryte różnice między nimi zostaną wyświetlone na liście w panelu Differences.

Porównanie graficzne bezpośrednio w przestrzeni projektowej edytora biblioteki.

Wersja do wydruku

Tł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.