Copyright: EAGLE Layout Editor (c) 1988-2000 CadSoft Computer GmbH


Úvod do nápovìdy

  UŽÍVACÍ PRÁVO
udìlené držitelem autorských práv èeského HELP systému Eagle, autorizovným distributorem EAGLE pro Èeskou republiku a Slovenskou republiku, vlastníkem ochranné známky EAGLE è. 206710, firmou:

•	 ELCAD v.o.s., 664 02 Ochoz u Brna 141

•	 Tel./fax: 05-44234850, mobil: 0602-779331 (0608-779331)

•	 e-mail: elcad@elcad.cz, http://www.eagle.cz, http://www.elcad.cz

Tuto BETA-verzi èeského elektronického HELP (manuálu) Eagle 3.55 vlastníte legálnì tehdy, pokud jste vlastníky originálního lisovaného CD-ROM katalogu firmy PS Electronic. Pokud tomu tak není, nemáte oprávnìní tento èeský HELP užívat. Užívací právo k této verzi HELP mùžete zdarma legálnì získat Vaší registrací u firmy ELCAD v.o.s. nebo získáním originálního lisovaného CD-ROM katalogu firmy PS Electronic na adrese:

•	 PS electronic, Husitská 54, 130 00 Praha 3

•	 tel.: 02-628 42 68, fax.: 02-627 89 66

•	 e-mail: ps@pselectronic.cz, internet: http://www.pselectronic.cz
____________________________________________________________________

Tento èeský pøeklad HELP-systému EAGLE je chránìn autorskými právy firmy ELCAD v.o.s. a je urèen jen pro  výše uvedeného uživatele této licence. Ten k tomuto èeskému HELP získal pouze právo užívací, které je vázáno na vlastnictví originálního lisovaného CD-ROM firmy PS Electronic. Jakákoliv kopie tohoto èeského manuálu HELP, která by se nalézala na jiném datovém nosièi než lisovaném CD-ROM firmy PS Electronic je nelegální a nesmíte ji používat. Tento èeský HELP není dovoleno poskytovat jiným právnickým nebo fyzickým osobám nebo jiným subjektùm, ani jej èinit pøístupným jakoukoliv formou pro jiné právní a obèanské subjekty a� ve formì tištìné nebo elektronické, ani v nìm provádìt jakékoliv úpravy bez souhlasu držitele autorskách práv. Dodržováním licenèních podmínek pøispíváte k podpoøe dalšího rozvoje èeské dokumentace v budoucích verzích Eagle. Pokud s tìmito podmínkami nesouhlasíte, nepoužívejte tento èeský HELP. Dìkujeme Vám za pochopení.

(Pozn.: Toto je BETA verze èeského HELP. Je omezena tím, že v èeštinì je pøeložena jen polovina originálního systému HELP, zbytek zùstává anglický. Èeská polovina však zahrnuje kompletní detailní popis všech pøíkazù a základních funkcí v rozsahu zhruba 80 nejpoužívanìjších stran manuálu, takže Vám umožní zaèít pracovat s Eagle hned teï. Anglická polovina HELP zahrnuje pokroèilejší techniky nastavování Eagle a pøedevším popis jazyka ULP, ve kterém lze dále volnì rozšiøovat možnosti Eagle smìrem k rutinní automatizaci a dávkování práce s technologickými výstupy, které zaèáteèník rozhodnì nevyužije. Kompletní èeský HELP lze objednat u distributora Eagle, firmy ELCAD v.o.s.)

Pøeji Vám pøíjemnou práci a objevení všech možností Eagle s naší èeskou nápovìdou.
Ing. Miroslav Hrabovský, ELCAD v.o.s.
____________________________________________________________________

Vysvìtlení základních funkcí nápovìdy EAGLE

Pokud se nacházíte v oknì editoru desky, schémat, nebo knihovny, stisk klávesy F1 nebo napsání pøíkazu HELP otevøe stránku s nápovìdou pro právì aktivní pøíkaz.

HELP pøíkaz

kde "pøíkaz" nahraïte napø., MOVE, což zobrazí stránku nápovìdy pro pøíkaz MOVE.

Kdekoliv jinde stiskem klávesy F1 vyvoláte kontextovì orientovanou stránku nápovìdy pro menu, dialog nebo akci, která je právì aktivní.

Pro podrobnìjší informace, jak zaèít pracovat s EAGLE si pøeètìte následující stránky s nápovìdou:

•	Rychlý úvod

•	Instalace

•	Øídící panel


Instalace

Hlavní parametry EAGLE mohou být upravovány v Øídícím panelu.

Následující pøíkazy editoru mohou být použity pro úpravu zpùsobu práce EAGLE. Mohou být zadány buï pøímo z pøíkazového øádku okna editoru, nebo v souboru EAGLE.SCR.

Uživatelské rozhraní

Pøíkazové menu	MENU pøíkaz..;

Pøiøazení funkè. kláves	ASSIGN funkèní_klávesa pøíkaz..;

Funkce zachycení	SET SNAP_LENGTH èíslo;

SET SNAP_BENDED ON | OFF;

SET SELECT_FACTOR hodnota;

Obsah menu	SET USED_LAYERS jméno | èíslo;

SET WIDTH_MENU hodnota..;

SET DIAMETER_MENU hodnota..;

SET DRILL_MENU hodnota..;

SET SMD_MENU hodnota..;

SET SIZE_MENU hodnota..;

Druh èáry	SET WIRE_STYLE èíslo_druhu;

Zvuk zap/vyp	SET BEEP ON | OFF;

Nastavení zobrazení

Barva rastrových èar	SET COLOR_GRID barva;

Barva kreslící hladiny	SET COLOR_LAYER hladina barva;

Barva oblastí DRC	SET DRC_COLOR barva;

Druh šrafování hladiny	SET FILL_LAYER hladina výplò;

Parametry rastru	SET GRID_REDRAW ON | OFF;

SET MIN_GRID_SIZE pixely;

Min. velik. zobr. textu	SET MIN_TEXT_SIZE velikost;

Zobrazení èar sítí	SET NET_WIRE_WIDTH šíøka;

Zobrazení plošek	SET DISPLAY_MODE REAL | NODRILL | FAST;

SET PAD_NAMES ON | OFF;

Zobrazení sbìrnic	SET BUS_WIRE_WIDTH šíøka;

DRC parametry	SET DRC_SHOW ON | OFF;

SET DRC_FILL druh_výplnì;

SET MAX_ERROR_ZOOM hodnota;

Zpracování polygonù	SET POLYGON_RATSNEST ON | OFF;

Parametry módu

Kontrola vývodù pozder	SET CHECK_CONNECTS ON | OFF;

Parametry rastru	GRID volby;

Zpùsob zámìny	SET REPLACE_SAME NAMES | COORDS;

Zásobník historie zap/vyp	SET UNDO_LOG ON | OFF;

Optimalizace èar zap/vyp	SET OPTIMIZING ON | OFF;

Pøednastavení

Tvar pájecích plošek	CHANGE SHAPE tvar;

Šíøka èáry	CHANGE WIDTH hodnota;

Prùmìr plošky/prokovu	CHANGE DIAMETER prùmìr;

Prùmìr vrtáku	CHANGE DRILL hodnota;

Velikost SMD	CHANGE SMD šíøka výška;

Výška textu	CHANGE SIZE hodnota;

Síla èáry textu	CHANGE RATIO pomìr;

Parametr polygonu	CHANGE THERMALS ON | OFF;

Parametr polygonu	CHANGE ORPHANS ON | OFF;

Parametr polygonu	CHANGE ISOLATE vzdálenost;

Parametr polygonu	CHANGE POUR SOLID | HATCH;

Parametr polygonu	CHANGE SPACING vzdálenost;


Rychlý úvod

Pro rychlý start potøebujete znát více o následujících tématech:

•	Øídící panel a okna editoru

•	Použití pøíkazù editoru

•	Zadávání parametrù a hodnot

•	Kreslení schématu

•	Kontrola schématu

•	Vytvoøení desky ze schématu

•	Kontrola rozložení

•	Vytváøení knihovny souèástek

•	Použití autorouteru

•	Použití systémové tiskárny

•	Použití CAM procesoru

V pøípadì problémù kontaktujte prosím Technickou podporu.


Øídící panel a okna editoru

Ze Øídícího panelu mùžete otevøít schéma, desku, nebo okno editoru knihoven použitím souborového menu nebo kliknutím na ikonu.


Zadávání parametrù a hodnot

Parametry a hodnoty EAGLE mohou být zadávány na pøíkazovém øádku, nebo pohodlnìji z lišt parametrù, které se objevují po aktivaci pøíkazu. V tomto pøípadì je funkce prizpùsobivá, text nápovìdy nemusí pøesnì vysvìtlovat stejnou volbu z jiného místa programu.


Kreslení schémat

Vytvoøení souboru schématu

Pro vytvoøení schématu, kterému dáte vlastní jméno použijte pøíkazy File/New a Save.

Vyvolání rámeèku výkresu

Vyvolejte knihovnu FRAMES pomocí USE a umístìte rámeèek, který si vyberete pomocí ADD.

Umístìní symbolù

Vyvolejte pøíslušnou knihovnu pomocí USE a umístìte symboly (viz ADD, MOVE, DELETE, ROTATE, NAME, VALUE). Pokud nenajdete požadovanou souèástku, nadefinujte si novou pomocí editoru knihovny.

Kreslení sbìrnic

Sbìrnice se kreslí pøíkazem BUS. Podle jmen signálù které bude obsahovat mùžete pojmenovat sbìrnici pøíkazem NAME.

Kreslení sítí

Sítì pøedstavují vzájemná elektrická propojení schematických znaèek (symbolù). Vývody rùzných symbolù propojíte ve schématu navzájem pøíkazem NET. Køížící se sítì je možno vzájemnì propojit pøíkazem JUNCTION.


Kontrola schématu

K provedení elektrických kontrol schématu slouží pøíkaz ERC, který zkontroluje nepøipojené piny atd, zkraty k napájení apod. Použijte zprávy generované tímto pøíkazem k opravì chyb. Použijte pøíkaz SHOW k prohlédnutí kompletních sítí na obrazovce. Pokud je tøeba, použijte pøíkaz EXPORT pro vygenerování netlistu, pinlistu, nebo partlistu.


Vytvoøení desky ze schématu

Použitím pøíkazu BOARD nebo kliknutím na ikonu Pøepnutí_na_desku mùžete vygenerovat desku z nataženého schématu (pokud dosud neexistuje deska se stejným jménem).

Vèechny souèástky, spoleènì se vzájemným propojením v podobì vzdušných (gumových) spojù se objeví vedle prázdné desky spojù a jsou pøipraveny pro rozmístìní. Napájecí piny jsou automaticky propojeny na odpovídající zdroje napìtí (pokud nejsou sítí pøipojeny ve schématu).

Deska je se schématem propojena pomocí dopøednì-zpìtné anotace. Tento mechanismus zajistí, že schéma a deska si navzájem stále odpovídají. Pokud se provádí editace výkresu a má být aktivní dopøenì-zpìtná anotace, musí být nataženy souèasnì deska i schéma.

Nastavení obrysù desky a umístìní souèástek

Obrysy desky mohou být upraveny pomocí pøíkazù MOVE a SPLIT pøed umístìním libovolného pouzdra na desku. Až jsou rozmístìna všechna pozdra, použije se pøíkaz RATSNEST, který zoptimalizuje vzdušné spoje (najde nejkratší cesty).

Definování zakázaných prostor

Pokud je to požadováno, mohou se na desce definovat zakázané prostory pro autorouter pomocí pravoúhelníkù RECT, víceúhelníkùPOLYGON, nebo kruhù CIRCLE v kreslících hladinách tRestrict (vrchní strana), bRestrict (spodní strana), nebo vRestrict (zákaz prokovù). Pozn.: oblasti uzavøené èárami ve hladinì Dimension (obrysy desky) jsou rovnìž nepøístupné pro autorouter.

Taháhí spojù (Routing)

Pøi tahání spojù jsou vzdušné spoje pøemìòovány pomocí pøíkazu ROUTE na pevné vodivé cesty na desce. Tato èinnost mùže také vykonat automaticky Autorouter, pokud ho máte, nebo lze oba zpùsoby kombinovat.


Kontrola rozložení

Zkontrolujte rozložení spojù a pouzder (izolaèní vzdálenosti, zkraty, rastr rozmístìní) pøíkazem DRC a opravte chyby. Seznam chyb vyvoláte pøíkazem ERRORS. Pokud je potøebujete, vygenerujte net, part, nebo pin list pøíkazem EXPORT.


Vytváøení knihovny souèástek

Vytvoøení nové souèástky v knihovnì má 3 kroky. Musíte tyto kroky zachovat, protože navazují jeden na druhý.

Zaènìte otevøením knihovny. Použijte pøíkaz Open z menu File nebo pøíkaz New (nepoužívat pøíkaz USE).

Vytvoøení pozdra

Pouzdro (Package) je èástí souèástky (Device), která se pøenáší na desku.

Kliknìte na ikonu Edit Package a editujte nové pozdro napsáním jeho jména do pole New v dialogovém rámeèku.

Nastavte si odpovídající rastr vývodù pøíkazem GRID.

Umístìte odpovídající pájecí plošky pøíkazem PAD a pojmenujte je pøíkazem NAME.

Vložte texty >NAME a >VALUE pøíkazem TEXT do odpovídajících kreslících hladin (ukazují pak skuteèné jméno a hodnotu souèástky na desce v potisku) a nakreslete obrys souèástky pøíkazem WIRE v odpovídající kreslící hladinì (tPlace nebo bPlace - obrys z horní a dolní strany desky - lze pak použít pøi potisku desky).

Vytvoøení schematické znaèky

Schematická znaèka (dále nazývaná symbol) je èást souèástky, která se umís�uje do schématu.

Kliknìte na ikonu Edit Symbol a editujte novou znaèku napsáním jejího jména do pole New v dialogovém rámeèku.

Umístìte a pojmenujte vývody znaèky (dále nazývané piny) pøíkazy PIN a NAME a pøiøaïte pinùm parametry pøíkazem (CHANGE).

Vložte texty >NAME a >VALUE pøíkazem TEXT do odpovídajících kreslících hladin (ukazují pak skuteèné jméno a hodnotu souèástky ve schématu) a nakreslete obrysy symbolu pøíkazem (WIRE command) v pøíslušné kreslící hladinì.

Vytvoøení souèástky

Souèástky (Device) jsou "øídícími" èástmi celé souèástky v knihovnì a používají jak pouzdro, tak i jeden nebo více symbolù.

kliknìte na ikonu Edit Device a editujte novou souèástku napsáním jejího jména v poli New dialogového rámeèku.

Pøiøaïte souèástce pozdro pøíkazem PACKAGE.

Pøidejte do souèástky symbol(y) (hradla) pøíkazem ADD, mùžete pøidat tolik symbolù, kolik je libo.

Pøíkazem CONNECT definujte vzájemná propojení mezi piny symbolù a vývody (pady) pouzdra.

Uložte knihovnu na disk a nyní mùžete používat novou souèástku pøíkazem USE z editoru schémat nebo desky.


Øídící panel

Øídící panel je okno nejvyšší úrovnì v EAGLE. Jeho spouštìcí menu Vám poskytuje pøístup do všech hlavních oken a dialogových menu v programu.

File

Open	otevøe existující soubor nebo vytvoøí nový

Save project...	otevøe souborový dialog k uložení aktuálního projektu pod stejným nebo novým jménem

Save all	uloží všechny soubory modifikované editorem

CAM Processor	spustí CAM Procesor

Exit	ukonèí program

Window

List all...  Alt+0	zobrazí seznam všech otevøených oken

1 Schematic - ...	pøepne do okna èíslo 1

2 Board - ...	pøepne do okna èíslo 2

Options

Directories...	otevøe  dialog složek

Backup...	otevøe zálohovací dialog

User interface...	otevøe dialog uživatelského rozhraní

Help

General help	otevøe stránku hlavní nápovìdy

Contents	otevøe obsah nápovìdy

Control panel	otevøe stránku nápovìdy, kterou právì prohlížíte

Product registration	otevøe dialog registrace produktu

Product information	otevøe okno informací o produktu, které obsahuje podrobnosti o licenèních podmínkách

Ikony datových souborù

Ikony zobrazené v Øídícím panelu reprezentují rùzné datové soubory EAGLE. Mùžete použít dialog složek k definici, které složky mají zobrazovat své soubory.

Dvojité kliknutí na ikonu vyvolá okno editoru, které obsahuje soubor pod ikonou.

Kliknutí pravým tlaèítkem na ikonu vyvolá kontextové menu k této ikonì.

Pokud zvolíte ikonu CAM Processor Job (Práce Cam Procesoru), spustí se CAM Processor s tímto pracovním souborem.

Stavový øádek

Stavový øádek dole na øídícím panelu obsahuje krátké tipy pro volby spouštìcího menu, které je právì vybráno nebo celé jméno právì vybrané ikony.


Kontextová menu

Kliknutí na ikonu v Øídícím panelu pravým tlaèítkem myši otevøe kontextové menu, které umožní následující akce:

Open

Otevøe okno editoru s tímto souborem.

Print...

Vytiskne soubor na systémové tiskárnì. Další informace o použití tiskových dialogù najdete v kapitole Tisk na systémové tiskárnì. Pøíkaz Print... lze použít pouze pro desky, schémata, skripty a ULP.

Tisk souborù pomocí tohoto kontextového menu vytiskne vždy soubor tak, jak je uložen na disku a to dokonce i tehdy, když máte otevøeno okno s jeho modifikací! Použijte pøíkaz PRINT pro tisk výkresu z otevøeného okna editoru. Upozoròujeme, že polygony na deskách nejsou automaticky propoèítány, pokud se tiskne pomocí kontextového menu! Budou vykresleny pouze obrysy. Aby byly polygony vytištìny ve své finální podobì, musíte natáhnou výkres do okna editoru, zadat pøíkaz RATSNEST a pak PRINT.

Copy...

Otevøe souborový dialog ve kterém mùžete zadat jméno souboru do kterého se pøekopíruje tento soubor.

Rename...

Otevøe souborový dialog ve kterém mùžete zadat nové jméno pro tento soubor.

Delete

Smaže soubor (budete požádáni o potvrzení, že to skuteènì chcete udìlat).

Help

Ukáže tyto stránky nápovìdy.


Složky (Adresáøe)

Dalog složek se používá pro definování cest ke složkám, ve kterých se mají hledat soubory.

Složka Design je základní pracovní složkou, která obsahuje desky a schémata.

Cesty Libraries ke knihovnám, Scripts ke skript souborùm, ULPs k programùm ULP a CAM Jobs k úlohám Cam Procesoru mohou obsahovat nìkolik složek (oddìlených støedníkem), ve kterých jsou hledány soubory knihoven, skriptù, programù ULP nebo úlohy CAM Procesoru. Pokud zadáte pøíkazy OPEN, USE, SCRIPT nebo RUN, na tìchto cestách budou hledány zleva doprava pøíslušné soubory.

Show

Pøíkaz Show zkouší ovládací rámeèky, zda v urèité složce nebo cestì jsou soubory zobrazeny jako ikony v Øídícím panelu.

Include

Nastavení Include na All znamená, že všechny soubory nalezené ve složkách cest Libraries, Scripts, ULPs a CAM Jobs budou zobrazeny (pokud je pøíkaz Show vyzkouší na této èásteèné cestì). Nastavení na First znamená, že budou zobrazeny pouze soubory nalezené v první složce ze všech cest, které byly zobrazeny. Skrytou myšlenkou je zde to, že první složka v urèité cestì je obvykle pracovní složkou (t.j. ta stejná, jaká je v poli Design), ostatní nebudou editovány a proto nemusejí být zobrazeny v Øídícím panelu.

Sort

Ikony zobrazené v Øídícím panelu mohou být tøídìny podle jména Name nebo podle druhu Type.


Backup

Dialog Backup Vám umožòuje pøizpùsobit funkci automatického zálohování.

Maximum backup level

Definuje, kolik záložních kopií Vašich datových souborù EAGLE má být udržováno (pøednastaveno je 9).

Automatically save project file

Pokud je zatržena tato volba, Váš projekt bude automaticky uložen, pokud opustíte program, pøedpokladem je, že jste vytvoøili soubor projektu buï pomocí pøíkazù File/Open/Project... nebo Options/Save as... z Øídícího panelu.

Standardnì je EAGLE nastaven na prázdný soubor projektu nazvaný EAGLE.EPF, takže nastavení Vaší pracovní plochy je ukládáno automaticky.


User Interface (Uživatelské rozhraní)

Nastavení User interface Vám umožòuje zvolit zpùsob zobrazování v oknech editoru desky, schématu a knihoven. Zmìny tìchto nastavení se projeví až v novì otevøených oknech!

Controls (Ovládání)

Pulldown menu	aktivuje otevírací menu na horní stranì okna editoru

Action toolbar	aktivuje ovládací lištu obsahující tlaèítka pro "Soubor", "Tisk" atd.

Parameter toolbar	aktivuje promìnnou uvládací lištu, která obsahuje všechny parametry, dostupné pro právì aktivní pøíkaz

Command line toolbar	aktivuje lištu s pøíkazovým øádkem

Command menu (Pøíkazová nabídka)

None	vypne pøíkazová menu (pøíkazy musí být zvoleny buï z otevíracího menu nebo zadávány z pøíkazového øádku)

Texts	aktivuje textové pøíkazové menu na pravé stranì okna editoru

Buttons	aktivuje tlaèítkové menu na levé stranì okna editoru

Layout (Editor desky)

Black background	zvolí èerné pozadí výkresu s deskou

White background	zvolí bílé pozadí výkresu s deskou

Schematic (Editor schémat)

Black background	zvolí èerné pozadí výkresu se schématem

White background	zvolí bílé pozadí výkresu se schématem

Help (Nápovìda)

Bubble help	aktivuje "bublinovou" nápovìdu s krátkými tipy k významu tlaèítek, pokud se na nì najede myší

User guidance	aktivuje funkci "Prùvodce", která zobrazuje nápovìdu, øíkající uživatelovi, co by mohla být další smysluplná akce po právì aktivním pøíkazu


Klávesnice a myš

Klávesnice

Stisk klávesy ESC bìhem aktivity pøíkazu zruší probíhající aktivitu pøíkazu ale nezruší pøíkaz samotný.

Napøíklad u pøíkazu MOVE to znamená, že pøenášený objekt, visící na kurzoru je upuštìn na své pùvodní místo a mùže být zachycen jiný objekt.

Tlaèítka myši

Levé tlaèítko myši se používá pro všechny akce, které nejsou uvedeny v následujících tabulkách.

Použití prostøedního tlaèítka tøítlaèítkové myši

ARC	Zmìna aktivní hladiny

CIRCLE	Zmìna aktivní hladiny

LABEL	Zmìna aktivní hladiny

POLYGON	Zmìna aktivní hladiny

RECT	Zmìna aktivní hladiny

ROUTE	Zmìna aktivní hladiny

SMD	Zmìna aktivní hladiny

TEXT	Zmìna aktivní hladiny

WIRE	Zmìna aktivní hladiny

ERRORS	Vymaže chyby z nabídky

Pokud se neobjeví nabídka aktivní hladiny po stisku prostøedního tlaèítka u výše uvedných pøíkazù, není nainstalován správný ovladaè myši. V takovém pøípadì použijte pøíkaz LAYER.

(Pozn.: Windows95/98/NT standardnì neznají prostøední tlaèítko myši. Ovladaè je nutno nainstalovat z diskety dodané výrobcem myši. S vìtšinou rùzných myší dobøe spolupracují ovladaèe dodávané s myškami Genius, napø. Genius Netscroll pro Windows95/NT. Poslední verze tìchto ovladaèù lze získat z Internetu http://www.winfiles.com).

Použití pravého tlaèítka myši

GROUP	Uzavøe mnohoúhelník (polygon)

ADD	Otáèí prvek

INVOKE	Otáèí symbol (hradlo)

LABEL	Otáèí text

MOVE	Otáèí prvek

PAD	Otáèí pájecí plošku (pad)

PIN	Otáèí vývod symbolu (pin)

PASTE	Otáèí kopírovací zásobník

ROTATE	Otáèí skupinu

SMD	Otáèí plošku SMD

TEXT	Otáèí text

ARC	Mìní smìr oblouku

MIRROR	Zrcadlí skupinu

POLYGON	Mìní druh èáry

ROUTE	Mìní druh èáry

SPLIT	Mìní druh èáry

WIRE	Mìní druh èáry


Výbìr objektù v hustých oblastech

Pokud se snažíte vybrat objekt v místì, kde je nìkolik objektù naplácáno na sobì nebo velmi blízko, zmìní se kurzor na køíž se ètyømi šipkami a objeví se dotaz

select highlighted object? (left=yes, right=no) (tj.: Vybrat zvýraznìný objekt? (levé=ano, pravé=ne).

Stisknete-li pravé tlaèítko myši, bude Vám nabídnut další objekt.

Stiskem levého tlaèítka zvolíte zvýraznìný objekt.

Takto si mùžete vybrat jeden z tìchto objektù.

Stskem Esc zrušíte proceduru nabízení.

Pøíkaz

SET Select_Factor prùmìr;

definuje velikost aktivní oblasti pøi výbìru.


Editor Windows

EAGLE rozlišuje rùzné druhy datových souborù, z nichž každý má svùj vlastní typ editovacího okna. Dvojkliknutím na jednu z ikon v Øídícím panelu nebo výbìrem souboru z nabídky File/Open je otevøeno okno vhodné pro zvolený soubor.

•	Editor knihoven

•	Editor schémat

•	Editor desek

•	Editor textù


Editor knihoven

Editor knihoven se používá pro editování knihovních prvkù v souborech typu (*.LBR).

Po otevøení nového editovacího okna knihovny je editovací oblast prázdná a musíte použít pøíkaz  EDIT k výbìru, které pozdro, symbol nebo souèástku chcete editovat nebo vytvoøit.


Editování objektu v knihovnì

V módu editace knihovny mùžete editovat pouzdra, symboly, a souèástky.

Package: definování pouzdra.

Symbol: symbol (schematická znaèka), která se objeví ve schématu.

Device: definice celé souèástky. Obsahuje jedno pouzdro a jeden nebo více symbolù (neboli hradel - Gates). Symboly mohou být rùzné.

Kliknìte na jedno z tlaèítek Dev, Pac nebo Sym a vyberte si souèástku, pouzdro nebo symbol.

Pokud chcete vytvoøit nový objekt, napište jeho jméno do políèka New. Mùžete také editovat již existující objekt napsáním jeho jména do tohoto pole. pokud neuvedete pøíponu jména (to co je za teèkou), bude nataženo to, co je indikováno pomocí Choose... Jinak je natažen objekt podle své pøípony.

Pokud Vaše licence neobsahuje modul schémat, tlaèítka typu objektu (Dev...) se v menu neobjeví.


Editor desky

Editor desky se používá pro úpravy deseky plošného spoje (*.BRD).

Pokud existuje (ve stejné složce) stejnojmenný soubor se schématem (*.SCH), otevøení okna editoru desky automaticky otevøe také okno Editoru schémat, obsahující tento soubor a umístí ho na pracovní plochu jako ikonu. Je nezbytné mít souèasnì natažen soubor se schématem bìhem editace desky, aby mohly být zmìny na desce zpìtnì anotovány ve schématu.


Editor schémat

Editor schémat se používá pro úpravy schématu (*.SCH).

 Pokud existuje (ve stejné složce) stejnojmenný soubor s deskou (*.BRD), otevøení okna editoru schématu automaticky otevøe také okno Editoru desky, obsahující tento soubor a umístí ho na pracovní plochu jako ikonu. Je nezbytné mít souèasnì natažen soubor s deskou bìhem editace schématu, aby mohly být zmìny ve schématu anotovány dopøedu v desce.

Kombinované tlaèítko v pruhu akcí okna editoru schémat Vám umožní pøepínat mezi rùznými listy schématu, nebo pøidat nové listy schématu. (To lze také provést pomocí pøíkazu EDIT).


Textový editor

Textový editor se používá pro úpravy libovolného druhu textu.

Text musí být èistý soubor ASCII a nesmí obsahovat žádné øídící kódy. Hlavní oblast použití textového editoru je psaní programù v uživatelsém jazyku a skriptových souborù, nebo zobrazení výsledkù kontroly elektrických pøedpisù.


Dialog o souborech

Výbìr cesty a souboru

Zadejte cestu a jméno souboru do pole Name a kliknìte na tlaèítko OK.

Vyberte urèitý druh souboru tlaèítky "Board" (deska) a "Schematic" (schéma), pokud jsou k dispozici. Objeví se v oknì souborù a mohou být vybrány myší.

"Directory list" (seznam složek) Vám umožòuje pøechod do jiných složek. Znak "\" znamená koøenovou složku, øetìzec ".." pøedstavuje nadøazenou složku.

Kombinované okno Path obsahuje složky, které byly specifikovány v dialogu "Options/Directories".

každá volba musí být potvrzena talèítkem OK nebo musíte položku vybrat dvojím kliknutím.

Tlaèítka mohou být "stisknuta" z klávesnice stiskem "horké klávesy" (podtržené písmeno).

Cancel nebo Esc ukonèují dialog o souborech a uzavírají okno.

Pokud jsou k dispozici, tlaèítka "LPT" a "COM" otevírají menu pro výbìr výstupního kanálu.


Pøíkazy editoru

Pøíkazy EAGLE a jejich význam

Pøíkazy pro zmìnu módu/souboru

EDIT	Natáhne/vytvoøí knihovní prvek

WRITE	Uloží výkres/knihovnu

OPEN	Otevøe knihovnu pro editování

CLOSE	Uzavøe knihovnu po editování

QUIT	Ukonèí EAGLE

EXPORT	Vytvoøí textový seznam v ASCII (napø. netlist)

SCRIPT	Provede pøíkazový soubor

USE	Vybere knihovnu pro umís�ování prvkù

DIR	Ukáže složky na disku/položky v knihovnì

REMOVE	Vymaže soubor/knihovní prvek

Vytváøení/úpravy výkresù nebo knihoven

ARC	Kreslí oblouk

CIRCLE	Kreslí kružnici

POLYGON	Kreslí mnohoúhelník (polygon)

RECT	Kreslí pravoúhelník

WIRE	Kreslí èáru nebo položený spoj

TEXT	Píše text do výkresu

ADD	Pøidává prvek do výkresu/znaèku do souèástky

COPY	Kopíruje objekty/prvky

GROUP	Definuje skupinu pro následující operaci

CUT	Uloží døíve definovanou skupinu do zásobníku

PASTE	Vytáhne døíve uloženou skupinu ze zásobníku

DELETE	Smaže objekt

MIRROR	Zrcadlí objekt

MOVE	Pøesune (pøípadnì také otoèí) objekt

ROTATE	Otoèí objekt

NAME	Pojmenuje objekt

VALUE	Vloží/zmìní hodnotu souèástky

SMASH	Uvolní texty NAME/VALUE pro pøesunutí

SPLIT	Tvaruje èáry (cesty, sítì, apod.)

LAYER	Vytvoøí/zmìní hladinu

Zvláštní pøíkazy pro desky

SIGNAL	Definuje signál (vzdušný spoj)

ROUTE	Pokládá spoj

RIPUP	Zvedá položený spoj (celý signál)

DELETE	Zvedá položený spoj (jeden segment)

VIA	Umís�uje díru s prokovem

HOLE	Umís�uje díru bez prokovu

RATSNEST	Nalezne nejkratší vdušné spoje

REPLACE	Nahradí pouzdro

DRC	Provede kontoly podle geometrických pravidel

ERRORS	Ukáže chyby nalezené DRC

Zvláštní pøíkazy pro schémata

NET	Definuje sí� (signál)

BUS	Kreslí sbìrnici

JUNCTION	Umístí propojovací bod

INVOKE	Pøidá vybrané 'hradlo' z již umístìné souèástky

LABEL	Pøidá oznaèení sbìrnici nebo sítì

GATESWAP	Prohodí zámìnná 'hradla'

PINSWAP	Prohodí zámìnné vývody (piny)

ERC	Provede kontolu dodržení elektrických pravidel

BOARD	Vytvoøí desku ze schématu

Zvláštní pøíkazy pro knihovny

RENAME	Pøejmenuje znaèku/pouzdro/souèástku

CONNECT	Definuje pøiøazení pin/pad (vývod znaèky s vývodem pouzdra)

PACKAGE	Definuje pouzdro souèástky

PREFIX	Definuje pøedvolený prefix oznaèení souèástky

VALUE	Definuje, je-li možno mìnit text hodnoty souèástky

PAD	Pøidá pájecí plošku (pad) k pouzdru

SMD	Pøidá plošku smd k pouzdru

PIN	Pøidá vývod (pin) ke schematické znaèce

HOLE	Definuje neprokovenou díru

REMOVE	Maže knihovní prvky

Zmìna nastavení obrazovky a uživatelského rozhraní

WINDOW	 Vybere okno

DISPLAY	Zobrazí/ukryje hladiny

ASSIGN	Pøiøadí funkèní klávesy

CHANGE	Mìní parametry

GRID	Definuje rastr/jednotky

MENU	Nastaví menu pøíkazù

SET	Nastaví parametry programu

Rùzné pøíkazy

AUTO	Spustí autorouter

HELP	Ukáže stránky s nápovìdou

INFO	Ukáže informace o objektu

MARK	Nastaví/vyjme znaèku (pro odmìøování)

OPTIMIZE	Optimalizuje (spojí) segmenty èar

RUN	Spustí program uživatele (ULP)

SHOW	Zvýrazní objekt

UNDO	Vrátí pøíkazy (krok zpìt)

REDO	Znovu provede pøíkazy (krok vpøed)

PRINT	Tiskne na systémové tiskárnì


Syntaxe pøíkazù

Syntaxe pøíkazù

Pøíkazy EAGLE mohou být zadány rùzným zpùsobem:

•	klávesnicí jako text

•	myší vybráním položky menu nebo kliknutím na ikonu

•	funkèními klávesami (viz pøíkaz ASSIGN)

•	pøíkazovými soubory (viz pøíkaz SCRIPT)

Všechny tyto zpùsoby mohou být kombinovány.

Pøíkazy a parametry psané VELKÝMI PÍSMENY jsou zadávány pøímo (nebo vybrány v pøíkazovém menu myší). Pro vstup pøíkazù nezáleží na malých nebo velkých písmenech.

Parametry psané malými písmeny se nahradí jmény, èíselnými hodnotami nebo klíèovými slovy. Pøíklad:

Syntaxe:	GRID grid_size grid_multiple;

Vstup:	GRID 1 10;

Zkracování klíèových slov

Pro pøíkazy a jiná klíèová slova je nutno zadat pouze tolik prvních písmen, aby mohly být odlišeny od ostatních klíèových slov.

Volitelné parametery

Oznaèení | znamená že mohou být zadány rùzné uvedené parametry. Pøíklad:

Syntaxe:	SET BEEP ON | OFF;

Vstup:	SET BEEP ON;

nebo

SET BEEP OFF;

Opakovací teèky

Oznaèení .. znamená že funkce mùže být vykonána nìkolikrát nebo je povoleno zadat nìkolik parametrù stejného typu. Pøíklad:

Syntaxe:	DISPLAY option layer_name..

Vstup:	DISPLAY TOP PINS VIAS

Souøadnice

Oznaèení • normálnì znamená že objekt má být na tomto místì pøíkazu vybrán kliknutím levého tlaèítka myši. Pøíklad:

Syntaxe:	MOVE • •..

Vstup:	MOVE

Kliknutí myší na první objekt k pøesunu

Kliknutí myší na cílovou pozici

Kliknutí myší na druhý objekt k pøesunu

atd.

Tento pøíklad také vysvìtluje význam opakovacích teèek pro pøíkazy s klikáním myší.

Program chápe každé kliknutí myší jako zadání souøadnic. Pokud je žádoucí zadat souøadnice jako text, zadání z klávesnice musí vypadat následovnì:

(x y)

x a y jsou èísla v jednotkách pøedem zvolených pøíkazem GRID. Vstup v textové podobì je pøedevším požadován ve skriptových souborech.

Pøíklad pro zadání souøadnic jako text. Pøejete si zadat pøesné rozmìry obrysu desky:

GRID 1 MM;
CHANGE LAYER DIMENSION;
WIRE 0 (0 0) (160 0) (160 100) (0 100) (0 0);
GRID LAST;

Støedník

Støedník (';') ukonèuje pøíkazy. Pøíkaz musí být zakonèen støedníkem pokud následuje ménì než maximální poèet volitelných položek. Napøíklad pøíkaz

WINDOW;

obnoví kreslící plochu, zatímco

WINDOW FIT

zmìní velikost výkresu tak, aby se vešel celý do kreslícího okna. Tentokrát není støedník nutný, protože je jasné, že pøíkaz je kompletní.


ADD

Funkce

Pøenáší prvky z knihoven do výkresu.
Pøidává schematickou znaèku do souèástky.

Zápis

ADD jméno_pouzdra 'jméno' orientace •..
ADD jméno_souèástky 'jméno' orientace •..
ADD jméno_znaèky 'jméno' volby •..

Myš

Pravé tlaèítko otáèí prvkem.

Viz také USE

Pøíkaz ADD zkopíruje symbol (hradlo) nebo pouzdro z aktivní knihovny a umístí ho do výkresu. Knihovna musí být nejprve aktivována pøíkazem USE.

Pøi definování souèástky v knihovnì pøidá pøíkaz ADD schematickou znaèku do souèástky.

Obvykle kliknete na pøíkaz ADD a vyberete pouzdro nebo symbol z menu, které se otevøe. Pokud je to potøeba, je nyní možno vložit parametry z klávesnice.

Pouzdro nebo symbol se umís�uje levým tlaèítkem a otáèí pravým tlaèítkem. Po jeho umístìní visí na kurzoru okamžitì jeho další kopie.

Vložení pouzdra nebo symbolu do výkresu

Jména

Parametry jméno_pouzdra, jméno_souèástky nebo jméno_symbolu jsou jména, pod kterými jsou knihovní prvky v knihovnì uloženy. Obvykle se vybírají z menu. Parametr 'jméno' je jméno, které má prvek dostat ve výkresu. Musí být uzavøen v apostrofech. Pokud jméno není explicitnì zadáno, je pøidìleno automaticky generované jméno.

Pøíklad:

ADD DIL14 'IC1' •

vloží pouzdro DIL14 na desku a dá mu jnméno IC1.

Pokud ve schématu není pøidìleno jméno, symbol dostane prefix, který byl specifikován pøi definování souèástky pomocí PREFIX, rozšíøený o poøadové èíslo (napø. IC1).

Pøíklad:

ADD 7400 • • • • •

umístí sérii hradel ze souèástek typu 7400. Protože prefix je definován jako "IC" a jednotlivá hradla v 7400 mají jména A..D, hradla budou ve schématu pojmenována IC1A, IC1B, IC1C, IC1D, IC2A. (Pokud prvky se stejným prefixem jsou vyèerpány, pokraèuje se s prefixem s dalším poøadovým èíslem.) Viz také INVOKE.

Orientace </p> Tento parametr urèuje orientaci knihovního prvku na výkrese. Prvkem lze normálnì otáèet pomocí pravého tlaèítka myši. Ve skriptových souborech se používá textový popis tohoto parametru:

Použitelné orientace jsou:

R0	bez otoèení

R90	jedno otoèení (90 stupòù proti smìru hodinových ruèièek)

R180	dvì otoèení (180 stupòù)

R270	tøi otoèení

MR0	zrcadlení kolem osy y

MR90	jedno otoèení a zrcadlení kolem osy y

MR180	dvì otoèení a zrcadlení kolem osy y

MR270	tøi otoèení a zrcadlení kolem osy y

Standardnì: R0

Pøíklad:

ADD DIL16 R90 (0 0);

umístí 16-vývodové pouzdro DIL, otoèené o 90 stupòù vlevo na souøadnice (0 0).

Chybová hlášení

Chybové hlášení se objeví tehdy, pokud je hradlo vybíráno ze souèástky, která není plnì definována (viz pøíkaz BOARD). Tomu lze pøedejít použitím pøíkazu"SET CHECK_CONNECTS OFF;". Ale pozor: Pøíkaz BOARD provede tuto kontrolu v každém pøípadì. Jeho vypnutí na off má smysl pouze když se nemá vyrábìt deska.

Vložení symbolu do souèástky

Pøi definování souèástky pøíkaz ADD vkládá pøedem definovaný symbol do souèástky. Jsou povoleny dva parametry (swaplevel a addlevel), a tyto mohou být vloženy v libovolném poøadí. Oba mohou být pøednastaveny a mìmìny pøíkazem CHANGE. Hodnota vložená s pøíkazem ADD se také stává pøednastavenou.

Swaplevel

Swaplevel je èíslo v rozsahu 0..255, pro které platí následující pravidla:

0:	Symbol (hradlo) nemùže být prohozen(o) s žádným jiným ve schématu.

1..255	Symbol (hradlo) mùže být prohozen(o) ve schématu s kterýmkoli jiným symbolem stejného typu který má stejné èíslo swaplevel (vèetnì prohození mezi rùznými souèástkami).

Standardnì: 0

Addlevel

Pro tento parametr jsou pøípustné následující možnosti:

Next: Pokud souèástka obsahuje více než jedno hradlo, symboly jsou do schématu vkládány s Addlevel Next.

Must: Pokud nìkterý symbol ze souèástky je vložen do schématu, pak se souèasnì objeví symbol definovaný s Addlevel Must. To se stane automaticky. Tento symbol nemùže být smazán, dokud nejsou smazány všechny ostatní symboly ze souèástky. Pokud ze souèástky zùstaly už jen symboly Must, pøíkaz DELETE smaže celou souèástku.

Always: Jako Must, ale pøesto symbol s Addlevel Always mùže být smazán a vložen zpìt do schématu pomocí pøíkazu INVOKE.

Can: Pokud souèástka obsahuje hradla Next, pak se hradla Can pøidávají do schématu pouze zvláštním zavoláním pomocí pøíkazu INVOKE. Symbol s Addlevel Can mùže být vyvolán do schématu pøíkazem ADD pouze tehdy, když souèástka obsahuje pouze hradla Can a Request.

Request: Tato možnost se používá u napájecích symbolù souèástek. Hradla Request mohou být vyvolána do schématu pouze explicitním zavoláním (pøíkaz INVOKE) a vnitønì se nepoèítají. Efekt je v tom, že v souèástkách s pouze jedním hradlem a jedním napájecím symbolem není jméno hradla není pøidáno do jména souèástky. V pøípadì 7400 se ètyømi hradly (plus napájecí zdroj) jsou jednotlivá hradla ve schématu nazývána napø.: IC1A, IC1B, IC1C and IC1D. V souèástce 68000 s pouze jedním hradlem, mùže být symbol procesoru nazýván IC1, protože jeho samostatný napájecí symbol není považován za hradlo.

Pøíklad:

ADD PWR 0 REQUEST •

vyvolá PWR symbol (t.j. symbol napájecích vývodù), a definuje pro nìho Swaplevel 0 (neprohoditelný) a Addlevel Request.


ARC

Funkce

Kreslí oblouk s volitelným polomìrem, šíøkou a délkou.

Zápis

ARC • • •
ARC šíøka • • •
ARC CW šíøka • • •
ARC CCW šíøka • • •

Myš

Pravé tlaèítko mìní orientaci.
Støední tlaèítko mìní aktivní hladinu.

Viz také CHANGE, WIRE, CIRCLE

Pøíkaz ARC, následovaný tøemi kliknutími myši na výkrese kreslí oblouk definované šíøky. První bod stanoví bod na kružnici, druhý její prùmìr. Zadání druhé souøadnice omezí kružnici na polokruh, pøièemž pravé talèítko mìní smìr z prvního na druhý bod. Zadání tøetí souøadnice omezí polokruh na oblouk tažený do bodu definovaného prùseèíkem obvodu a èáry mezi tøetím bodem a støedem oblouku.

Parametry CW a CCW umožòují volbu smìru oblouku textovì. Je to užiteèné ve skriptových souborech.

CW: Smìr oblouku ve smìru hodinových ruèièek
CCW: Smìr oblouku proti smìru hodinových ruèièek

Šíøka èáry

Parametr "width" urèuje šíøku kreslené èáry. Mùže být mìnìn nebo pøeddefinován pøíkazem:

CHANGE WIDTH šíøka;

Nastavená šíøka je stejná také pro šíøku všech rovných èar.

Oblouky s úhly 0 nebo 360 stupòù nebo polomìrem 0 nejsou pøípustné.

Oblouky nejsou považovány za èásti signálù, proto nejsou kontrolovány funkcí DRC.

Pøíklad pro textové zadání:

GRID inch 1;
ARC CW (0 1) (0 -1) (1 0);

vytvoøí 90-stupòový oblouk se støedem v poèátku.


ASSIGN

Funkce

Pøiøadí funkèní klávesy

Zápis

ASSIGN
ASSIGN funkèní_klávesa pøíkaz..;
ASSIGN funkèní_klávesa;

funkèní_klávesa: F1..12, (Shift)F1..12, (Ctrl)F1..12, (Alt)F1..12

Viz také SCRIPT

Pøíkaz ASSIGN se používá pro definování významu funkèních kláves (také v kombinaci se Shift, Alt, a Ctrl). Funkèní klávese mùže být pøiøazen jeden pøíkaz nebo více pøíkazù. Posloupnost pøíkazù k pøiøazení musí být uzavøena v apostrofech.

Upozoròujeme, že pøíkaz ASSIGN pøepíše vìtšinu speciálních funkcí pøiøazených funkèním klávesám operaèním systémem. (Podle nastavení operaèního systému se mùže stát, že nìkterá funkèní klávesa nemusí jít pøíkazem ASSIGN pøepsat).

Pro vyjmutí pøiøazení k funkèní klávese mùžete zadat ASSIGN pouze se zadáním funkèní klávesy ale bez pøíkazu.

Pøíklady

ASSIGN F7 'change layer top; route';
ASS AF7 'cha lay to; rou';
ASSIGN SF10 menu add mov rou ''';''' edit;

První dva pøíklady udìlají totéž, protože EAGLE umožòuje zkracování nejen pøíkazù, ale také parametrù (do té míry, aby nešly zamìnit).

Upozoròujeme, že zde napøíklad pøíkaz change layer top je ukonèen støedníkem, ale pøíkaz route ne. Dùvod je v tom že v prvním pøípadì pøíkaz již obsahuje všechny nezbytné parametry zatímco v druhém pøípadì se stále èeká na zadání souøadnic (obvykle myší). Proto pøíkaz ROUTE nemusí být ukonèen støedníkem.

Poèáteèní nastavení

Pøíkaz ASSIGN bez parametrù zobrazí souèasné pøiøazení funkèních kláves v oknì, které Vám souèasnì umožní tato nastavení mìnit.

Pøednastavení funkèních kláves

F1     HELP	Funkce nápovìdy

Alt-F1 HELP	Úvod do nápovìdy

Alt-F2 WINDOW FIT	Zobrazení celého výkresu

F2     WINDOW;	Pøekreslení obrazovky

F3     WINDOW 2	Zvìtšení 2x

F4     WINDOW 0.5	Zmenšení 2x

F5     WINDOW (@);	Nový støed na pozici kurzoru

F6     GRID;	Rastr zap/vyp

F7     MOVE	Pøíkaz MOVE

F8     SPLIT	Pøíkaz SPLIT

F9     UNDO	Pøíkaz UNDO

F10    REDO	Pøíkaz REDO

Další kombinace kláves (nemohou být použity s ASSIGN)

Alt-Space	Otevírá systémové menu

Šipka nahoru	listuje historií pøíkazù

Šipka dolù	listuje historií pøíkazù

Definování pøíkazového menu

Pokud chcete pøíkaz MENU pøiøadit funkèní klávese, oddìlovací znak v pøíkaze MENU (støedník) musí být uzavøen ve dvojici apostrofù (viz tøetí pøíklad). Tento støedník se pak objeví v novém menu.


AUTO

Funkce

Spustí Autorouter

Zápis

AUTO;
AUTO jméno_signálu..;
AUTO ! jméno_signálu..;
AUTO •..;

Klávesnice

Ctrl-Break pøeruší autorouter.

Viz také SIGNAL, ROUTE, WIRE, RATSNEST, SET

Pøíkaz AUTO aktivuje vestavìný Autorouter. Pokud jsou zadána jména signálù nebo jsou signály vybrány myší, jsou zpracovány pouze tyto signály. Pokud nejsou signály zadány, pøíkaz se pokusí natáhnout všechny signály. Pokud je zadán znak "!" , jsou pokládány všechny signály kromì signálù vyjmenovaných za znakem "!" . Znak "!" musí být prvním parametrem a mùže se vyskytovat pouze jednou.

Pøíklad

AUTO ! GND VCC;

V každém pøípadì je nutný støedník jako ukonèovaè. Menu pro nastavení øídících parametrù Autorouteru se objeví pokud zvolíte AUTO z pøíkazového menu nebo napíšete AUTO z klávesnice (následované klávesou Enter).

Pokud je Autorouter aktivní, lze ho pøerušit stisknutím Ctrl-Break.

Menu autorouteru se objeví po zadání AUTO (bez støedníku). Pak mùžete nastavit parametry a spustit pokládání spojù. Automaticky je generován pracovní soubor (job file - jméno.JOB) a øídící soubor (control file - jméno.CTL). Tyto soubory jsou nutné pokud chcete pokraèovat v pøerušeném bìhu pokládání spojù pozdìji. Pokud nechcete spustit pokládání, mùžete vytvoøit tyto soubory pomocí "Create Job".

Na levé stranì menu mùžete zadat preferované smìry pro každou vrstvu (první vstup) a jejich základní váhy (druhý vstup). Pokud nechcete aby Autorouter používal vrstvu, zadáte "0" do pole preferovaných smìrù.

Všechny parametry jsou "obecné" vyjma skupin váh "Costs" a limitù "Maximum" které mohou být odlišné pro každý prùchod pokládání.

Jednotlivé prùchody jsou vybírány nebo rušeny kliknutím na zatrhávací èvereèek vpravo. Prùchod "Route" nemùže být zrušen. Aktivní jenotka rastru platí pro všechny hodnoty.

Polygony (Mnohoúhelníky)

Když je Autorouter spuštìn, jsou propoèítány a zobrazeny všechny Polygony kromì tìch, které jsou souèástí signálù, které nemají být pokládány ("AUTO ! jméno_signálu..;").

Zálohovací a protokolovací soubory

Když skonèí práce autorouteru, zpracovaná deska je automaticky uložena pod názvem JMÉNO.B$$. Pokud deska není uložena pøíkazem WRITE (napø. po výpadku el. proudu) tento soubor mùže být pøejmenován a natažen jako normální soubor desky.

Protokolovací soubor (jméno.pro) je generován automaticky.

Velikost desky

Autorouter si stanoví pravoúhelník ve hladinì Dimension do kterého uzavøe všechny spoje, se kterými má pracovat a stanoví velikost tohoto pravoúhelníku jako pokládací prostor. Èáry (cesty) ve hladinì Dimension jsou pro autorouter hranièní, neprùchodné. To znamená že mùžete omezit prostor pokládání uzavøenými polygony kreslenými pøíkazem WIRE ve hladinì Dimension.

V praxi nakreslíte obrysy desky do hladiny Dimension pomocí pøíkazu WIRE a umístíte souèástky do této oblasti.

Signály

Signály definované v EAGLE pøíkazem SIGNAL, polygony a èáry nakreslené ve hladinách Top, Bottom, a ROUTE2...15 jsou rozpoznány autorouterem.

Upuzoròujeme, že autorouter nemùže umís�ovat prùchody (vias) na zaplnìné plochy propoèítaných polygonù. Polygony obsahující napøíklad plochy zemního potenciálu by proto mìly být umístìny až poté, co jsou všechny ostatní signály položeny (kromì signálu zem).

Zakázané oblasti

Pravoúhelníky, polygony, a kruhy ve hladinách tRestrict, bRestrict, a vRestrict jsou považovány za zakázané oblasti pro stranu Top (vrch) a Bottom (spodek), pøípadnì také pro prokovy (vias).

Pokud nechcete, aby autorouter používal urèitou vrstvu, zadejte "0" do pole preferovaných smìrù.


BOARD

Funkce

Pøevádí schéma na desku.

Zápis

BOARD

Viz také EDIT

Pøíkaz BOARD se používá k vytvoøení výkresu desky z výkresu schématu.

Pokud deska již existuje, bude natažena do okna desky.

Pokud deska neexistuje, budete dotázaáni, zda chcete vytvoøit novou desku.

Pøíkaz BOARD nikdy nepøepíše kiž existující soubor desky. Pøed vytvoøením souboru desky se jménem, které již existuje musíte nejdøíve vymazat pùvodní soubor.

Vytvoøení desky ze schématu

Když poprvé editujete desku, program hledá, zda je ve stejné složce schéma se stejným názvem a dá Vám na výbìr, zda chcete vytvoøit desku z tohoto schématu.
Pokud mmáte otevøeno okno se schématem a chcete vytvoøit desku, staèí napsat

edit .brd

na pøíkazovém øádku okna editoru.

Všechny platné údaje ze souboru schémat (jméno.SCH) budou pøevedeny do souboru desky (jméno.BRD). Nová deska se natáhne automaticky jako prázdná karta (DPS) o velikosti 160x100mm (Verze Light: 100x80mm), kde obrysy jsou umístìny tak, že deska je centována mezi rastrem 50 mil. Všechna pozdra a spoje jsou zobrazeny na levé stranì desky. Napájecí vývoddy jsou již zapojeny (viz pøíkaz PIN).

Pokud si pøejete jiné rzmìry desky, než pøednastavené, jednoduše smažte nežádoucí èáry použijte pøíkaz WIRE k nakreslení nových obrysù ve hladinì Dimension. Doporuèená šíøka tìchto èar je 0.

Soubor desky nemùže být vytvoøen:

•	pokud jsou ve schématu symboly, pro nìž není v knihovnì definováno pouzdro (chybové hlášení: "device name has no package"). Vyjímka: pokud symbol má pouze vývody s Direction "Sup" (napájecí symboly)

•	pokud jsou ve schématu hradla ze souèástky která nemá všechny vývody pøiøazeny pájecím ploškám pouzdra (chybové hlášení: "device name has no connects"). Vyjímka: souèástka bez vývodù (napø. rámeèky)


BUS

Funkce

Kreslí ve schématu sbìrnice.

Zápis

BUS •..
BUS jméno_sbìrnice •..

Viz také NET, NAME, SET

Pøíkaz BUS se používá pro kreslení sbìrnicových spojù ve hladinì Bus na výkrese schématu. Jméno_sbìrnice má následující formy:

SYNONYM:podsbìrnice,podsbìrnice,..

kde SYNONYM mùže být dlouhý až osm znakù. Podsbìrnice je buï jméno dlouhé až osm znakù nebo jiné jméno sbìrnice následující formy:

Jméno[NejnižšíIndex..NejvyššíIndex]

Jméno spoleènì s NejnižšíIndex nebo NejvyššíIndex nesmí pøekroèit osm znakù. Název sbìrnice mùže obsahovat až 21 podsbìrnicových jmen (vèetnì SYNONYM). Ujistìte se, že:

0 <= NejnižšíIndex <= NejvyššíIndex < 255

Pøíklady jmen sbìrnic

A[0..15]
RESET
DB[0..7],A[3..4]
ATBUS:A[0..31],B[0..31],RESET,CLOCK,IOSEL[0..1]

Pokud sbìrnici nepojmenujete, je jí automaticky pøidìleno jméno v podobì B$1. Toto jmíno mùže být zmìnìno kdykoliv pøíkazem NAME.

Síla èáry použité pro kreslení sbìrnice mùže být definována napøíklad pomocí

SET Bus_Wire_Width 40;

na velikost 40 mil. (Pøednastaveno: 30 mil).


CHANGE

Funkce

Mìní parametry.

Zápis

CHANGE volba • •..

Myš

Pravé tlaèítko mìní skupinu.

Pøíkaz CHANGE se používá pro zmìnu nebo pøednastavení vlastností objektù. Objekty jsou kliknuty myší po zmìnì požadovaných parametrù z pøíkazového menu CHANGE nebo poté, co jsou napsány z klávesnice.

Parametry nastavené pomocí pøíkazu CHANGE zùstávají pøednastaveny také pro další objekty, pøidané pozdìji.

Všechny hodnoty v pøíkazu CHANGE se zadávají v aktuálních jednotkách rastru.

Zmìna skupiny

Pokud se aplikuje pøíkaz CHANGE na skupinì, je tøeba nejdøíve oznaèit skupinu pøíkazem GROUP (oznaèení mnohoúhelníku myší) pøedtím, než se zadá pøíkaz CHANGE s odpovídajícími parametry. Zmìny se poté provedou pravým tlaèítkem myši.

Co mùže být mìnìno?

Hladina	CHANGE LAYER jméno | èíslo

Text	CHANGE TEXT

Výška textu	CHANGE SIZE hodnota

Šíøka èáry písma	CHANGE RATIO pomìr

Šíøka èáry	CHANGE WIDTH hodnota

Tvar plošky	CHANGE SHAPE SQUARE | ROUND | OCTAGON | XLONGOCT | YLONGOCT

Prùmìr plošky/prokovu	CHANGE DIAMETER prùmìr

Vrták plošky/prokovu/díry	CHANGE DRILL hodnota

Rozmìry Smd plošky	CHANGE SMD šíøka výška

Parametry vývodu	CHANGE DIRECTION NC | IN | OUT | I/O | OC | HIZ | SUP | PAS | PWR | SUP

CHANGE FUNCTION NONE | DOT | CLK | DOTCLK

CHANGE LENGTH POINT | SHORT | MIDDLE | LONG

CHANGE VISIBLE BOTH | PAD | PIN | OFF

CHANGE SWAPLEVEL èíslo

Parametry ploch	CHANGE THERMALS ON | OFF

CHANGE ORPHANS ON | OFF

CHANGE ISOLATE vzdálenost

CHANGE POUR SOLID | HATCH

CHANGE SPACING vzdálenost

Parametry hradel	CHANGE SWAPLEVEL èíslo

CHANGE ADDLEVEL NEXT | MUST | ALWAYS | CAN | REQUEST


CIRCLE

Funkce

Pøidává do výkresu kružnice.

Zápis

CIRCLE • •..       [støed, polomìr]
CIRCLE šíøka • •..

Myš

Støední tlaèítko mìní aktivní hladinu.

Viz také CHANGE, WIRE

Pøíkaz CIRCLE se používá pro kreslení kružnic. Kružnice ve hladinách tRestrict, bRestrict, a vRestrict definují zakázané oblasti. Tyto by mìly být definovány se šíøkou (width) 0.

Parametr width definuje šíøku èáry kružnice a je to tentýž parametr, který používá pøíkaz WIRE. Šíøka mùže být mìnìna pøíkazem:

CHANGE WIDTH šíøka;

kde šíøka je požadovaná hodnota v aktuálních jednotkách.

Kružnice definovaná se šíøkou èáry 0 bude celá vyplnìna.

Pøíklad

GR ID inch 1;
CIRCLE (0 0) (1 0);

vytvoøí kružnici s polomìrem 1 palec a støedem v poèátku.


CLOSE

Funkce

Zavírá okno editoru.

Zápis

CLOSE

Viz také OPEN, EDIT, WRITE, SCRIPT

Pøíkaz CLOSE se používá pro zavøení okna editoru. Pokud výkres, který editujete byl pozmìnìn, budete vyzváni, zda ho chcete uložit.

Tento pøíkaz se používá pøedevším ve skriptových souborech.


CONNECT

Funkce

Pøiøadí pájecí plošky pouzdra (pad) k vývodùm schematických znaèek (pin).

Zápis

CONNECT
CONNECT jméno_symbolu.jméno_pinu jméno_padu..
CONNECT jméno_pinu jméno_padu..

Viz také PREFIX, OPEN, CLOSE, SCRIPT

Tento pøíkaz se používá v módu editování souèástek pro definování vztahù mezi vývody schematických znaèek a vývody odpovídajícího pouzdra v knihovnì. Nejprve je nutno pøíkazem PACKAGE urèit, které pouzdro bude použito. Pøíkaz PACKAGE vymaže døíve definovaná "propojení".

Pokud je pøíkaz CONNECT vyvolán bez parametrù, objeví se editovací okno které Vám umožní interaktivnì definovat propojení.

Souèástka s jednou schematickou znaèkou

Pokud souèástka obsahuje pouze jeden symbol, je možno vynechat parametr jméno_symbolu, napø.:

CONNECT gnd 1 rdy 2 phi1 3 irq\ 4 nc1 5...

(Pozn.: "\" se normálnì používá pro oznaèení invertovaných signálù.)

Souèástka s nìkolika schematickými znaèkami

Pokud souèástka obsahuje nìkolik symbolù, parametry musí být vždy zadány jako jméno_symbolu, jméno_pinu a jméno_padu . Napøíklad:

CONNECT A.I1     1  A.I2  2   A.O  3;
CONNECT B.I1     4  B.I2  5   B.O  6;
CONNECT C.I1    13  C.I2  12  C.O 11;
CONNECT D.I1    10  D.I2  9   D.O  8;
CONNECT PWR.gnd  7;
CONNECT PWR.VCC 14;

V tomto pøípadì je vytvoøeno propojení pouzdra se ètyømi klasickými hradly NAND 7400. Souèástka obsahuje pìt symbolù - A, B, C, D, a PWR. Vstupy hradel jsou pojmenovány I1 a I2, výstup je pojmenován O.

Pøíkaz CONNECT mùže být opakován tolikrát, kolikrát je potøeba. Mùže být použit k definování všech propojení pin/pad nebo pouze nìkterých. Každý nový pøíkaz CONNECT pøepisuje døíve definovaná propojení pro stejné vývody.

Skriptové soubory

Pøíkaz CONNECT mùže být použit jako skriptový soubor, který lze pak obmìòovat pomocí textového editoru.

Pøíklad

ed 6502.dev;
prefix 'IC';
package dil40;
connect gnd 1 rdy 2 phi1 3 irq\ 4 nc1 5 nmi\ 6 \
        sync 7 vcc 8  a0 9 a1 10 a2 11 a3 12 a4 \
        13 a5 14 a6 15 a7 16 a8 17 a9 18 a10 19 \
        a11 20 p$0 21 a12 22 a13 23 a14 24 a15 \
        25 d7 26 d6 27 d5 28 d4 29 d3 30 d2 31 \
        d1 32 d0 33 r/w 34 nc2 35 nc3 36 phi0 37 \
        so 38 phi2 39 res\ 40;

Pokud pøíkaz pokraèuje na dalším textovém øádku, je nutno na konec øádku vložit znak "\" aby zaèátek dalšího øádku nebyl považován za nový pøíkaz EAGLE.

Podobnì kolize parametrù s pøíkazy mohou být vylouèeny uzavøením parametrù do apostrofù.

Z dùvodu syntaxe pøíkazu CONNECT nesmí jména symbolù obsahovat teèku.


COPY

Funkce

Kopíruje objekty a prvky.

Zápis

COPY • •..

Viz také GROUP, CUT, PASTE, POLYGON

Pøíkaz COPY se používá pro výbìr objektù nebo prvkù a jejich kopírování v rámci jednoho výkresu. EAGLE vytvoøí pro kopie nová jména, ale kopii zùstane hodnota pùvodního objektu. Pokud se kopírují signály (wire), sbìrnice (bus) a sítì (net), jména zùstanou zachována, ale ve všech ostatních pøípadech je pøidìleno nové jméno.

Kopírování spojù

Pokud kopírujete spoje nebo polygony, které patøí signálu, kopie bude patøit stejnému signálu. Proto pozor, z tohoto dùvodu, pokud se pøekryjí dva spoje v dùsledku použití pøíkazu COPY, elektrické kontroly DRC nezaregistrují chybu!

Kopírování prvkù

Použitím pøíkazu COPY lze umís�ovat do výkresu prvky, které se již ve výkrese vyskytují, aniž by bylo nutno otevírat knihovnu.


CUT

Funkce

Zkopíruje skupinu (blok) do zásobníku.

Zápis

CUT;
CUT •

Viz také PASTE, GROUP

Èásti výkresu (nebo i celá deska) mohou být kopírovány do jiných výkresù pomocí pøíkazù CUT a PASTE.

Nejprve je tøeba definovat skupinu (pøíkaz GROUP). Pak se použije pøíkaz CUT ke zkopírování zvolených objektù a prvkù do zásobníku. Nyní mùžete pøejít na jinou desku nebo knihovnu (EDIT) a zkopírovat obsah zásobníku do jiného výkresu pøíkazem PASTE.

Referenèní bod

Když kliknete myší po vyvolání pøíkazu CUT, pozice myši definuje referenèní bod skupiny, takže po použití pøíkazu PASTE je kurzor myši pøesnì na stejném místì.

Poznámka

Na rozdíl od jiných (Windowsovských) aplikací pøíkaz CUT v EAGLE nevymaže oznaèenou skupinu z výkresu ale pouze ji zkopíruje do zásobníku.


DELETE

Funkce

Maže objekty a prvky.

Zápis

DELETE •..
DELETE SIGNALS

Myš

Pravé tlaèítko maže skupinu.

Viz také RIPUP, DRC, GROUP

Pøíkaz DELETE  se používá pro mazání objektù vybraných myší.

Kliknutí pravým tlaèítkem maže skupinu naposledy definovanou pøíkazem GROUP.

Po smazání skupiny je možné, že vzdušné spoje, které novì vznikly smazáním souèástek zùstanou "zapomenuty", protože nebyly souèástí pùvodní skupiny. V takovém pøípadì proveïte nové propoèítaání vzdušných spojù pøíkazem  RATSNEST.

Pøi aktivní Dopøedné&zpìtné anotaci nemohou být na desce smazány spoje a prokovy ze signálu, který je pøipojen k souèástkám. Také nemohou být smazány souèástky, ke kterým jsou pøipojeny signály. Podobné úpravy je nutno udìlat ve schématu.

Pro pøemìnu již položených spojù zpìt na vzdušné spoje použijte pøíkaz RIPUP.

Pøíkaz DELETE nemá vliv na kreslící hladiny, které nejsou zobrazeny (viz pøíkaz DISPLAY).

Pøíkaz DRC mùže vygenerovat polygony zobrazující chyby, které lze vymazat pouze pomocí DRC CLEAR.

Rohy polygonù

Pøíkaz DELETE smaže pøi jednom použití jeden roh polygonu. Celý polygon je smazán tehdy, když už zbývají pouze tøi poslední rohy.

Mazání souèástek

Souèástky mohou být mazány pouze pokud je zobrazena hladina tOrigins (nebo bOrigins pro souèástky zrcadlené , tj. montované ze spodní strany desky) a pokud (s aktivní dopøednou&zpìtnou anotací) nejsou k souèástce pøipojeny žádné signály  (viz také REPLACE). Upozoròujeme, že se prvek mùže jevit jako nepøipojený (žádné vzdušné ani položené spoje nevedou k jeho vývodùm), zatímco ve skuteènosti je pøipojen k napájecímu napìtí pomocí implicitního napájecího pinu. V takovém pøípadì mùžete smazat ze schématu pouze jeho odpovídající èást.

Mazání propojení (Junction), sítí (Net), a sbìrnic (Bus)

Platí následující pravidla:

•	Pokudje sbìrnice rozdìlena do dvou èástí, obìma zùstane pùvodní jméno.

•	Pokud je sí� rozdìlena do dvou èástí, vìtší z nich zùstane pùvodní jméno zatímco menší je pøidìleno nové (vygenerované) jméno.

•	Po pøíkazu DELETE oznaèení (label) pøipadne nejbližšímu segmentu.

•	Pokud je smazán propojovací bod (junction), sí� je v tomto místì rozdìlena. Je vhodné si ovìøit jména segmentù pøíkazem SHOW.

Mazání signálù

Pokud vyberete v pøíkazu DELETE spoje (cesty) nebo prokovy patøící signálu, mohou nastat tøi pøípady:

•	Signál je rozdìlen na dvì èásti. EAGLE vygeneruje nové jméno pro menší z nich a vìtší z nich ponechá pùvodní jméno.

•	Signál je z jednoho konce smazán. Zùstávající èást signálu si ponechá pùvodní jméno.

•	Signál má pouze jeden vzdušný spoj. Je zcela smazán a jeho jméno již nadále neexistuje.

Po smazání spojù nebo prokovù ze signálu který obsahuje polygony všechny polygony budou patøit signálu, kterému zùstalo pùvodní jméno (obvykle vìtší èást).

Mazání všech signálù

Pøíkaz DELETE SIGNALS se použije pro smazání všech signálù na desce. To je užiteèné pokud hodláte naèíst nový nebo pozmìnìný netlist (viz EXPORT). Jsou smazány pouze ty signály, které jsou pøipojeny k vývodùm.

Nezapomeòte: Mazání mùže být vráceno zpìt pøíkazem UNDO!


DIR

Funkce

Ukáže složky (adresáøe).

Zápis

DIR jméno_cesty

Viz také EXPORT

Pøíkaz DIR se používá k zobrazení složek na disketì nebo pevném disku. Jména cest a náhradní znaky (napø.*) je možno používat podle pravidel normálního MS-DOSu.

Pøíklady

DIR c:\boards\*.brd
DIR .
DIR

Pøíkaz DIR bez parametrù zobrazí obsah pracovní složky.


DISPLAY

Funkce

Urèí viditelnost kreslících hladin.

Zápis

DISPLAY
DISPLAY volba èíslo_hladiny..
DISPLAY volba jméno_hladiny..

Platné volby jsou: ALL a NONE

Viz také LAYER

Pøíkaz DISPLAY se používá pro výbìr viditelnosti hladin. Jako parametry jsou povoleny èíslo hladiny a jméno hladiny (i spoleènì). Pokud je vybrán parametr ALL, všechny hladiny budou viditelné. Pokud se použije parametr NONE, všechny hladiny jsou vypnuty. Napøíklad:

DISPLAY NONE BOTTOM;

Po tomto pøíkaze je zobrazena pouze hladina Bottom.

Pokud jméno hladiny nebo èíslo hladiny obsahuje znaménko mínus, nebude hladina zobrazena. Napøíklad:

DISPLAY TOP -BOTTOM -3;

V tomto pøípadì bude zobrazena hladina hladina Top, zatímco hladina Bottom a hladina s èíslem 3 nebudou zobrazeny.

Není možno použít jména hladin ALL a NONE ani jména zaèínající znakem "-".

Pokud ae zapnou hladiny tPlace nebo bPlace, jsou automaticky zapnuty také hladiny t/bNames, t/bValues, t/bOrigins a t/bDocu.

Nìkteré pøíkazy (PAD, SMD, SIGNAL, ROUTE) automaticky zapínají urèité hladiny.

Pokud jsou hladiny t/bPlace zapnuty nebo vypnuty v menu pøíkazu DISPLAY, jsou spoleènì zapnuty nebo vypnuty tak= hladiny t/bNames, t/bValues, a t/bOrigins. Pokud je zapnuta/vypnuta hladina Symbols, jsou souèasnì zapnuty/vypnuty také hladiny Names a Values.

Pokud je pøíkaz DISPLAY vyvolán bez parametrù, objeví se interaktivní okno, které Vám umožní zvolit všechna nastavení pro hladiny.

Vybrání objektù

Pokud chcete vybrat nìjaké objekty nebo prvky (napø. s pomocí MOVE nebo DELETE) musejí být viditelné pøíslušné hladiny. Prvky mohou být vybrány pouze pokud je viditelná hladina tOrigins (nebo bOrigins pro zrcadlené prvky na spodní stranì desky)!


DRC

Funkce

Kontroluje pravidla návrhu.

Zápis

DRC\
SetParameter\
MaxErrors = 50\
MinDist = 10\
MinDiameter = 40\
MaxDiameter = 255\
MinDrill = 24\
MaxDrill = 255\
MinWidth = 10\
MaxWidth = 255\
MinPad = 8\
MinSmd = 10\
Overlap\
Angle\
OffGrid\
Clear\
Signal = name\
• •\
;

Viz také SET, ERC, ERRORS

Pøíkaz DRC provede kontrolu pravidel návrhu. Testuje:

•	minimální izolaèní vzdálenost mezi spoji

•	pøekrytí spojù (zkraty)

•	spoje vyboèující ze 45-stupòového rastru

•	nejmenší a nejvìtší prùmìr pájecí plošky

•	nejmenší a nejvìtší prùmìr vrtáku

•	nejmenší a nejvìtší šíøku spoje

•	šíøku pájecí plošky po vrtání

•	nejmenší velikost plošky smd

•	objekty mimo rastr

Pøednastaveno: Všechny kontroly jsou zapnuty a používají hodnoty uvedené výše. Pokud je pøíkaz požit s parametry, jsou testovány pouze tyto parametry.

Co se kontroluje?

Kontrolují se následující hladiny: Top, Bottom, ROUTE2...15, Pads, a Vias - ale pouze zobrazené hladiny. Pochopitelnì musí být zobrazena alespoò jedna z hladin Top, Bottom, a ROUTE2...15. Pokud jsou zobrazeny všechny, jsou kontrolovány jednotlivì (oddìlenì). Není kontrolováno pøekrytí polygonu s jinými polygony!

Jak provést DRC

Pokud se chcete pøesvìdèit, že deska je v poøádku, je nutno vykonat následující kroky:

•	Zmìnit pomocí textového editoru skriptový soubor DRCSET.SCR (na Vašich disketách s EAGLE) podle Vašich požadavkù.

•	Zobrazir hladiny Top, Bottom, Pad a Via (pøíkaz DISPLAY). Pro vícevrstvé desky zobrazit také hladiny ROUTE které obsahují spoje.

•	Provést skriptový soubor DRCSET (pøíkaz SCRIPT).

•	Provést pøíkaz DRC bez parametrù:

DRC;

Samozøejmì si mùžete napsat skriptový soubor, který všechny kroky provede za Vás.  Soubor DRC

Pøíkaz DRC zapíše své výsledky do (ne-textového) souboru jménodesky.DRC.

Pøíklady

Drc SetParameter MaxErrors=9999 MinDist=20 Angle;

zvýší maximální poèet chyb na 9999, definuje nejmenší vzdálenost mezi spoji na 20 mil a aktivuje kontroly úhlù. (Kontrola desky se nespustí pokud se v pøíkaze objeví klíèové slovo SetParameter - jsou definovány pouze parametry.)

DRC;

spustí DRC s pøeddefinovanými parametry.

DRC • •

spustí DRC v pravoúhelníku definovaném dvìma kliknutími myši.

GRID mm;
DRC Signal = GND MinDist = 7 MinWidth = 5 Angle;

spustí DRC na signál "GND"; kontroluje, jestli GND má vzdálenost aspoò 7 mm od každého jiného signálu (viz pøíkaz GRID) a jestli všechny spoje patøící signálu GND mají nejmenší šíøku aspoò 5 mm; DRC také kontroluje, jestli se vyskytují spoje vedené pod jiným úhlem, než je násobek 45 stupòù a jestli se rùzné signály navzájem nepøekrývají (pøekrytí se kontoluje vždy když je zapnuta kontrola vzdáleností).

DRC MinDist MinDiameter MaxDiameter ;

spustí DRC a kontroluje nejmenší vzdálenosti a souèasnì nejmenší a nejvìtší prùmìry pájecích plošek a prokovù. Jsou použity pøednastavené hodnoty, protože parametry jsou definovány bez speciálních hodnot.

Smazání chybových obrazcù

DRC Clear ;

smaže z obrazovky všechny obrazce DRC, které vyznaèují chyby a pøíslušný soubor *.DRC.

Parametry

SetParameter: Jsou nastaveny urèené parametry, ale DRC se nespustí. Následující pøíkaz DRC tyto parametry použije. SetParameter je zvláštì užiteèný ve skriptových souborech.

MaxErrors: Definuje nejvìtší poèet chyb v každé hladinì. Pokud je tento poèet pøekroèen, DRC je zastaven. Pøednastaveno: 50 chyb.

MinDist: Definuje nejmenší vzdálenost mezi rùznými signály. Tato hodnota se zadává v aktuálních jeednotkách rastru (Inch, mm, mil, mic). "MinDist" bez hodnoty zapne kontrolu minimálních vzdáleností beze zmìny pøeddefinované hodnoty (to platí také pro všechny ostatní parametry Min/Max). Nejmenší vzdálenost zapne vždy také kontrolu pøekrytí. Pøednastaveno: 10 mil.

Overlap: Zapne kontrolu pøekrytí.

Angle: Zapne kontrolu úhlù. Všechny spoje které nejsou umístìny v násobku úhlu 45 stupòù se objeví jako chybné (viz "SET SNAP_BENDED").

MinDiameter: Definuje nejmenší prùmìr pájecích plošek a prokovù (viz MinDist). Pøednastaveno: 40 mil.

MaxDiameter: Definuje nejvìtší prùmìr pájecích plošek a prokovù (viz MinDist). Pøednastaveno: 255 mil.

MinDrill: Definuje nejmenší prùmìr vrtáku pájecích plošek a prokovù (viz MinDist). Pøednastaveno: 24 mil.

MaxDrill: Definuje nejvìtší prùmìr vrtáku pájecích plošek a prokovù (viz MinDist). Pøednastaveno: 255 mil.

MinWidth: Definuje nejmenší šíøku spojù (viz MinDist). Pøednastaveno: 10 mil.

MaxWidth: Definuje nejvìtší šíøku spojù (viz MinDist). Pøednastaveno: 255 mil.

MinPad: Definuje nejmenší šíøku kroužku mìdi, která musí zùstat na pájecích ploškách a prokovech po vrtání (viz MinDist). Pøednastaveno: 8 mil.

MinSmd: Definuje nejmenší rozmìr plošky SMD. (viz MinDist). Pøednastaveno: 10 mil.

OffGrid: Zapíná kontrolu umístìní v rastru. Všechny prvky, které nejsou umístìny v aktuálním rastru se zobrazí jako chyby.

Clear: Smaže všechny chybové obrazce DRC a chybová hlášení v otevíracím menu. To se provede také automaticky, když se prování další kontola DRC.

Signal: Definuje jméno signálu, který má být kontolován. To Vám umožní napøíklad kontolovat pouze urèitý signál vzhledem ke všem ostatním. Pokud je zadáno jméno signálu, všechny kontroly se provedou pouze na tomto signálu.

• •: Dvì kliknutí myši definují pravoúhlou oblast, ve které se provedou kontroly DRC. Jsou nalezeny pouze ty chyby (tøeba jen èásteènì) které byly nalezeny v této oblasti. Po druhém kliknutí myši se DRC okamžitì spustí.

;: Ukonèovací støedník spustí DRC na celou desku, pokud nebyla pøedem definována jen urèitá oblast.

Pøíbuzné pøíkazy SET

Ke zmìnì chování pøíkazu DRC je možno použít pøíkaz SET:

SET DRC_SHOW  ON | OFF;

Zapne/vypne ukazování oblasti, kde DRC právì provádí kontroly.

SET DRC_COLOR název_barvy;

Definuje barvu pro výše zmínìný pravoúhelník. Pøednastavený název_barvy: LGray. {svìtle šedá}

SET DRC_FILL jméno_výplnì;

Definuje druh výplnì která se použije pro chybové obrazce DRC. Pøednastavené jméno_výplnì: LtSlash. {tenké šikmé pruhy}

Hledání chyb

Ke zobrazení chyb DRC se používá pøíkaz ERRORS. Když je vyvolán, zobrazí se okénkové menu, ve kterém jsou vypsány všechny chyby které se nalézají v oblasti desky právì viditelné v oknì editoru. Umístìní kurzoru myši na položku seznamu chyb vyvolá ukazovátko, které oznaèí chybu na desce obdélníkem. Stisk levého tlaèítka myši pøiblíží tuto chybu tak, že se bude nalézat ve støedu okna oditoru. Pøíkaz

SET MAX_ERROR_ZOOM hodnota;

definuje omezení pøiblížení. Pøednastaveno je 1 inch což znamená že se na obrazovce objeví oblast desky která vodorovnì mìøí 1 palec. {cca 2,54 cm}

Støedním tlaèítkem myši mùžete smazat chybu pod kurzorem z okénkového menu. Souèasnì je smazán také pøíslušný chybový obrazec.

Pøíkaz ERRORS mùže být vyvolán pøímo z pøíkazu DRC kliknutím na tlaèítko "ERRORS" v jeho menu.


EDIT

Funkce

Vyvolá existující výkres k editaci nebo vytvoøí nový.

Zápis

EDIT name
EDIT name.ext
EDIT .ext

Viz také OPEN, CLOSE, BOARD

Pøíkaz EDIT se používá pro natažení výkresu nebo pokud byla otevøena knihovna pøíkazem OPEN, k natažení pouzdra, smbolùu nebo souèástky k editování.

EDIT name.brd	natáhne desku

EDIT name.sch	natáhne schéma

EDIT name.pac	natáhne pouzdro

EDIT name.sym	natáhne symbol

EDIT name.dev	natáhne souèástku

EDIT name.S1	natáhne list 1 schématu

EDIT name.S99	natáhne list 99 schématu

Ve jménu jsou povoleny náhradní znaky (napø.: *.brd).

Pøíkaz EDIT bez parametrù vyvolá souborový dialog (v módu desky nebo schématu) nebo okénkové menu (v módu knihovny) ze kterého mùžete vybrat soubor nebo objekt.

K pøechodu ze schématu na desku stejného jména mùže být použit pøíkaz

EDIT .BRD

Podobnì lze pøejít z desky do schématu pøíkazem

EDIT .SCH

K editaci jiného listu téhož schématu lze užít pøíkaz

EDIT .Sx

(x je èíslo listu) nebo kombinované tlaèítko v akèní lištì okna editoru.

Symboly, souèástky nebo pouzdra mohou být editovány pouze pokud je nejprve otevøena knihovna pøíkazem OPEN.

Která složka?

EDIT natáhne soubory z pracovní složky.


ERC

Funkce

Kontrola elektrických zásad. {Electrical Rule Check}

Zápis

ERC

Viz také DRC, Kontrola soudržnosti

Tento pøíkaz se používá pro kontrolu schémat na elektrické chyby. Výsledek je zapsán do textového souboru s pøíponou .ERC.

Mohou být vygenerována následující varovná hlášení:

•	SUPPLY Pin Pin_Name overwritten with Net_Name {vývod zdroje napájení Jméno_vývodu pøepsán signálem Jméno_sítì}

•	NC Pin Elem._Name Pin_Name connected to Net_Name {vývod bez funkce Jméno_souèástky Jméno_vývodu pøipojen k síti Jméno_sítì}

•	POWER Pin El._Name Pin_N. connected to Net_Name {napájecí vývod Jméno_souèástky Jméno_vývodu pøipojen k signálu Jméno_sítì}

•	only one Pin on net Net_Name {je pøipojen pouze jeden vývod k síti Jméno_sítì}

•	no Pins on net Net_Name {nejsou pøipojeny žádné vývody k síti Jméno_sítì}

•	SHEET Sheet_Nr.: unconnected Pin: Element_N. Pin_N. {na listu: Èíslo_listu je nepøipojený vývod: Jméno_souèástky Jméno_vývodu}

Mohou být vygenerována následující chybová hlášení:

•	no SUPPLY for POWER Pin Element_Name Pin_Name {chybí zdroj pro napájecí vývod Jméno_souèástky Jméno_vývodu}

•	no SUPPLY for implicit POWER Pin El._Name Pin_Name {chybí zdroj pro implicitní napájecí vývod Jméno_souèástky Jméno_vývodu}

•	unconnected INPUT Pin: Element_Name Pin_Name {nepøipojený vstupní vývod: Jméno_souèástky Jméno_vývodu}

•	only INPUT Pins on net Net_Name {pouze vstupní vývody na síti Jméno_sítì}

•	OUTPUT and OC Pins mixed on net Net_Name {vývody typu VÝSTUP a OTEVØENÝ KOLEKTOR jsou spoleènì na síti Jméno_sítì}

•	n OUTPUT Pins on net Net_Name {n výstupních vývodù pøipojeno k síti Jméno_sítì}

•	OUTPUT and SUPPLY Pins mixed on net OUTNET {výstupní vývody a napájecí zdroje jsou spoleènì na síti Jméno_sítì}

Pøi automatické kontrole soudržnosti mùže být vygenerováno následující doplòkové hlášení:

Consistency Check

Pøíkaz ERC také provede kontrolu soudržnosti mezi schématem a jemu odpovídající deskou, pokud je soubor desky natažen ještì pøed spuštìním ERC. Výsledkem této kontroly je zapnutí nebo vypnutí dopøedné a zpìtné anotace v závislosti na tom, zda soubory schématu a desky si navzájem odpovídají {zapne se} èi nikoliv {vypne se}.


ERRORS

Funkce

Ukáže chyby nalezené pøíkazem DRC.

Zápis

ERRORS

Myš

Levé tlaèítko ukáže chybu.
Dvojité kliknutí ukáže chybu zvìtšenou uprostøed ukna.
Støední tlaèítko smaže hlášení o chybì z menu.

Viz také DRC, SET

Pøíkaz ERRORS se používá na zobrazení chyb nalezených pøíkazem DRC. Když je spuštìn, otevøe okénkové menu, ve kterém jsou vypsány všechny chyby, které se nalézají v oknì editoru. Vybrání chyby myší ukáže na tuto chybu v oknì editoru ukazovátkem vedoucím z levého horního rohu okna editoru.

Dvojité kliknutí na chybu v seznamu nebo klik na OK zvìtší chybu takže je zobrazena zvìtšenì ve støedu okna editoru. Pøíkaz

SET Max_Error_Zoom hodnota;

nastaví nejmenší vodorovnou velikost této oblasti (v palcích).
Pøednastaveno: 1 palec.

Støední tlaèítko myši smaže chybu z menu. To má samozøejmì smysl až po  opravì chyby.

Chybové obrazce generované funkcí DRC mohou být smazány pouze pøíkazem

DRC CLEAR;


EXPORT

Funkce

Vygenerování ASCII souborù.

Zápis

EXPORT SCRIPT    jméno_souboru;
EXPORT NETLIST   jméno_souboru;
EXPORT NETSCRIPT jméno_souboru;
EXPORT PARTLIST  jméno_souboru;
EXPORT PINLIST   jméno_souboru;
EXPORT DIRECTORY jméno_souboru;

Viz také SCRIPT, RUN

Pøíkaz EXPORT vám vytvoøí textové ASCII soubory, které se mohou použít napøíklad pro pøenos dat z EAGLE do jiných programù.

Standardnì je výstupní soubor zapsán do složky Design. Je to definováno v dialogovém oknì složek. Zde je možno také výstupní složku zmìnit.

Pøíkaz generuje následující textové soubory:

SCRIPT

Knihovna døíve otevøená pøíkazem OPEN bude exportována jako skriptový soubor. Pokud vyexportujete knnihovnu a opìt ji chcete importovat pøíkazem SCRIPT, je nutno otevøít novou knihovnu, aby nedošlo k duplikaci jmen, tj. jeden symbol nebyl definován dvakrát. Ètení skriptových souborù mùže být urychleno, pokud pøedtím zadáte pøíkaz

Set Undo_Log Off;

Když se exportuje knihovna, je použita právì nastavená jednotka rastru.

NETLIST

Generuje netlist z právì zobrazeného schématu nebo desky. Jsou vypsány pouze spoje pøipojené k souèástkám.

NETSCRIPT

Generuje netlist z nataženého schématu ve formì skript souboru. Tento soubor mùže být použit pro naètení nového nebo zmìnìného netlistu do desky kde byly pøidány souèástky nebo byly døíve položené cesty smazány pøíkazem DELETE SIGNALS.

PARTLIST

Generuje seznam souèástek pro schéma nebo desku. Jsou vypsány pouze souèástky s elektrickými vývody.

PINLIST

Generuje seznam vývodù souèástek (plošky a piny), který obsahuje popis sítí a vývodù souèástek k nim pøipojených.

DIRECTORY

Generuje obsah právì otevøené knihovny.


GATESWAP

Funkce

Prohodí navzájem ekvivalentní hradla ve schématu.

Zápis

GATESWAP • •..;
GATESWAP jméno_hradla jméno_hradla..;

Viz také ADD

Použití tohoto pøíkazu prohodí navzájem ekvivalentní hradla ve schématu. Obì hradla musí být stejná se stejným poètem vývodù a musí mít pøiøazenu stejnou úroveò prohazování pøi definici souèástky. Musejí být také obsaženy ve stejné souèástce (device).

Jméno použité v pøíkaze GATESWAP je to, které se zobrazuje ve schématu (napø. U1A pro hradlo A v souèástce U1).

Pokud se souèástka po pøíkaze GATESWAP už dále nepoužívá, je automaticky smazána ze schématu.


GRID

Funkce

Definuje rastr.

Zápis

GRID volba..;
GRID;

Viz také SCRIPT

Pøíkaz GRID se používá pro nastavení velikosti a jednotky rastru. Pokud je zadán bez volby, pøepíná mezi zapnutím (GRID ON) a vypnutím (GRID OFF) rastru.

Existují následující volby:

GRID ON;	Zobrazí rastr na obrazovce

GRID OFF;	Vypne zobrazení rastru

GRID DOTS;	Zobrazí rastr jako body

GRID LINES;	Zobrazí rastr jako plné èáry

GRID MIC;	Nastaví rastrovou jednotku na mikron (=0,001 mm)

GRID MM;	Nastaví rastrovou jednotku na milimetr (mm)

GRID MIL;	Nastaví rastrovou jednotku na mil (=0,001 inch)

GRID INCH;	Nastaví rastrovou jednotku na inch (palec)

GRID FINEST;	Nastaví rastrovou jednotku na 0.1 mikronu

GRID velikost_rastru;	Definuje vzdálenost mezi

body rastru v právì nastavené jednotce

GRID LAST;	Vrací se k naposledy nastaveným

hodnotám rastru

GRID DEFAULT;	Nastaví rastr na standardní hodnoty

GRID velikost_rastru násobnost_rastru;

velikost_rastru = vzdálenost soudedních bodù

násobnost_rastru = zobrazení jen každé n-té èáry rastru

Pøíklady

Grid mm;
Set Diameter_Menu 1.0 1.27 2.54 5.08;
Grid Last;

V tomto pøípadì se mùžete vrátit k poslednímu nastavení rastru pøestože nevíte, jaké bylo.

GRID mm 1 10;

napøíklad nastavuje, že vzdálenost mezi dvìma body rastru bude 1 mm a že každý desátý bod rastru bude zobrazen.

Pozn: První èíslo v pøíkaze GRID vždy reprezentuje velikost rastru, druhé - pokud existuje - reprezentuje násobnost rastru.

Pøíkaz GRID mùže obsahovat násobné parametry:

GRID inch 0.05 mm;

V tomto pøípadì je nejprve definována velikost rastru na 0.05 palce. Pak je zadáno, že se souøadnice kurzoru mají zobrazovat v milimetrech.

GRID DEFAULT;

Nastaví rastr na standardní hodnoty. Je to stejné jako zadání:

GRID OFF DOTS INCH 0.05 1;


GROUP

Funkce

Definuje skupinu objektù (blok).

Zápis

GROUP •..
GROUP;

Myš

Pravé tlaèítko myši uzavírá ohranièující mnohoúhelník [polygon].
Zakliknutí a tažení levým tlaèítkem definuje pravoúhlou skupinu.

Viz také CHANGE, CUT, PASTE, MIRROR, DELETE

Pøíkaz GROUP se používá pro definování skupiny objektù a prvkù pro následující pøíkaz. Také celý výkres nebo prvek mùže být oznaèen jako skupina. Objekty jsou vybrány - po aktivaci pøíkazu GROUP - kreslením ohranièujícího mnohoúhelníku (polygonu) myší. Nejsnadnìjší zpùsob uzavøení polygonu je použít pravé tlaèítko myši. Souèástí skupiny se mohou stát pouze objekty v zobrazených kreslících hladinách.

Skupina obsahuje:

•	všechny objekty, jejichž referenèní bod (origin) je uvnitø polygonu

•	všechny spoje s alespoò jedním koncovým bodem uvnitø polygonu

•	všechny kružnice, jejichž støed je uvnitø polygonu

•	všechny pravoúhelníky s alespoò jedním bodem uvnitø polygonu

Posunutí skupiny

Pro posunutí skupiny se musí vybrat pøíkaz MOVE pravým tlaèítkem myši. Když se posouvají s pøíkazem GROUP spoje (èáry) které mají v polygonu jen jeden konec, je posouván pouze tento jeden konec, zatímco druhý zùstává na pùvodním místì.

Napøíklad: Pro zmìnu tvaru nìkolika pájecích plošek (v knihovnì) vyberte CHANGE a SHAPE levým tlaèítkem myši a vyberte skupinu pravým tlaèítkem myši.

Definice skupiny zùstává do natažení nového výkresu nebo vykonání dalšího pøíkazu

GROUP;


HELP

Funkce

Nápovìda pro aktuální pøíkaz.

Zápis

HELP
HELP pøíkaz

Klávesnice

Pøíkaz HELP je pøiøazen klávese F1.

Tento pøíkaz otevírá obsahovì orientované okno s nápovìdou. Téhož lze dosáhnout stiskem funkèní klávesy F1.

Název pøíkazu po pøíkazu HELP ukáže stránku s nápovìdou pro požadovaný pøíkaz.

Pøíklad

HELP GRID;


HOLE

Funkce

Vloží vrtanou díru do desky nebo pouzdra.

Zápis

HOLE vrták •..

Viz také VIA, PAD, CHANGE

Tento pøíkaz se používá pro definování napø. montážních otvorù (nemají elektrické propojení mezi rùznými vrstvami spoje) na deskách nebo v pouzdrech souèástek. Pametr 'vrták' definuje prùmìr díry v aktuálních jednotkách. Prùmìr mùže být až 0.51602 inch (13.1 mm).

Pøíklad

HOLE 0.20 •

Pokud je aktuální jednotka "inch", díra bude mít prùmìr 0.20 palce.

Hodnota zadaná pro prùmìr (také se používá pro prokovy [via] a pájecí plošky [pads]) zùstává nastavena i pro následující operace. Mùže být zmìnìna pøíkazem:

CHANGE DRILL hodnota •

Díra mùže být uchopena pouze pokud je zobrazena hladina Holes.

Pøíkaz HOLE vytvoøí symbol ve hladinì Holes a také kružnici s prùmìrem díry ve hladinì Dimension. Vztah mezi prùmìry a symboly je definován parametrem -Y. Kružnici ve hladinì Dimension používá autorouter. Dodržuje minimální vzdálenost mezi spoji a dírou, která se nastavuje v menu autorouteru v položkách "Minimum Distance" Dim/wire.

Pøíkaz HOLE také generuje symbol Annulus (izolaèní mezikruží) v napájecích vrstvách. Tím je zajištìna izolaèní vzdálenost mezi napájecí vrstvou a montážním šroubem.

Ve hladinách tStop a bStop, generuje HOLE nepájivou masku, jejíž prùmìr se poèítá z prùmìru díry plus hodnota definovaná parametrem -B.


INFO

Funkce

Zobrazuje vlastnosti objektù.

Zápis

INFO •..

Viz také CHANGE, SHOW

Pøíkaz INFO zobrazí další podrobnìjší údaje o objektu, napø. šíøku èáry, èíslo hladiny, velikost textu atd.


INVOKE

Funkce

Vyvolá zvolenou schématickou znaèku [symbol] ze souèástky [device].

Zápis

INVOKE • orientace •
INVOKE jméno_souèástky jméno_hradla orientace •

Myš

Pravé tlaèítko otoèí symbol o 90 stupòù.

Viz také COPY

Pøíkaz INVOKE se používá pro výbìr jednotlivých hradel [gate] nebo znaèek [symbol] ze souèástky [device] a umís�uje je do schématu (napø. znaèku napájení s pøíznakem pøidání [Addlevel] = Request).

Hradla [gate] se vyvolávají následovnì:

•	Zadáním jména souèástky (napø. IC5) a vybráním hradla ze spouštìcího menu, které se objeví.

•	Zadáním jména souèástky a hradla z klávesnice (napø. INVOKE IC5 POWER).

•	Vybráním existujícího hradla ze souèástky myší a pak vybrání požadovaného hradla ze spouštìcího menu které se objeví.

Poslední kliknutí myší umístí nové hradlo.

Hradla na rùzných listech

Pokud má být umístìno hradlo ze souèástky, která je na jiném listu schématu, musí se v pøíkaze INVOKE specifikovat jméno tohoto hradla. V tomto pøípadì pravý sloupec spouštìcího menu bude ukazovat èíslo listu, kde jsou umístìna doposud použitá hradla. Hradla umístìná na aktivním listì jsou oznaèena hvìzdièkou.


JUNCTION

Funkce

Umís�uje bod na propojení sítí.

Zápis

JUNCTION •..

Viz také NET

Tento pøíkaz se používá k nakreslení propojovacího bodu v místì kde se mají propojit sítì [net]. Bod Junction se má umís�ovat pouze na sítì se stejným signálem. Pokud je umís�ován na køížení sítí s rùznými signály, je uživateli nabídnuta možnost spojit tyto sítì.

Na obrazovce jsou body Junction zobrazovány s prùmìrem nejménì 5 pixelù.


LABEL

Funkce

Pøipojí textové oznaèení názvu sbìrnice nebo sítì.

Zápis

LABEL • •..

Myš

Pravé tlaèítko otáèí oznaèením.
Støední tlaèítko vybírá kreslící hladinu pro oznaèení.

Viz také NAME, BUS

Jména sbìrnic a sítí lze pøíkazem LABEL umístit ve schématu na kterékoliv místo. Když se klikne myší na sbìrnici nebo sí�, objeví se na kurzoru myši odpovídající oznaèení, kterým lze otáèet (pravám tlaèítkem), pøemís�ovat do jiných hladin (støední tlaèítko) nebo pøenášet na jiné místo. Druhé kliknutí myší umístí text na urèené místo.

Sbìrnice a sítì mohou mít libovolný poèet (stejných) oznaèení.

Oznaèení nelze mìnit pomocí "CHANGE TEXT".

Program zachází s oznaèeními jako s texty, ale jejich hodnoty odpovídají jménùm pøíslušné sbìrnice nebo sítì. Pokud je sbìrnice nebo sí� pøejmenována, všechna jí pøíslušná oznaèení se také automaticky zmìní na odpovídající jméno.

Pokud jsou sbìrnice, sí� nebo oznaèení vybrány pøíkazem SHOW, všechny pøipojené sbìrnice, sítì a oznaèení se stejným jménem jsou zvýraznìny.


LAYER

Funkce

Mìní a definuje kreslící hladiny.

Zápis

LAYER èíslo_hladiny
LAYER jméno_hladiny
LAYER èíslo_hladiny jméno_hladiny
LAYER -èíslo_hladiny

Viz také DISPLAY

Výbìr kreslící hladiny

Pøíkaz LAYER s jedním parametrem se používá pro zmìnu aktivní hladiny, tj. hladiny, ve které budou kresleny spoje, kružnice atd. Pokud je pøíkaz LAYER vybrán z menu, objeví se spouštìcí menu, ve kterém vyberete požadovanou hladinu. Pokud je zadán z pøíkazového øádku,'èíslo_hladiny' musí být èíslo kterékoliv platné hladiny, a 'jméno_hladiny' musí být jméno hladiny, které je zobrazováno ve spouštìcím menu.

Nìkteré hladiny nejsou pøístupné ve všech módech.

Definování hladin

Pøíkaz LAYER se dvìma parametry se používá pro definování nové hladiny nebo pøejmenování stávající.

Pokud pouzdro obsahuje hladiny, které dosud na desce nejsou, tyto hladiny jsou pøidány na výkres desky v okamžiku umístìní pouzdra na desku (pøíkazy ADD nebo REPLACE).

Pøeddefinované hladiny mají zvláštní funkce. Mùžete zmìnit jejich jména, ale jejich funkce (vázané na jejich èíslo) zùstanou stejné.

Pokud definujete vlastní hladiny, mìli byste používat pouze èísla od 100 do 255. Nižší èísla než 100 jsou vyhrazena pro zvláštní úèely v budoucích verzích EAGLE.

Zrušení hladin

Pøíkaz LAYER se znaménkem mínus pøed èíslem_hladiny zruší hladinu s uvedeným èíslem, napø.:

LAYER -103;

smaže hladinu s èíslem 103. Hladiny které se mají mazat musí být prázdné. Pokud prázdné nejsou, program zobrazí chybové hlášení

"layer is not empty: #"

kde "#" pøedstavuje èíslo hladiny.

Standardní pøeddefinované hladiny nemohou být smazány.

Napájecí hladiny [Supply Layers]

Hladiny 2...15 jsou autorouterem považovány za napájecí, pokud jejich jména zaèínají znakem $ a existuje signál se stejným jménem bez úvodního znaku $.

Pøeddefinované hladiny EAGLE

Deska spojù

1   Top	Spoje, vrchní strana

2   Route2	Vnitøní vrstva spojù (signály nebo napájení)

3   Route3	Vnitøní vrstva spojù (signály nebo napájení)

4   Route4	Vnitøní vrstva spojù (signály nebo napájení)

5   Route5	Vnitøní vrstva spojù (signály nebo napájení)

6   Route6	Vnitøní vrstva spojù (signály nebo napájení)

7   Route7	Vnitøní vrstva spojù (signály nebo napájení)

8   Route8	Vnitøní vrstva spojù (signály nebo napájení)

9   Route9	Vnitøní vrstva spojù (signály nebo napájení)

10  Route10	Vnitøní vrstva spojù (signály nebo napájení)

11  Route11	Vnitøní vrstva spojù (signály nebo napájení)

12  Route12	Vnitøní vrstva spojù (signály nebo napájení)

13  Route13	Vnitøní vrstva spojù (signály nebo napájení)

14  Route14	Vnitøní vrstva spojù (signály nebo napájení)

15  Route15	Vnitøní vrstva spojù (signály nebo napájení)

16  Bottom	Spoje, spodní strana

17  Pads	Pájecí plošky (s dírou skrz)

18  Vias	Prokovené prùchody (s dírou skrz)

19  Unrouted	Vzdušné spoje (gumové)

20  Dimension	Obrysy desky (kružnice pro díry)

21  tPlace	Pokládaèka - vrch

22  bPlace	Pokládaèka - spodek

23  tOrigins	Referenèní body - vrch

24  bOrigins	Referenèní body - spodek

25  tNames	Jména souèástek - vrch

26  bNames	Jména souèástek - spodek

27  tValues	Hodnoty souèástek - vrch

28  bValues	Hodnoty souèástek - spodek

29  tStop	Nepájivá maska - vrch

30  bStop	Nepájivá maska - spodek

31  tCream	Pájecí pasta - vrch

32  bCream	Pájecí pasta - spodek

33  tFinish	Zušlechtìní - vrch

34  bFinish	Zušlechtìní - spodek

35  tGlue	Lepidlo - vrch

36  bGlue	Lepidlo - spodek

37  tTest	Testovací údaje - vrch

38  bTest	Testovací údaje - spodek

39  tKeepout	Zakázané oblasti souèástek - vrch

40  bKeepout	Zakázané oblasti souèástek - spodek

41  tRestrict	Zakázané oblasti pro spoje - vrch

42  bRestrict	Zakázané oblasti pro spoje - spodek

43  vRestrict	Zakázané oblasti prokovených prùchodù - vrch

44  Drills	Prokovené díry

45  Holes	Neprokovené díry

46  Milling	Rastrování

47  Measures	Mìøítka

48  Document	Obecná dokumentace

49  Reference	Referenèní znaèky

51  tDocu	Dokumentace souèástek - vrch

52  bDocu	Dokumentace souèástek - spodek

Schéma

91  Nets	Signálové sítì

92  Busses	Sbìrnice

93  Pins	Pøípojné body schématických znaèek

s doprovodnou informací

94  Symbols	Tvary schématických znaèek

95  Names	Jména schématických znaèek

96  Values	Hodnoty schématických znaèek


MARK

Funkce

Definuje znaèku v kreslící oblasti.

Zápis

MARK •
MARK;

Viz také GRID

Pøíkaz MARK umožòuje definovat vztažný bod v kreslící oblasti a zobrazovat relativní vzdálenost kurzoru myši k tomuto bodu v levém hormím rohu obrazovky (oznaèení znakem @ pøed údajem). Tento pøíkaz je užiteèný zvláštì když je tøeba definovat rozmìry nebo obrysy desky nebo odmìøovat vzájemné vzdálenosti souèástek. Zadání MARK; vypne toto relativní odmìøování.

Pøed užitím pøíkazu MARK je vhodné nastavit jemnìjší rastr (krokuje po rastru).


MENU

Funkce

Upravuje pøíkazové menu.

Zápis

MENU pøíkaz..;
MENU;

Viz také ASSIGN, SCRIPT

Pøíkaz MENU lze použít pro vytvoøení vlastních položek v pøíkazovém menu.

Pøíklad

MENU MOVE DELETE ROTATE ROUTE ';' EDIT;

vytvoøí pøíkazové menu, které obsahuje pøíkazy MOVE...ROUTE, støedník, a pøíkaz EDIT.

Pøíkaz

MENU;

pøepne zpìt do standardního menu.

Pozor, znak ";" by mìl být vždy v menu k dispozici. Používá se pro ukonèení øady pøíkazù. Poslední položka - v tomto pøípadì EDIT - je vždy pøi práci nahrazována naposledy použitým pøíkazem, který není normálnì v menu pøítomen.


MIRROR

Funkce

Zrcadlí objekty a skupiny.

Zápis

MIRROR •..

Myš

Pravé tlaèítko pracuje se skupinou.

Viz také ROTATE, TEXT

Pøi použití pøíkazu MIRROR jsou objekty zrcadleny podle svislé osy. Používá se napøíklad pro umístìní souèástek na spodní stranu desky.

Souèástky je možno zrcadlit pouze pokud jsou viditelné odpovídající hladiny tOrigins/bOrigins.

Pokud se pøíkaz MIRROR aplikuje na pouzdra, jsou zrcadleny také pøipojené spoje [wires/tracks], (pozor na vznik zkratù!).

Zrcadlení skupiny [Group]

Pro zrcadlení skupiny prvkù musí být nejprve obvyklým zpùsobem definována skupina pøíkazem GROUP a vyznaèením jejích obrysù. Pak se použije pøíkaz MIRROR a použije se pravé tlaèítko myši pro uskuteènìní zmìny. Skupina se zrcadlí kolem svislé osy na dalším nejbližším rastrovém bodì.

Spoje [wires], kružnice, plošky [pads], pravoúhelníky, polygony a oznaèení nelze samostatnì zrcadlit, pokud nejsou souèástí skupiny.

Zrcadlení textù

Text na desce na stranì pájení (hladiny Bottom a bPlace) je zrcadlen automaticky tak, že je èitelný pøi pohledu na spodní stranu desky.

Text ve schématu nelze zrcadlit (to je také pøípad pøi použití CAM procesoru).


MOVE

Funkce

Pøemístìní objektù a prvkù.

Zápis

MOVE • •..
MOVE jméno_pouzdra •..

Myš

Pravé tlaèítko otáèí prvkem nebo vybírá skupinu.
Levé kliknutím a tažením ihned pøesouvá objekt.

Viz také GROUP, RATSNEST

Pøíkaz MOVE se používá pro pøemís�ování objektù. Pouzdra lze také vybírat podle jména. To je zvláštì užiteèné, když se nacházejí mimo právì zobrazený výøez desky.

Souèástkami lze pohybovat pouze pokud jsou zobrazeny odpovídající hladiny tOrigins/bOrigins.

Pøíkaz MOVE nemá vliv na hladiny, které nejsou právì zobrazeny (viz pøíkaz DISPLAY).

Konce èar (spojù) které jsou pøipojeny k prvku nemohou být pøemís�ovány.

Když se pøemís�ují prvky, pøipojené spoje (cesty) které pøísluší saignálu se pøemís�ují také (pozor na zkraty!).

Pokud je objekt vybrán levým tlaèítkem myši a tlaèítko není uvolnìno, objekt mùže být ihned pøemís�ován ("zakliknutí a tažení"). Pøi tomto zpùsobu však nelze otáèet nebo zrcadlit objekt bìhem pohybu.

Pøemístìní spojù

Pokud se bìhem pøíkazu MOVE stane, že se spojí dohromady dva spoje s rùznými signály, jsou stále považovány za rùzné spoje a pøi provedení kontrol pøíkazem DRC je nahlášena chyba.

Pøemístìní skupiny

Pro pøemístìní skupiny je nutno nejprve objekty umístit normálním zpùsobem do skupiny (pøíkaz GROUP a ohranièení polygonem), pak následuje výbìr pøíkazu MOVE a kliknutí na skupinu pravým tlaèítkem myši. Celá skupina pak mùže být pøemís�ována a otáèena pravým tlaèítkem myši.

Tipy pro schémata

Pokud je napájecí vývod [pin] s funkcí [Direction] 'Sup' umístìn na sí�, sí� pøevezme jméno tohoto vývodu.

Vývody umístìné jeden na druhý jsou propojeny dohromady.

Pokud se nepøipojený vývod prvku umístí na sí� nebo jiný vývod, pak je s ním propojen.

Pokud jsou sítì pøemís�ovány pøes vývody, nepropojí se s nimi.


NAME

Funkce

Zobrazuje a mìní jména.

Zápis

NAME •..
NAME nové_jméno •
NAME staré_jméno nové_jméno

Viz také SHOW, SMASH, VALUE

Výkres

V editovacím módu se pøíkaz NAME používá pro zobrazení nebo zmìnu jména zvoleného prvku, signálu, sítì nebo sbìrnice.

Syntaxi staré_jméno nové_jméno je možno použít pro pøejmenování prvku pouze na desce.

Knihovna

V editovacím módu se pøíkaz NAME používá pro zobrazení nebo zmìnu jména zvolené pájecí plošky [pad], smd plošky, vývodu [pin] nebo hradla [gate].

Délka

Jména mohou mít až osm znakù, jména souèástek [device] až deset znakù.

Automatické pojmenování

EAGLE vytváøí jména automaticky: E$.. pro prvky, S$.. pro signály, P$.. pro pájecí plošky [pad], vývody [pin] a smd plošky [smd]. Vìtšinou je vhodné nahradit tato automaticky generovaná jména bìžnì užívanými jmény (napø. 1...14 pro 14-vývodové pouzdro DIL).

Schéma

Pokud jsou pøejmenovávány sbìrnice a sítì, program rozlišuje mezi tøemi možnými pøípady, protože mohou sestávat z nìkolika èástí umístìných na rùzných listech výkresu. Objeví se menu:

   This segment [=tento úsek]
   Every segment on this sheet [=všechny úseky na tomto listì]
   All segments on all sheets [=všechny úseky na všech listech]

Tyto dotazy se objevují podle potøeby ve spouštìcím menu a odpovídá se na nì kliknutím myši na odpovídající položku nebo stiskem "horké" klávesy (T, E, A).


NET

Funkce

Kreslení sítí ve schématu.

Zápis

NET • •..
NET jméno_sítì • •..

Viz také BUS, NAME, SET

Pøíkazem NET se kreslí jednotlivá propojení (sítì) ve hladinì Net schématu. První kliknutí myši definuje poèátek èáry, druhý definuje zlomový bod. Další kliknutí myši na stejné místo ukonèuje èáru. Dvì kliknutí myší ve stejném bodu ukonèují sí�.

Volba signálu sbìrnice

Pokud se ze sbìrnice vede sí�, otvøe se okénkové menu, ze kterého lze zvolit jeden ze signálù sbìrnice. Sí� potom obdrží odpovídající jméno a patøí tomuto signálu. Pokud sbìrnice obsahuje více podsbìrnic, otevøe se nejdøíve okénkové menu, ze kterého se zvolí podsbìrnice.

Jména sítí

Pokud se zadá jméno (maximálnì osm znakù) v pøíkazu NET, obdrží sí� toto jméno.

Pokud se nezadá žádné jméno v pøíkazu NET a sí� nazaèíná na sbìrnici, je automaticky pøiøazeno jméno ve tvaru N$1.

Šíøka èáry

Šíøka èar, pøedstavujících sítì, se dá pøednastavit pøíkazem:

SET NET_WIRE_WIDTH šíøka;

(Pøednastaveno: 6 mil).


OPEN

Funkce

Otevøení knihovny pro editaci.

Zápis

OPEN jméno_knihovny

Viz také CLOSE, USE, EDIT, SCRIPT

Pøíkaz OPEN otevírá již existující knihovnu nebo zakládá novou, pokud zadané jméno ještì není použito. Potom mùže být editována již existující nebo nová schematická znaèka (Symbol), souèástka (Device) nebo pouzdro (Package).

Tento pøíkaz se používá hlavnì ve skriptových souborech.


OPTIMIZE

Funkce

Zcelení segmentù èar.

Zápis

OPTIMIZE;
OPTIMIZE jméno_signálu..
OPTIMIZE •..

Myš

Pravé tlaèítko provede pøíkaz na pøedem definované skupinì.

Viz také SET, SPLIT, MOVE, ROUTE

Pøíkaz OPTIMIZE spojí segmenty èar, ležící v jedné pøímce v signálových hladinách na jeden segment. Pøedpokladem je že se segmenty nalézají ve stejné hladinì a mají stejnou sílu èáry. Tento pøíkaz je užiteèný ke zmenšení poètu objektù na výkrese a k usnadnìní pohybu celým spojem namísto jenotlivými segmenty.

Automatická optimalizace

Tato optimalizace èar se uskuteèòuje také automaticky na zvolených èarách po pøíkazech MOVE, SPLIT a ROUTE pokud není vypnuta pøíkazem:

SET OPTIMIZING OFF;

nebo dokud stejné místo nekliknete dvakrát pøíkazem SPLIT.

Pøíkaz OPTIMIZE pracuje nezávisle na nastavení promìnné SET Optimizing.


PACKAGE

Funkce

Pøiøazení pouzdra (Package) souèástce (Device).

Zápis

PACKAGE jméno_pouzdra

Viz také CONNECT, PREFIX

Tento pøíkaz se používá v módu editace souèástky (Device). Pøiøazuje právì editované souèástce urèité pouzdro (Package). Pouzdro musí již v knihovnì existovat pod zadaným jménem.

Pøíkaz PACKAGE maže døíve definované pøiøazení výodù symbolù a plošek (Pad/Pin).

Nakonec se použije pøíkaz CONNECT, který stanoví, který vývod schematické znaèky (Pin) bude propojen se kterou pájecí ploškou pouzdra (Pad).

Pokud se provede v módu schématu pøíkaz BOARD, pak namísto schematických znaèek (Symbol) se objeví pro každou souèástku pouzdro, které bylo definováno pøíkazem PACKAGE.


PAD

Funkce

Definování pájecích plošek pouzdra (Pad) .

Zápis

PAD •..
PAD prùmìr_plošky tvar_plošky 'jméno' •..

Myš

Pravé tlaèítko otáèí obdélníkovou ploškou.

Viz také SMD, CHANGE, SET, NAME, VIA

Pøíkaz PAD umís�uje pájecí plošku (Pad) do knihovního prvku pouzdro (Package). Když je pøíkaz PAD aktivován, symbol plošky se zavìsí na kurzor a mùže být pøemís�ován po obrazovce. Stisknutím levého tlaèítka myši se umístí symbol na místo, kde se nachází kurzor a na kurzor je povìšen další symbol plošky. Zadání prùmìru pøed umís�ováním mìní velikost plošek (v aktuálních jednotkách). Ploška mùže mít maximální rozmìr 0.51602 palce  (13.1 mm).

Pøíklad

PAD 0.06 •

Pokud je nanastavená jednotka rastru palec ("Inch"), má ploška prùmìr 0.06 palce. Zadaná velikost zùstává zachována pro následující operace.

Tvary plošek

Ploška mùže mít jeden z následujících tvarù (pad_shape):

Square	ètvercový

Round	kulatý

Octagon	osmihran

XLongOct	podlouhlý osmihran ve smìru x

YLongOct	podlouhlý osmihran ve smìru y

U podlouhlých plošek se zadává jako parametr vìtší z obou rozmìrù. Pomìr stran je pevnì stanoven na 2 : 1 .

Tvar plošky (stejnì jako prùmìr) mùže být zmìnìn kdykoliv, dokud je aktivní pøíkaz PAD, nebo mùže být zmìnìn pøíkazem CHANGE, napø.:

CHANGE SHAPE OCTAGON •

Velikost vrtáku mùže být mìnìna rovnìž pøíkazem CHANGE. Takto zadaný tvar zùstane zachován i pro následující operace.

Protože nastavení rùzných dìr a tvarù plošek ponìkud zpomaluje vykreslování obrazu, lze pøepnout z reálného na rychlé zobrazování.pøíkazem:

SET DISPLAY_MODE REAL | NODRILL | FAST;

Jména plošek

Jména plošek jsou programem automaticky vytváøena a mohou být zmìnìna pøíkazem NAME. Obsahují maximálnì osm znakù. Jméno mùže být zadáno také jako parametr v pøíkazu PAD (musí být uzavøeno do apostrofù). Jména plošek lze zobrazit nebo vypnout pøíkazem:

SET PAD_NAMES ON | OFF;

Zmìna je viditelná až po následujícím pøekreslení obrazovky.

Jména plošek do tøí znakù vyžadují mnohem ménì pamìti než jména s více znaky.

Jednotlivé plošky

Jednotlivé plošky (Pads) na desce musí být definovány jako pouzdro (Package) a umístìny na desku. Prokovené prùchody vrstev lze ovšem pøímo umís�ovat na desku pøíkazem VIA. Taková prokovení ovšem nemají žádný název souèástky a nemohou být proto zahrnuta do seznamu sítí.

Zmìna pouzdra

Není možno do pouzdra (Package), které je již použito v souèástce (Device) dodateènì pøikreslovat nebo mazat plošku, nebo� by se tím porušilo pøiøazení Pin/Pad v souèástce definované pøíkazem CONNECT.


PASTE

Funkce

Zkopírování obsahu zásobníku na výkres.

Zápis

PASTE •

Myš

Pravé tlaèítko otáèí obsahem zásobníku.

Viz také CUT, GROUP

Pøíkazy GROUP, CUT a PASTE lze kopírovat èásti nebo celé výkresy a knihovny, a to i do jiných výkresù a knihoven. Pøitom je tøeba dbát následujícího:

•	CUT/PASTE nelze použít v módu editace souèástky (Device).

•	Souèástky a signály se mohou kopírovat jenom z desky na desku.

•	Souèástky, sbìrnice a sítì se mohou kopírovat pouze ze schématu na schéma.

•	Plošky (Pads) a plošky Smd se mohou kopírovat pouze z pouzdra do pouzdra (Package).

•	Piny mohou být kopírovány pouze se Symbolu do Symbolu.

•	Elementy, signály, plošky, Smd a piny obdrží nová jména, pokud se jejich pøedchozí jména už na novém výkrese nacházejí (pøíp. v symbolu nebo pouzdru).

•	Sbìrnice si zachovají svá jména.

•	Sítì si zachovají svá jména, pokud se na nìkterém jejich segmentu vyskytuje popis (Label) nebo Supply-Symbol. Jinak je generováno nové jméno, pokud není k dispozici pøedchozí jméno.


PIN

Funkce

Definice pøípojného místa schématické znaèky (pinu).

Zápis

PIN 'jméno' volby •..

Myš

Pravé tlaèítko otáèí pinem.

Viz také NAME, SHOW, CHANGE

Volby

Kompletní definice pinu obsahuje následující volby (tedy možné parametry):

     Direction
     Function
     Length
     Orientation
     Visible
     Swaplevel

Direction

Logický popis smìru toku signálu. Prakticky slouží pro možnost kontroly nakresleného schématu pøíkazem ERC a pro automatické propojení napájecích pinù. Mùže nabývat tìchto hodnot:

NC	není pøipojen žádný signál

In	vstup

Out	výstup (totem-pole)

I/O	vstupu i výstup (obousmìrný)

OC	otevøený kolektor nebo otevøené hradlo

Hiz	tøístavový výstup (0, 1, vysoká impedance)

Pas	pasivní vstup (odpor, kondenzátor, ...)

Pwr	napájecí signál (zdroj napájení)

Sup	vstup napájení (Vcc, Gnd, Vss ..)

Pøednastaveno: I/O

Pokud jsou ve schematické znaèce použity vývody Pwr a ve schéamtu existují odpovídající vývody Sup, jsou mezi nimi automaticky propojeny sítì. Vývod Sup se nepoužívá v souèástkách.

Jméno vývodu Sup nemá být delší než 8 znakù, protože bude použito jako jméno sítì, které mùže mít jen 8 znakù. Jména s více než 8 znaky budou oøíznnuta bez chybového hlášení, což mùže zpùsobit zkraty!

Function

Definuje se grafické zobrazení pinu:

None	žádná funkce

Dot	symbol inverze (negovaný pin)

Clk	vstup hodinového signálu

DotClk	negovaný vstup hodinového signálu

Pøednastaveno: NONE.

Length

Definuje se délka pinu. Možné volby jsou:

Point	pouze bod, bez èáry a popisu

Short	délka èáry 0.1 palce

Middle	délka èáry 0.2 palce

Long	délka èáry 0.3 palce

Pøednastaveno: LONG.

Orientation

Orientace pinu vzhledem k souèástce. Pøi umís�ování lze piny rotovat pravým tlaèítkem myši. Tento parametr má význam pøedevším pøi textovém zadání napø. ve script souborech. Možné varianty jsou:

R0	symbol má umístìn pin vpravo

R90	symbol má umístìn pin nahoøe

R180	symbol má umístìn pin vlevo

R270	symbol má umístìn pin dole

Pøednastaveno: R0

Visible

Definuje se viditelnost názvù Pinu (vývod znaèky) a Padu (pájecí ploška pouzdra) ve schématu. Možné volby jsou:

Off	není viditelné jméno Pinu ani Padu

Pad	viditelné je jen jméno Padu

Pin	viditelné je jen jméno Pinu

Both	viditelná jsou jména Pinu i Padu

Pøednastaveno: Both

Swaplevel

Èíslo mezi 0 a 255. Definuje možnost prohazování pinu s jinými piny. Hodnota 0 zakazuje prohazovat pin s jiným pinem schématického prvku. Hodnota vìtší než 0 znamená, že pin mùže být prohozen s jiným pinem ve stejné schematické znaèce, který má stejné èíslo swaplevel. Pøíklad: Dva vstupy hradla NAND mohou mít stejné èíslo Swaplevel, protože jsou zámìnné.

Pøednastaveno: 0

Using the PIN Command

Pøíkaz Pin slouží k definování vývodù (Pinù) schematické znaèky, na které se ve schématu pøipojují signálové spoje (sítì). Piny se zobrazují ve hladinì Symbols. Další pøídavné informace se zobrazují ve hladinì Pins. Pomocí voleb lze pøiøadit každému Pinu rùzné vlastnosti. Volby lze zadávat v libovolném poøadí, nebo mohou být vynechány. V takovém pøípadì jsou platné pøednastavené hodnoty.

Pokud je v pøíkaze PIN zadáváno jméno, musí být uzavøeno v apostrofech. Jména Pinù lze zadávat a mìnit v módu editace Symbolu pøíkazem NAME.

Automatické pojmenování

Pokud se napøíklad mají do nìjakého symbolu umístit piny se jmény D0 až D7, pak staèí zadat pouze první pin pøíkazem:

PIN 'D0' *

a všechny další pak jenom dalšími kliknutími myši. Èíselná èást jména bude automaticky zvìtšována.

Pøeddefinování hodnot pøíkazem CHANGE

Všechny volby lze pøednastavit také pøíkazem CHANGE. Zùstanou zachovány tak dlouho, dokud nebudou znovu zmìnìny pøíkazy PIN nebo CHANGE.

Pøíkaz SHOW ukáže jména pinù, stejnì jako Direction a Swaplevel.

Piny se stejnými jmény

Pokud chcete definovat souèástky, které mají více stejnojmenných pinù, pak postupujte následovnì:

Tøi piny se mají napøíklad jmenovat GND. Pøi definici symbolu jim dejte jména GND@1, GND@2 a GND@3. Ve schématu jsou pak viditelné pouze znaky pøed znakem "@" a s piny bude zacházeno tak, jako by se jmenovaly GND.

Není možno do symbolu, který je již použit v souèástce (Device) dodateènì pøikreslovat nebo mazat Pin, nebo� by se tím porušilo pøiøazení Pin/Pad v souèástce (viz pøíkaz CONNECT).

Délka jména Pinu

Piny mohou mít jména s maximálnì osmi znaky.

Popis pinù

Pozice jmen Pinù a plošek (Pad) ve schematických symbolech je pevnì vztažena k referenènímu bodu pinu a nemùže být mìnìna. Stejnì je pevnì nastavena výška písma pro popis pinù a plošek. Pøi definování nových symbolù se orientujte podle velikosti popisù souèástek v originálních knihovnách dodávaných s programem.


PINSWAP

Funkce

Zámìna ekvivalentních Pinù/Padù.

Zápis

PINSWAP • •..

Viz také PIN

Tímto pøíkazem lze ve schématu navzájem zamìnit dva piny, které patøí ke stejné souèástce a pøi definici symbolu dostaly stejnou prohazovací úroveò (Swaplevel> 0). Swaplevel viz pøíkaz PIN.  Pokud je deska svázána se schématem pomocí zpìtné anotace mohou být dvì plošky navzájem prohozeny pouze pokud jsou prohoditelní odpovídající piny ve schématu.

Na desce bez schématu lze tímto pøíkazem navzájem zamìnit dva vývody jednoho pouzdra. Pøitom v tomto okamžiku není prohazovací úroveò kontrolována.

Spoje pøipojené k prohazovaným pinùm/ploškám se pohybují spoleènì s nimi, takže by mohlo dojít ke zkratùm. Proto po tomto pøíkazu proveïte na desce kontrolu DRC a pokud je to potøeba, opravte chyby.


POLYGON

Funkce

Kreslení mnohoúhelníkových ploch (polygonù)

Zápis

POLYGON jméno_signálu šíøka_èáry • • •..

Myš

Dvojité kliknutí levým tlaèítkem uzavírá polygon.
Støední tlaèítko volí kreslicí hladinu (Layer).
Pravé tlaèítko mìní úhel zalomení èáry(viz SET Wire_Style).

Viz také CHANGE, DELETE, RATSNEST, RIPUP

Pøíkaz POLYGON slouží ke kreslení ploch. Polygony ve hladinách Top, Bottom a Route2..15 jsou považovány za signály. Polygony ve hladinách T/B/VRestrict jsou zakázané plochy pro autorouter.

Poznámka

Mìli byste se vyhnout používání velmi malých hodnot parameru width pro polygony, protože, to mùže zpùsobit vygenerování velkého množství dat bìhem zpracování výkresu pro výstupy v CAM procesoru.
Parametr polygonu width by mìl být vždy vìtší, než hardwarové rozlišení výstupního zaøízení. Napøíklad pøi použití fotoplotru Gerber s typickým rozlišením 1 mil by nemìl být parametr polygonu width menší než pøibližnì 6 mil. Typicky by se mìla udržovat šíøka èar polygonu width srovnatelná se šíøkou ostatních èar.
Pokud chcete dát polygonu jméno zaèínající èíslicí (jako napø. 0V), musíte jméno uzavøít do jednoduchých uvozovek, aby se odlišilo od hodnoty width.

Obrysový a reálný stav

Polygony které jsou souèásti signálù se mohou vyskytovat ve dvou stavech:

<tr><td width=160>1. Obrysy   </td><td>tvar, který byl nakreslen uživatelem (obrysové èáry).</td></tr>

2. Reálné zobrazení	všechny oblasti jsou  viditelné tak, jak je propoèítal program.

V souboru desky (jméno.BRD) se ukládá pouze obrysový stav.

Standardnì jsou všechny polygony na obrazovce zobrazovány v obrysovém stavu, nebo� propoèítávání je èasovì nároèné.

Pøi výstupu pøes CAM procesor jsou vždy všechny polygony propoèítány.

Propoèítávání lze pøerušit kombinací kláves Ctrl-Break. Všechny do té doby propoèítané polygony zùstanou v reálném stavu, všechny ostatní (i ty, které se právì propoèítávaly!) zùstanou v obrysovém stavu.

Propoèítávání polygonù nastane po spuštìní pøíkazu RATSNEST (to lze vypnout pøíkazem SET POLYGON_RATSNEST OFF;).

Reálný polygon lze vrátit zpìt do obrysového stavu, klikne-li se na nìho pøíkazem RIPUP.

Pøíkazy CHANGE, které se týkají polygonù v reálném stavu opìt propoèítají polygon po provedení zmìny.

Vliv jiných pøíkazù na polygon

Polygony lze uchopit za hrany a rohy (jako spoje).

SPLIT: Vytvoøí novou hranu polygonu.

DELETE: Smaže roh polygonu (pokud zbývají pouze 3 rohy, je smazán celý polygon).

CHANGE LAYER: Mìní kreslící hladinu zvoleného polygonu.

CHANGE WIDTH: Mìní šíøku èar zvoleného polygonu.

MOVE: Pohybuje okrajem polygonu nebo rohem (jako pøi tahání normálních èar (Wire).

COPY: Kopíruje celý polygon.

NAME: Pokud polygon leží v signálové hladinì, bude zmìnìno jméno signálu.

Parametry Polygonu

Width: Síla okrajových èar polygonu. Používá se také pøi šrafování výplnì.

Layer: Polygony mohou být kresleny v libovolných hladinách. Polygony v signálových hladinách jsou souèástí signálù a budou "vypuzeny", t.j. "obteèou" plochy s jinými potenciály. Polygony ve hladinì Top budou pøi obtékání také vypuzovány objekty ve hladinì TRestrict (totéž platí pro hladiny Bottom a BRestrict). Tím je napø. možno vytvoøit negativní obtažení tvaru spojù uvnitø zemnící plochy.

Pour: Zpùsob vyplnìní  Solid = zcela vyplnìn [pøednastaveno],  Hatch = šrafování

Thermals: Urèují, jak budou pøipojeny plošky Pads a Smds se stejným potenciálem
 On = budou generovány symboly Thermal [pøednast.],  Off = nebudou.

Spacing: Vzdálenost èar šrafování pøi Pour = Hatch  (pøednastaveno: 50 Mil).

Isolate: Vzdálenost "obtékajících" hran polygonu od mìdi s jiným potenciálen (pøednastaveno: 14 Mil).

Orphans: Pøi propoèítávání polygonù se mùže stát, že se urèitý polygon rozpadne na nìkolik menších èástí. Pokud na takové èásti není žádný vývod souèástky (Pad, Smd) nebo prokov (Via), stává se tato èást "ostrovem". Pokud takové ostrovy (nebo "osiøelé" plochy) mají zùstat zachovány, nastaví se Orphans = On. Pøi Orphans = Off [pøednastaveno] budou vymazány.

Pozor: Pøi propoèítávání (zvláštì pøi Orphans=Off) se mùže stát, že urèitý polygon zdánlivì "zmizí"!.

Rozmìry symbolù Thermal

Šíøka vodivých paprskù v symbolu Thermal se poèítá následovnì:

•	Pads: pøesnì polovina prùmìru vrtáku

•	Smds: pøesnì polovina kratší strany

•	alespoò stejná jako šíøka èáry (Width) polygonu

•	maximálnì dvojnásobek šíøky èáry (Width) polygonu.

Parametry Width, Isolate a Spacing polygonu. Width má vliv na všechny èáry v polygonu.


PREFIX

Funkce

Nastavení prefixu pro jména symbolù

Zápis

PREFIX øetìzec_znakù;

Viz také CONNECT, PACKAGE, VALUE

Tento pøíkaz se používá v módu editace souèástky (Device). Definuje, kterým znakem nebo øetìzcem znakù zaèíná automatické pojmenovávání symbolù pøi umís�ování souèástek do schématu pøíkazem ADD.

Pøíklad

PREFIX U;

Parametr øetìzec_znakù mùže být dlouhý nejvíce tøi znaky.

Po provedení tohoto pøíkazu pøi editaci souèástky 7400, a pøi následném pøechodu do schématu a jejím umís�ování pøíkazem ADD obdrží hradla NAND jména U1, U2, U3 atd. Tato jména lze mìnit pøíkazem NAME. .


PRINT

Funkce

Vytiskne výkres na systémové tiskárnì. (Tento pøíkaz není pøístupný ve verzi pro operaèní systém DOS!)

Zápis

PRINT [mìøítko] [-omezení] [volby] [;]

Viz také CAM procesor, tisk na systémové tiskárnì

Pøíkaz PRINT tiskne právì editovaný výkres na systémové tiskárnì.

Barvy a typy výplní se použijí stejné jako v oknì editoru. To lze zmìnit pomocí nastavení voleb SOLID a BLACK.

Pokud chcete vytisknout plošky a prokovy "vyplnìné" (aby vrtací díry nebyly viditelné), použijte pøíkaz

SET DISPLAY_MODE NODRILL;

Upozoròujeme, že polygony na deskách nebudou pøi použití pøíkazu PRINT automaticky propoèítány! Budou vytisknuty pouze obrysy. Pro výtisk polygonù v jejich reálném tvaru musíte pøed tiskem použít pøíkaz RATSNEST.

Pro zmìnu mìøítka výstupu lze zadat parametr mìøítko.

Volba omezení se používá pro zadání maximálního poètu stran, které mùže výstup použít. Pøed èíslem musí být uveden znak '-' aby se odlišilo od èísla mìøítko. Pokud se výkres nechce vejít na zadaný poèet stran, je automaticky zmenšeno mìøítko, až se na strany vejde.

Pokud pøíkaz PRINT není ukonèen støedníkem ';', objeví se tiskový dialog který umožní nastavit parametry tisku.

Existují následující parametry:

MIRROR	zrcadlení výstupu

ROTATE	otáèí výstup o 90°

UPSIDEDOWN	otáèí výstup o 180°. Spoleènì s ROTATE lze výkres otoèit celkem o 270°

BLACK	ignoruje nastavení barev kreslících hladin a tiskne vše èernì

SOLID	ignoruje nastavení druhù výplní kreslících hladin a tiskne vše s pevnou výplní

Pøíklady

PRINT	otevøe tiskový dialog ve kterém mùžete nastavit parametry tisku

PRINT;	ihned tiskne výkres s pøeddefinovanými parametry

PRINT MIRROR BLACK SOLID;	tiskne výkres zrcadlený, vše èernì a s pevnou výplní

PRINT 2.5 -1;	tiskne výkres zvìtšený 2.5x, ale kontroluje, aby výkres nepøesáhnul  jednu stranu


QUIT

Funkce

Ukonèení programu v EAGLE

Zápis

QUIT

Tento pøíkaz ukonèuje práci s EAGLE. Pokud byly od posledního uložení výkresu nebo knihovny provedeny zmìny, objeví se okénkové menu, které se zeptá, jestli chcete výkres nejprve uložit.

Z EAGLE mùžete také kdykoliv odejít stiskem Alt+X.


RATSNEST

Funkce

Vypoèítá nejkratší možné vzdušné spoje a polygony.

Zápis

RATSNEST

Viz také SIGNAL, MOVE, POLYGON, RIPUP

Pøíkaz RATSNEST pøepoèítává všechny vzdušné spoje, aby bylo dosaženo jejich nejkratších délek (napø. po zmìnì v umístìní souèástek). Stejnì je vhodné použít pøíkaz RATSNEST po naètení Netlistu pøíkazem SCRIPT aby byla délka vzdušných spojù optimalizována.

Pøíkaz RATSNEST také znovu pøepoèítává všechny polygony, které patøí k signálùm. To je nezbytné pro zabránìní výpoètù vzdušných spojù, které jsou už pøipojeny k polygonùm. Všechny propoèítané plochy je pak možno vidìt v reálném (propoèítaném) tvaru. Vykreslování obrazu se tím zpomalí. Pro opìtné zobrazení obrysù lze použít pøíkaz RIPUP.
Automatické výpoèty polygonù lze vypnout pøíkazem SET POLYGON_RATSNEST OFF;.

RATSNEST nevypoèítává vzdušné spoje pro signály, pro nìž existuje vlastní hladina (napø. hladina $GND pro signál GND), s výjimkou spojù k SMD souèástkám, které jsou pøipojeny k vnitøní napájecí vrstvì GND pomocí nejbližší prokovené díry.

Vzdušné spoje s nulovou délkou

Pokud dva nebo více spojù stejného signálu v rùzných kreslících hladinách konèí ve stejném bodì bez vzájemného propojení skrze plošku souèástky nebo prokov, je vygenerován vzdušný spoj s nulovou délkou, který se zobrazí jako nepatrný bod (pixel) ve hladinì Unrouted. To stejné se provede u plošek SMD, které patøí stejnému signálu a jsou umístìny na opaèných stranách desky.

Takové vzdušné spoje s nulovou délkou mohou být zpracovány pøíkazem ROUTE stejnì jako normální vzdušné spoje. Také mohou být odstranìny umístìním prokovu VIA do tohoto bodu.

Kontrola položení všech spojù

Pokud jsou všechny vzdušné spoje položeny (zmìnìny na mìdìné spoje), pøíkaz RATSNEST odpoví hlášením

Ratsnest: Nothing to do!

Jinak pokud existují nepoložené (vzdušné) spoje, objeví se zpráva

Ratsnest: xx airwires.

kde xx je poèet nepoložených vzdušných spojù.


RECT

Funkce

Vložení pravoúhelníku do výkresu.

Zápis

RECT • •..

Myš

Støedním tlaèítkem se mìní aktivní hladina.

Viz také CIRCLE

Tímto pøíkazem se kreslí pravoúhelníky do aktivní hladiny. Oba body urèují naproti sobì ležící rohy pravoúhelníku. Støední tlaèítko myši mìní aktivní hladinu, do které se má pravoúhelník vložit.

Pravoúhelníky se vyplní barvou aktivní hladiny. Po smazání pravoúhelníku by se mìl obraz opìt obnovit pøíkazem WINDOW; (F2), aby se zviditelnily èásti obrazu, které døíve ležely pod smazanou plochou.

Plochy nepatøící k signálùm

Pravoúhelníky v hladinách Top a Bottom nepatøí k signálùm. Kontrola DRC proto hlásí chybu, když se pøekrývají se spoji, pady, atd.

Zakázané plochy

Pøíkaz RECT v hladinách TRestrict, BRestrict a VRestrict slouží k vytvoøení zakázaných oblastí pro autorouter.


REDO

Funkce

Provede znovu pøíkaz vrácený pøíkazem UNDO.

Zápis

REDO;

Klávesnice

Funkèní klávesa F10: pøiøazena pøíkazu REDO (pøednastaveno).

Viz také UNDO, Dopøedná&zpìtná anotace

V EAGLE je možno vrátit pøedchozí akce pøíkazem UNDO. Tyto akce je možno znovu provést znovu pøíkazem REDO. UNDO a REDO disponují pamìtí pøíkazù která existuje zpìt až po poslední pøíkazy EDIT, OPEN, AUTO nebo REMOVE.

UNDO/REDO jsou kompletnì integrovány s dopøednou a zpìtnou anotací.


REMOVE

Funkce

Mazání souborù (Files), souèástek (Devices), symbolù (Symbols), pouzder (Packages) a listù (Sheets).

Zápis

REMOVE jméno
REMOVE jméno.Sxx

Viz také OPEN, RENAME

Mazání souborù

Pøíkaz REMOVE vymaže v editaèním módu desek soubor "jméno".

Souèástky (Devices), Znaèky (Symbols), Pouzdra (Packages)

V módu editace knihovny vymaže pøíkaz REMOVE z aktivní knihovny souèástku (Device), znaèku (Symbol) nebo pouzdro (Package), uložené jako "jméno". Ujistìte se, že je aktivní odpovídající mód editace. Chcete-li napø. vymazat symbol, vložte nejlépe pøedem libovolný symbol (schématickou znaèku).

Pokud není k editaci zadána znaèka (symbol), souèástka (device), nebo pouzdro (package), jméno je interpretováno jako jako jméno souèástky, pøípadnì jako jméno pouzdra, pokud není instalován modul schémat.

Znaèky/pouzdra je možno mazat jen tehdy, nejsou-li použity v žádné souèástce.

Listy schématu (Sheets)

Pøíkaz REMOVE se mùže použít také k mazání listù (Sheets) ze schématu, pøi tom lze vynechat jméno vyvolaného výkresu. V popisu syntaxe odpovídá xx èíslu listu, který se má vymazat , napøíklad:

REMOVE .S3

vymaže list è. 3 z právì editovaného schématu.

Pokud je xx stejné jako èíslo právì editovaného listu, vloží se list èíslo 1. Všechny listy s èísly vìtšími než xx , obdrží èísla zmenšená o 1.

UNDO s tímto pøíkazem nepracuje. Pokud smažete omylem list, stále je ještì pøítomen ve "starém" souboru schématu tak dlouho, dokud "nový" soubor není uložen.

REMOVE vymaže pamì� UNDO.


RENAME

Funkce

Pøejmenování symbolù (Symbols), souèástek (Devices) nebo pouzder (Packages) v knihovnì.

Zápis

RENAME staré_jméno nové_jméno;

Viz také OPEN

Pomocí RENAME lze zmìnit jméno symbolu, souèástky nebo pouzdra. Knihovna musí být nejprve otevøena pomocí OPEN.

Pozor:

•	Pokud je editován symbol, symbol mùže být pøejmenován.

•	Pokud je editována souèástky, souèástka mùže být pøejmenována.

•	Pokud je editováno pouzdro, pouzdro mùže být pøejmenováno.

RENAME maže pamì� UNDO.


REPLACE

Funkce

Výmìna pouzdra na desce.

Zápis

REPLACE jméno_pouzdra •..

Viz také SET

Pøíkaz REPLACE umožòuje dva rozdílné zpùsoby použití, které se pøedvolí pomocí pøíkazu SET. V obou je možné nahradit souèástku na desce za jinou z libovolné knihovny.

První zpùsob (pøednastavený) se aktivuje pomocí pøíkazu:

SET REPLACE_SAME NAMES;

V tomto zpùsobu je možné pøiøadit souèástce ve schématu jiné pouzdro (Package), u kterého jsou stejná jména plošek (Pad) a Smd plošek (SMD). Nové pouzdro mùže pocházet z jiné knihovny, mùže obsahovat navíc další plošky (Pads) a Smds a poloha vývodù je libovolná.

Plošky Pads starého pouzdra pøipojené k signálùm musí existovat i v novém pouzdru. Pokud je tato podmínka splnìna, nové pouzdro mùže mít i ménì vývodù než staré.

Druhý zpùsob se aktivuje pomocí pøíkazu

SET REPLACE_SAME COORDS;

Umožòuje pøiøadit souèástce ve schématu jiné pouzdro, u kterého na stejných souøadnicích (relativnì k závìsnému bodu pouzdra) musí ležet plošky (Pads) nebo Smds. Jména mohou být rozdílná. Nové pouzdro mùže pocházet z jiné knihovny a smí obsahovat pøídavné plošky a SMD.

Plošky Pads starého pouzdra pøipojené k signálùm musí existovat i v novém pouzdru. Pokud je tato podmínka splnìna, nové pouzdro mùže mít i ménì vývodù než staré.

Pøíkaz REPLACE pracuje pouze pokud jsou zobrazeny odpovídající hladiny tOrigins/bOrigins.


RIPUP

Funkce

Pøemìna pevných spojù na vzdušné spoje.
Pøemìna Polygonù na tvar "obrys".

Zápis

RIPUP;
RIPUP •..
RIPUP jméno..
RIPUP ! jméno..

Pøíkaz RIPUP lze aplikovat i na pøedem definované skupinì (viz pøíkaz GROUP).

Viz také DELETE, GROUP, POLYGON, RATSNEST

Pøíkaz RIPUP se používá k pøemìnì (zvednutí) již položených signálù zpìt na vzdušné spoje. Pøíkaz se mùže použít pro:

•	všechny signály(RIPUP;)

•	všechny signály kromì vyjmenovaných (napø. RIPUP ! GND VCC)

•	pro urèité signály (napø. RIPUP D0 D1 D2;)

•	pro urèité úseky signálù (urèí se myší).

V posledním pøípadì vzniknou vzdušné spoje mezi dvìma pájecími ploškami (Pads, resp. SMDs). Aplikování RIPUP na vzdušný spoj pøemìní všechny pøipojené položené spoje a prokovy na vzdušné spoje a to až k další plošce Pad nebo Smd.

RIPUP jméno..

vyjme celý signál "jméno" (mùže být zadáno nìkolik signálù, napø. RIPUP D0 D1 D2;).

RIPUP •..

vyjme segmenty oznaèené myší až k nejbližší plošce Pad/Smd.

RIPUP vyjme pouze signály které jsou pøipojeny k prvkùm (napø. technologické znaèky desky nejsou ovlivnìny).

Polygony

Pokud je použit pøíkaz RIPUP na signál, ke kterému patøí Polygon, bude Polygon následnì zobrazen ve tvaru obrysu (rychlejší vykreslování obrazu!). Pokud má být Polygon opìt v reálném tvaru (propoèítán), použije se pøíkaz RATSNEST.

Pøíkaz RIPUP lze použít také na pøedem definovaných skupinách.


ROTATE

Funkce

Otáèení objektù a souèástek.

Zápis

ROTATE •..

Myš

Pravé tlaèítko otáèí pøedem oznaèenou skupinu.

Viz také ADD, MIRROR, MOVE, GROUP

Pøíkazem ROTATE je možné zmìnit orientaci objektù a prvkù v 90-stupòových krocích.

Pouzdra (Packages)

Pøi otáèení pouzder (Packages) se pohybují také pøipojené spoje (pozor na zkraty!).

Pouzdra je možno otáèet jen tehdy, je-li zobrazena hladina TOrigins resp. BOrigins.

Objekty

Èáry (Wires), kružnice (Circles), plošky (Pads), pravoúhelníky (Rectangles) a popisy (Labels) nelze explicitnì otáèet. Mohou být otáèeny jen jako souèásti skupiny (viz. pøíkaz GROUP).

Text

Text se vždy zobrazí tak, že je èitelný buï zepøedu, nebo zprava, a to i když je otoèený. Po dvojí rotaci se objeví proto stejnì, ale závìsný bod neleží vlevo dole, ale vpravo nahoøe. Vzpomeòte na to v pøípadì, kdy není zdánlivì možno zachytit text.


ROUTE

Funkce

Pøemìna vzdušných spojù na plošné spoje.

Zápis

ROUTE • •..
ROUTE šíøka_èáry • •..
ROUTE • šíøka_èáry •..

Myš

Pravé tlaèítko mìní úhel tažení èáry(viz SET Wire_Style).
Støední tlaèítko mìní kreslící hladinu

Viz také AUTO, UNDO, WIRE, SIGNAL, SET, RATSNEST

Pøíkaz ROUTE aktivuje ruèní router, který Vám umožòuje pøemìòovat vzdušné spoje (airwires) na fyzické plošné spoje na desce.

Po aktivaci pøíkazu ROUTE se umístí první bod na jeden konec vzdušného spoje a pohybuje se kurzorem ve smìru, ve kterém chceme položit spoj. Je uchopen ten konec, který je blíže kurzoru myši. Nyní mùže být pokládán spoj (viz také WIRE). Pravé tlaèítko myši mìní úhel tažení spojù a støedním tlaèítkem se mìní kreslicí hladiny. Když je dosaženo koneèné pozice spoje, dalším klikem levého tlaèítka myši se umístí zlomový bod a ke kurzoru je pøipojen nový segment spoje.

Pokud se mìní vrstva umístìní spoje a je nutno umístit prokov, je pøidán automaticky do místa zmìny vrstvy. Když je vzdušný spoj kompletnì položen, ozve se pípnutí a je možno zvolit další vzdušný spoj pro pokládání.

Pokud j pøíkaz ROUTE aktivní, lze zadat šíøku spoje z kávesnice.

Tahání k a od plošek Smd

Pokud táhnete spoj od plošky Smd, pak vrstva na které je ploška se automaticky stane aktivní kreslící hladinou.

Pokud konèíte spoj na souøadnici plošky SMD, je spoj považován za ukonèený pouze v pøípadì, že poslední úsek spoje leží ve stejné vrstvì jako ploška SMD.

Funckce dotažení

Pokud je spoj dotažen do tìsné blízkosti koncového bodu, poslední úsek je umístìn automaticky. Nejmenší vzdálenost pro toto dotažení se dá nastavit pøíkazem

SET SNAP_LENGTH vzdálenost;

kde "vzdálenost" je okruh dotažení v aktuálních jednotkách rastru. Pokud je "vzdálenost" 0, je funkce dotažení zakázána.

Úhel spoje

Pokud taháte spoje pøipojené k ploškám ,které nejsou umístìny v bodech rastru, nelze to provést s úlem zalomení spoje 45 stupòù. V takovém pøípadì lze provést pøíkaz

SET SNAP_BENDED OFF;

který umožní, že takovéto spoje mohou být propojeny, i když je parametr wire_style nastaven na 1 nebo 3. V tomto pøípadì se segment vodièe nepatrnì odchyluje od 45-stupòového úhlového rastru.


RUN

Funkce

Spustí program vytvoøený v ULP (Program uživatele).

Zápis

RUN jméno_souboru

Klávesnice

Ctrl-Break pøeruší provádìní Programu uživatele.

Viz také SCRIPT

Spouštìní ULP skriptovým souborem

Pokud je ULP spuštìn ze skriptového souboru, a program vrátí hodnotu jinou než 0 (buï proto, že byl ukonèen voláním funkce exit() nebo protože byla stisknuta kombinace kláves Ctrl-Break), provádìní skriptového souboru bude ukonèeno.


SCRIPT

Funkce

Provedení souboru pøíkazù.

Zápis

SCRIPT jméno_souboru;

Viz také SET, MENU, ASSIGN, EXPORT, RUN

Pøíkaz SCRIPT se používá k provádìní sekvencí pøíkazù, které jsou uloženy v souboru. Zadá-li se pøíkaz klávesnicí, "jméno_souboru" mùže obsahovat libovolné rozšíøení. Pokud nebylo zadáno žádné rozšíøení, program automaticky použije pøednastavené .SCR.

Pøíklady

SCRIPT NOFILL	spustí NOFILL.SCR

SCRIPT MYSCR.	spustí MYSCR (no Suffix)

SCRIPT MYSCR.OLD	spustí MYSCR.OLD

Všimnìte si možností pøíkazu EXPORT v souvislosti se Script soubory!

Zvolíte-li pøíkaz pomocí myši, potom ukáže okénkové menu všechny soubory s rozšíøením .SCR. Mùžete pak spustit požadovaný soubor.

Pøíkaz SCRIPT nabízí možnost pøizpùsobit program individuálním potøebám. Kromì jiného je možno:

•	nastavit pøíkazové menu

•	obsadit funkèní klávesy

•	vložit obrysy desky

•	stanovit barvy

Øádky pokraèování

SCRIPT soubory obsahují pøíkazy podle pravidel syntaxe, každý na samostatném øádku. Pouze pøíkaz MENU mùže vyžadovat použití více než jednoho øádku. V tomto pøípadì platí: každý otevírací apostrof musí být na stejném øádku také uzavøen. Znak "\" na konci pøíkazového øádku slouží k tomu, aby první slovo následujícího øádku nebylo interpretováno jako pøíkaz. Tím je možno se v mnohých pøípadech vyhnout apostrofùm.

Pøerušení Script souboru

Provádìní Script souborù se mùže zrušit klávesou kombinací kláves Ctrl-Break.

Pøednastavení parametrù

Pøi startu programu EAGLE se automaticky provede soubor EAGLE.SCR pokud je v pracovním adresáøi nebo je k nìmu nastavena cesta.

Provádìní skriptových souborù v Editoru knihoven

Urèité kreslící hladiny mohou být používány jen tehdy, když byly døíve používány v editoru knihoven.


SET

Funkce

Zmìna systémových parametrù.

Zápis

SET
SET volby;

Pøíkazem SET se mohou nastavit parametry, které mají vliv na chování programu, zobrazování na obrazovce a uživatelské prostøedí. Pøesná syntaxe je popsána v následujícím.

Pokud se zadá pøíkaz SET bez parametrù, objeví se dialogové okno, ve kterém mohou být všechny parametry nastaveny.

Pracovní plocha

Funkce dotažení	SET SNAP_LENGTH èíslo;

Nastaví vzdálenost, do které lze v pøíkazu ROUTE dotáhnout ukonèovací bod spoje (v aktuální jednotce).

Pøednastaveno: 20 mil

Pokud jsou spoje taženy pøíkazem ROUTE do blízkosti plošek které nejsou v rastru, funkce snap zajistí, že spoj bude dotažen až k plošce do vzdálenosti dotažení.

SET SNAP_BENDED ON | OFF;

pokud je nastaveno on pak záhyb taženého spoje bude v rastru, pokud jenastaveno wire_styles 1 a 3.

SET SELECT_FACTOR hodnota;

Nastavuje vzdálenost kolem kurzoru myši, do které jsou blízké objekty nabízeny k  výbìru. Hodnota se zadává relativnì k výšce právì viditelné èásti výkresu.
Pøednastaveno: 0.02 (2%).

Obsah menu	SET USED_LAYERS jméno | èíslo;

Specifikuje hladiny, které budou zobrazeny v souvisejících menu EAGLE. Viz pøíklad v souboru MYLAYERS.SCR.

Hladiny Top, Bottom, Pads, Vias, Unrouted, Dimension, Drills a Holes zùstávají v každém pøípadì v menu. Signálové hladiny ve kterých jsou spoje také v menu zùstávají.SET Used_Layers All activuje všechny hladiny.

SET WIDTH_MENU hodnota..;

SET DIAMETER_MENU hodnota..;

SET DRILL_MENU hodnota..;

SET SMD_MENU hodnota..;

SET SIZE_MENU hodnota..;

Výše uvedenými pøíkazy mùže být nastaven obsah spøažených okénkových menu pro parametry width atd.. V každém menu mùže být až 16 hodnot (16 párù hodnot v menu pro SMD).

Pøíklad:
Grid Inch;
Set Width_Menu 0.1 0.2 0.3;

Úhel zlomu èáry	SET WIRE_STYLE èíslo_stylu;

èíslo_stylu mùže nabávat hodnot 0 až 4.

0: Poèáteèní bod - vodorovnì - svisle - konec

1: Poèáteèní bod - vodorovnì - 45° - konec

2: Poèáteèní bod - konec (pøímé propojení)

3: Poèáteèní bod - 45° - vodorovnì - konec

4: Poèáteèní bod - svisle - vodorovnì - konec

Pípnutí ano/ne	SET BEEP ON | OFF;

Zobrazování na obrazovce

Barva èar rastru	SET COLOR_GRID barva;

Barva hladiny	SET COLOR_LAYER hladina barva;

Vyplòovací vzorek hladiny	SET FILL_LAYER hladina vzorek;

Parametry rastru	SET GRID_REDRAW ON | OFF;

Pøekreslí obrazovku nebo ne pøi zmìnì rastru.

SET MIN_GRID_SIZE obrazové_body;

Rastr se zobrazí pouze tehdy, když je velikost rastru vìtší než nastavený poèet obrazových bodù.

Min. velikost textu	SET MIN_TEXT_SIZE velikost;

Text menší než velikost obrazových bodù je na obrazovce vykreslen jako obdélník. Nastavení 0 znamená, že všechny texty budou èitelné.

Šíøka èar sítí	SET NET_WIRE_WIDTH šíøka;

Zobrazení plošek Pad	SET DISPLAY_MODE REAL | NODRILL | FAST;

REAL: Plošky jsou zobrazeny tak, jak budou vykresleny.
NODRILL: Plošky jsou zobrazeny bez vrtacích dìr.
FAST: Plošky jsou zobrazeny jako ètverce (rychlé pøekreslování obrazovky).

SET PAD_NAMES ON | OFF;

Jména plošek Pad jsou/nejsou zobrazena.

Zobrazení sbìrnic	SET BUS_WIRE_WIDTH šíøka;

DRC-Parametr	SET DRC_SHOW ON | OFF;

SET DRC_FILL jméno_výplnì;

SET DRC_COLOR barva;

SET MAX_ERROR_ZOOM hodnota;

Viz pøíkaz ERRORS.

Propoèítávání polygonù	SET POLYGON_RATSNEST ON | OFF;

Viz pøíkaz POLYGON.

Chování programu

Kontrola pouzder	SET CHECK_CONNECTS ON | OFF;

Pøíkaz ADD kontroluje, zda byl každý pin pøipojen ke každé plošce Pad (pøíkazem CONNECT). Tato kontrola mùže být vyøazena. V žádném pøípadì nemùže být ze schématu vygenerována deska, pokud je nalezena souèástka, která nemá pouzdro a má pøípojné body pin.

REPLACE Mód	SET REPLACE_SAME NAMES | COORDS;

UNDO pamì� ano/ne	SET UNDO_LOG ON | OFF;

optimalizace èar ano/ne	SET OPTIMIZING ON | OFF;

Pokud je nastaveno on, spoje které leží v jedné pøímce jsou po pøíkazech MOVE, ROUTE a SPLIT sceleny do jediného spoje. Viz také OPTIMIZE.

Barvy, seøazené podle èísel barev, které lze použít namísto názvù barev:

0	Black (èerná)

1	Blue (modrá)

2	Green (zelená)

3	Cyan (azurová)

4	Red (èervená)

5	Magenta (fialová)

6	Brown (hnìdá)

7	LGray (svìtle šedá)

8	DGray (tmavì šedá)

9	LBlue (svìtle modrá)

10	LGreen (svìtle zelená)

11	LCyan (svìtle azurová)

12	LRed (svìtle èervená)

13	LMagenta (svìtle fialová)

14	Yellow (žlutá)

15	White (bílá)

Fill stanoví výplò èar a pravoúhelníkù. Také tento parametr mùže být nahrazen èíslem na zaèátku øádku:

0	Empty (prázdný)

1	Solid (plný)

2	Line (èáry vodorovné)

3	LtSlash (tenké èáry /)

4	Slash (tuèné èáry /)

5	BkSlash (tuèné èáry \)

6	LtBkSlash (tenké èáry \)

7	Hatch (møíž +)

8	XHatch (møíž x)

9	Interleave (síto)

10	WideDot (øídké body)

11	CloseDot (husté body)


SHOW

Funkce

Zobrazuje informace o zvoleném objektu.

Zápis

SHOW •..
SHOW jméno..

Viz také INFO

Pøíkaz SHOW se používá pro zobrazení jmen a dalších podrobností prvkù a objektù. Parametry jsou vypsány v levém horním rohu obrazovky. Kompletní signály a sítì je možno zviditelnit pøíkazem SHOW.

Køížová zkouška

S aktivní Dopøednou a zpìtnou anotací je objekt zvýraznìný pøíkazem SHOW na desce zvýraznìn také ve schématu a obrácenì.

Rùzné objekty

Pokud pøíkazem SHOW vyberete souèasnì více objektù, každý z nich je zvýraznìn samostatnì.

Pøíklady

SHOW IC1 IC2;

Nejprve se zvýrazní IC1, pak je zatemnìn a je zvýraznìn IC2.

SHOW IC1;

IC1 se zvýrazní a zùstává zvýraznìn.

SHOW IC2;

IC2 je také zvýraznìn.


SIGNAL

Funkce

Definuje signály.

Zápis

SIGNAL • •..
SIGNAL jméno_signálu • •..
SIGNAL jméno_signálu jméno_pouzdra jméno_vývodu..;

Viz také AUTO, ROUTE, NAME, WIRE, RATSNEST, EXPORT

Pøíkaz SIGNAL se používá pro definování signálù (spojù mezi rùznými pouzdry). Aby mohl být signál vygenerován, uživatel musí definovat aspoò dva páry jméno_pouzdra/jméno_vývodu.

Zadání myší

Provádí se postupným výbìrem (pomocí myši) padù (nebo SMD) souèástek, které mají být propojeny, jeden po druhém. EAGLE zobrazuje èásti signálù jako vzdušné spoje ve hladinì Unrouted.

Pokud se signál zadá se jménem_signálu, obdrží zadané jméno.

Zadání textem

Signály mohou být také kompletnì zadány pomocí textu (pomocí klávesnice nebo skriptového souboru). Pøíkaz

SIGNAL GND IC1 7 IC2 7 IC3 7;

spojí vývody 7 souèástek IC1...3. Pro zadání celého netlistu se musí vygenerovat skriptový soubor s pøíponou *.SCR. Tento soubor musí obsahovat všechny potøebné pøíkazy SIGNAL ve formátu podle pøedchozího popisu.

Pøimá kontrola

Pokud je pøíkaz SIGNAL použit k propojení plošek (pad nebo smd) které už patøí jiným signálùm, objeví se menu a zeptá se uživatele, zda chce signály propojit dohromady a jaké jméno má výsledný signál obdržet.


SMASH

Funkce

Oddìlí texty >NAME a >VALUE od prvkù (symbolù nebo pouzder).

Zápis

SMASH •..

Viz také NAME, VALUE

Pøíkaz SMASH se používá pro prvky k uvolnìní textù se jménem a hodnotou od prvkù. Text pak mùže být pøesunut do nového, výhodnìjšího místa pøíkazem MOVE.

Použití pøíkazu SMASH umožní, aby s textem bylo zacházeno jako s každým jiným textem, napø. CHANGE SIZE, ROTATE, atd., ale vložený text nemùže být mìnìn.

Pokud je text uvolnìný pøíkazem SMASH smazán, pak se objeví ve své výchozí pozici a velikosti.


SMD

Funkce

Pøidává plošky smd k pouzdru.

Zápis

SMD •..
SMD x_šíøka 'jméno' •..
SMD x_šíøka y_výška 'jméno' •..

Myš

Pravé tlaèítko otáèí ploškou smd.
Støední tlaèítko mìní kreslící hladinu.

Viz také PAD, CHANGE, NAME, ROUTE

Pøíkaz SMD se používá pro pøidávání pájecích plošek souèástek smd do pouzdra. Pokud je pøíkaz smd aktivní, ploška smd je pøichycena ke kurzoru. Stiskem levého tlaèítka myši se ploška umístí do výkresu na aktuální pozici a na kurzoru se objeví nová ploška. Zadáním èísel lze mìnit šíøku x a výšku y plošky smd. Ta mùže být až 13.1 mm (0.51602 palce). Tyto parametry zùstávají zapamatovány pro následující pøíkazy SMD a mohou být zmìnìny pøíkazem CHANGE. Mohou být použity pouze sudé hodnoty. Stiskem støedního tlaèítka myši lze mìnit kreslící hladinu pro umístìní SMD plošek, pravé tlaèítko myši otáèí ploškou smd. Pøíkaz SMD je aktivní dokud není zadán jiný pøíkaz nebo ';' (støedník).

Jména

Jména plošek SMD jsou generována automaticky a mohou být zmìnìna pøíkazem NAME. Jména mohou mít až 8 znakù a v pøíkaze SMD musí být uzavøena v apostrofech.

Jména plošek smd se 3 a ménì znaky vyžadují mnohem ménì pamìti než jména s více znaky.

Jednotlivé plošky smd

Jednotlivé plošky smd mohou být na desku umístìny jedinì definováním a použitím pouzdra s jednou ploškou smd.

Zmìna pouzdra

Není možno pøidávat nebo mazat plošky smd v pouzdrech (package), která jsou už používána souèástkami (device), protože by to znamenalo zmìnu vztahù pin/smd definovanou pøíkazem CONNECT.


SPLIT

Funkce

Rozdìlí èáry a hrany polygonù na segmenty.

Zápis

SPLIT • •..

Myš

Pravé tlaèítko mìní druh_èáry (viz SET WIRE_STYLE).

Viz také MOVE, OPTIMIZE, SET

Pøíkaz SPLIT se používá k rozdìlení èáry (nebo segmentu) nebo hrany polygonu na dva segmenty napøíklad pro vytvoøení rohu. To tnamená, že mùžete rozdìlit spoje na èásti, kterými lze bìhem pøíkazu SPLIT pohybovat myší. Kliknutí myši oznaèí bod, ve kterém se spoj má rozdìlit. Kratší ze dvou nových segmentù se chová podle aktuálního nastavení wire_style a sám tedy sestává ze dvou segmentù (viz SET WIRE_STYLE), delší segment jde pøímo do dalšího koncového bodu.

Po ukonèení pøíkazu SPLIT se segmenty automaticky zcelí, pokud leží v pøímce a pokud tato funkce nebyla pøedem zakázána pøíkazem

SET OPTIMIZING OFF;

nebo pokud spoj nebyl kliknut na stejném místì dvakrát. V takovém pøípadì dìlící bod zùstane a mùže být použit, napøíklad, ke ztenèení šíøky segmentu. Toho dosáhneme vybráním pøíkazu SPLIT, oznaèením èásti spoje, která má být ztenšena dvìma kliknutím myši a použitím pøíkazu

CHANGE WIDTH šíøka

Nakonec se klikne na segment a tím je zmìna provedena.


TEXT

Funkce

Adds text to a drawing.

Zápis

TEXT  libovolný_text  orientace •..
TEXT 'libovolný_text' orientace •..

Myš

Pravé tlaèítko otáèí textem.
Støední tlaèítko mìní kreslící hladinu.

Viz také CHANGE, MOVE, MIRROR, PIN, ROTATE

Pøíkaz TEXT se používá pro pøidání textu do knihovního prvku nebo výkresu. Pokud se zadává nìkolik textových popisù, není tøeba zadávat pøíkaz vždy znovu, protože po umístìní textu myší zùstává pøíkaz stále aktivní.

Orientace

Orientaci textu lze urèit v pøíkaze TEXT (orientace). Používá se obvyklá definice, jak byla popsána v pøíkaze PIN (R0, R90 atd.). Pravé tlaèítko myši umožòuje mìmit natoèení textu a støední tlaèítko mìní aktuální kreslící hladinu.

Text je vžda zobrazován tak, že je èitelný zepøedu nebo zprava - i když je otoèen. Proto po každých dvou otoèeních se objeví stejnì, pouze záchytný bod se pøesune z dolního levého do horního pravého rohu. To je tøeba si pøipomenout pokud se zdá že je text nezachytitelný.

Zvláštní znaky

Pokud text obsahuje nìkolik následujících mezer nebo støedník, musí se celý text zavøít do jednoduchých uvozovek. Pokud text obsahuje jednoduché uvozovky, pak každá z nich musí být samostatnì uzavøena do jednoduchých uvozovek. Pokud jsou v textu požadovány apostrofy, každý musí být uzavøen v jednoduchých uvozovek.

(Pozn.: Jednoduchá uvozovka se nachází pouze na anglické klávesnici mezi ; a ENTER.)

Klíèová slova

Pokud pøíkaz TEXT je aktivní a chcete napsat text, který obsahuje øetìzec který by mohl být považován za nový pøíkaz (napø. "red" pro "REDO") pak takový øetìzec musí být uzavøen do jednoduchých uvozovek.

Velikost textu

Výška a síla èar znakù (pøesnìji pomìr velikosti textu k síle èar) mohou být mìnìny pøíkazy CHANGE:

CHANGE SIZE velikost_textu •..
CHANGE RATIO pomìr •..

Maximální velokost textu:  2 palce
Maximální šíøka èar: 0.51602 palce (13.1 mm)
Pomìr: 0...31 (% velikosti textu).

Zvláštní druhy textù

>NAME	Jméno souèástky (pøíp.+jméno hradla) 1)

>VALUE	Hodnota/typ souèástky 1)

>PART	Jméno souèástky 2)

>GATE	Jméno hradla 2)

>DRAWING_NAME	Jméno výkresu

>LAST_DATE_TIME	Èas poslední zmìny

>PLOT_DATE_TIME	Èas tisku/kreslení

>SHEET	Èíslo listu schématu 3)

1) Pouze pro pouzdra nebo schematické znaèky
2) Pouze pro znaèky
3) Pouze pro znaèky nebo schémata


UNDO

Funkce

Vrátí pøedchozí pøíkazy.

Zápis

UNDO;

Klávesnice

Funkèní klávesa F9: pøiøazena pøíkazu UNDO (výchozí).

Viz také REDO, SET, Dopøedná a zpìtná anotace

Pøíkaz UNDO umožòuje zrušit døíve vykonané pøíkazy. Je to zvláš� užiteèné, když omylem nìco smažete. Vícenásobní použití pøíkazu UNDO vás vrátí o odpovídající poèet pøíkazù zpìt, dokud není dosaženo nìkterého z posledních pøíkazù EDIT, OPEN, AUTO, nebo REMOVE. Není možno vrátit oprace s oknem obrazovky.

Pøíkaz UNDO používá diskový prostor. Pokud ho máte málo, mùžete tuto funkci vypnout pøíkazem SET

SET UNDO_LOG OFF;

Po použití pøíkazu UNDO se mohou nìkteré objekty jevit jako èásteènì vymazané. V takovém pøípadì zjednáte nápravu pøekreslením obrazovky (funkèní klávesa F2).

Funkce UNDO/REDO jsou plnì integrovány s dopøednou a zpìtnou anotací.


USE

Funkce

Otevøe knihovnu.

Zápis

USE
USE -*;
USE jméno_knihovny..;

Viz také ADD, REPLACE

Pøíkaz USE zavede knihovnu do pamìti. Když je knihovna zavedena, mohou být do výkresu pøidávány souèástky nebo pouzdra pomocí pøíkazu ADD.

Pro zmìnu aktivní knihovny jednoduše použijte opìt pøíkaz USE se jménem požadované knihovny.

Pokud aktivujete pøíkaz USE bez parametrù, objeví se roletové menu které nabízí k výbìru všechny soubory s pøíponou *.lbr, tedy knihovny. Pokud je cesta ke knihovnám definována v nastavení "Options/Directories", jsou nabízeny knihovny ze složky definované v této volbì.

Zvláštní parametr -* zpùsobí zmizení všech døíve otevíraných knihoven.

jméno_knihovny mùze být plné jméno knihovny nebo mùže obsahovat zástupné znaky " * ". Pokud jméno_knihovny je jménem složky, jsou aktivovány všechny knihovny v této složce.

Pøípona .LBR mùže být vynechána.

Pokud je zadáno více jmen knihovnen, je do pamìti natažena jen ta poslední. Všechny ostatní jsou evidovány ve vnitøním seznamu a budou pøístupné pomocí pøíkazù ADD a REPLACE.

Když se pøidává souèástka nebo pouzdro do výkresu, tak se do výkresu zkopíruje kompletní informace z knihovny, takže pøi pozdìjší zmìnì výkresu už knihovnu nepotøebujete.

Zmìny v knihovnách nemají vliv na již existující výkresy.

Pokud je knihovna, kterou hodláte použít právì upravována v editoru knihoven a není dosud uložena, budete dotázáni, zda chcete uložit soubor knihovny. Pokud na otázku odpovíte Yes, knihovna bude uložena a vy použijete upravenou knihovnu. Pokud odpovíte No, upravená knihovna uložena nebude a vy použijete knihovnu ve stavu, v jakém je uložena na disku. Tlaèítko Cancel zruší celý pøíkaz, takže nic nebude uloženo ani nebude použita nová knihovna.

Pøíklady

USE	otevøe dialog pro výbìr knihovny

USE -*;	vymaže seznam døíve použitých knihoven

USE DEMO TRANS*;	natáhne knihovnu DEMO.LBR a všechny knihovny se jmény zaèínajícími TRANS*.LBR

USE -* C:\EAGLE\LBR;	nejprve vyøadí všechny døíve natažené knihovny a pak natáhne všechny knihovny z adresáøe C:\EAGLE\LBR


VALUE

Funkce

Zobrazuje a mìní hodnoty.

Zápis

VALUE •..
VALUE hodnota •..
VALUE jméno hodnota ..
VALUE ON;
VALUE OFF;

Viz také NAME, SMASH

Na deskách a schématech

Prvkùm mùže být pøiøazena hodnota, napø. '1k' pro odpor nebo '10uF' pro kondenzátor. To se provádí pøíkazem VALUE. Pøíkaz vybere prvek a otevøe menu, které umožní vložit nebo zmìnit hodnotu.

Pokud zadáte hodnotu bez pøedchozího výbìru prvku, pak všechny následnì vybrané prvky obdrží tuto hodnotu. To je velmi užiteèné když napøíklad chcete øadì odporù dát stejnou hodnotu.

Pokud jsou po sobì zadávány údaje jména a hodnoty, vymenovaný prvky obdrží pøíslušné hodnoty.

Pøíklad

VALUE R1 10k R2 100k

V tomto pøípadì více prvkù dostane hodnotu. Tato možnost je výhodná hlavnì ve skriptových souborech:

VALUE R1   10k \
      R2  100k \
      R3  5.6k \
      C1  10uF \
      C2  22nF \
      ...

Znak "\" na konci øádku zajiš�uje, že následující øádek nebude programem považován za pøíkaz.

V módu souèástek (Device)

Pokud je použit pøíkaz VALUE v módu editace souèástek, musí se použít parametry ON nebo OFF:

On: Povoluje zmìnu aktuální hodnoty ve schématu.

Off: Automaticky pøepíše aktuální hodnotu z knihovny do schématu (napø.7400) a ta nemùže být ve schématu zmìnìna.


VIA

Funkce

Pøidává prokovy (via) na desku.

Zápis

VIA •..
VIA 'jméno_signálu' prùmìr tvar •..

Viz také SMD, CHANGE, SET, PAD

Když je pøíkaz VIA aktivován, ke kurzoru se pøipojí znak prokovu (via). Stiskem levého tlaèítka myši se prokov umístí v aktuální pozici na desku a ke kurzoru je pøipojen nový symbol prokovu. Když se prokov umístí na signálový spoj, je proveden test na zkraty. Když se pokusíte spojit rùzné signály, EAGLE se zeptá, zda je chcete skuteènì propojit.

Jméno signálu

Parametr jméno_signálu je urèen hlavnì pro použití ve skriptových souborech, které ètou v generovaných datech. Když je zadáno jméno_signálu, všechny následující prokovy budou pøidány k tomuto signálu a nebude provedena automatická kontrola.
Tuto vlastnost je nutno používat s velkou opatrností, protože  pøi umístìní prokovu na místo, kde spojí rùzné signály dojde ke zkratu. Po použití pøíkazu VIA s parametrem  signal_name se doporuèuje spustit kontrolu Design Rule Check!

Velikost prokovu Via

Zadáním èísla se mìní prùmìr prokovu (v aktuálních jednotkách) a hodnota zùstává použita i pro další prokovy. Prùmìry prokovù mohou být až 0.51602 palce (13.1 mm).

Prùmìr vrtáku prokovu (Via) je stejný jako prùmìr nastavený pro pájecí plošky (Pad). Mùže být zmìnìn pomocí

CHANGE DRILL prùmìr •

Tvar (Shape)

Prokov mùže mít nìkterý z následujících tvarù:

     Square (ètverec)
     Round (koleèko)
     Octagon (osmiúhelník)

Prokovy generují vrtací symboly v kreslící hladinì Drills a pøíslušné symboly v nepájivývé masce v kreslících hladinách tStop/bStop .

Stejnì jako prùmìr, tak i tvar prokovu lze zadat v dobì kdy je pøíkaz VIA aktivní, nebo se mùže pozdìji zmìnit pøíkazem CHANGE. Hodnoty pak zùstávají nastaveny i pro další prokovy a plošky.

Rychlé zobrazení

Protože vykreslování rùzných tvarù prokovù a prùmìrù vrtákù v jejich skuteèné velikosti zpomaluje pøekreslování obrazovky, EAGLE umožòuje pøepínat mezi reálným a rychlým zpùsobem zobrazení pomocí pøíkazù SET:

SET DISPLAY_MODE REAL | NODRILL | FAST;


WINDOW

Funkce

Zvìtšuje nebo zmenšuje pohled na výkres.

Zápis

WINDOW;
WINDOW •;
WINDOW • •;
WINDOW • • •
WINDOW mìøítko
WINDOW FIT

Myš

Kliknutí levým tlaèítkem&tažení pracuje jako zkratka pro "• •;".

Klávesnice

Alt-F2: WINDOW FIT  Výkres vyplní obrazovku (okno)
F2:     WINDOW;     Obrazovka se pøekreslí
F3:     WINDOW 2    Zvìtšení 2x
F4:     WINDOW 0.5  Zmenšení na polovinu
F5:     WINDOW (@); Nový støed na pozici kurzoru (pokud je pøíkaz aktivní)

Pøíkaz WINDOW se používá pro zvìtšování a zmenšování výkresu a ke zmìnì umístìní výkresu na obrazovce. Pøíkaz je možno použít také pomocí tøí klikù myší. Pokud je klikù ménì, je nutno pøíkaz ukonèit støedníkem.

Obnova obrazovky

Pokud použijete pøíkaz WINDOW následovaný støedníkem, EAGLE pøekreslí obrazovku beze zmìny polohy výkresu nebo mìøítka. To je užiteèné, pokud chybová hlášení pøekryjí èást výkresu.

Nový støed

Pøíkaz WINDOW s jedním kliknutým bodem znamená, že tento bod se stává novým støedem zobrazeného výkresu. Mìøítko výkresu se nemìní. Pro posunutí viditelné èásti výkresu lze použít také posuvníky (šipky) na okrajích okna výkresu. Funkèní klávesa F5 umístí støed výkresu na aktuální pozici kurzoru.

Rohové body

Pøíkaz WINDOW zadaný se dvìma kliknutími definuje obdélník s protìjšími rohy v místech kliknutí. Obdélník se roztáhne tak, aby vyplnil obrazovku tak, že je vidìt celá plocha definovaná obdélníkem.

Nový støed a mìøítko

Pøíkaz WINDOW mùžete definovat i tøemi kliknutími. První bod znaèí nový støed výkresu a zobrazení se zvìtší nebo zmenší v závislosti na umístìní dalších dvou kliknutí. Pro zvìtšení musí být vzdálenost mezi body 1 a 3 vìtší než vzdálenost mezi body 1 a 2; pro zmenšení umístìte bod 3 mezi body 1 a 2.

Zvìtšení a zmenšení

WINDOW 2;

Zvìtší prvky na dvojnásobek.

WINDOW 0.5;

Zmenší velikost prvkù na polovinu.

K pøíkazu WINDOW mùžete pøidat celé nebo desetinné èíslo, které znamená zmìnu mìøítka. Støed zobrazení se pøitom nemìní.

Celý výkres

WINDOW FIT;

zobrazí na obrazovce celý výkres.


WIRE

Funkce

Kreslí spoje do výkresu.

Zápis

WIRE • •..
WIRE 'jméno_signálu' šíøka_spoje • •..
WIRE • šíøka_spoje •..

Myš

Pravé tlaèítko mìní styl_èáry (viz SET Wire_Style).
Støední tlaèítko vybírá hladinu.

Viz také SIGNAL, ROUTE, CHANGE, NET, BUS, DELETE, RIPUP

Pøíkaz WIRE se používá k pøidávání spojù do výkresu. Spoj zaèíná n aprvním urèeném bodì a bìží do dalšího. Další body kreslí další segmenty. Dvì kliknutí myší na stejném místì ukonèí spoj a je možno zaèít další spoj v bodì dalšího kliku myši.

V závislosti na právì nastaveném stylu èáry je nakreslen jeden nebo dva segmenty spoje. Styl èáry definuje úhel, který svírají segenty a lze ho prùbìžnì mìnit pravým tlaèítkem myši. Stisk prostøedního tlaèítka myši vyvolá menu, ze kterého lze vybrat hladinu, ve které se bude spoj kreslit.

Jméno signálu

Parametr jméno_signálu je urèen pøedevším pro skriptové soubory které ètou v generovaných datech. Pokud je jméno_signálu zadáno, všechny následující spoje budou patøit tomuto signálu a nebudou provádìny automatické kontroly.
Tuto možnost je tøeba užívat s velkou opatrností protože mùže zpùsobit zkraty, pokud se spoj umístí tak, že propojí rùzné signály. Po použití pøíkazu WIRE je vodné spustit kontrolu Design Rule Check s parametrem jméno_signálu !

Šíøka èáry

Zadání èísla po aktivaci pøíkazu WIRE mìní šíøku èáry (v aktuálních jednotkách) která mùže být až 0.51602 palce (13.1 mm).

Šíøka èáry mùže být kdykoliv mìnìna pøíkazem

CHANGE WIDTH šíøka •

Signály ve hladinách Top, Bottom, a Route

Èáry ve hladinách Top, Bottom, a ROUTE2...15 jsou považovány za signály. Pokud kreslíte èáru v nìkteré z tìchto hladin, která zaèíná na nìkterém z existujících signálù, pak všechny segmenty této èáry patøí tomuto signálu (pouze pokud støed èáry je umístìn pøímo do støedu existující èáry nebo plošky). Pokud konèíte tuto èáru na segmentu èáry, pøipojeném k jinému signálu, pak se EAGLE zeptá, jestli chcete propojit tyto dva signály.

Upozoròujeme, že EAGLE považuje každý segment spoje za samostatný objekt (napø. pøi mazání spojù).

Když je pøíkaz WIRE aktivní, lze použít støední tlaèítko myši ke zmìnì hladiny, do které se má spoj kreslit.

Nepoužívejte pøíkaz WIRE pro sítì (net), sbìrnice (bus), a vzdušné spoje (airwire). Viz NET, BUS a SIGNAL.


WRITE

Funkce

Ukládá aktuální výkres nebo knihovnu.

Zápis

WRITE;
WRITE jméno WRITE @jméno

Pøíkaz WRITE se používá k uložení výkresu nebo knihovny. Pokud je zadáno 'jméno' , EAGLE uloží soubor pod novým jménem.

Pokud se má soubor uložit do jiného adresáøe (složky), pak se musí zadat také cesta do této složky. Pokud není cesta zadána, soubor je uložen do pracovního adresáøe.

Pokud je pøed novým jménem @, je podle nového jména pøejmenován také právì natažený výkres. Odpovídající deska/schéma bude také automatcky uložena pod tímto jménem a je vymazána pamì� krokù UNDO.

Pokud je WRITE vybrán z menu, objeví se okno s dotazem na jméno, které se má použít (pøednastaveno je souèasné jméno výkresu). Toto jméno je možno editovat a potvrdit kliknutím na tlaèítko OK. Stisk klávesy ESCAPE nebo kliknutí na tlaèítko CANCEL zruší pøíkaz WRITE.

Pro zajištìní vazby mezi deskou a schématem v dopøedné &zpìtné anotaci. má pøíkaz WRITE následující pøídavné funkce:

•	když je deska/schéma uloženo pod stejným jménem jsou také uloženy odpovídající schéma/deska, pokud byly modifikovány.

•	Pokud jsou deska/schéma uloženy po rùznými jkmény, uživatel bude dotázán, zda skuteènì chce uložit schéma/desk pod rùznými jmény.


Tisk a kreslení

Pokud zadáte pøíkaz PRINT bez ukonèení  ';', nebo vyberete Print z kontextového menu ikony kreslení Ovládacího panelu, objeví se Vám menu s následujícími možnostmi:

Mirror

Zrcadlí výstup.

Rotate

Otáèí výstup o 90°.

Upside down

Otáèí výkres o 180°. Dohromady s Rotate, lze takto otoèit výkres o celkem 270°.

Black

Ignoruje nastavení barev kreslících hladin a vše tiskne èernì.

Solid

Ignoruje nastavení stylù hladin a tiskne vše s plnou plochou.

Scale factor

Nastaví mìøítko tisku podle zadané hodnoty.

Page limit

Definuje maximální poèet stránek, které je možno použít pro výstup. Pokud se výkres nevejde na zadaný poèet stránek, mìøítko bude zmenšeno tak, aby se vešel. Pøednastavená hodnota 0 znamená "bez omezení".

All

Budou vytištìny všechny listy schématu (to je pøednastaveno, když se zvolí Print z kontextového menu ikony výkresu schémat).

From...to

Budou vytištìny jen listy od [from] ... do [to].

This

Bude vytištìn jen list, který je právì editován (to je pøednastaveno pøi použití pøíkazu PRINT z okna editoru schématu).

Printer...

Vyvolá dialogové okno tiskárny, které Vám umožní vybrat tiskárnu a nastavit její specifické parametry (jako velikost papíru a orientaci).

Page...

Vyvolá Nastavení stránky tiskárny.


Tisk textu

Pokud vyberete Print z kontextového menu z ikony textového souboru Ovládacího panelu, nebo z menu File  Textového editoru, dostanete se do nabídky s následujícími možnostmi:

Wrap

Umožòuje zalamování pøíliš dlouhých øádek tak, aby se vešly na šíøku stránky.

Printer...

Vyvolá okno systémové tiskárny, které Vám umožní vybrat tiskárnu která se má použít a nastavit její specifické parametery (jako velikost papíru a orientaci).

Page...

Vyvolá Nastavení stránky tiskárny.


Nastavení stránky tiskárny

Okno Nastavení stránky tiskárny se používá pro nastavení, jak má být výkres nebo text umístìn na papíru.

Border

Definuje levý, horní, pravý a spodní okraje stránky. Hodnoty jsou buï v milimetrech nebo v palcích, v závislosti na Vašem nastavení operaèního systému.

Pøednastavené hodnoty okrajù jsou pøevzaty z ovladaèe tiskárny a definují maximální oblast pro tisk, kterou Vaše tiskárna mùže obsáhnout. Jakékoliv hodnoty sem zadáte, budou omezeny na tyto hardwarové limity.

Po zmìnì typu tiskárny se objeví nové hardwarové limity a zmìní se Vaše nastavení limitù okrajù tak, aby se maximálnì využilo použitelné plochy tisku nové tiskárny. Pozor ! Hodnoty se automaticky nesníží, pokud použijete tiskárnu s menší tisknutelnou plochou. Pro dosažení nejmenších možných okrajù zadejte 0 do každého pole. Tak bude nastaveno hardwarové minimum.

Calibrate

Pokud chcete použít tiskárnu na vytvoøení výrobních podkladù plošných spojù, mìli byste si zkalibrovat Vaši tiskárnu pro dosažení pøesné reprodukce 1:1 Vašeho návrhu spojù.

Hodnota pole X se používá pro kalibraci ve smìru pohybu tiskové hlavy (vodorovném), zatímco hodnoty pole Y se používá pro kalibraci ve smìru pohybu papíru (svislém).

Dùležitá POZNÁMKA: Pokud vytváøíte výrobní podklady pomocí Vaší tiskárny, vždy zkontrolujte výsledný výtisk na správnost rozmìrù!

Pøednastavená hodnota 1 pøedpokládá, že tiskárna zachovává pøesná mìøítka v obou smìrech.

Vertical

Definuje svislé zarovnání výkresu buï nahoøe [Top], uprostøed [Center] nebo dole [Bottom].

Horizontal

Definuje vodorovné zarovnání výkresu buï vlevo [Left], uprostøed [Center] nebo vpravo [Right].

Caption

Activuje tisk informaèního øádku, který obsahuje údaje èasu a data tisku a jméno tištìného souboru.

Pokud je výkres zrcadlený, v informaèním øádku se objeví slovo "mirrored". Pokud mìøítko není 1.0 bude tam také pøipsáno jako f=....

Printer...

Vyvolá okno systémové tiskárny, které Vám umožní vybrat tiskárnu která se má použít a nastavit její specifické parametery (jako velikost papíru a orientaci).


CAM Processor

CAM Processor Vám umožòuje provést výstup libovolné kombinace hladin na zaøízení nebo do souboru.

Následující témata nápovìdy Vás provedou nezbytnými kroky od výbìru datového souboru až po konfiguraci výstupního zaøízení:

•	Výbìr datového souboru

•	Výbìr typu výstupního zøízení

•	Výbìr výstupního souboru

•	Výbìr hladin pro výstup

•	Nastavení parametrù zaízení

•	Nastavení parametrù desky (pokud se zpracovává soubor desky)

•	Výbìr listu (pøi zpracování schématu)

•	Nastavení voleb pøíznakù

CAM Processor Vám umožní kombinovat nìkolik nìkolik sad nastavení parametrù z tzv. Úlohy CAM Procesoru [CAM Processor Job], která mùže být použita k vytvoøení kompletní sady výstupních souborù pomocí jediného kliknutí myší.

Viz také Tisk na systémové tiskárnì


Hlavní menu CAM

Hlavní menu CAM je to, kde vybíráte, který soubor se bude zracovávat, editujete sadu vrtákù a soubory prùmìrù clonek fotoplotru a naèítáte nebo ukládáte soubory úloh.

File

Open	Board...  otevøe soubor desky ke zpracování

Schematic...  otevøe soubor schémat pro zpracování,

Drill rack...  otevøe soubor sady vrtákù pro editaci

Wheel...  otevøe soubor clonek pro editaci

Job...  pøepne do jiné úlohy (nebo vytvoøí novou)

Save job...	uloží souèasnou úlohu

Close	zavøe okno CAM Processoru

Exit	ukonèí program

Layer

Deselect all	zruší výbìr všech hladin

Show selected	zobrazí pouze vybrané hladiny

Show all	zobrazí všechny hladiny

Help

General help	otevøe hlavní stránku nápovìdy

Contents	otevøe obsah nápovìdy

CAM Processor	zobrazí nápovìdu pro CAM Processor

Job help	zobrazí nápovìdu k mechanismu úloh

Device help	zobrazí nápovìdu k výstupním zaøízením


Úloha CAM Processoru

Úloha [Job] CAM Processoru se skládá z nìkolika Sekcí [Sections]. Každá z nich definuje kompletní sadu parametrù CAM Processoru a výbìr hladin.

Typická úloha CAM Processoru má napøíklad dvì sekce. Jednu, která vytvoøí data pro fotoplotr pro horní vrstvu a jiná která vytvoøí data pro spodní stranu desky.

Section

Výbìr Section ukazuje právì aktivní sekci úlohy. Stiskem tlaèítka mùžete vybrat libovolné sekce, které jste pøedtím nadefinovali pomocí tlaèítka Add.

Prompt

Pokud do tohoto pole zadáte text, CAM Processor se Vás tímto textem zeptá pøed provedením této èásteèné sekce úlohy. Napøíklad mùžete chtít vymìnit papír v perovém plotru pro každý výkres, takže výzva by mohla být "Prosím vymìòte papír!". Každá sekce úlohy mùže mít svou vlastní výzvu. Pokud výzva není zadána, sekce se provede okamžitì automaticky.

Add

Pro pøidání nové sekce do úlohy kliknìte tlaèítko Add. Budete požádáni o zadání jména nové sekce úlohy. Nová sekce úlohy bude bude vytvoøena se všemi parametry nastavenými na hodnoty právì zobrazené v menu.
Doporuèujem pøi vytváøení nové sekce úlohy nejdøíve pøidat tuto novou sekci a pak upravit parametry. Jinak, pokud nejdøíve upravíte paramtry aktuální sekce a pak pøidáte novou sekci, budete žádáni o potvrzení, zda úpravy aktuální sekce mají být uloženy nebo ne.

Del

Tlaèítko Del se použije pro smazání aktuální sekce úlohy. pak budete žádáni o potvrzení, zda chcete skuteènì smazat aktuální sekci.

Process

Tlaèítko Process vykoná aktuální sekci úlohy, jak je zobrazena ve výbìru Section.

Process Job

Tlaèítko Process Job vykoná celou úlohu postupným vykonáváním jednotlivých sekcí, poèínaje první sekcí. Vykoná se to stejné, jako kdybyste vybírali postupnì jednotlivé sekce výbìrem Section a spouštìli je jednotlivì tlaèítkem Process - je to však pohodlnìjší! !-- --------------------------------------------------------------------------- -->


Výstupní zaøízení [Output Device]

Output Device definuje druh výstupu, který má CAM Processor vytvoøit. Mùžete si vybrat z rùzných typù zaøízení, jako tiskárny, plotry, vrtaèky etc.

Device

Kliknutí na tlaèítko výbìru Device otevøe seznam všech dostupných výstupních zaøízení.

Scale

U zaøízení, která mohou nastavit mìøítko výstupu mùžete do tohoto pole zadat mìøítko. Hodnoty vìtší než 1 zpùsobí zvìtšení výstupu, hodnoty menší než 1 zmenší výstup.

Output

Do tohoto pole mùžete buï zadat jméno výstupního souboru [output file] nebo kliknout na tlaèítko Output pro otevøení dialogu o souborech a výbìr z nìho.
Pokud chcete odvodit jméno výstupního souboru ze souboru vstupního, mùžete zadat neúplné jméno souboru (alespoò pøíponu, napø. .GBR). V tomto pøípadì je zbytek jména souboru pøevzat ze vstupního souboru.

Wheel

You can either enter the name of the aperture wheel file directly into this field, or click on the Wheel button to open a file dialog to select from.
If you want to derive the output filename from the input data file, you can enter a partial filename (at least an extension, e.g. .WHL), in which case the rest of the filename will be taken from the input data filename.

Rack

You can either enter the name of the drill rack file directly into this field, or click on the Rack button to open a file dialog to select from.
If you want to derive the output filename from the input data file, you can enter a partial filename (at least an extension, e.g. .DRL), in which case the rest of the filename will be taken from the input data filename.


Device Parameters

Depending on the type of output device you have selected, there are several device specific parameters that allow you to adjust the output to your needs:

•	Aperture Wheel File

•	Aperture Emulation

•	Aperture Tolerances

•	Drill Rack File

•	Drill Tolerances

•	Offset

•	Page Size

•	Pen Data


Soubor clonek fotoplotru

Fotoplotr obvykle potøebuje znát které clonky jsou pøiøazeny kódùm použitým ve výstupním souboru. Tato pøiøazení jsou definována v Souboru clonek fotoplotru [Aperture Wheel File].

Pøíklady

D010    annulus   0.004 x 0.000
D010    round     0.004
D040    square    0.004
D054    thermal   0.090 x 0.060
D100    rectangle 0.060 x 0.075
D104    oval      0.030 x 0.090
D110    draw      0.004


Emulace clonek

Pokud je vybrána položka "Apertures" , clonky které nejsou k dispozici jsou emulovány pomocí menších prùmìrù. Pokud tato položka není vybrána, nebude se provádìt emulace clonek.

"Annulus" a/nebo "Thermal" se vyberou tehdy, když je tøeba emulovat tyto typy clonek (pracuje to pouze když jeu také vybráno "Apertures").

Upozoròujeme, že taková emulace clonek mùže vést ke dlouhým kreslícím èasùm (cenám!).


Tolerance clonek

Poud zadáte tolerance clonek pro kreslení a/nebo bodových clonek, CAM Processor použije clonky v rámci tìchto tolerancí, pokud není k dispozici pøesný prùmìr clonky.

Tolerance se zadávají jako desetinná èísla (0.1 = 10%).

Prosím uvìdomte si, že pravidla návrhu (izolaèní vzdálenoti!) nemusí být dodrženy, pokud povolíte tolerance!


Soubor definice vrtákù

A drill station needs to know which drill diameters are assigned to the codes used in the output file. These assignments are defined in a Drill Rack File.

Pøíklad

T01   0.010
T02   0.016
T03   0.032
T04   0.040
T05   0.050
T06   0.070


Drill Tolerances

If you enter tolerances for drills the CAM Processor uses drill diameters within the tolerances, provided the drill with the exact value is not available.

Tolerances are entered as decimal numbers (0.1 = 10%).


Offset

Offset in x and y direction (inch, decimal number).

Can be used to place more than one drawing on a sheet, or to position the origin of plotters at the lower left corner.


Page Size

Height

Printable area for matrix printers in Y direction (inch). This is the direction the paper moves.

Width

Printable area in X direction (inch).

Please note that the CAM Processor divides a drawing into several pages if the rectangle which includes all objects of the file (even the ones not printed) doesn't fit into the printable area.


Pen Data

Diameter

Pen diameter in mm. Is used for the calculation of lines when areas have to be filled.

Velocity

Pen velocity in cm/s for pen plotters which can be adjusted to different speeds.

The plotter default speed is selected with the value 0.


Defining Your Own Device Driver

The drivers for output devices are defined in the text file EAGLE.DEF. There you find details on how to define your own driver. It is advisable to copy the whole section of an existing driver of the same device category and to edit the parameters which are different.

Please use a text editor which doesn't place control characters into the file.


Output File

The Output File contains the data produced by the CAM Processor. This can either be a data file on a disk, or a parallel or serial port.

The following file names are commonly used:

-------------------------------------------------------
File   Layers               Meaning
-------------------------------------------------------
*.cmp  Top, Via, Pad        Component side
*.ly2  Route2, Via, Pad     Inner signal layer
*.ly3  Route3, Via, Pad     Inner signal layer
*.ly4  $User1               Inner supply layer
...                         ...
*.sol  Bot, Via, Pad        Solder side
*.plc  tPl, Dim, tName,     Silkscreen comp. side
*.pls  bPl, Dim, bName,     Silkscreen solder side
*.dcc  tPl, Dim, tName,     Doc. print comp. side
       tVal, tDocu
*.dcs  bPl, Dim, bName,     Doc. print sold. side
       bVal, bDocu
*.stc  tStop                Solder stop mask comp. side
*.sts  bStop                Solder stop mask sold. side
*.drp  Drills, Holes, Dim   Position of drill holes
*.drd  Drills, Holes        Drill data for NC drill st.
-------------------------------------------------------

Alternative Output File Names

If you enter ".EXT" into the Output field the output file "boardname.EXT" will be generated.

In order to avoid the Gerber info file in a Job being overwritten by the following Section, you can enter ".xx#" into the Output field (where "xx" stands for any valid filename characters). The output file name will then be "boardname.xxX", and the info file name will be "boardname.xxI". If, for instance, a board named "MYBOARD.BRD" is loaded and you have entered ".CP#" into the Output field, an output file "MYBOARD.CPX" and a Gerber info file "MYBOARD.CPI" will be generated.

Fixed Output Channel for a Device

The output channel for a device can be defined directly in the EAGLE.DEF file. In this case you have to add the following line to the definition block of the device:

OUTPUT = port | filename

Pøíklad

OUTPUT = COM1:9600N81R


COM Port Parameters

Select the parameters for the serial interface.

You can enter the string for the option "Output" directly into the Output field if you like.

Pøíklad

COM1:9600N81R

You can also define the output channel for a device in the EAGLE.DEF file. To do that, add the following line to the definition block of the device:

OUTPUT = port | filename

Pøíklad

OUTPUT = COM1:9600N81R

Cable for the Serial Interface

The following diagram shows the most common wiring used to connect a computer with a serial output device. Please consult the manual of your particular output device for further details.

Computer           Output Device
25pin  9pin        25pin
--------------------------------
           Xon/Xoff
--------------------------------
 3      2 ____  ____ 2
              \/
 2      3 ____/\____ 3
 7      4 _        _ 4
 8      5 _|      |_ 5
 5      7 __________ 7
 6      6 _
 4     20 _|
--------------------------------
           RTS/CTS
--------------------------------
 3      2 ____  ____ 2
              \/
 2      3 ____/\____ 3
                   _ 4
 8      5 _       |_ 5
 6      6 _|________ 20
 5      7 __________ 7
--------------------------------


Flag Options

Mirror

Mirror output. This option normally causes negative coordinates, therefore it should be used only if "pos. Coord." is selected, too.

Rotate

Rotate drawing by 90 degrees. This option normally causes negative coordinates, therefore it should be used only if "pos. Coord." is selected, too.

Upside down

Rotate the drawing by 180 degrees. Together with Rotate, the drawing is rotated by a total of 270 degrees. This option normally causes negative coordinates, therefore it should be used only if "pos. Coord." is selected, too.

pos. Coord

Offsets the output so that negative coordinates are eliminated and the drawing is referenced to the origin of the output device. This is advisable for devices which generate error messages if negative coordinates are detected.

Quickplot

Draft output which shows only the outlines of objects (subject to availability on the selected output device).

Optimize

Activates the optimization of the drawing sequence for plotters.

Fill pads

Pads will be filled. This function can be properly executed only if the values for pen diameter, pad diameter and drill diameter allow it.
If this option is not selected, the drill holes of pads will be visible on the output.


Layers and Colors

Select the layer combination by clicking the check boxes in the Layer list.

If you have selected an output device that supports colors, you can enter the color number in the Color field of each layer.

The following layers and output file names are commonly used to create the output:

-------------------------------------------------------
File   Layers               Meaning
-------------------------------------------------------
*.cmp  Top, Via, Pad        Component side
*.ly2  Route2, Via, Pad     Inner signal layer
*.ly3  Route3, Via, Pad     Inner signal layer
*.ly4  $User1               Inner supply layer
...                         ...
*.sol  Bot, Via, Pad        Solder side
*.plc  tPl, Dim, tName,     Silkscreen comp. side
*.pls  bPl, Dim, bName,     Silkscreen solder side
*.dcc  tPl, Dim, tName,     Doc. print comp. side
       tVal, tDocu
*.dcs  bPl, Dim, bName,     Doc. print sold. side
       bVal, bDocu
*.stc  tStop                Solder stop mask comp. side
*.sts  bStop                Solder stop mask sold. side
*.drp  Drills, Holes, Dim   Position of drill holes
*.drd  Drills, Holes        Drill data for NC drill st.
-------------------------------------------------------


Board Parameters

When producing data files for a board the following parameters can be adjusted to your needs:

•	Annulus

•	Thermal

•	Mask Data


Annulus

Annulus symbols isolate through-holes in supply layers.

Their dimensions are calculated in the following way, based on the parameters "Isolate" and "Conduct" along with the drill diameter:

Inner diameter = D + 2 * C
Outer diameter = max(D, Inner dia.) + 2 * I

which: D = drill diameter
       C = Conduct (Default: -1000, completely filled)
       I = Isolate (Default:  20 [Mil])

With the default settings annulus symbols with an isolation ring of 20 Mils width are generated.


Thermal

Thermal symbols connect through-holes in supply layers with the supply signal.

The dimensions of the symbol are calculated with the parameters "Isolate", "Conduct", and "Gap" along with the drill diameter:

Inner diameter = D + 2 * C
Outer diameter = Inner diameter + 2 * I
Gap = width of the conducting paths in
      the thermal symbol
      Default: 20 [Mil]
      (only relevant with emulation)

where: D = drill diameter
       C = Conduct (Default: 20 [Mil])
       I = Isolate (Default: 10 [Mil])

With the default settings thermal symbols with a conducting ring of 20 Mils width are generated. The isolation lines are 10 Mils wide and leave conducting paths of 20 Mils width.


Mask Data

Stop frame

Oversize (negative value = undersize) of solder stop mask versus pads.

Stop limit

No solder stop mask is generated if the drill diameter is below "Limit".

Cream frame

Oversize (negative value = undersize) of solder cream mask versus smd pads.

All values in Mil.


Sheet Selection

If you have loaded a schematic that contains more than one Sheets, you can use the Sheet selector to define which sheet shall be processed.


Autorouter

The integrated Autorouter can be started from a board window with the AUTO command.

Please check your license to see whether you have access to the Autorouter module.


Design Checks

There are two integrated commands that allow you to check your design:

•	Electrical Rule Check (ERC)

•	Design Rule Check (DRC)

The ERC is performed in a schematic window, and checks the design for electrical consistency.

The DRC is performed in a board window, and checks the design for overlaps, distance violations etc.


User Language

The EAGLE User Language can be used to access the EAGLE data structures and to create a wide variety of output files.

To use this feature you have to write a User Language Program (ULP), and then execute it.

The following sections describe the EAGLE User Language in detail:

Syntax	lists the rules a ULP file has to follow

Data Types	defines the basic data types

Object Types	defines the EAGLE objects

Definitions	shows how to write a definition

Operators	lists the valid operators

Expressions	shows how to write expressions

Statements	defines the valid statements

Builtins	lists the builtin constants, functions etc.


Writing a ULP

A User Language Program is a plain text file which is written in a C-like syntax. User Language Programs use the extension .ULP. You can create a ULP file with any text editor (provided it does not insert any additional control characters into the file) or you can use the builtin text editor.

A User Language Program consists of two major items, definitions and statements.

Definitions are used to define constants, variables and functions to be used by statements.

A simple ULP could look like this:

// Definitions:

string hello = "Hello";

int count(string s)
{
  int c = 0;
  for (int i = 0; s[i]; ++i)
      c += s[i];
  return c;
}

// Statements:

output("sample") {
  printf("Count is: %d\n", count(hello));
  }


Executing a ULP

User Language Programs are executed by the RUN command from an editor window's command line.

A ULP can return information on whether it has run successfully or not. You can use the exit() function to terminate the program and set the return value.

A return value of 0 means the ULP has ended "normally" (i.e. successfully), while any other value is considered as an abnormal program termination.

The default return value of any ULP is 0.

When the RUN command is executed as part of a script file, the script is terminated if the ULP has exited with a return value other than 0.


Syntax

The basic building blocks of a User Language Program are

•	Whitespace

•	Comments

•	Keywords

•	Identifiers

•	Constants

•	Punctuators

All of these have to follow certain syntactical rules, which are described in their respective sections.


Whitespace

Before a User Language Program can be executed, it has to be read in from a file. During this read in process, the file contents is parsed into tokens and whitespace.

Any spaces (blanks), tabs, newline characters and comments are considered whitespace and are discarded.

The only place where ASCII characters representing whitespace are not discarded is within literal strings, like in

string s = "Hello World";

where the blank character between 'o' and 'W' remains part of the string.

If the final newline character of a line is preceded by a backslash (\), the backslash and newline character are both discarded, and the two lines are treated as one line:

"Hello \
World"

is parsed as "Hello World"


Comments

When writing a User Language Program it is good practice to add some descriptive text, giving the reader an idea about what this particular ULP does. You might also want to add your name (and, if available, your email address) to the ULP file, so that other people who use your program could contact you in case they have a problem or would like to suggest an improvement.

There are two ways to define a comment. The first one uses the syntax

/* some comment text */

which marks any characters between (and including) the opening /* and the closing */ as comment. Such comments may expand over more than one lines, as in

/* This is a
   multi line comment
*/

but they do not nest. The first */ that follows any /* will end the comment.

The second way to define a comment uses the syntax

int i; // some comment text

which marks any characters after (and including) the // and up to (but not including) the newline character at the end of the line as comment.


Keywords

The following keywords are reserved for special purposes and must not be used as normal identifier names:

break
case
char
continue
default
do
else
enum
for
if
int
numeric
real
return
string
switch
void
while

In addition, the names of builtins and object types are also reserved and must not be used as identifier names.


Identifiers

An identifier is a name that is used to introduce a user defined constant, variable or function.

Identifiers consist of a sequence of letters (a b c..., A B C...), digits (1 2 3...) and underscores (_). The first character of an identifier must be a letter or an underscore.

Identifiers are case-sensitive, which means that

int Number, number;

would define two different integer variables.

The maximum length of an identifier is 100 characters, and all of these are significant.


Constants

Constants are literal data items written into a User Language Program. According to the different data types, there are also different types of constants.

•	Character constants

•	Integer constants

•	Real constants

•	String constants


Character Constants

A character constant consists of a single character or an escape sequence enclosed in single quotes, like

'a'
'='
'\n'

The type of a character constant is char.


Integer Constants

Depending on the first (and possibly the second) character, an integer constant is assumed to be expressed in different base values:

first      second	constant interpreted as

  0        1-7	octal (base 8)

  0        x,X	hexadecimal (base 16)

 1-9	decimal (base 10)

The type of an integer constant is int.

Pøíklady

16	decimal

020	octal

0x10	hexadecimal


Real Constants

A real constant follows the general pattern

[-]int.frac[e|E[±]exp]

which stands for

•	optional sign

•	decimal integer

•	decimal point

•	decimal fraction

•	e or E and a signed integer exponent

You can omit either the decimal integer or the decimal fraction (but not both). You can omit either the decimal point or the letter e or E and the signed integer exponent (but not both).

The type of an real constant is real.

Pøíklady

Constant	Value

23.45e6	23.45 x 10^6

.0	0.0

0.	0.0

1.	1.0

-1.23	-1.23

2e-5	2.0 x 10^-5

3E+10	3.0 x 10^10

.09E34	0.09 x 10^34


String Constants

A string constant consists of a sequence of characters or escape sequences enclosed in double quotes, like

"Hello world\n"

The type of a string constant is string.

String constants can be of any length (provided there is enough free memory available).

String constants can be concatenated with the + operator to form larger strings:

string s = "Hello" + " world\n";

It is also possible to extend a string constant over more than one line by escaping the newline character with a backslash (\):

string s = "Hello \
world\n";


Escape Sequences

An escape sequence consists of a backslash (\), followed by one or more special characters:

Sequence	Value

\a	audible bell

\b	backspace

\f	form feed

\n	new line

\r	carriage return

\t	horizontal tab

\v	vertical tab

\\	backslash

\'	single quote

\"	double quote

\O	O = up to 3 octal digits

\xH	H = up to 2 hex digits

Any character following the initial backslash that is not mentioned in this list will be treated as that character (without the backslash).

Escape sequences can be used in character constants and string constants.

Pøíklady

'\n'
"A tab\tinside a text\n"
"Ring the bell\a\n"


Punctuators

The punctuators used in a User Language Program are

[]	Brackets

()	Parentheses

{}	Braces

,	Comma

;	Semicolon

:	Colon

=	Equal sign

Other special characters are used as operators in a ULP.


Brackets

Brackets are used in array definitions

int ai[10];

in array subscripts

n = ai[2];

and in string subscripts to access the individual characters of a string

string s = "Hello world";

char c = s[2];


Parentheses

Parentheses group expressions (possibly altering normal operator precedence), isolate conditional expressions, and indicate function calls and function parameters:

d = c * (a + b);
if (d == z) ++x;
func();
void func2(int n) { ... }


Braces

Braces indicate the start and end of a compound statement:

if (d == z) {
   ++x;
   func();
   }

and are also used to group the values of an array initializer:

int ai[] = { 1, 2, 3 };


Comma

The comma separates the elements of a function argument list or the parameters of a function call:

int func(int n, real r, string s) { ... }
int i = func(1, 3.14, "abc");

It also delimits the values of an array initializer:

int ai[] = { 1, 2, 3 };

and it separates the elements of a variable definition:

int i, j, k;


Semicolon

The semicolon terminates a statement, as in

i = a + b;

and it also delimits the init, test and increment expressions of a for statement:

for (int n = 0; n < 3; ++n) {
    func(n);
    }


Colon

The colon indicates the end of a label in a switch statement:

switch (c) {
  case 'a': printf("It was an 'a'\n"); break;
  case 'b': printf("It was a  'b'\n"); break;
  default:  printf("none of them\n");
  }


Equal Sign

The equal sign separates variable definitions from initialization lists:

int i = 10;
char c[] = { 'a', 'b', 'c' };

It is also used as an assignment operator.


Data Types

A User Language Program can define variables of different types, representing the different kinds of information available in the EAGLE data structures.

The four basic data types are

char	for single characters

int	for integral values

real	for floating point values

string	for textual information

Besides these basic data types there are also high level Object Types, which represent the data structures stored in the EAGLE data files.

The special data type void is used only as a return type of a function, indicating that this function does not return any value.


char

The data type char is used to store single characters, like the letters of the alphabet, or small unsigned numbers.

A variable of type char has a size of 8 bit (one byte), and can store any value in the range 0..255.

Viz také Operators, Character Constants


int

The data type int is used to store signed integral values, like the coordinates of an object.

A variable of type int has a size of 32 bit (four byte), and can store any value in the range -2147483648..2147483647.

Viz také Integer Constants


real

The data type real is used to store signed floating point values, like the grid distance.

A variable of type real has a size of 64 bit (eight byte), and can store any value in the range ±2.2e-308..±1.7e+308 with a precision of 15 digits.

Viz také Real Constants


string

The data type string is used to store textual information, like the name of a part or net.

A variable of type string is not limited in it's size (provided there is enough memory available).

Variables of type string are defined without an explicit size. They grow automatically as necessary during program execution.

The elements of a string variable are of type char and can be accessed individually by using [index]. The first character of a string has the index 0:

string s = "Layout";

printf("Third char is: %c\n", s[2]);

This would print the character 'y'. Note that s[2] returns the third character of s!

Viz také Operators, Builtin Functions, String Constants

Implementation details

The data type string is actually implemented through native C-type zero terminated strings (i.e. char[]). Looking at the following variable definition

string s = "abcde";

s[4] is the character 'e', and s[5] is the character '\0', or the integer value 0x00. This fact may be used to determine the end of a string without using the strlen() function, as in

for (int i = 0; s[i]; ++i) {
    // do something with s[i]
    }

It is also perfectly ok to "cut off" part of a string by "punching" a zero character into it:

string s = "abcde";

s[3] = 0;

This will result in s having the value "abc".


Type Conversions

The result type of an arithmetic expression, such as a + b, where a and b are different arithmetic types, is equal to the "larger" of the two operand types.

Arithmetic types are char, int and real (in that order). So if, e.g. a is of type int and b is of type real, the result of the expression a + b would be real.

Viz také Typecast


Typecast

The result type of an arithmetic expression can be explicitly converted to a different arithmetic type by applying a typecast to it.

The general syntax of a typecast is

type(expression)

where type is one of char, int or real, and expression is any arithmetic expression.

When typecasting a real expression to int, the fractional part of the value is truncated!

Viz také Type Conversions


Object Types

The EAGLE data structures are stored in three binary file types:

•	Library (*.LBR)

•	Schematic (*.SCH)

•	Board (*.BRD)

These data files contain a hierarchy of objects. In a User Language Program you can access these hierarchies through their respective builtin access statements:

library(L) { ... }
schematic(S) { ... }
board(B) { ... }

These access statements set up a context within which you can access all of the objects contained in the library, schematic or board.

The properties of these objects can be accessed through members.

There are two kinds of members:

•	Data members

•	Loop members

Data members immediately return the requested data from an object. For example, in

board(B) {
  printf("%s\n", B.name);
  }

the data member name of the board object B returns the board's name.
Data members can also return other objects, as in

board(B) {
  printf("%f\n", B.grid.size);
  }

where the board's grid data member returns a grid object, of which the size data member then returns the grid's size.

Loop members are used to access multiple objects of the same kind, which are contained in a higher level object:

board(B) {
  B.elements(E) {
    printf("%-8s %-8s\n", E.name, E.value);
    }
  }

This example uses the board's elements() loop member function to set up a loop through all of the board's elements. The block following the B.elements(E) statement is executed in turn for each element, and the current element can be referenced inside the block through the name E.

Loop members process objects in alpha-numerical order, provided they have a name.

A loop member function creates a variable of the type necessary to hold the requested objects. You are free to use any valid name for such a variable, so the above example might also be written as

board(MyBoard) {
  B.elements(TheCurrentElement) {
    printf("%-8s %-8s\n", TheCurrentElement.name, TheCurrentElement.value);
    }
  }

and would do the exact same thing. The scope of the variable created by a loop member function is limited to the statement (or block) immediately following the loop function call.

Object hierarchy of a Library:

LIBRARY
  GRID
  LAYER
  DEVICE
    GATE
  PACKAGE
    PAD
    SMD
    ARC
    CIRCLE
    HOLE
    RECTANGLE
    TEXT
    WIRE
    POLYGON
      WIRE
  SYMBOL
    PIN
    ARC
    CIRCLE
    RECTANGLE
    TEXT
    WIRE
    POLYGON
      WIRE

Object hierarchy of a Schematic:

SCHEMATIC
  GRID
  LAYER
  LIBRARY
  SHEET
    ARC
    CIRCLE
    RECTANGLE
    TEXT
    WIRE
    POLYGON
      WIRE
    PART
      INSTANCE
    BUS
      SEGMENT
        TEXT
        WIRE
    NET
      SEGMENT
        JUNCTION
        PINREF
        TEXT
        WIRE

Object hierarchy of a Board:

BOARD
  GRID
  LAYER
  LIBRARY
  ARC
  CIRCLE
  HOLE
  RECTANGLE
  TEXT
  WIRE
  POLYGON
    WIRE
  ELEMENT
  SIGNAL
    CONTACTREF
    POLYGON
      WIRE
    VIA
    WIRE


UL_ARC

Data members

angle1	real (start angle, 0.0...359.9°)

angle2	real (end angle, 0.0...719.9°)

layer	int

radius	int

width	int

x1, y1	int (starting point)

x2, y2	int (end point)

xc, yc	int (center point)

Viz také UL_BOARD, UL_PACKAGE, UL_SHEET, UL_SYMBOL

Note

Start and end angles are defined mathematically positive (i.e. counterclockwise), with angle1 < angle2.

Pøíklad

board(B) {
  B.arcs(A) {
    printf("Arc: (%d %d), (%d %d), (%d %d)\n",
           A.x1, A.y1, A.x2, A.y2, A.xc, A.yc);
    }
  }


UL_AREA

Data members

x1, y1	int (lower left corner)

x2, y2	int (upper right corner)

Viz také UL_BOARD, UL_DEVICE, UL_PACKAGE, UL_SHEET, UL_SYMBOL

A UL_AREA is an abstract object which gives information about the area covered by an object. For a UL_DEVICE, UL_PACKAGE and UL_SYMBOL the area is defined as the surrounding rectangle of the object definition in the library, so even if e.g. a UL_PACKAGE is derived from a UL_ELEMENT, the package's area will not reflect the elements offset within the board.

Pøíklad

board(B) {
  printf("Area: (%d %d), (%d %d)\n",
          B.area.x1, B.area.y1, B.area.x2, B.area.y2);
  }


UL_BOARD

Data members

area	UL_AREA

grid	UL_GRID

name	string

Loop members

arcs()	UL_ARC

circles()	UL_CIRCLE

elements()	UL_ELEMENT

holes()	UL_HOLE

layers()	UL_LAYER

libraries()	UL_LIBRARY

polygons()	UL_POLYGON

rectangles()	UL_RECTANGLE

signals()	UL_SIGNAL

texts()	UL_TEXT

wires()	UL_WIRE

Viz také UL_LIBRARY, UL_SCHEMATIC

Pøíklad

board(B) {
  B.elements(E) printf("Element: %s\n", E.name);
  B.signals(S)  printf("Signal: %s\n", S.name);
  }


UL_BUS

Data members

name	string (BUS_NAME_LENGTH)

Loop members

segments()	UL_SEGMENT

Constants

BUS_NAME_LENGTH	max. length of a bus name

Viz také UL_SHEET

Pøíklad

schematic(SCH) {
  SCH.sheets(SH) {
    SH.busses(B) printf("Bus: %s\n", B.name);
    }
  }


UL_CIRCLE

Data members

layer	int

radius	int

width	int

x, y	int (center point)

Viz také UL_BOARD, UL_PACKAGE, UL_SHEET, UL_SYMBOL

Pøíklad

board(B) {
  B.circles(C) {
    printf("Circle: (%d %d), r=%d, w=%d\n",
           C.x, C.y, C.radius, C.width);
    }
  }


UL_CONTACT

Data members

name	string (CONTACT_NAME_LENGTH)

pad	UL_PAD

signal	string

smd	UL_SMD

x, y	int (center point)

Constants

CONTACT_NAME_LENGTH	max. length of a contact name

Viz také UL_PACKAGE, UL_PAD, UL_SMD, UL_CONTACTREF, UL_PINREF

Pøíklad

library(L) {
  L.packages(PAC) {
    PAC.contacts(C) {
      printf("Contact: '%s', (%d %d)\n",
             C.name, C.x, C.y);
      }
    }
  }


UL_CONTACTREF

Data members

contact	UL_CONTACT

element	UL_ELEMENT

Viz také UL_SIGNAL, UL_PINREF

Pøíklad

board(B) {
  B.signals(S) {
    printf("Signal '%s'\n");
    S.contactrefs(C) {
      printf("\t%s, %s\n", C.element.name, C.contact.name);
      }
    }
  }


UL_DEVICE

Data members

area	UL_AREA

name	string (DEVICE_NAME_LENGTH)

package	UL_PACKAGE

prefix	string (DEVICE_PREFIX_LENGTH)

value	string ("On" or "Off")

Loop members

gates()	UL_GATE

Constants

DEVICE_NAME_LENGTH	max. length of a device name

DEVICE_PREFIX_LENGTH	max. length of a device prefix

Viz také UL_LIBRARY, UL_PART

Pøíklad

library(L) {
  L.devices(D) {
    printf("Device: %s, Package: %s\n", D.name, D.package.name);
    D.gates(G) {
      printf("\t%s\n", G.name);
      }
    }
  }


UL_ELEMENT

Data members

angle	real (0.0...359.9°)

mirror	int

name	string (ELEMENT_NAME_LENGTH)

package	UL_PACKAGE

value	string  (ELEMENT_VALUE_LENGTH)

x, y	int (origin point)

Loop members

texts()	UL_TEXT

Constants

ELEMENT_NAME_LENGTH	max. length of an element name

ELEMENT_VALUE_LENGTH	max. length of an element value

Viz také UL_BOARD, UL_CONTACTREF

Note

When processing an element's texts, you have to loop through the element's own texts() member as well as the texts() member of the element's package.

Pøíklad

board(B) {
  B.elements(E) {
    printf("Element: %s, (%d %d), Package=%s\n",
           E.name, E.x, E.y, E.package.name);
    }
  }


UL_GATE

Data members

addlevel	int (GATE_ADDLEVEL_...)

name	string (GATE_NAME_LENGTH)

swaplevel	int

symbol	UL_SYMBOL

x, y	int (origin point)

Constants

GATE_ADDLEVEL_MUST	must

GATE_ADDLEVEL_CAN	can

GATE_ADDLEVEL_NEXT	next

GATE_ADDLEVEL_REQUEST	request

GATE_ADDLEVEL_ALWAYS	always

GATE_NAME_LENGTH	max. length of a gate name

Viz také UL_DEVICE

Pøíklad

library(L) {
  L.devices(D) {
    printf("Device: %s, Package: %s\n", D.name, D.package.name);
    D.gates(G) {
      printf("\t%s, swaplevel=%d, symbol=%s\n",
             G.name, G.swaplevel, G.symbol.name);
      }
    }
  }


UL_GRID

Data members

distance	real

dots	int (0=lines, 1=dots)

multiple	int

on	int (0=off, 1=on)

unit	int (GRID_UNIT_...)

Constants

GRID_UNIT_MIC	microns

GRID_UNIT_MM	millimeter

GRID_UNIT_MIL	mil

GRID_UNIT_INCH	inch

Viz také UL_BOARD, UL_LIBRARY, UL_SCHEMATIC, Unit Conversions

Pøíklad

board(B) {
  printf("Gridsize=%f\n", B.grid.distance);
  }


UL_HOLE

Data members

drill	int

x, y	int (center point)

Viz také UL_BOARD, UL_PACKAGE

Pøíklad

board(B) {
  B.holes(H) {
    printf("Hole: (%d %d), drill=%d\n",
           H.x, H.y, H.drill);
    }
  }


UL_INSTANCE

Data members

angle	real (0.0...359.9°)

gate	UL_GATE

mirror	int

name	string (INSTANCE_NAME_LENGTH)

sheet	int (0=unused, 1..99=sheet number)

value	string (PART_VALUE_LENGTH)

x, y	int (origin point)

Loop members

texts()	UL_TEXT

Constants

INSTANCE_NAME_LENGTH	max. length of an instance name

PART_VALUE_LENGTH	max. length of a part value (instances do not have a value of their own!)

Viz také UL_PART, UL_PINREF

Note

When processing an instance's texts, you have to loop through the instance's own texts() member as well as the texts() member of the instance's gate's symbol.

Pøíklad

schematic(S) {
  S.parts(P) {
    printf("Part: %s\n", P.name);
    P.instances(I) {
      if (I.sheet != 0)
         printf("\t%s used on sheet %d\n", I.name, I.sheet);
      }
    }
  }


UL_JUNCTION

Data members

diameter	int

x, y	int (center point)

Viz také UL_SEGMENT

Pøíklad

schematic(SCH) {
  SCH.sheets(SH) {
    SH.nets(N) {
      N.segments(SEG) {
        SEG.junctions(J) {
          printf("Junction: (%d %d)\n", J.x, J.y);
          }
        }
      }
    }
  }


UL_LAYER

Data members

color	int

fill	int

name	string (LAYER_NAME_LENGTH)

number	int

visible	int (0=off, 1=on)

Viz také UL_BOARD, UL_LIBRARY, UL_SCHEMATIC

Constants

LAYER_NAME_LENGTH	max. length of a layer name

LAYER_TOP	layer numbers

LAYER_BOTTOM

LAYER_PADS

LAYER_VIAS

LAYER_UNROUTED

LAYER_DIMENSION

LAYER_TPLACE

LAYER_BPLACE

LAYER_TORIGINS

LAYER_BORIGINS

LAYER_TNAMES

LAYER_BNAMES

LAYER_TVALUES

LAYER_BVALUES

LAYER_TSTOP

LAYER_BSTOP

LAYER_TCREAM

LAYER_BCREAM

LAYER_TFINISH

LAYER_BFINISH

LAYER_TGLUE

LAYER_BGLUE

LAYER_TTEST

LAYER_BTEST

LAYER_TKEEPOUT

LAYER_BKEEPOUT

LAYER_TRESTRICT

LAYER_BRESTRICT

LAYER_VRESTRICT

LAYER_DRILLS

LAYER_HOLES

LAYER_MILLING

LAYER_MEASURES

LAYER_DOCUMENT

LAYER_REFERENCE

LAYER_TDOCU

LAYER_BDOCU

LAYER_NETS

LAYER_BUSSES

LAYER_PINS

LAYER_SYMBOLS

LAYER_NAMES

LAYER_VALUES

LAYER_USER

Pøíklad

board(B) {
  B.layers(L) printf("Layer %3d %s\n", L.number, L.name);
  }


UL_LIBRARY

Data members

grid	UL_GRID

name	string (LIBRARY_NAME_LENGTH)

Loop members

devices()	UL_DEVICE

layers()	UL_LAYER

packages()	UL_PACKAGE

symbols()	UL_SYMBOL

Constants

LIBRARY_NAME_LENGTH	max. length of a library name (only for libraries used in a board or a schematic!)

Viz také UL_BOARD, UL_SCHEMATIC

Pøíklad

library(L) {
  L.devices(D)  printf("Dev: %s\n", D.name);
  L.packages(P) printf("Pac: %s\n", P.name);
  L.symbols(S)  printf("Sym: %s\n", S.name);
  }

schematic(S) {
  S.libraries(L) printf("Library: %s\n", L.name);
  }


UL_NET

Data members

name	string (NET_NAME_LENGTH)

Loop members

pinrefs()	UL_PINREF (see Note)

segments()	UL_SEGMENT (see Note)

Constants

NET_NAME_LENGTH	max. length of a net name

Viz také UL_SHEET, UL_SCHEMATIC

Note

The pinrefs() loop member can only be used if the net is in a schematic context.
The segments() loop member can only be used if the net is in a sheet context.

Pøíklad

schematic(S) {
  S.nets(N) {
    printf("Net: %s\n", N.name);
    // N.segments(SEG) will NOT work here!
    }
  }

schematic(S) {
  SCH.sheets(SH) {
    SH.nets(N) {
      printf("Net: %s\n", N.name);
      N.segments(SEG) {
        SEG.wires(W) {
          printf("\tWire: (%d %d) (%d %d)\n",
                 W.x1, W.y1, W.x2, W.y2);
          }
        }
      }
    }
  }


UL_PACKAGE

Data members

area	UL_AREA

library	string

name	string (PACKAGE_NAME_LENGTH)

Loop members

arcs()	UL_ARC

circles()	UL_CIRCLE

contacts()	UL_CONTACT

holes()	UL_HOLE

polygons()	UL_POLYGON

rectangles()	UL_RECTANGLE

texts()	UL_TEXT

wires()	UL_WIRE

Constants

PACKAGE_NAME_LENGTH	max. length of a package name

Viz také UL_DEVICE, UL_ELEMENT, UL_LIBRARY

Pøíklad

library(L) {
  L.package(PAC) {
    printf("Package: %s\n", PAC.name);
    PAC.contacts(C) {
      if (C.pad)
         printf("\tPad: %s, (%d %d)\n",
                 C.name, C.pad.x, C.pad.y);
      else if (C.smd)
         printf("\tSmd: %s, (%d %d)\n",
                 C.name, C.smd.x, C.smd.y);
      }
    }
  }

board(B) {
  B.elements(E) {
    printf("Element: %s, Package: %s\n", E.name, E.package.name);
    }
  }


UL_PAD

Data members

diameter	int

drill	int

name	string (PAD_NAME_LENGTH)

shape	int (PAD_SHAPE_...)

signal	string

x, y	int (center point)

Constants

PAD_SHAPE_SQUARE	square

PAD_SHAPE_ROUND	round

PAD_SHAPE_OCTAGON	octagon

PAD_SHAPE_XLONGOCT	xlongoct

PAD_SHAPE_YLONGOCT	ylongoct

PAD_NAME_LENGTH	max. length of a pad name (same as CONTACT_NAME_LENGTH)

Viz také UL_PACKAGE, UL_CONTACT, UL_SMD

Pøíklad

library(L) {
  L.packages(PAC) {
    PAC.contacts(C) {
      if (C.pad)
         printf("Pad: '%s', (%d %d), d=%d\n",
                 C.name, C.pad.x, C.pad.y, C.pad.diameter);
      }
    }
  }


UL_PART

Data members

device	UL_DEVICE

name	string (PART_NAME_LENGTH)

value	string (PART_VALUE_LENGTH)

Loop members

instances()	UL_INSTANCE (see Note)

Constants

PART_NAME_LENGTH	max. length of a part name

PART_VALUE_LENGTH	max. length of a part value

Viz také UL_BOARD

Note

If the part is in a sheet context, the instances() loop member loops only through those instances that are actually used on that sheet. If the part is in a schematic context, all instances are looped through.

Pøíklad

schematic(S) {
  S.parts(P) printf("Part: %s\n", P.name);
  }


UL_PIN

Data members

angle	real (0.0...359.9°)

contact	UL_CONTACT (see Note)

direction	int (PIN_DIRECTION_...)

function	int (PIN_FUNCTION_FLAG_...)

length	int (PIN_LENGTH_...)

name	string (PIN_NAME_LENGTH)

swaplevel	int

visible	int (PIN_VISIBLE_FLAG_...)

x, y	int (connection point)

Loop members

circles()	UL_CIRCLE

texts()	UL_TEXT

wires()	UL_WIRE

Constants

PIN_DIRECTION_NC	not connected

PIN_DIRECTION_IN	input

PIN_DIRECTION_OUT	output (totem-pole)

PIN_DIRECTION_IO	in/output (bidirectional)

PIN_DIRECTION_OC	open collector

PIN_DIRECTION_PWR	power input pin

PIN_DIRECTION_PAS	passive

PIN_DIRECTION_HIZ	high impedance output

PIN_DIRECTION_SUP	supply pin

PIN_FUNCTION_FLAG_NONE	no symbol

PIN_FUNCTION_FLAG_DOT	inverter symbol

PIN_FUNCTION_FLAG_CLK	clock symbol

PIN_LENGTH_POINT	no wire

PIN_LENGTH_SHORT	0.1 inch wire

PIN_LENGTH_MIDDLE	0.2 inch wire

PIN_LENGTH_LONG	0.3 inch wire

PIN_NAME_LENGTH	max. length of a pin name

PIN_VISIBLE_FLAG_OFF	no name drawn

PIN_VISIBLE_FLAG_PAD	pad name drawn

PIN_VISIBLE_FLAG_PIN	pin name drawn

Viz také UL_SYMBOL, UL_PINREF, UL_CONTACTREF

Note

The contact data member returns the contact that has been assigned to the pin through a CONNECT command. It can be used as a boolean function to check whether a contact has been assigned to a pin (see example below).

The coordinates (and layer, in case of an SMD) of the contact returned by the contact data member depend on the context in which it is called:

•	if the pin is derived from a part that is used on a sheet, and if there is a corresponding element on the board, the resulting contact will have the coordinates as used on the board

•	in all other cases, the coordinates of the contact will be the same as defined in the package drawing

Pøíklad

library(L) {
  L.symbols(S) {
    printf("Symbol: %s\n", S.name);
    S.pins(P) {
      printf("\tPin: %s, (%d %d)", P.name, P.x, P.y);
      if (P.direction == PIN_DIRECTION_IN)
         printf(" input");
      if ((P.function & PIN_FUNCTION_FLAG_DOT) != 0)
         printf(" inverted");
      printf("\n");
      }
    }
  L.devices(D) {
    D.gates(G) {
      G.symbol.pins(P) {
        if (!P.contact)
           printf("Unconnected pin: %s/%s/%s\n", D.name, G.name, P.name);
        }
      }
    }
  }


UL_PINREF

Data members

instance	UL_INSTANCE

part	UL_PART

pin	UL_PIN

Viz také UL_SEGMENT, UL_CONTACTREF

Pøíklad

schematic(SCH) {
  SCH.sheets(SH) {
    printf("Sheet: %d\n", SH.number);
    SH.nets(N) {
      printf("\tNet: %s\n", N.name);
      N.segments(SEG) {
        SEG.pinrefs(P) {
          printf("connected to: %s, %s, %s\n",
                 P.part.name, P.instance.name, P.pin.name);
          }
        }
      }
    }
  }


UL_POLYGON

Data members

isolate	int

layer	int

orphans	int (0=off, 1=on)

pour	int (POLYGON_POUR_...)

spacing	int

thermals	int (0=off, 1=on)

width	int

Loop members

wires()	UL_WIRE

Constants

POLYGON_POUR_SOLID	solid

POLYGON_POUR_HATCH	hatch

Viz také UL_BOARD, UL_PACKAGE, UL_SHEET, UL_SIGNAL, UL_SYMBOL


UL_RECTANGLE

Data members

layer	int

x1, y1	int (lower left corner)

x2, y2	int (upper right corner)

Viz také UL_BOARD, UL_PACKAGE, UL_SHEET, UL_SYMBOL

Pøíklad

board(B) {
  B.rectangles(R) {
    printf("Rectangle: (%d %d), (%d %d)\n",
           R.x1, R.y1, R.x2, R.y2);
    }
  }


UL_SCHEMATIC

Data members

grid	UL_GRID

name	string

Loop members

layers()	UL_LAYER

libraries()	UL_LIBRARY

nets()	UL_NET

parts()	UL_PART

sheets()	UL_SHEET

Viz také UL_BOARD, UL_LIBRARY

Pøíklad

schematic(S) {
  S.parts(P) printf("Part: %s\n", P.name);
  }


UL_SEGMENT

Loop members

junctions()	UL_JUNCTION (see Note)

pinrefs()	UL_PINREF (see Note)

texts()	UL_TEXT

wires()	UL_WIRE

Viz také UL_BUS, UL_NET

Note

The junctions() and pinrefs() loop members are only available for net segments.

Pøíklad

schematic(SCH) {
  SCH.sheets(SH) {
    printf("Sheet: %d\n", SH.number);
    SH.nets(N) {
      printf("\tNet: %s\n", N.name);
      N.segments(SEG) {
        SEG.pinrefs(P) {
          printf("connected to: %s, %s, %s\n",
                 P.part.name, P.instance.name, P.pin.name);
          }
        }
      }
    }
  }


UL_SHEET

Data members

area	UL_AREA

number	int

Loop members

arcs()	UL_ARC

busses()	UL_BUS

circles()	UL_CIRCLE

nets()	UL_NET

parts()	UL_PART

polygons()	UL_POLYGON

rectangles()	UL_RECTANGLE

texts()	UL_TEXT

wires()	UL_WIRE

Viz také UL_SCHEMATIC

Pøíklad

schematic(SCH) {
  SCH.sheets(S) {
    printf("Sheet: %d\n", S.number);
    }
  }


UL_SIGNAL

Data members

name	string (SIGNAL_NAME_LENGTH)

Loop members

contactrefs()	UL_CONTACTREF

polygons()	UL_POLYGON

vias()	UL_VIA

wires()	UL_WIRE

Constants

SIGNAL_NAME_LENGTH	max. length of a signal name

Viz také UL_BOARD

Pøíklad

board(B) {
  B.signals(S) printf("Signal: %s\n", S.name);
  }


UL_SMD

Data members

dx, dy	int (size)

layer	int

name	string (SMD_NAME_LENGTH)

signal	string

x, y	int (center point)

Constants

SMD_NAME_LENGTH	max. length of an smd name (same as CONTACT_NAME_LENGTH)

Viz také UL_PACKAGE, UL_CONTACT, UL_PAD

Pøíklad

library(L) {
  L.packages(PAC) {
    PAC.contacts(C) {
      if (C.smd)
         printf("Smd: '%s', (%d %d), dx=%d, dy=%d\n",
                 C.name, C.smd.x, C.smd.y, C.smd.dx, C.smd.dy);
      }
    }
  }


UL_SYMBOL

Data members

area	UL_AREA

name	string (SYMBOL_NAME_LENGTH)

Loop members

arcs()	UL_ARC

circles()	UL_CIRCLE

rectangles()	UL_RECTANGLE

pins()	UL_PIN

polygons()	UL_POLYGON

texts()	UL_TEXT

wires()	UL_WIRE

Constants

SYMBOL_NAME_LENGTH	max. length of a symbol name

Viz také UL_GATE, UL_LIBRARY

Pøíklad

library(L) {
  L.symbols(S) printf("Sym: %s\n", S.name);
  }


UL_TEXT

Data members

angle	real (0.0...359.9°)

layer	int

mirror	int

ratio	int

size	int

value	string

x, y	int (origin point)

Loop members

wires()	UL_WIRE

Viz také UL_BOARD, UL_PACKAGE, UL_SHEET, UL_SYMBOL

Pøíklad

board(B) {
  B.texts(T) {
    printf("Text: %s\n", T.value);
    }
  }


UL_VIA

Data members

diameter	int

drill	int

shape	int (VIA_SHAPE_...)

x, y	int (center point)

Constants

VIA_SHAPE_SQUARE	square

VIA_SHAPE_ROUND	round

VIA_SHAPE_OCTAGON	octagon

Viz také UL_SIGNAL

Pøíklad

board(B) {
  B.signals(S) {
    S.vias(V) {
      printf("Via: (%d %d)\n", V.x, V.y);
      }
    }
  }


UL_WIRE

Data members

layer	int

x1, y1	int (starting point)

x2, y2	int (end point)

width	int

Viz také UL_BOARD, UL_PACKAGE, UL_SEGMENT, UL_SHEET, UL_SIGNAL, UL_SYMBOL

Pøíklad

board(B) {
  B.wires(W) {
    printf("Wire: (%d %d) (%d %d)\n",
           W.x1, W.y1, W.x2, W.y2);
    }
  }


Definitions

The data items to be used in a User Language Program must be defined before they can be used.

There are three kinds of definitions:

•	Constant Definitions

•	Variable Definitions

•	Function Definitions

The scope of a constant or variable definition goes from the line in which it has been defined to the end of the current block, or to the end of the User Language Program, if the definition appeared outside any block.

The scope of a function definition goes from the closing brace (}) of the function body to the end of the User Language Program.


Constant Definitions

Constants are defined using the keyword enum, as in

enum { a, b, c };

which would define the three constants a, b and c, giving them the values 0, 1 and 2, respectively.

Constants may also be initialized to specific values, like

enum { a, b = 5, c };

where a would be 0, b would be 5 and c would be 6.


Variable Definitions

The general syntax of a variable definition is

[numeric] type identifier [= initializer][, ...];

where type is one of the data or object types, identifier is the name of the variable, and initializer is a optional initial value.

Multiple variable definitions of the same type are separated by commas (,).

If identifier is followed by a pair of brackets ([]), this defines an array of variables of the given type. The size of an array is automatically adjusted at runtime.

The optional keyword numeric can be used with string arrays to have them sorted alphanumerically by the sort() function.

By default (if no initializer is present), data variables are set to 0 (or "", in case of a string), and object variables are "invalid".

Pøíklady

int i;	defines an int variable named i

string s = "Hello";	defines a string variable named s and initializes it to "Hello"

real a, b = 1.0, c;	defines three real variables named a, b and c, initializing b to the value 1.0

int n[] = { 1, 2, 3 };	defines an array of int, initializing the first three elements to 1, 2 and 3

numeric string names[];	defines a string array that can be sorted alphanumerically

UL_WIRE w;	defines a UL_WIRE object named w


Function Definitions

You can write your own User Language functions and call them just like the Builtin Functions.

The general syntax of a function definition is

type identifier(parameters)
{
  statements
}

where type is one of the data or object types, identifier is the name of the function, parameters is a list of comma separated parameter definitions, and statements is a sequence of statements.

Functions that do not return a value have the type void.

A function must be defined before it can be called, and function calls can not be recursive (a function cannot call itself).

The statements in the function body may modify the values of the parameters, but this will not have any effect on the arguments of the function call.

Execution of a function can be terminated by the return statement. Without any return statement the function body is executed until it's closing brace (}).

A call to the exit() function will terminate the entire User Language Program.

The special function main()

If your User Language Program contains a function called main(), that function will be explicitly called as the main function, and it's return value will be the return value of the program.

Pøíklad

int CountDots(string s)
{
  int dots = 0;
  for (int i = 0; s[i]; ++i)
      if (s[i] == '.')
         ++dots;
  return dots;
}

string dotted = "This.has.dots...";

output("test") {
  printf("Number of dots: %d\n",
                 CountDots(dotted));
  }


Operators

The following table lists all of the User Language operators, in order of their precedence (Unary having the highest precedence, Comma the lowest):

Unary	! ~ + - ++ --

Multiplicative	* / %

Additive	+ -

Shift	<< >>

Relational	< <= > >=

Equality	== !=

Bitwise AND	&

Bitwise XOR	^

Bitwise OR	|

Logical AND	&&

Logical OR	||

Conditional	?:

Assignment	= *= /= %= += -= &= ^= |= <<= >>=

Comma	,

Associativity is left to right for all operators, except for Unary, Conditional and Assignment, which are right to left associative.

The normal operator precedence can be altered by the use of parentheses.


Bitwise Operators

Bitwise operators work only with data types char and int.

Unary

~	Bitwise (1's) complement

Binary

<<	Shift left

>>	Shift right

&	Bitwise AND

^	Bitwise XOR

|	Bitwise OR

Assignment

&=	Assign bitwise AND

^=	Assign bitwise XOR

|=	Assign bitwise OR

<<=	Assign left shift

>>=	Assign right shift


Logical Operators

Logical operators work with expressions of any data type.

Unary

!	Logical NOT

Binary

&&	Logical AND

||	Logical OR

Using a string expression with a logical operator checks whether the string is empty.

Using an Object Type with a logical operator checks whether that object contains valid data.


Comparison Operators

Comparison operators work with expressions of any data type, except Object Types.

<	Less than

<=	Less than or equal to

>	Greater than

>=	Greater than or equal to

==	Equal to

!=	Not equal to


Evaluation Operators

Evaluation operators are used to evaluate expressions based on a condition, or to group a sequence of expressions and have them evaluated as one expression.

?:	Conditional

,	Comma

The Conditional operator is used to make a decision within an expression, as in

int a;
// ...code that calculates 'a'
string s = a ? "True" : "False";

which is basically the same as

int a;
string s;
// ...code that calculates 'a'
if (a)
   s = "True";
else
   s = "False";

but the advantage of the conditional operator is that it can be used in an expression.

The Comma operator is used to evaluate a sequence of expressions from left to right, using the type and value of the right operand as the result.

Note that arguments in a function call as well as multiple variable declarations also use commas as delimiters, but in that case this is not a comma operator!


Arithmetic Operators

Arithmetic operators work with data types char, int and real (except for ++, --, % and %=).

Unary

+	Unary plus

-	Unary minus

++	Pre- or postincrement

--	Pre- or postdecrement

Binary

*	Multiply

/	Divide

%	Remainder (modulus)

+	Binary plus

-	Binary minus

Assignment

=	Simple assignment

*=	Assign product

/=	Assign quotient

%=	Assign remainder (modulus)

+=	Assign sum

-=	Assign difference

Viz také String Operators


String Operators

String operators work with data types char, int and string. The left operand must always be of type string.

Binary

+	Concatenation

Assignment

=	Simple assignment

+=	Append to string

The + operator concatenates two strings, or adds a character to the end of a string and returns the resulting string.

The += operator appends a string or a character to the end of a given string.

Viz také Arithmetic Operators


Expressions

An expression can be one of the following:

•	Arithmetic Expression

•	Assignment Expression

•	String Expression

•	Comma Expression

•	Conditional Expression

•	Function Call

Expressions can be grouped using parentheses, and may be recursive, meaning that an expression can consist of subexpressions.


Arithmetic Expression

An arithmetic expression is any combination of numeric operands and an arithmetic operator or a bitwise operator.

Pøíklady

a + b
c++
m << 1


Assignment Expression

An assignment expression consists of a variable on the left side of an assignment operator, and an expression on the right side.

Pøíklady

a = x + 42
b += c
s = "Hello"


String Expression

A string expression is any combination of string and char operands and a string operator.

Pøíklady

s + ".BRD"
t + 'x'


Comma Expression

A comma expression is a sequence of expressions, delimited by the comma operator

Comma expressions are evaluated left to right, and the result of a comma expression is the type and value of the rightmost expression.

Pøíklad

i++, j++, k++


Conditional Expression

A conditional expression uses the conditional operator to make a decision within an expression.

Pøíklad

int a;
// ...code that calculates 'a'
string s = a ? "True" : "False";


Function Call

A function call transfers the program flow to a user defined function or a builtin function. The formal parameters defined in the function definition are replaced with the values of the expressions used as the actual arguments of the function call.

Pøíklad

int p = strchr(s, 'b');


Statements

A statement can be one of the following:

•	Compound Statement

•	Control Statement

•	Expression Statement

•	Builtin Statement

•	Constant Definition

•	Variable Definition

Statements specify the flow of control as a User Language Program executes. In absence of specific control statements, statements are executed sequentially in the order of appearance in the ULP file.


Compound Statement

A compound statement (also known as block) is a list (possibly empty) of statements enclosed in matching braces ({}). Syntactically, a block can be considered to be a single statement, but it also controls the scoping of identifiers. An identifier declared within a block has a scope starting at the point of declaration and ending at the closing brace.

Compound statements can be nested to any depth.


Expression Statement

An expression statement is any expression followed by a semicolon.

An expression statement is executed by evaluating the expression. All side effects of this evaluation are completed before the next statement is executed. Most expression statements are assignments or function calls.

A special case is the empty statement, consisting of only a semicolon. An empty statement does nothing, but it may be useful in situations where the ULP syntax expects a statement but your program does not need one.


Control Statements

Control statements are used to control the program flow.

Iteration statements are

do...while
for
while

Selection statements are

if...else
switch

Jump statements are

break
continue
return


break

The break statement has the general syntax

break;

and immediately terminates the nearest enclosing do...while, for, switch or while statement.

Since all of these statements can be intermixed and nested to any depth, take care to ensure that your break exits from the correct statement.


continue

The continue statement has the general syntax

continue;

and immediately transfers control to the test condition of the nearest enclosing do...while, while, or for statement, or to the increment expression of the nearest enclosing for statement.

Since all of these statements can be intermixed and nested to any depth, take care to ensure that your continue affects the correct statement.


do...while

The do...while statement has the general syntax

do statement while (condition);

and executes the statement until the condition expression becomes zero.

The condition is tested after the first execution of statement, which means that the statement is always executed at least one time.

If there is no break or return inside the statement, the statement must affect the value of the condition, or condition itself must change during evaluation in order to avoid an endless loop.

Pøíklad

string s = "Trust no one!";
int i = -1;

do {
   ++i;
   } while (s[i]);


for

The for statement has the general syntax

for ([init]; [test]; [inc]) statement

and performs the following steps:

1.	If an initializing expression init is present, it is executed.

2.	If a test expression is present, it is executed. If the result is nonzero (or if there is no test expression at all), the statement is executed.

3.	If an inc expression is present, it is executed.

4.	Finally control returns to step 2.

If there is no break or return inside the statement, the inc expression (or the statement) must affect the value of the test expression, or test itself must change during evaluation in order to avoid an endless loop.

The initializing expression init normally initializes one or more loop counters. It may also define a new variable as a loop counter. The scope of such a variable is valid until the end of the active block.

Pøíklad

string s = "Trust no one!";
int sum = 0;

for (int i = 0; s[i]; ++i)
    sum += s[i]; // sums up the characters in s


if...else

The if...else statement has the general syntax

if (expression)
   t_statement
[else
   f_statement]

The conditional expression is evaluated, and if its value is nonzero the t_statement is executed. Otherwise the f_statement is executed in case there is an else clause.

An else clause is always matched to the last encountered if without an else. If this is not what you want, you need to use braces to group the statements, as in

if (a == 1) {
   if (b == 1)
      printf("a == 1 and b == 1\n");
   }
else
   printf("a != 1\n");


return

A function with a return type other than void must contain at least one return statement with the syntax

return expression;

where expression must evaluate to a type that is compatible with the function's return type. The value of expression is the value returned by the function.

If the function is of type void, a return statement without an expression can be used to return from the function call.


switch

The switch statement has the general syntax

switch (sw_exp) {
  case case_exp: case_statement
  ...
  [default: def_statement]
  }

and allows for the transfer of control to one of several case-labeled statements, depending on the value of sw_exp (which must be of integral type).

Any case_statement can be labeled by one or more case labels. The case_exp of each case label must evaluate to a constant integer which is unique within it's enclosing switch statement.

There can also be at most one default label.

After evaluating sw_exp, the case_exp are checked for a match. If a match is found, control passes to the case_statement with the matching case label.

If no match is found and there is a default label, control passes to def_statement. Otherwise none of the statements in the switch is executed.

Program execution is not affected when case and default labels are encountered. Control simply passes through the labels to the following statement.

To stop execution at the end of a group of statements for a particular case, use the break statement.

Pøíklad

string s = "Hello World";
int vowels = 0, others = 0;

for (int i = 0; s[i]; ++i)
    switch (toupper(s[i])) {
      case 'A':
      case 'E':
      case 'I':
      case 'O':
      case 'U': ++vowels;
                break;
      default: ++others;
      }
printf("There are %d vowels in '%s'\n", vowels, s);


while

The while statement has the general syntax

while (condition) statement

and executes the statement as long as the condition expression is not zero.

The condition is tested before the first possible execution of statement, which means that the statement may never be executed if condition is initially zero.

If there is no break or return inside the statement, the statement must affect the value of the condition, or condition itself must change during evaluation in order to avoid an endless loop.

Pøíklad

string s = "Trust no one!";
int i = 0;

while (s[i])
      ++i;


Builtins

Builtins are Constants, Functions and Statements that provide additional information and allow for data manipulations.

•	Builtin Constants

•	Builtin Functions

•	Builtin Statements


Builtin Constants

Builtin constants are used to provide information about object parameters, such as maximum name length, flags etc.

Many of the object types have their own Constants section which lists the builtin constants for that particular object (see e.g. UL_PIN).

The following builtin constants are defined in addition to the ones listed for the various object types:

EAGLE_VERSION	EAGLE program version number (int)

EAGLE_RELEASE	EAGLE program release number (int)

EAGLE_SIGNATURE	a string containing EAGLE program name, version and copyright information

PI	the value of "pi" (3.14..., real)


Builtin Functions

Builtin functions are used to perform specific tasks, like printing formatted strings, sorting data arrays or the like.

You may also write your own functions and use them to structure your User Language Program.

The builtin functions are grouped into the following categories:

•	Character Functions

•	File Handling Functions

•	Mathematical Functions

•	Miscellaneous Functions

•	Printing Functions

•	String Functions

•	Time Functions

Alphabetical reference of all builtin functions:

•	abs()

•	acos()

•	asin()

•	atan()

•	ceil()

•	cos()

•	exit()

•	exp()

•	filedir()

•	fileext()

•	filename()

•	filesetext()

•	filesize()

•	filetime()

•	floor()

•	frac()

•	isalnum()

•	isalpha()

•	iscntrl()

•	isdigit()

•	isgraph()

•	islower()

•	isprint()

•	ispunct()

•	isspace()

•	isupper()

•	isxdigit()

•	log()

•	log10()

•	max()

•	min()

•	pow()

•	printf()

•	round()

•	sin()

•	sort()

•	sprintf()

•	sqrt()

•	strchr()

•	strlen()

•	strlwr()

•	strrchr()

•	strrstr()

•	strstr()

•	strsub()

•	strtod()

•	strtol()

•	strupr()

•	t2day()

•	t2dayofweek()

•	t2hour()

•	t2minute()

•	t2month()

•	t2second()

•	t2string()

•	t2year()

•	tan()

•	time()

•	tolower()

•	toupper()

•	trunc()

•	u2inch()

•	u2mic()

•	u2mil()

•	u2mm()


Character Functions

Character functions are used to manipulate single characters.

The following character functions are available:

•	isalnum()

•	isalpha()

•	iscntrl()

•	isdigit()

•	isgraph()

•	islower()

•	isprint()

•	ispunct()

•	isspace()

•	isupper()

•	isxdigit()

•	tolower()

•	toupper()


is...()

Funkce

Check whether a character falls into a given category.

Zápis

int isalnum(char c);
int isalpha(char c);
int iscntrl(char c);
int isdigit(char c);
int isgraph(char c);
int islower(char c);
int isprint(char c);
int ispunct(char c);
int isspace(char c);
int isupper(char c);
int isxdigit(char c);

Returns

The is... functions return nonzero if the given character falls into the category, zero otherwise.

Character categories

isalnum	letters (A to Z or a to z) or digits (0 to 9)

isalpha	letters (A to Z or a to z)

iscntrl	delete characters or ordinary control characters (0x7F or 0x00 to 0x1F)

isdigit	digits (0 to 9)

isgraph	printing characters (except space)

islower	lowercase letters (a to z)

isprint	printing characters (0x20 to 0x7E)

ispunct	punctuation characters (iscntrl or isspace)

isspace	space, tab, carriage return, new line, vertical tab, or formfeed (0x09 to 0x0D, 0x20)

isupper	uppercase letters (A to Z)

isxdigit	hex digits (0 to 9, A to F, a to f)

Pøíklad

char c = 'A';

if (isxdigit(c))
   printf("%c is hex\n", c);
else
   printf("%c is not hex\n", c);


to...()

Funkce

Convert a character to upper- or lowercase.

Zápis

char tolower(char c);
char toupper(char c);

Returns

The tolower function returns the converted character if c is uppercase. All other characters are returned unchanged.
The toupper function returns the converted character if c is lowercase. All other characters are returned unchanged.

Viz také strupr, strlwr


File Handling Functions

Filename handling functions are used to work with file names, sizes and timestamps.

The following file handling functions are available:

•	filedir()

•	fileext()

•	filename()

•	filesetext()

•	filesize()

•	filetime()


Filename Functions

Funkce

Split a filename into its separate parts.

Zápis

string filedir(string file);
string fileext(string file);
string filename(string file);
string filesetext(string file, string newext);

Returns

filedir returns the directory of file (including the drive).
fileext returns the extension of file.
filename returns the file name of file (including the extension).
filesetext returns file with the extension set to newext.

Viz také Filedata Functions

If a filename has been split into its three separate parts, these parts can be put together again with the + operator to form the original full filename.

Pøíklad

if (board) board(B) {
  output(filesetext(B.name, ".OUT")) {
    ...
    }
  }


Filedata Functions

Funkce

Gets the timestamp and size of a file.

Zápis

int filesize(string filename);
int filetime(string filename);

Returns

filesize returns the size (in byte) of the given file.
filetime returns the timestamp of the given file in a format to be used with the time functions.

Viz také time, Filename Functions

Pøíklad

board(B)
  printf("Board: %s\nSize: %d\nTime: %s\n",
         B.name, filesize(B.name),
         t2string(filetime(B.name)));


Mathematical Functions

Mathematical functions are used to perform mathematical operations.

The following mathematical functions are available:

•	abs()

•	acos()

•	asin()

•	atan()

•	ceil()

•	cos()

•	exp()

•	floor()

•	frac()

•	log()

•	log10()

•	max()

•	min()

•	pow()

•	round()

•	sin()

•	sqrt()

•	trunc()

•	tan()

Error Messages

If the arguments of a mathematical function call lead to an error, the error message will show the actual values of the arguments. Thus the statements

real x = -1.0;
real r = sqrt(2 * x);

will lead to the error message

Invalid argument in call to 'sqrt(-2)'


Absolute, maximum and minimum functions

Funkce

Absolute, maximum and minimum functions.

Zápis

type abs(type x);
type max(type x, type y);
type min(type x, type y);

Returns

abs returns the absolute value of x.
max returns the maximum of x and y.
min returns the minimum of x and y.

The return type of these functions is the same as the (larger) type of the arguments. type must be one of char, int or real.

Pøíklad

real x = 2.567, y = 3.14;

printf("The maximum is %f\n", max(x, y));


Rounding functions

Funkce

Rounding functions.

Zápis

real ceil(real x);
real floor(real x);
real frac(real x);
real round(real x);
real trunc(real x);

Returns

ceil returns the smallest integer not less than x.
floor returns the largest integer not greater than x.
frac returns the fractional part of x.
round returns x rounded to the nearest integer.
trunc returns the integer part of x.

Pøíklad

real x = 2.567;

printf("The rounded value of %f is %f\n", x, round(x));


Trigonometric functions

Funkce

Trigonometric functions.

Zápis

real acos(real x);
real asin(real x);
real atan(real x);
real cos(real x);
real sin(real x);
real tan(real x);

Returns

acos returns the arc cosine of x.
asin returns the arc sine of x.
atan returns the arc tangent of x.
cos returns the cosine of x.
sin returns the sine of x.
tan returns the tangent of x.

Constants

PI	the value of "pi" (3.14...)

Pøíklad

real x = 2.0;

printf("The sine of %f is %f\n", x, sin(x));


Exponential functions

Funkce

Exponential functions.

Zápis

real exp(real x);
real log(real x);
real log10(real x);
real pow(real x, real y);
real sqrt(real x);

Returns

exp returns the exponential e to the power of x.
log returns the natural logarithm of x.
log10 returns the base 10 logarithm of x.
pow returns the value of x to the power of y.
sqrt returns the square root of x.

Note

The "n-th" root can be calculated using the pow function with a negative exponent.

Pøíklad

real x = 2.1;

printf("The square root of %f is %f\n", x, sqrt(x));


Miscellaneous Functions

Miscellaneous functions are used to perform various tasks.

The following miscellaneous functions are available:

•	exit()

•	sort()

•	Unit Conversions


exit()

Funkce

Exits from a User Language Program.

Zápis

void exit(expression);

Constants

EXIT_SUCCESS	return value for successful program execution (value 0)

EXIT_FAILURE	return value for failed program execution (value -1)

Viz také RUN

Description

The exit function terminates execution of a User Language Program. The given expression will be evaluated and the result will be the return value of the program.


sort()

Funkce

Sorts an array or a set of arrays.

Zápis

void sort(int number, array1[, array2,...]);

Description

The sort function either directly sorts a given array1, or it sorts a set of arrays (starting with array2), in which case array1 is supposed to be an array of int, which will be used as a pointer array.

In any case, the number argument defines the number of items in the array(s).

Sorting a single array

If the sort function is called with one single array, that array will be sorted directly, as in the following example:

string A[];
int n = 0;

A[n++] = "World";
A[n++] = "Hello";
A[n++] = "The truth is out there...";
sort(n, a);
for (int i = 0; i < n; ++i)
    printf(A[i]);

Sorting a set of arrays

If the sort function is called with more than one array, the first array must be an array of int, while all of the other arrays may be of any array type and hold the data to be sorted. The following example illustrates how the first array will be used as a pointer:

numeric string Nets[], Parts[], Instances[], Pins[];
int n = 0;
int index[];

schematic(S) {
  S.nets(N) N.pinrefs(P) {
    Nets[n] = N.name;
    Parts[n] = P.part.name;
    Instances[n] = P.instance.name;
    Pins[n] = P.pin.name;
    ++n;
    }
  sort(n, index, Nets, Parts, Instances, Pins);
  for (int i = 0; i < n; ++i)
      printf("%-8s %-8s %-8s %-8s\n",
             Nets[index[i]], Parts[index[i]],
             Instances[index[i]], Pins[index[i]]);
  }

The idea behind this is that one net can have several pins connected to it, and in a netlist you might want to have the net names sorted, and within one net you also want the part names sorted and so on.

Note the use of the keyword numeric in the string arrays. This causes the strings to be sorted in a way that takes into account a numeric part at the end of the strings, which leads to IC1, IC2,... IC9, IC10 instead of the alphabetical order IC1, IC10, IC2,...IC9.

When sorting a set of arrays, the first (index) array must be of type int and need not be initialized. Any contents the index array might have before calling the sort function will be overwritten by the resulting index values.


Unit Conversions

Funkce

Converts internal units.

Zápis

real u2inch(int n);
real u2mic(int n);
real u2mil(int n);
real u2mm(int n);

Returns

u2inch returns the value of n in inch.
u2mic returns the value of n in microns (1/1000mm).
u2mil returns the value of n in mil (1/1000inch).
u2mm returns the value of n in millimeters.

Viz také UL_GRID

EAGLE stores all coordinate and size values as int values with a resolution of 1/10000mm (0.1μ). The above unit conversion functions can be used to convert these internal units to the desired measurement units.

Pøíklad

board(B) {
  B.elements(E) {
    printf("%s at (%f, %f)\n", E.name,
           u2mm(E.x), u2mm(E.y));
    }
  }


Printing Functions

Printing functions are used print formatted strings.

The following printing functions are available:

•	printf()

•	sprintf()


printf()

Funkce

Writes formatted output to a file.

Zápis

int printf(string format[, argument, ...]);

Returns

The printf function returns the number of characters written to the file that has been opened by the most recent output statement.

In case of an error, printf returns -1.

Viz také sprintf, output

Format string

The format string controls how the arguments will be converted, formatted and printed. There must be exactly as many arguments as necessary for the format. The number and type of arguments will be checked against the format, and any mismatch will lead to an error message.

The format string contains two types of objects - plain characters and format specifiers:

•	Plain characters are simply copied verbatim to the output

•	Format specifiers fetch arguments from the argument list and apply formatting to them

Format specifiers

A format specifier has the following form:

% [flags] [width] [.prec] type

Each format specification begins with the percent character (%). After the % comes the following, in this order:

•	an optional sequence of flag characters, [flags]

•	an optional width specifier, [width]

•	an optional precision specifier, [.prec]

•	the conversion type character, type

Conversion type characters

d	signed decimal int

o	unsigned octal int

u	unsigned decimal int

x	unsigned hexadecimal int (with a, b,...)

X	unsigned hexadecimal int (with A, B,...)

f	signed real value of the form [-]dddd.dddd

e	signed real value of the form [-]d.dddde[±]ddd

E	same as e, but with E for exponent

g	signed real value in either e or f form, based on given value and precision

G	same as g, but with E for exponent if e format used

c	single character

s	character string

%	the % character is printed

Flag characters

The following flag characters can appear in any order and combination.

"-"	the formatted item is left-justified within the field; normally, items are right-justified

"+"	a signed, positive item will always start with a plus character (+); normally, only negative items begin with a sign

" "	a signed, positive item will always start with a space character; if both "+" and " " are specified,  "+" overrides " "

Width specifiers

The width specifier sets the minimum field width for an output value.

Width is specified either directly, through a decimal digit string, or indirectly, through an asterisk (*). If you use an asterisk for the width specifier, the next argument in the call (which must be an int) specifies the minimum output field width.

In no case does a nonexistent or small field width cause truncation of a field. If the result of a conversion is wider than the field width, the field is simply expanded to contain the conversion result.

n	At least n characters are printed. If the output value has less than n characters, the output is padded with blanks (right-padded if "-" flag given, left-padded otherwise).

0n	At least n characters are printed. If the output value has less than n characters, it is filled on the left with zeroes.

*	The argument list supplies the width specifier, which must precede the actual argument being formatted.

Precision specifiers

A precision specifier always begins with a period (.) to separate it from any preceding width specifier. Then, like width, precision is specified either directly through a decimal digit string, or indirectly, through an asterisk (*). If you use an asterisk for the precision specifier, the next argument in the call (which must be an int) specifies the precision.

none	Precision set to default.

.0	For int types, precision is set to default; for real types, no decimal point is printed.

.n	n characters or n decimal places are printed. If the output value has more than n characters the output might be truncated or rounded (depending on the type character).

*	The argument list supplies the precision specifier, which must precede the actual argument being formatted.

Default precision values

douxX	1

eEf	6

gG	all significant digits

c	no effect

s	print entire string

How precision specification (.n) affects conversion

douxX	.n specifies that at least n characters are printed. If the input argument has less than n digits, the output value is left-padded with zeros. If the input argument has more than n digits, the output value is not truncated.

eEf	.n specifies that n characters are printed after the decimal point, and the last digit printed is rounded.

gG	.n specifies that at most n significant digits are printed.

c	.n has no effect on the output.

s	.n specifies that no more than n characters are printed.

Pøíklad

int i = 42;
real r = 3.14;
char c = 'A';
string s = "Hello";

printf("Integer: %8d\n", i);
printf("Hex:     %8X\n", i);
printf("Real:    %8f\n", r);
printf("Char:    %-8c\n", c);
printf("String:  %-8s\n", s);


sprintf()

Funkce

Writes formatted output into a string.

Zápis

int sprintf(string result, string format[, argument, ...]);

Returns

The sprintf function returns the number of characters written into the result string.

In case of an error, sprintf returns -1.

Viz také printf

Format string

See printf.

Pøíklad

string result;
int number = 42;

sprintf(result, "The number is %d", number);


String Functions

String functions are used to manipulate character strings.

The following string functions are available:

•	strchr()

•	strlen()

•	strlwr()

•	strrchr()

•	strrstr()

•	strstr()

•	strsub()

•	strtod()

•	strtol()

•	strupr()


strchr()

Funkce

Scans a string for the first occurrence of a given character.

Zápis

int strchr(string s, char c);

Returns

The strchr function returns the integer offset of the character in the string, or -1 if the character does not occur in the string.

Viz také strrchr, strstr

Pøíklad

string s = "This is a string";
char c = 'a';
int pos = strchr(s, c);

if (pos > 0)
   printf("The character %c is at position %d\n", c, pos);
else
   printf("The character was not found\n");


strlen()

Funkce

Calculates the length of a string.

Zápis

int strlen(string s);

Returns

The strlen function returns the number of characters in the string.

Pøíklad

string s = "This is a string";
int l = strlen(s);

printf("The string is %d characters long\n", l);


strlwr()

Funkce

Converts uppercase letters in a string to lowercase.

Zápis

string strlwr(string s);

Returns

The strlwr function returns the modified string. The original string (given as parameter) is not changed.

Viz také strupr, tolower

Pøíklad

string s = "This Is A String";
string r = strlwr(s);

printf("Prior to strlwr: %s - after strlwr: %s\n", s, r);


strrchr()

Funkce

Scans a string for the last occurrence of a given character.

Zápis

int strrchr(string s, char c);

Returns

The strrchr function returns the integer offset of the character in the string, or -1 if the character does not occur in the string.

Viz také strchr, strrstr

Pøíklad

string s = "This is a string";
char c = 'a';
int pos = strrchr(s, c);

if (pos > 0)
   printf("The character %c is at position %d\n", c, pos);
else
   printf("The character was not found\n");


strrstr()

Funkce

Scans a string for the last occurrence of a given substring.

Zápis

int strrstr(string s1, string s2);

Returns

The strrstr function returns the integer offset of the first character of s2 in s1, or -1 if the substring does not occur in the string.

Viz také strstr, strrchr

Pøíklad

string s1 = "This is a string", s2 = "is a";
int pos = strrstr(s1, s2);

if (pos > 0)
   printf("The substring starts at %d\n", pos);
else
   printf("The substring was not found\n");


strstr()

Funkce

Scans a string for the first occurrence of a given substring.

Zápis

int strstr(string s1, string s2);

Returns

The strstr function returns the integer offset of the first character of s2 in s1, or -1 if the substring does not occur in the string.

Viz také strrstr, strchr

Pøíklad

string s1 = "This is a string", s2 = "is a";
int pos = strstr(s1, s2);

if (pos > 0)
   printf("The substring starts at %d\n", pos);
else
   printf("The substring was not found\n");


strsub()

Funkce

Extracts a substring from a string.

Zápis

string strsub(string s, int start[, int length]);

Returns

The strsub function returns the substring indicated by the start and length value.

The value for length must be positive, otherwise an empty string will be returned. If length is ommitted, the rest of the string (beginning at start) is returned.

If start points to a position outside the string, an empty string is returned.

Pøíklad

string s = "This is a string";
string t = strsub(s, 4, 7);

printf("The extracted substring is: %s\n", t);


strtod()

Funkce

Converts a string to a real value.

Zápis

real strtod(string s);

Returns

The strtod function returns the numerical representation of the given string as a real value. Conversion ends at the first character that does not fit into the format of a real constant. If an error occurs during conversion of the string 0.0 will be returned.

Viz také strtol

Pøíklad

string s = "3.1415";
real r = strtod(s);

printf("The value is %f\n", r);


strtol()

Funkce

Converts a string to an integer value.

Zápis

int strtol(string s);

Returns

The strtol function returns the numerical representation of the given string as an int value. Conversion ends at the first character that does not fit into the format of an integer constant. If an error occurs during conversion of the string 0 will be returned.

Viz také strtod

Pøíklad

string s = "1234";
int i = strtol(s);

printf("The value is %d\n", i);


strupr()

Funkce

Converts lowercase letters in a string to uppercase.

Zápis

string strupr(string s);

Returns

The strupr function returns the modified string. The original string (given as parameter) is not changed.

Viz také strlwr, toupper

Pøíklad

string s = "This Is A String";
string r = strupr(s);

printf("Prior to strupr: %s - after strupr: %s\n", s, r);


Time Functions

Time functions are used to get and process time and date information.

The following time functions are available:

•	t2day()

•	t2dayofweek()

•	t2hour()

•	t2minute()

•	t2month()

•	t2second()

•	t2string()

•	t2year()

•	time()


time()

Funkce

Gets the current system time.

Zápis

int time(void);

Returns

The time function returns the current system time as the number of seconds elapsed since a system dependent reference date.

Viz také Time Conversions, filetime

Pøíklad

int CurrentTime = time();


Time Conversions

Funkce

Convert a time value to day, month, year etc.

Zápis

int t2day(int t);
int t2dayofweek(int t);
int t2hour(int t);
int t2minute(int t);
int t2month(int t);
int t2second(int t);
int t2year(int t);

string t2string(int t);

Returns

t2day returns the day of the month (1..31)
t2dayofweek returns the day of the week (0=sunday..6)
t2hour returns the hour (0..23)
t2minute returns the minute (0..59)
t2month returns the month (0..11)
t2second returns the second (0..59)
t2year returns the year (including century!) t2string returns a formatted string containing date and time

Viz také time

Pøíklad

int t = time();

printf("It is now %02d:%02d:%02d\n",
       t2hour(t), t2minute(t), t2second(t));


Builtin Statements

Builtin statements are generally used to open a certain context in which data structures of files can be accessed.

The general syntax of a builtin statement is

name(parameters) statement

where name is the name of the builtin statement, parameters stands for one or more parameters, and statement is the code that will be executed inside the context opened by the builtin statement.

Note that statement can be a compound statement, as in

board(B) {
  B.elements(E) printf("Element: %s\n", E.name);
  B.Signals(S)  printf("Signal: %s\n", S.name);
  }

The following builtin statements are available:

•	board()

•	device()

•	library()

•	output()

•	package()

•	schematic()

•	sheet()

•	symbol()


board()

Funkce

Opens a board context.

Zápis

board(identifier) statement

Description

The board statement opens a board context if the current editor window contains a board drawing. A variable of type UL_BOARD is created and is given the name indicated by identifier.

Once the board context is successfully opened and a board variable has been created, the statement is executed. Within the scope of the statement the board variable can be accessed to retrieve further data from the board.

If the current editor window does not contain a board drawing, an error message is given and the ULP is terminated.

Viz také schematic, library

Check if there is a board

By using the board statement without an argument you can check if the current editor window contains a board drawing. In that case, board behaves like an integer constant, returning 1 if there is a board drawing in the current editor window, and 0 otherwise.

Accessing board from a schematic

If the current editor window contains a schematic drawing, you can still access that schematic's board by preceding the board statement with the prefix project, as in

project.board(B) { ... }

This will open a board context regardless whether the current editor window contains a board or a schematic drawing. However, there must be an editor window containing that board somewhere on the desktop!

Pøíklad

if (board)
   board(B) {
     B.elements(E)
       printf("Element: %s\n", E.name);
     }


device()

Funkce

Opens a device context.

Zápis

device(identifier) statement

Description

The device statement opens a device context if the current editor window contains a device drawing. A variable of type UL_DEVICE is created and is given the name indicated by identifier.

Once the device context is successfully opened and a device variable has been created, the statement is executed. Within the scope of the statement the device variable can be accessed to retrieve further data from the device.

If the current editor window does not contain a device drawing, an error message is given and the ULP is terminated.

Viz také package, symbol, library

Check if there is a device

By using the device statement without an argument you can check if the current editor window contains a device drawing. In that case, device behaves like an integer constant, returning 1 if there is a device drawing in the current editor window, and 0 otherwise.

Pøíklad

if (device)
   device(D) {
     D.gates(G)
       printf("Gate: %s\n", G.name);
     }


library()

Funkce

Opens a library context.

Zápis

library(identifier) statement

Description

The library statement opens a library context if the current editor window contains a library drawing. A variable of type UL_LIBRARY is created and is given the name indicated by identifier.

Once the library context is successfully opened and a library variable has been created, the statement is executed. Within the scope of the statement the library variable can be accessed to retrieve further data from the library.

If the current editor window does not contain a library drawing, an error message is given and the ULP is terminated.

Viz také board, schematic, device, package, symbol

Check if there is a library

By using the library statement without an argument you can check if the current editor window contains a library drawing. In that case, library behaves like an integer constant, returning 1 if there is a library drawing in the current editor window, and 0 otherwise.

Pøíklad

if (library)
   library(L) {
     L.devices(D)
       printf("Device: %s\n", D.name);
     }


output()

Funkce

Opens an output file for subsequent printf() calls.

Zápis

output(string filename[, string mode]) statement

Description

The output statement opens a file with the given filename and mode for output through subsequent printf() calls. If the file has been successfully opened, the statement is executed, and after that the file is closed.

If the file cannot be opened, an error message is given and execution of the ULP is terminated.

By default the output file is written into the Design directory as defined in the directories dialog.

Viz také printf

File Modes

The mode parameter defines how the output file is to be opened. If no mode parameter is given, the default is "wt".

"a"	append to an existing file, or create a new file if it does not exist

"w"	create a new file (overwriting an existing file)

"t"	open file in text mode

"b"	open file in binary mode

Mode characters may appear in any order and combination. However, only the last one of a and w or t and b, respectively, is significant. For example a mode of "abtw" would open a file for textual write, which would be the same as "wt".

Nested Output statements

output statements can be nested, as long as there are enough file handles available, and provided that no two active output statements access the same file.

Pøíklad

void PrintText(string s)
{
  printf("This also goes into the file: %s\n", s);
}

output("FILE.TXT", "wt") {
  printf("Directly printed\n");
  PrintText("via function call");
  }


package()

Funkce

Opens a package context.

Zápis

package(identifier) statement

Description

The package statement opens a package context if the current editor window contains a package drawing. A variable of type UL_PACKAGE is created and is given the name indicated by identifier.

Once the package context is successfully opened and a package variable has been created, the statement is executed. Within the scope of the statement the package variable can be accessed to retrieve further data from the package.

If the current editor window does not contain a package drawing, an error message is given and the ULP is terminated.

Viz také library, device, symbol

Check if there is a package

By using the package statement without an argument you can check if the current editor window contains a package drawing. In that case, package behaves like an integer constant, returning 1 if there is a package drawing in the current editor window, and 0 otherwise.

Pøíklad

if (package)
   package(P) {
     P.contacts(C)
       printf("Contact: %s\n", C.name);
     }


schematic()

Funkce

Opens a schematic context.

Zápis

schematic(identifier) statement

Description

The schematic statement opens a schematic context if the current editor window contains a schematic drawing. A variable of type UL_SCHEMATIC is created and is given the name indicated by identifier.

Once the schematic context is successfully opened and a schematic variable has been created, the statement is executed. Within the scope of the statement the schematic variable can be accessed to retrieve further data from the schematic.

If the current editor window does not contain a schematic drawing, an error message is given and the ULP is terminated.

Viz také board, library, sheet

Check if there is a schematic

By using the schematic statement without an argument you can check if the current editor window contains a schematic drawing. In that case, schematic behaves like an integer constant, returning 1 if there is a schematic drawing in the current editor window, and 0 otherwise.

Accessing schematic from a board

If the current editor window contains a board drawing, you can still access that board's schematic by preceding the schematic statement with the prefix project, as in

project.schematic(S) { ... }

This will open a schematic context regardless whether the current editor window contains a schematic or a board drawing. However, there must be an editor window containing that schematic somewhere on the desktop!

Access the current Sheet

Use the sheet statement to directly access the currently loaded sheet.

Pøíklad

if (schematic)
   schematic(S) {
     S.parts(P)
       printf("Part: %s\n", P.name);
     }


sheet()

Funkce

Opens a sheet context.

Zápis

sheet(identifier) statement

Description

The sheet statement opens a sheet context if the current editor window contains a sheet drawing. A variable of type UL_SHEET is created and is given the name indicated by identifier.

Once the sheet context is successfully opened and a sheet variable has been created, the statement is executed. Within the scope of the statement the sheet variable can be accessed to retrieve further data from the sheet.

If the current editor window does not contain a sheet drawing, an error message is given and the ULP is terminated.

Viz také schematic

Check if there is a sheet

By using the sheet statement without an argument you can check if the current editor window contains a sheet drawing. In that case, sheet behaves like an integer constant, returning 1 if there is a sheet drawing in the current editor window, and 0 otherwise.

Pøíklad

if (sheet)
   sheet(S) {
     S.parts(P)
       printf("Part: %s\n", P.name);
     }


symbol()

Funkce

Opens a symbol context.

Zápis

symbol(identifier) statement

Description

The symbol statement opens a symbol context if the current editor window contains a symbol drawing. A variable of type UL_SYMBOL is created and is given the name indicated by identifier.

Once the symbol context is successfully opened and a symbol variable has been created, the statement is executed. Within the scope of the statement the symbol variable can be accessed to retrieve further data from the symbol.

If the current editor window does not contain a symbol drawing, an error message is given and the ULP is terminated.

Viz také library, device, package

Check if there is a symbol

By using the symbol statement without an argument you can check if the current editor window contains a symbol drawing. In that case, symbol behaves like an integer constant, returning 1 if there is a symbol drawing in the current editor window, and 0 otherwise.

Pøíklad

if (symbol)
   symbol(S) {
     S.pins(P)
       printf("Pin: %s\n", P.name);
     }


Automatic Backup

The Write command creates backup copies of the saved files. These backups have the same name as the original file, with a modified extension that follows the pattern

.X#n

In this pattern X is represented by the character

B for board files
S for schematic files
L for library files

n stands for a single digit number in the range 1..9. Higher numbers indicate older files.

The fixed '#' character makes it easy to delete all backup files with the operating system command

DEL *.?#?

Note that backup files with the same number 'n' do not necessarily represent consistent combinations of board and schematic files!

The maximum number of backup copies can be set in the backup dialog.


Forward&Back Annotation

A schematic and board file are logically interconnected through automatic Forward&Back Annotation. Normally there are no special things to be considered about Forward&Back Annotation. This section, however, lists all of the details about what exactly happens during f/b activities:

•	When adding a new part to a schematic, the part's package is added to the board at the lower left corner of the drawing. If the part contains power pins (pins with Direction "Pwr") the related pads will be automatically connected to their power signals.

•	When deleting a part from a schematic drawing, the part's package is deleted from the board. Any wires that were connected to that package are left unchanged. This may require additional vias to be set in order to keep signals connected. These vias will not be set automatically! The ratsnest will be re-calculated for those signals that were connected to the removed package.

•	When deleting a part from a board drawing, all of the gates contained in that part will be deleted from the schematic. Note that this may affect more than one sheet, if the gates were placed on different sheets!

•	After an operation that removes a pad from a signal that has a supply layer, the Thermal/Annulus display may be incorrect. In such a case a window refresh will show the correct Thermal/Annulus symbols. The same applies to Undo/Redo operations that involve pads connected to supply layers.

•	A PinSwap or GateSwap operation in the schematic will make all the necessary mìní to the wires of the board. However, after this operation the wires may overlap or violate minimum distance rules. Therefore the user should take a look at these wires and modify them with Move, Split, Change Layer etc.

•	To make absolutely sure that a board and schematic belong to each other (and are therefore connected via Forward&Back Annotation) the two files must have the same file name (with extensions .BRD and .SCH) and must be located in the same directory!

•	The Replace command checks whether all pads in the old package which have been assigned to pins will also be present in the new package, regardless whether they are connected to a signal or not.

•	When the pins of two parts in the schematic are directly overlapping (and thus connected without a visible net wire), a net wire will be generated when these parts are moved away from each other. This is done to avoid unnecessary ripup of signal wires in the board.


Consistency Check

In order to use Forward&Back Annotation a board and schematic must be consistent, which means they must contain an equivalent set of parts/elements and nets/signals.

Normally a board and schematic will always be consistent as long as they have never been edited separately (in which case the message "No Forward&Back Annotation will be performed!" will have warned you).

When loading a pair of board and schematic files the program will check some consistency markers in the data files to see if these two files are still consistent. If these markers indicate an inconsistency, you will be offered to run an Electrical Rule Check (ERC), which will do a detailed cross-check on both files.

If this check turns out positive, the two files are marked as consistent and Forward&Back Annotation will be activated.

If the two files are found to be inconsistent the ERC protocol file will be brought up in a text window and Forward&Back Annotation will not be activated.

The ERC protocol file contains several sections that list the inconsistencies found. Each of these sections may or may not be present, depending on which inconsistencies have been found. Please do not be alarmed if you get a lot of inconsistency messages. In most cases fixing one error (like renaming a part or a net) will reduce the number of error messages you get in the next ERC run.

Parts not found in board:

  IC1
  R7

This section lists the names of the parts that are present in the schematic, but are missing in the board.

Elements not found in schematic:

  C33
  D2

This section lists the names of the elements that are present in the board, but are missing in the schematic.

The following sections are only present if the part and element names have checked out to be consistent:

Parts/Elements with inconsistent packages:

  IC12
  R1

This section lists the names of the parts/elements that are present on both schematic and board, but which have inconsistent packages. Packages are considered consistent if they contain an equally named set of pads/smds.

Parts/Elements with inconsistent values:

  R55      100k       47k
  C99      10n        10p

This section lists the names of the parts/elements that are present on both schematic and board, but which have different values. The second column lists the value of the part in the schematic, the third column lists the value of the element in the board.

The following sections are only present if the part and element packages have checked out to be consistent:

Pins/Pads with different connections:

  Part   Gate   Pin   Net   Pad   Signal

  IC5    A      2     GND   2     S$42
  R3     R      1     D1    1     D2

This section lists the names of the pins and pads that are connected to different nets/signals in schematic and board. The Net column contains the net name in the schematic, while the Signal column gives the signal name in the board. If either of these two entries is blank, this means that the pin/pad is not connected.

Making a Board and Schematic consistent

To make an inconsistent pair of board and schematic files consistent, you have to manually fix any inconsistency listed in the ERC protocol file. This can be done by applying editor commands like NAME, VALUE, PINSWAP, REPLACE etc. After fixing the inconsistencies you must use the ERC command again to check the files and eventually activate Forward&Back Annotation.


Limitations

The following actions are not allowed in a board when Back Annotation is active (i.e. the schematic is loaded, too):

•	adding or copying a part that contains Pads or Smds

•	deleting an airwire

•	defining connections with the Signal command

•	pasting from a board into a board, if the pasted objects contain parts with Pads or Smds, or Signals with connections

If you try to do one of the above things, you will receive a message telling you that this operation cannot be backannotated. In such a case please do the necessary operations in the schematic (they will then be forward annotated to the board). If you absolutely have to do it in the board, you can close the schematic window and then do anything you like inside the board. In that case, however, board and schematic will not be consistent any more!


Technical Support

As a registered EAGLE user you get free technical support from CadSoft. There are several ways to contact us or obtain the latest part libraries, drivers or program versions:

CadSoft Computer, Inc.
801 South Federal Highway
Delray Beach, FL 33483-5185
USA

Phone	(561)274-8355

Fax	(561)274-8218

Email	Support@CadSoftUSA.COM

URL	www.CadSoftUSA.COM


License

To legally use EAGLE you need a registered user license. Please check your "User License Certificate" whether it contains a holographic sticker with the EAGLE logo as well as a label with your name, address, serial number and installation code. If you have any doubts about the validity or authenticity of your license, please contact our Technical Support staff for verification.

There are different types of licenses, varying in the number of users who may use the program and in the areas of application the program may be used in:

Single-User License

Only ONE user may use the program at any given time. However, that user may install the program on any of his computers, as long as he makes sure that the program will only be run on ONE of these computers at a time.

A typical application of this kind would be a user who has a PC at home and also a notebook or laptop computer which he uses "on the road". As he would only use one of these computers at a time it is ok to have EAGLE installed on both of them.

3-User License

Up to THREE users may use the program simultaneously, on three different computers. The only restriction that applies is that these computers must all belong to the license holder, and that they be located in the same building.

5-User License

Same as "3-User License", but up to FIVE users may use the program simultaneously.

Network License

The program may be installed on ONE LAN Server, and an UNLIMITED number of users who are logged in to that LAN Server may use the program simultaneously.

Commercial License

The program may be used for any purpose, be it commercial or private.

Educational License

The program may only be used in an educational environment like a school, university or training workshop, in order to teach how to use ECAD software.

Student License

The program may only be used for private ("non-profit") purposes. Student versions are sold at a very low price, to allow people who could otherwise never afford buying EAGLE the use of the program for their private hobby or education. It is a violation of the license terms if you "earn money" by using a Student Licence of EAGLE.


Product Registration

Before you can work with EAGLE it is necessary to register the program with your personalized license data.

Please make sure your EAGLE installation disk with your serial number on it is inserted in your disk drive (A: by default, if you are using a different drive please enter that drive letter in the line containing A:\LICENSE.KEY).

Next you need to enter your Installation Code as printed on the label on your User License Certificate. This code consists of 10 lowercase characters and has to be entered exactly as printed on the label.

After pressing enter or clicking on the OK button, EAGLE will be installed with your personalized license data.

If you have problems installing EAGLE or are in doubt about the validity of your license please contact our Technical Support staff for assistance.


EAGLE Editions

EAGLE is available in three different editions to fit various user requirements.

Professional

The Professional edition has no limitations.

Standard

The Standard edition has the following limitations:

•	board area limited to 160x100mm (6.3x4inch), which corresponds to a full Eurocard

•	only four routing layers (Top, Route2, Route15 and Bottom)

Light

The Light edition has the following limitations:

•	board area limited to 100x80mm (4x3.2inch), which corresponds to half of a Eurocard

•	only two routing layers (Top and Bottom)

•	a schematic can consist of only one single sheet

If you receive an error message like

The Light edition of EAGLE can't perform the requested action!

this means that you are attempting to do something that would violate the limitations that apply to the EAGLE edition in use, like for example placing an element outside of the allowed area.

Both the Standard and Light edition of EAGLE can be used to view files created with the Professional edition, even if these drawings exceed the editing capabilities of the edition currently in use.

To check which edition your license has enabled, select "Help/Product information" from the Control Panel's menu.