Uživatelské nástroje

Nástroje pro tento web


cs:tools

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze
Předchozí verze
cs:tools [2021/06/07 15:36] – [Tvorba knihoven] kaklikcs:tools [2023/02/06 21:52] (aktuální) – [KiCAD] kaklik
Řádek 11: Řádek 11:
 ==== KiCAD ==== ==== KiCAD ====
  
-Program [[http://www.kicad-pcb.org/display/KICAD/KiCad+EDA+Software+Suite|KiCad]] je jeden z [[http://en.wikipedia.org/wiki/Comparison_of_EDA_software|mála OpenSource]] nástrojů určený k EDA návrhu elektronických konstrukcí.  +Program [[http://www.kicad-pcb.org/display/KICAD/KiCad+EDA+Software+Suite|KiCad]] je jeden z [[http://en.wikipedia.org/wiki/Comparison_of_EDA_software|OpenSource]] nástrojů určený k EDA návrhu elektronických konstrukcí.  
-Použití kicadu pro návrh modulů popisuje [[cs:kicad|samostatná stránka]].+Použití KiCADu pro návrh modulů popisuje [[cs:kicad|samostatná stránka KiCAD]].
  
  
Řádek 31: Řádek 31:
 ==== Mentor Graphics PADS Layout ==== ==== Mentor Graphics PADS Layout ====
  
-Jde o komerční software, ve kterém je navržena většina současných modulů MLAB. Do budoucna se však předpokládá jeho úplné nahrazení Open-Source softwarem KiCAD. +Jde o komerční software, ve kterém byly dříve navrhovány MLAB moduly. Do budoucna však předpokládáme jeho úplné nahrazení Open-Source softwarem [[cs:kicad|KiCAD]]. Zdůvodu zachování kompatibility však má Mentor [[cs:pads_mentor|Graphics PADS svojí samostatnou stránku]]
  
  
-=== Návrh plošného spoje === 
  
-== Použití vrstev == 
- 
-<WRAP todo>Dopsat použití vrstev a jak vnikají SMD plošky.</WRAP> 
- 
-U fidu značek a u dalších podobných objektů (například různé díry a podobně) je vhodné zhasnout refdes. Na osazováku nejsou potřeba. 
- 
-Filter = Labels, označit text a smazat klávesou Del 
-Smazané labely lze nechat znovu položit 
- 
-Texty (popis na potisku) patří do vrstvy Silkscreen Top/Bottom. Nezapomenenme někam umístit identifikátor modulu. Stejný text patří i do vrstvy spojů. 
- 
-Písmo 80mils 
-Čára 8mils 
- 
-U diod přidáváme A k anodě a u kondenzátorů přidáváme + do vrstvy Assembly Drawing Top/Bottom) 
- 
-Písmo 80mils 
-Čára 8mils 
-Design Rules a velikosti elementů 
- 
-Nastavení Setup / Design Rules / Default / Clerance určují šířku spojů a izolační mezery mezi různými objekty. Nastavujeme hodnoty adekvátní hustotě návrhu. 
- 
-Šířka spojů 
-Trace Width / Minimum = 12mils (možno až 9mils) 
-Trace Width / Recomended = (12mils), 15mils, 20mils, 30mils nebo i 45mils 
-Trace Width / Maximum = není omezeno, ale ale spoje nad 60mils je lepší vylévat mědí. 
-Izolační vzdálenosti 
-Clearence = 10mils Clearence Copper = 20mils 
- 
-Rast je vhodný zejména pro umísťování součástek. Pro spoje je možno nastavit rastr v podstatě libovolně malý. Nejsnadněji se nastavuje pomocí příkazu G, například G10 přímo z klávesnice.  
  
 ==== OrCAD Schematic ==== ==== OrCAD Schematic ====
  
-Nástroj pro vyváření zapojení modulů a následný export netlistů pro zpracování návrhu PCB v systému PADS. Naprostá většina schémat modulů je kreslena v tomto editoru. Protože se však používal v kombinaci s PADS a nadále se významně nevyvíjí, tak se předpokládá v blízké době jeho úplné nahrazení programem KiCAD. +Nástroj pro vyváření zapojení modulů a následný export netlistů pro zpracování návrhu PCB v systému [[cs:pads_mentor|PADS]]. Protože se však používal v kombinaci s PADS a nadále se významně nevyvíjí, tak je nyní úplně nahrazen programem [[cs:kicad|KiCAD]].  
 +Historické použití OrCADu je však zdokumentováno na [[cs:orcad|samostatné stránce]].
  
-=== kreslení schéma === 
- 
-== Základní nastavení programu == 
- 
-Nastavení pro automatické vkládání razítka Options /Design Template / Title Block 
- 
-Library Name = C:\LIBRARY\ORCAD9x\SYMBOLS 
-Title Block Name = TITLE_MLAB 
- 
-Nastavení velikosti stránky (evropské nastavení) Options / Design Template / Page Size 
- 
-Units = Millimeters 
-New Page Size = A4 
-Pin to Pin Spacing = 2.54 
- 
-Nastavení rastru Options / Design Template / Grid Reference 
- 
-Vertical & Horizontal Width = 2.54 
- 
-Povolené velikosti písma ve schématu jsou 8, 14 nebo 22. 
- 
-== Umístění knihoven == 
- 
-Při kreslení schématu ukládáme knihovny do adresáře C:\LIBRARY\ORCAD9x aby se v případě změny v knihovně snadno aktualizovaly použité knihovní prvky v existujícím schématu. 
- 
-Každý prvek ve schématu je současně uložen spolu s vlastním schématem v tzv. library cache a je tam uložen včetně celé absolutní cesty ke knihovně ze které byl kopírován a tam se také hledá v případě aktualizace. Pokud budou mít všichni stejné knihovny na stejném místě budou mít snazší život. 
- 
-Máme tyto skupiny knihoven: 
- 
-    * Knihovny obsahující obecné schématické značky, například všemožné tranzistory. Tyto knihovny slouží jako zásobárna „tvarů“ při tvorbě konkrétních prvků. 
-    * Knihovny obsahující výběr běžných zástupců uvažované skupiny, například konkrétní nejběžnější tranzistory. 
-    * Knihovny přímo obsahující celou skupinu konkrétních součástí, například jumpery s různým počtem špiček. 
-    * Knihovny obsahující prvky konkrétního výrobce. Ty jsou ukládány do podadresářů jednotlivých výrobců. 
- 
-Při práci s knihovnami je třeba extra dávat pozor aby se omylem nevymazaly prvky z knihoven (stačí samotné DEL a prvek je nenávratně pryč). Dokončeným knihovnám je vhodné nastavit atribut Read Only. Knihovní prvky lze přetahovat z library cache existujícího schématu do knihovny. 
- 
-Dopsat použití atributů. Propojů a konektorů. 
- 
- 
- 
-=== Generování výstupů === 
- 
-== Generování netlistu == 
- 
- 
-Netlist obsahuje seznam spojů pro návrh plošného spoje, hodnoty součástek a názvy jejich pouzder. Gneruje se volbou Tools / Create Netlist 
- 
-Other 
-PCB Footprint / Combined Property String = {Device},{Value}@{PCB Footprint} 
-Formatters = padspcb.dll 
-Netlist File 1 – nastavit příponu .ASC 
-Generování seznamu součástí 
- 
-Tvorba seznamu součástí se skládá ze dvou kroků 
- 
-      - Vygenerování seznamu ze schématu 
-      - Úprava do podoby XLS tabulky  
- 
-Seznam součástí se z OrCADu vygeneruje funkcí Bill of Material a výsledkem je TXT soubor. 
- 
-Header: Quantity\tReference\tPart\tPCB Footprint 
-Combined property string: {Quantity}\t{Reference}\t{Value}\t{PCB Footprint} 
- 
-Finální podoba seznamu součástí je XLS tabulka. Vzor tabulky je v souboru VZOR_Seznam_součástí.xls. Vzor uložíme do adresáře SCH a otevřeme jej. Dále postupujeme podle návodu ve vzoru napsanému. 
-Generování .PDF 
- 
-Tisk provádíme obvykle na cílový formát A4 a to i pro schémata originálního formátu A3. Pro kvalitní výstup stačí rozlišení 600dpi. 
- 
-Soubor se jmenuje jako jméno modulu s doplňkem _sch. Například POKUS_sch.pdf. 
-Adobe Acrobat Distiller - preferované 
- 
-Acrobat Distiller dává barevné PDF soubory. Žádné specifické nastavení parametrů Acrobat Distiller nepotřebuje (600dpi, měřítko 100%). 
- 
-Při tisku z programu OrCAD Capture je třeba nastavit zmenšení a posunutí tisku aby byly rozumné okraje takto: 
- 
-Schéma A3 – Scale=0,65; Print Offset X=12, Y=10 
-Schéma A4 – Scale=0,91; Print Offset X=12, Y=10 
-Adobe Acrobat Writter 
- 
-Acrobat Writter dává černobílé PDF. Pro dosažení malé velikosti výsledných PDF souborů je třeba nastavit komprimaci. Velikost výstupu ani posunutí nejde ovlivnit. Výhodou je to, že schéma může být tisknuto najednou i když obsahuje listy různých formátů. Cílovým formátem nemusí být nutně formát A4 ale je to nejobvyklejší. Různé verze programu mají různé možnosti nastavení. 
- 
-Page Setup 
-Page Size / Standard = A4 
-Graphic / Resolution = 600dpi 
-Graphic / Scaling = 100% 
-Compression Options 
-General / Compress text and lineart = Yes 
-Color/Gray Scale Images / Compress using = ZIP 
-Úklid souborů 
- 
-Smažeme nepotřebné soubory, u cílových souborů zkontrolujeme jména souborů a nastavíme Read Only atribut. 
- 
-Následující soubory se obvykle nezavádějí do databáze: 
- 
-    * .OPJ definice projektu 
-    * .DBK záložní soubor schématu (.DSN) 
-    * .OBK záložní soubor knihovny (.OLB) 
- 
-Naopak následující soubory obsahují podstatná data: 
- 
-    * .DSN soubor schématu (obsahuje i library cache použitých knihovních prvků) 
-    * .OLB soubor knihovny (společné knihovny nejlépe v adresáři C:\LIBRARY\ORCAD9x) 
-    * .ASC soubor spojů – netlist 
-    * .PDF soubor s vytištěným schématem (název ve tvaru XXX_sch.pdf) 
-    * .XLS soubor se seznamem součástí včetně objednacích informací 
- 
-Povinné úkony 
- 
-Seznam povinných úkonů slouží pro rychlé ověření, že se na nic důležitého nezapomnělo. Na všechny otázky by se mělo odpovědět buď „ano“ nebo „v tomto případě záměrně ne“. 
- 
-Založení nového schématu: 
- 
-    * Je zvolen správný formát listů (A4 nebo A3) ? 
-    * Je na první straně informace o historii schématu ? 
-    * Jsou hodnoty neosazovaných součástek označeny podtržítkem ? 
-    * Jsou na schématu i součástky, které se neosazují na plošný spoj ? 
-    * Jsou na schématu alespoň 2 fidu značky na každou stranu plošného spoje ? 
- 
-Aktualizace: 
- 
-    * Je historie na první stránce aktuální ? 
-    * Je rohové razítko na všech stranách aktuální ? 
-    * Je vygenerovaný platný netlist v .ASC souboru ? 
-    * Je vygenerovaný tiskový soubor schématu v .PDF souboru ? 
-    * Je správné pořadí stránek v .PDF souboru ? 
-    * Je vygenerovaný seznam součástek ? 
-    * Mají soubory správný název ? 
-    * Mají soubory atribut Read Only ? 
-    * Jsou smazané nepotřebné soubory (i adresáře) ? 
  
  
 ==== Eagle ==== ==== Eagle ====
  
-Některé moduly jsou navržené v tomto systému ale díky nutnosti odlišné adresářové struktury jsou publikovány v SVN databázi MLAB_E, která zatím nemá webové výpisy. Do budoucna se využití Eagle pro návrh modulů dále nepředpokládá. +Některé moduly jsou navržené v tomto systému ale díky nutnosti odlišné adresářové struktury jsou publikovány v SVN databázi MLAB_E, která zatím nemá webové výpisy. Do budoucna se využití [[cs:eagle|Eagle pro návrh modulů dále nepředpokládá]].
- +
-=== Texty a popisy === +
- +
-Program Eagle používá jiné textové fonty než původně využívaný program PADs, proto je nastavení mírně odlišné, zatím se jako nejlepší jeví toto +
- +
-  * Vrstva mědi = popisky font "Vector", Size 80, Ratio 10%. +
- +
-Na jednom modulu se může vyskytovat více velikostí písma, (obvykle na modulech stačí méně, než 3). Pouzivaji se v poradi, nazev modulu, popisky, výstrahy, označení autora. Různé velikosti se samozřejmě používají pouze v případech, kdy je k tomu na modulu místo. Na některých  modulech je proto jenom jedna velikost písma podřízená čitelnosti a rozměrům modulu.    +
  
  
Řádek 233: Řádek 66:
  
  
-==== ATOM ==== 
-[[https://atom.io/|ATOM]] je nástroj pro editaci zdrojových kódů. 
- 
-Pro OpenSCAD je potřeba [[cs:openscad#pouziti_editoru_atom|doinstalovat]] balíček language-openscad. 
  
 ==== OpenSCAD ==== ==== OpenSCAD ====
Řádek 404: Řádek 233:
   sudo apt-get install codeblocks   sudo apt-get install codeblocks
      
 +=== ATOM ===
 +[[https://atom.io/|ATOM]] je nástroj pro univerzální editaci zdrojových kódů.
 +
 +
  
 ==== Embeded systémy ==== ==== Embeded systémy ====
Řádek 424: Řádek 257:
  
 Pro správu softwarového vývoje a dokumentace modulů používáme [[https://github.com/MLAB-project|github]].  Pro správu softwarového vývoje a dokumentace modulů používáme [[https://github.com/MLAB-project|github]]. 
- 
-=== Linux === 
- 
-Jako nejefektivnější uživatelské rozhraní pro git se osvědčil příkazový řádek s tím, že jeho efektivita je zde ještě markantnější než u SVN. 
- 
-== Nový uživatel == 
-Pro pohodlnou ptáci s git je efektivnější používat metodu klonování s SSH. Není při práci vyžadováno stále přihlašování. Komunikace je autentizována na základě privátního klíče. Pro každý počítač je potřeba vygenerovat unikátní klíč. 
- 
-  - Je potřeba si založit uživatelský účet na https://github.com/ 
-  - Následně je potřeba [[https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/|vygenerovat na daném počítači SSH klíč]]. 
-  - Vygenerovaný klíč je potřeba [[https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/|vložit do účtu na githubu]] 
-  - Pokud v návodu nefunguje správně uložení klíče do schránky, tak je možné daný klíč získat otevřením skrytého souboru a provést překopírování klíče ručně. ''cat ~/.ssh/id_rsa.pub'' 
-  - Tento postup stačí provést jen při prvním stahování na daném počítači. 
- 
-== Základní příkazy == 
- 
-== Klonování repozitáře : == 
- 
-  - Nejprve je potřeba vybrat místo, kde má být repozitář v počítači uložen a v daném místě si otevřít příkazový řádek. 
-  - Příklad bude ukázán na repozitáři kicad-mlab: https://github.com/MLAB-project/kicad-mlab 
-  - Na dané stránce si stáhneme potřebnou cestu k repozitáři. Webové tlačítko "Clone or download". 
-  - Je potřeba si přepnout cestu pro "Clone with SSH", na místo "Clone with HTTPS". 
-  - Pro náš případ cesta vypadá takto: git@github.com:MLAB-project/kicad-mlab.git 
-  - Nyní stačí v příkazové řádce zadat příkaz: 
- 
- 
-  git clone git@github.com:MLAB-project/kicad-mlab.git 
- 
- 
-  - Následně můžeme být vyzváni k zadání hesla, které jsme si zvolili při generování SSH klíče. 
- 
-== Stažení aktuální verze: == 
- 
-  - V místě uložení repozitáře je potřeba zadat v příkazové řádce následující příkaz: 
- 
-  git pull 
- 
- 
-== Zjištění stavu aktuálnosti repozitáře == 
- 
-  git status 
- 
-Tento příkaz vypíše u jakých souborů došlo ke změně, nebo které byli přidány jako nové. 
- 
-== Přidání nového souboru, složky == 
- 
-  git add název_souboru  
-   
-Po označení celé cesty z výpisu příkazů lze cestu vložit pomocí kliknutí na prostřední tlačítko myši. 
-Pro přidání všech změn lze použít ```git add .```. 
-        
-== Vytvoření commitu == 
- 
-  git commit -m "Popis provedené změny" 
- 
-Po tomto příkazu je commit pouze v lokální kopii repozitáře. Aby se data odeslala na server je potřeba zadat následující příkaz. 
- 
-== Upload na server == 
- 
-  git push  
-   
-Pro ověření, zda veškeré úkony proběhly v pořádku je dobré se podívat na výstup příkazu: 
- 
-  git status 
- 
-Ve výpisu by neměly být žádné položky, které jsme chtěli nahrát.      
-       
-  
-== Změna velikosti lokálního repozitáře == 
- 
-Git si ve výchozím nastavení stahuje celý repozitář včetně veškeré historie úprav. Toto lze zamezit při stahování repozitáře pomocí parametru ```--depth=<pocet stazenych commitu>``` 
- 
-  git clone <adresa_repozitare> --depth=1 
- 
-Pokuď toto chcete aplikovat na existující kopii repozitáře, lze to provést následujícím postupem. 
- 
-  git fetch --depth 2 
-  git reflog expire --expire=all --all 
-  git gc --prune=all 
- 
- 
-== Přejmenování větve repozitáře == 
- 
-Protože u repozitářů hardware není vhodné využívat větev master, neboť mezi větvemi vyrobeného hardware nemá velký smysl větve slučovat do aktuální. Tak každý hardwarový repozitář obsahuje větve pojmenovávající varianty již vyrobeného hardware.  
- 
-Protože git implicitně předpokládá název hlavní větve jako master, tak je nutné provést přejmenování.   
- 
-Nejdříve lokálně přejmenujeme větev v naklonovaném repozitáři  
-  git branch -m master new_branch         # Rename branch locally     
- 
-Změnu názvu je potřeba nahrát do repozitáře na serveru 
-  git push --set-upstream origin new_branch    
-  # Push the new branch, set local branch to track the new remote 
- 
-Následně je potřeba ve webovém rozhraní githubu pro nastevení repozitáře změnit jméno default větve. (Na githubu volba Branches -> Default branch).  
-Pak je možné větev master smazat. 
- 
-  git push origin :master                 # Delete the old branch     
- 
- 
-== Odděleni složky z repozitáře do samostatného repozitáře == 
- 
-Některé repozitáře postupem času vyrostou v obrovské molochy, které na disku zabírají hodně prostoru. Toto je příklad repozitáře [[https://github.com/MLAB-project/Modules|Modules]].  Přitom častým požadavkem lidí je snadno navázat na konstrukci jednoho jedinného modulu. Což znamená si ho na githubu forknout.  
-Plánovaným řešením tohoto problému je oddělení jednotlivých modulů do [[https://github.com/mlab-modules|samostatné organizace]].  Pro oddělení složky modulu do samostatného repozitáře využijeme postup z [[https://help.github.com/en/github/using-git/splitting-a-subfolder-out-into-a-new-repository 
-|dokumentace githubu]]. 
- 
-Nejdříve je potřeba si naklonovat čistý repozitář.  
- 
-  git clone git@github.com:MLAB-project/Modules.git 
-   
-V něm je potřeba vyfiltrovat složku, která obsahuje oddělovaný modul 
- 
-  git filter-branch --prune-empty --subdirectory-filter cesta_k/modulu  master 
-   
-Takto upravenému repozitáři ještě vytvoříme větev pojmenovanou podle konkrétní verze modulu.  
- 
-  git branch -m master Názevmodulu_včetně_verze 
- 
-Následně je potřeba na githubu vytvořit nový repozitář a cestu na remote nahradit jeho adresou. např. 
- 
-  git remote set-url origin git@github.com:mlab-modules/ISM02.git 
- 
-Pak stačí do repozitáře nahrát připravený obsah odděleného modulu 
- 
-  git push -u origin BRANCH-NAME 
- 
- 
- 
- 
- 
- 
  
  
 +Github používá verzovací nástroj [[https://cs.wikipedia.org/wiki/Git |  git ]], jeho použití máme popsané na samostatné stránce [[cs:git|]]
  
-=== Windows === +==== Subversion ====
-[[https://tortoisegit.org/download/|TortoiseGit]] Pod operačním systémem Windows je možné stahovat pohodlně data z GitHub do počítače přes program [[cs:tortoisegit|TortoiseGit]].+
  
 +Historicky byly konstrukce i moduly udržovány pomocí nástroje [[https://en.wikipedia.org/wiki/Apache_Subversion | Subversion]]. Na tomto nástroji je i postaven ještě původní [[http://home.mlab.cz/Server/GenIndex/GenIndex.php?lang=en&path=/Designs |MLAB web]].
  
 ===== Dokumentace vývoje ===== ===== Dokumentace vývoje =====
cs/tools.1623080208.txt.gz · Poslední úprava: 2021/06/07 15:36 autor: kaklik