Parametr

Parent page: Obiekty schematu

Parametry są używane dla komponentów (pokazano), dokumentów i projektów, aby dodać do projektu szczegółowe informacje.

Podsumowanie

Parametry to ogólnego przeznaczenia ciągi tekstowe, które są obiektami podrzędnymi obiektu nadrzędnego i umożliwiają dodanie do niego szczegółowych informacji. Na przykład komponenty schematu intensywnie korzystają z parametrów. Służą one do zdefiniowania oznaczenia (Designator) i komentarza (Comment), a także ogólnych ciągów parametrów, które można dodać, aby w pełni go opisać. Ogólne parametry komponentu mogą być używane do różnych celów, w tym do opisu szczegółów komponentu, takich jak moc, napięcie itp., szczegółów dostawcy, w tym nazwy dostawcy i numeru części, szczegółów projektu komponentu bibliotecznego, takich jak numer rewizji symbolu, oraz szczegółów dokumentacji, takich jak URL prowadzący do noty katalogowej komponentu.

Parametry można definiować na poziomie arkusza schematu (dokumentu) oraz na poziomie projektu. Parametry na poziomie dokumentu idealnie nadają się do definiowania pól, takich jak tytuł i numer dokumentu, a parametry na poziomie projektu są idealne do definiowania pól, takich jak projektant lub nazwa projektu.

Dostępność

Parametry są dodawane jako właściwość obiektu nadrzędnego; nie umieszcza się ich niezależnie jak ciągu tekstowego. Parametry można dodać do dowolnego z następujących obiektów projektu:

• Component - dodaj parametry zdefiniowane przez użytkownika w obszarze Parameters okna dialogowego Component Properties lub okna dialogowego Library Component Properties, jeśli są dodawane podczas definiowania komponentu w edytorze biblioteki schematów. Parametry Designator i Comment są zawsze obecne dla obiektu Component. Aby uzyskać dostęp do okna dialogowego, kliknij dwukrotnie komponent w edytorze schematów lub kliknij dwukrotnie nazwę komponentu w panelu Sch Library w edytorze biblioteki schematów.
• Pin - na karcie Parameters okna dialogowego Pin Properties.
• Port - na karcie Parameters okna dialogowego Port Properties.
• Sheet Symbol - na karcie Parameters okna dialogowego Sheet Symbol.
• Document - w oknie dialogowym Document Options (Project | Content | ). Parametry są wymienione na karcie Parameters okna dialogowego; w nowym arkuszu schematu automatycznie uwzględnianych jest wiele parametrów domyślnych.
• Project - w oknie dialogowym Options for Project (Project | Content | ). Parametry są wymienione na karcie Parameters okna dialogowego.

Edycja graficzna

Widoczne ciągi można edytować graficznie za pomocą tzw. edycji in-place. Aby edytować ciąg w miejscu, kliknij raz, aby zaznaczyć, odczekaj sekundę, a następnie kliknij drugi raz, aby wejść w tryb edycji.

 Kliknij raz, aby zaznaczyć ciąg.

 Zatrzymaj się, następnie kliknij drugi raz, aby wejść w tryb edycji w miejscu.

Wartość ciągu oznaczenia (designator) można edytować w miejscu.

 Tutaj ciąg został zaznaczony i jest gotowy do wpisania ciągu zastępczego.

Po zakończeniu edycji naciśnij Enter lub kliknij poza ciągiem, aby wyjść z trybu edycji w miejscu.

Edycja za pomocą panelu Inspektora

Panel pages: SCH Inspector, SCHLIB Inspector

Panel Inspector umożliwia przeglądanie i edycję właściwości jednego lub wielu obiektów projektu w aktywnym dokumencie.

Parametry komponentu

Parametry komponentu obejmują oznaczenie (designator) i komentarz (comment), a także wszelkie parametry zdefiniowane przez użytkownika.

Edycja parametrów komponentu w edytorze biblioteki schematów

Domyślnie oznaczenie, komentarz i parametry zdefiniowane przez użytkownika nie są widoczne w edytorze biblioteki schematów. Edytuje się je w oknie dialogowym Library Component Properties. Kliknij dwukrotnie nazwę komponentu w panelu SCH Library lub kliknij przycisk Edit, aby otworzyć okno dialogowe, jak pokazano na poniższym obrazie.

Kliknij dwukrotnie nazwę komponentu lub kliknij przycisk Edit , aby otworzyć okno dialogowe i edytować parametry komponentu w edytorze biblioteki.

Parametry zdefiniowane przez użytkownika można wyświetlić, zaznaczając ich pole wyboru Visible w oknie dialogowym Library Component Properties. Spowoduje to wyświetlenie parametru Value.. Aby wyświetlić nazwę parametru, kliknij przycisk Edit, aby otworzyć okno dialogowe Parameter Properties, w którym można włączyć pole wyboru Visible dla pola Name.

Alternatywnie ciągi oznaczenia i komentarza można wyświetlić w edytorze biblioteki schematów, a następnie kliknąć je dwukrotnie, aby edytować ich właściwości. Aby wyświetlić te ciągi, kliknij Tools | Options |

, aby otworzyć okno dialogowe Library Editor Workspace, a następnie włącz opcję Always Show Comment/Designator, jak pokazano na poniższym obrazie. To ustawienie jest właściwością biblioteki schematów.

Włącz opcję Always Show Comment/Designator, aby wyświetlać te ciągi w edytorze biblioteki schematów.

Edycja parametrów komponentu w edytorze schematów

Parametry komponentu można definiować w edytorze schematów podczas umieszczania komponentu lub po umieszczeniu komponentu na arkuszu schematu.

• Aby zdefiniować oznaczenie/komentarz/parametr użytkownika podczas umieszczania komponentu, naciśnij klawisz Tab, gdy komponent „pływa” na kursorze. Otworzy się okno dialogowe Properties for Schematic Component. Wprowadź wymagany ciąg oznaczenia/komentarza/parametru zdefiniowanego przez użytkownika, a następnie kliknij OK, aby zamknąć okno dialogowe i zakończyć umieszczanie komponentu. Kontynuuj umieszczanie komponentów lub naciśnij Esc, aby zakończyć tryb umieszczania.
• Aby zdefiniować oznaczenie/komentarz/parametr użytkownika po umieszczeniu, kliknij dwukrotnie umieszczony komponent, aby otworzyć okno dialogowe Properties for Schematic Component, w którym można edytować oznaczenie/komentarz/parametr użytkownika. Kliknij OK, aby zamknąć okno dialogowe i zatwierdzić zmianę.

Edycja właściwości wyświetlania parametrów komponentu

Wygląd ciągów oznaczenia/komentarza/parametru użytkownika, w tym typ czcionki, rozmiar i kolor, można zdefiniować jako:

1. Właściwość symbolu poprzez ustawienie właściwości oznaczenia/komentarza/parametru użytkownika w oknie dialogowym Parameter Properties w edytorze biblioteki schematów. Wymaga to ustawienia ciągu oznaczenia jako widocznego, jak opisano wcześniej.
2. Poprzez edycję ciągu oznaczenia/komentarza/parametru użytkownika umieszczonego komponentu schematu — kliknij dwukrotnie komponent, aby edytować różne właściwości parametru.

Oba podejścia otwierają okno dialogowe Parameter Properties, jak pokazano poniżej. Zwróć uwagę, że w tym oknie dialogowym można edytować wszystkie właściwości parametru.

Wartość i wygląd ciągu Designator można edytować w oknie dialogowym Parameter Properties.

Ustalanie położenia ciągów parametrów

Domyślne zachowanie ciągu parametru komponentu polega na automatycznym pozycjonowaniu podczas obracania komponentu w trakcie umieszczania. Jeśli to zachowanie nie jest wymagane, wyłącz opcję Autoposition w oknie dialogowym Parameter Properties (patrz poprzedni obraz) — podczas tworzenia symbolu lub po umieszczeniu komponentu na arkuszu schematu. Zwróć uwagę, że spowoduje to sklasyfikowanie tego parametru jako manual parameter (czyli parametru pozycjonowanego ręcznie). Parametry ręczne są identyfikowane kropką w lewym dolnym rogu ich ramki zaznaczenia.

Parametry komponentu specjalnego przeznaczenia

Utworzono parametry komponentu specjalnego przeznaczenia do definiowania łączy z komponentów do powiązanej dokumentacji. Obejmują one parametr HelpURL oraz parę parametrów ComponentLink.

Parametr HelpURL

Parametr HelpURL umożliwia zdefiniowanie łącza z komponentu do zewnętrznego dokumentu, takiego jak PDF lub strona WWW. Łącze jest aktywowane po naciśnięciu F1 nad komponentem na arkuszu schematu lub gdy ten komponent jest zaznaczony w panelu Libraries. Za pomocą tego parametru można odwołać się do pliku PDF, pliku tekstowego lub strony HTML. Aby użyć tej funkcji, dodaj parametr HelpURL do wymaganego komponentu i ustaw wartość parametru na dokument, który chcesz otworzyć.

Podczas określania wartości parametru możesz podać ścieżkę bezwzględną albo wpisać nazwę dokumentu. Poniższe przykłady są poprawnymi wpisami wartości parametru:

• C:\Design_Projects\Schematics\Modifications.txt
• From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
• www.circuitstudio.com

Gdy F1 zostanie naciśnięty, a kursor znajduje się nad umieszczonym obiektem, wyszukiwanie dokumentu odbywa się następująco:

• Jeśli podano ścieżkę, najpierw przeszukiwane jest to położenie,
• Jeśli dokumentu nie można znaleźć w tym położeniu lub nie podano ścieżki, przeszukiwany jest folder \Help instalacji CircuitStudio,
• Jeśli dokumentu nie można znaleźć, wyświetlany jest domyślny temat pomocy dla obiektu.

Para parametrów ComponentLink

Ta funkcja umożliwia definiowanie i prezentowanie nazwanych łączy do dowolnej liczby dokumentów referencyjnych. Można zdefiniować wiele par parametrów ComponentLink. Aby użyć tej funkcji, dodaj i skonfiguruj dwa parametry dla każdej pary ComponentLink w następujący sposób:

Pierwszy parametr — służy do zdefiniowania dokumentu docelowego:

• Nazwa parametru = ComponentLinknURL (gdzie n jest dowolną liczbą całkowitą)
• Wartość parametru = target document path\name

Drugi parametr — służy do zdefiniowania wpisu, który pojawi się w menu:

• Nazwa = ComponentLinknDescription (gdzie n jest tą samą liczbą całkowitą, co w pierwszym parametrze)
• Wartość = Entry to appear in the menu

Można zdefiniować dowolną liczbę par parametrów ComponentLink; każda para jest powiązana poprzez współdzielenie tej samej wartości dla n.

Aby uzyskać dostęp do łączy komponentu, kliknij prawym przyciskiem myszy umieszczoną część w obszarze roboczym. Wpis dla łącza pojawi się w podmenu References.

Zastępowanie wartości ciągu tekstowego wartością parametru

Parametry komponentu można łatwo wyświetlać za pomocą ich Visible pola wyboru. Nie dotyczy to parametrów dokumentu ani projektu, których nie można bezpośrednio wyświetlić na arkuszu schematu. Aby wyświetlić te parametry, stosuje się technikę znaną jako String Indirection. String Indirection to mechanizm, w którym na arkuszu schematu umieszcza się standardowy ciąg tekstowy, a zamiast wpisywać wartość tekstu, wpisuje się nazwę parametru dokumentu lub projektu poprzedzoną znakiem równości, na przykład =Title. Oprogramowanie automatycznie wykrywa takie ciągi i zamiast wyświetlać zawartość pola tekstowego, taką jak =Title, sprawdza parametry dokumentu i projektu, a jeśli znajdzie parametr o nazwie Title, wyświetla wartość parametru Title.

Ciągi z indirection są znane jako Special Strings. Istnieje duża liczba predefiniowanych ciągów specjalnych, które wymieniono poniżej. Każdy parametr dokumentu lub projektu zdefiniowany przez użytkownika również można traktować jako ciąg specjalny i zastosować do niego indirection w polu Text String na arkuszu schematu.

Predefiniowane ciągi specjalne schematu

Poniżej znajdują się predefiniowane ciągi specjalne dostępne do użycia w dokumencie schematu. Większość z nich odwołuje się do domyślnych informacji parametrów zdefiniowanych dla aktywnego dokumentu na karcie Parameters w oknie dialogowym Document Options (Project | Content | Document Options).

• =Address1 – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Address1.
• =Address2 – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Address2.
• =Address3 – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Address3.
• =Address4 – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Address4.
• =Application_BuildNumber – wyświetla wersję i numer kompilacji bieżącej instalacji CircuitStudio.
• =ApprovedBy – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu ApprovedBy.
• =Author – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Author.
• =CheckedBy – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu CheckedBy.
• =CompanyName – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu CompanyName.
• =CurrentDate – bieżąca data, automatycznie obliczana na podstawie ustawień systemu użytkownika i w formacie dd/mm/yyyy, aktualizowana podczas edycji schematu lub przy odświeżeniu/przerysowaniu. Przykład: 10/12/2012.
• =CurrentTime – bieżący czas, automatycznie obliczany na podstawie ustawień systemu użytkownika i w formacie h:mm:ss AM/PM, aktualizowany podczas edycji schematu lub przy odświeżeniu/przerysowaniu. Przykład: 2:39:47 PM.
• =Date – służy do wyświetlania statycznych informacji o dacie. Wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Date. W przeciwieństwie do ciągu specjalnego =CurrentDate, który jest automatycznie obliczany i prezentowany w ustalonym formacie, statyczną datę możesz wprowadzić w dowolnym formacie.
• =DocumentFullPathAndName – służy do wyświetlania pełnej ścieżki i nazwy dokumentu, w którym umieszczono ciąg. Przykład: C:\MyTestDesign\PSU.SchDoc.
• =DocumentName – służy do wyświetlania wyłącznie nazwy pliku schematu (bez ścieżki). Przykład: PSU.SchDoc.
• =DocumentNumber – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu DocumentNumber. Parametr źródłowy można także zaktualizować w oknie dialogowym Sheet Numbering For Project podczas używania polecenia Tools | Annotation | Number Sheets.
• =DrawnBy – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu DrawnBy.
• =Engineer – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Engineer.
• =ImagePath – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu ImagePath.
• =ModifiedDate – znacznik daty modyfikacji schematu, uzupełniany automatycznie. Przykład: 10/12/2012.
• =Organization – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Organization.
• =ProjectName – wyświetla rzeczywistą nazwę projektu (wraz z rozszerzeniem). Na przykład dla projektu o nazwie pliku MyPCB.PrjPcb ten ciąg specjalny wyświetli MyPCB.PrjPcb.
• =Revision – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Revision.
• =Rule – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Rule. Wartość tego parametru początkowo będzie wynosić Undefined Rule (na schemacie widoczne jako * ). Kliknij dwukrotnie wartość parametru, aby uzyskać możliwość zdefiniowania typu reguły i edycji jej ograniczeń.
• =SheetNumber – numer arkusza bieżącego schematu. Wartość ta jest obliczana podczas używania polecenia Tools | Annotate | Number Sheets. Przypisany numer arkusza w oknie dialogowym Sheet Numbering For Project zostanie wpisany jako wartość domyślnego parametru na poziomie dokumentu SheetNumber. Ciąg specjalny, użyty w widoku karty Editor arkusza schematu, będzie pobierał informacje właśnie stąd.
• =SheetTotal – łączna liczba arkuszy w projekcie. Wartość ta jest obliczana podczas używania polecenia Tools | Annotate | Number Sheets. Łączna liczba arkuszy w oknie dialogowym Sheet Numbering For Project zostanie wpisana jako wartość domyślnego parametru na poziomie dokumentu SheetTotal. Ciąg specjalny, użyty w widoku karty Editor arkusza schematu, będzie pobierał informacje właśnie stąd.
• =Time – służy do wyświetlania statycznych informacji o czasie. Wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Time. W przeciwieństwie do ciągu specjalnego =CurrentTime, który jest automatycznie obliczany i prezentowany w ustalonym formacie, statyczny czas możesz wprowadzić w dowolnym formacie.
• =Title – wyświetla wartość określoną dla domyślnego parametru na poziomie dokumentu Title.
• =VariantName - wyświetla wariant, z którego wygenerowano dane wyjściowe. Występuje po wpisie dla bieżącego wariantu (Project | Project Actions | Current Variant). Jeśli do wygenerowania danych wyjściowych użyto projektu bazowego, wartością będzie [No Variations].

Ciągi specjalne do użycia z parametrami komponentu

Dostępnych jest kilka dodatkowych ciągów specjalnych (lub specjalnych interpretacji już istniejących) podczas definiowania parametrów komponentu. W każdym przypadku ciąg specjalny jest wprowadzany jako value dla parametru.

• =CurrentFootprint – wyświetla nazwę aktualnie przypisanego footprintu dla komponentu, zgodnie z definicją w obszarze Models powiązanego okna dialogowego Component Properties .
• =Comment – wyświetla wartość widoczną w polu Comment komponentu, zgodnie z definicją w obszarze Properties powiązanego okna dialogowego Component Properties .
• =Description – wyświetla wartość widoczną w polu Description komponentu, zgodnie z definicją w obszarze Properties powiązanego okna dialogowego Component Properties .
• =[ParameterName] – wyświetla wartość zdefiniowaną dla wskazanego parametru komponentu. Wprowadź rzeczywistą nazwę parametru komponentu jako nazwę ciągu specjalnego; na przykład dla parametru komponentu o nazwie PowerRating wpisz =PowerRating. Podczas definiowania właściwości Comment dla komponentu powiązane pole listy rozwijanej zostanie wypełnione ciągami specjalnymi dla wszystkich istniejących parametrów komponentu, co umożliwia szybkie użycie wartości dowolnego zdefiniowanego parametru dla Comment.