Toto je starší verze dokumentu!
Obsah
Návod na instalaci a použití KiCAD v systému MLAB
Instalace
Zprovoznění KiCAD se bohužel liší podle konkrétního operačního systému a platformy.
Ubuntu
Kicad má v linuxu dvě možnosti instalace. Obvykle je však nejvhodnější použít PPA.
PPA Repozitář
PPA je systém vzdáleného přístupu k balíčkům připraveného software. Obvykle obsahují aktuálnější verzi, než balíčky dostupné ze standardních systémových repositářů.
Pro stažení a instalaci nejnovější stabilní připravené verze KiCAD stačí do konzole zadat následující příkazy:
sudo add-apt-repository --yes ppa:js-reynaud/ppa-kicad sudo apt-get update sudo apt-get install kicad
Zapnutí kontextových ikon
Ubuntu má v továrním nastavení vypnuté kontextové ikony, takže nainstalovaný KiCAD nemá v menu ikony, které usnadňují orientaci při návrhu. Lze vyřešit zadáním následujících příkazů do konzole.
gsettings set org.gnome.desktop.interface menus-have-icons true gsettings set org.gnome.desktop.interface buttons-have-icons true UBUNTU_MENUPROXY= kicad # or pcbnew, eeschema and etc.
Instalace Windows
Stačí si stáhnout instalační soubor a ten nainstalovat.
Základní nastavení
V případě, že nový modul je založen uvnitř template repozitáře a zároveň je použit KiCAD MLAB template z korektně nainstalovaných kicad-mlab knihoven. Tak by nemělo být potřeba nastavovat parametry KiCAD projektu popsané níže.
KiCAD MLAB šablona se použije stejně jako jakýkoliv jiný KiCAD template s tím, že název KiCAD projektu je potřeba zadat stejný, jako je název repozitáře nového modu. Nový projekt má být v repozitáři umístěn na cestě MODUL01/hw/sch_pcb/
.
Nastavení knihoven
Během návrhu se využívá více typů knihoven součástek:
- Standardní knihovny obsažené přímo v programu KiCAD
- Knihovny se součástkami specifickými pro MLAB, které obsahují i skript pro stažení knihoven z GitHubu a offline práci v KiCADu.
Je dobré při návrhu modulů využít co nejvíce prvků z knihoven KiCAD. MLAB knihovny, které jsou dostupné na GitHubu, obsahují speciální součástky, které KiCAD nemá, nebo nejsou vhodně optimalizované pro použití v modulech (aktuálně se jedná především o hřebínky). Zbylé prvky zůstávají v knihovnách z důvodu kompatibility se starými moduly.
Pokud nějaká součástka není ani v jedné knihovně a vznikne potřeba vytvořit vlastní novou. Je potřeba danou součástku zařadit do knihovny MLAB, aby jí bylo možné snadno použít i v dalších modulech. Nedávat jí jen do knihovny projektu, nebo do nějaké vlastní knihovny, ke které není přístup již vůbec.
Na začátku prací je potřeba si nejprve dobře definovat cesty ke knihovnám:
Důležité je dodržet názvy KICAD_XXX_MLAB. Díky sjednoceným názvům nenastane problém s otevřením projektu a editace na různých počítačích:
Knihovny se do KiCADu přidávají zvlášť při kreslení schéma a zvlášť při návrhu PCB v obou případech je postup velmi obdobný.
- Preferences → Manage Symbol Libraries → „Global Libraries“ - Browse Libraries → Open Library
Návrhová pravidla
Před začátkem návrhu plošného spoje je potřeba nastavit návrhová pravidla. Pokud nejsou použity obvody s malou roztečí pinů je dobré dodržet následující parametry.
Vrtané otvory - VIA
- standardně vrtaný otvor 0,4 mm a průměr okruží 0,8 mm
- na GND plochách 0,2 mm a průměr okruží 0,45 mm
Vrstvy
Nastavení vrstev se liší podle celkového počtu vrstev plošného spoje.
Dvojvrstvý plošný spoj
- F.CU - horní vrstva mědi (většinou vrstva GND)
- B.CU - spodní vrstva (zde primárně umisťovat SMD součástky)
- F.SilkS - vrstva horního potisku (tato vrstva se nechává vyrábět)
- B.Silks - vrstva spodního potisku (vrstva se standardně nevyrábí)
- F.Mask - Nepájivá maska horní strana
- B.Mask - Nepájivá maska spodní strana přivrácená k základní desce
- User.Drawings - Pomocné nákresy, které nebudou vyrobeny na PCB. Například obrysy krytů
- User.Comments - kóty a další potřebné popisy, které nepatří do výrobní nebo osazovací vrstvy
- Edge.Cuts - vnější obrys desky výsledného PCB
- F.Fab - potisk pro osazování - strana součástek
- B.Fab - potisk pro osazování - strana spojů
Toto uspořádání vrstev respektuje dokumentaci vrstev KiCADu
Při návrhu dvou, nebo vícevrstvého plošného spoje, je užitečné jednu, nebo dvě vrstvy vyhradit pro zem a napájení. Tyto vrstvy je pak vhodné nastavit jako „Split/Mixed plane“ a přiřadit k nim signál GND a napájení (VCC, VDD). To umožní automaticky ukončovat tyto spoje prokovem (via) do této vrstvy. Je to mnohem lepší než pro tuto vrstvu zadat „copper pour“ protože v takovém případě se spoj špatně edituje.
Rohové razítko
Rohové razítko a další pro moduly společné soubory se nachází v repozitáři MLAB/documents, který je submodulem každého repozitáře modulu. Při vytvoření nového modulu z template jej není potřeba nastavovat. Pooužití submodulu je následující
- V repozitáři je vytvořen submodul z repozitáře documents použitím
git submodule add git@github.com:MLAB-project/documents.git doc/assets
- Následně je v projektu KiCADu potřeba nastavit relativní cestu k rohovému razítku
../../doc/assets/templates/KiCAD/page_layout.kicad_wks
Výsledkem je projekt, který obsahuje rohová razítka s grafickou identifikaci MLABu.
Používání KiCADu při návrhu
Schéma - Parametry součástek
Při kreslení schéma je potřeba dodržet určitou konvenci, aby byla výsledná výroba a automatické generování dalších dokumentů bez problémů.
Při prvním spuštění Kicad Eeschema je potřeba přidal tyto pole popisující součástky:
- MFPN - Označení součástky podle výrobce (přesný typ součástky, pro osazování)
- Distributor - Označení součástky distributorem
- Link - odkaz na stránku dodavatele
- Note - poznámka k parametrům součástky
- UST_ID - skladové číslo (Hash identifikující položku z nástroje UST - OpenIntranet)
V případě, že schéma obsahuje varianty osazovaných komponent, tak se k identifikaci pole přidá ještě pořadové číslo, napřiklad „MFPN_1“,„MFPN_2“ a podobně. Komponenty se stejným pořadovým číslem odpovídají jedné osazované variantě. Komponenty, které nemají pořadové číslo jsou společné pro všechny varianty osazení.
Při použití následujícího postupu není potřeba pole vytvářet potřebná pole ručně u každé součástky znovu:
V menu Preferences » General options » Field Name Templates
Při otevření parametrů součástky vypadá tabulka následnovně:
Příklad vyplnění parametrů součástky:
Reference: C1 Value: 10nF MFPN: 1812CA103JAT2A Distributor: Mouser 581-1812CA103JAT2A Link: https://cz.mouser.com/ProductDetail/AVX/1812CA103JAT2A?qs=sGAEpiMZZMsh%252b1woXyUXjzY5digEXfcQu%252bp00y9d0Fc%3d Note: Tolerance 20%, C0G UST_ID: 5ed7ac8e12875004e15a62cf8
Pokud máte přístup do UST skladu, tak je užitečné při kreslení schéma vkládat rovnou UST_ID odpovídající přesným součástkám ze skladu. A pokud daná součástka ve skladu ještě neexistuje, je potřeba jí rovnou vytvořit. Značně to zjednodušuje výrobu a jednoznačně definuje osazení.
Výrobní a dokumentační výstupy
Většina výstupů je generována automaticky na základě správně připravených dat v repozitáři modulu pomocí GitHub workflow. Nejsnazší je toto automatické generování využít, případně opravit chyby v repozitáři tak, aby automatické generování výstupů fungovalo. Následující postupy popisují manuální generování výstupů, které je značně nekomfortní.
Generování seznamu součástek - BOM
Linux
- Zmáčknout tlačítko „set plugin cmd“ a tam vybrat soubor: /usr/lib/kicad/plugins/bom2csv.xsl
- Výsledkem je, že se pole „command line“ se samo nastaví na: xsltproc -o „%O.csv“ „/usr/lib/kicad/plugins/bom2csv.xsl“ „%I“
- Pak stačí zmáčknou „Generate“. A KiCAD vyrobí soubor .csv se seznamem součástek.
Windows
Generování souborů BOM není ve formátu .CSV pod WIN přímo možné. Vyřešit tento problém je možné podle následujícího postupu.
- Nejprve je potřeba stáhnout bom_ust.py.
- V KiCAD eeschema otevřít v nabídce „Tools > Generate Bill Of Materials“
- Zmáčknout „+“
- Pojmenovat si ho podle sebe
- Vybrat cestu do uloženého místa.
- Poté stačí vždy dát jen Generate
Generování gerber a vrtacích dat
Při návrhu je dobré nepodlézat parametry v následující tabulce:
Před počátkem generování výrobních dat je potřeba provést kontrolu DRC. Doporučené parametry:
Gerber data
Drill data
Osazovací výkres
Při generování osazovacího výkresu v PDF formátu, který slouží jako náhled pro výrobu, se trochu naráží na limity KiCADu. Ten při tisku do PDF zarovná do tiskové oblasti celou stránku. Z praktických důvodů však je většina modulů kreslena tak, že má nulu souřadnic v levém spodním rohu. Což znamená mimo stránku.
Pro tisk osazovacího výkresu je tak potřeba celý modul vzít a posunout do středu stránky. Vygenerovat potřebné výkresy a pak posunutí neuložit.
Přejmenování projektu
Ve verzovaném repozitáři je potřeba projekty přejmenovávat s vědomím verzovacího systému. Typicky je tuto problematiku potřeba řešit při vytváření nové verze modulu.
Postup je následující:
- Je potřeba vytvořit novou větev ve které budou změny provedeny viz git
- V této větvi otevřeme existující projekt v kicadu a uložíme jej pod novým názvem do jiné složky mimo verzovací systém. (Tento krok je nutný kvůli tomu, že je potřeba přejmenování provést i uvnitř KiCAD projektových souborů).
- Původní soubory v repozitáři přejmenujeme pomocí příkazu rename.
- Soubory s novým názvem v repozitáři přepíšeme původně uloženými soubory z projektu pod jejich novým názvem.
Příklad
Je potřeba vytvořit novou verzi modulu z repozitáře ISM02B.
V naklonovaném repozitáři přejmenujeme zvolenou větev na název odpovídající navé aplikaci modulu
git branch -m TFLORA01B
V této větvi otevřeme KiCAD projekt a uložíme jej pod novým názvem do neverzované složky. Následně přejmenujeme všechny relevantní soubory. Použitím příkazu rename.
rename 's/\ISM02B/\TFLORA01B/' *
Ten je potřebné použít v některých případech vícekrát, aby byly přejmenovány všechny soubory v relevantních složkách. Nakonec přejmenované soubory přepíšeme soubory uloženými v neverzované složce. Výsledkem je takovýto stav repozitáře:
Repozitář v tomto stavu je již možné commitnout a pushnout na server standardním postupem
git commit -a git push
Výsledkem tohoto postupu je plně trackovatelná historie změn a možnost jejich porovnání a oprava chyb v původním repozitáři.