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 [2020/10/24 20:37] – [Linux] 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 pouze [[http://en.wikipedia.org/wiki/Comparison_of_EDA_software|tří 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 KiCAD]].
  
-=== Instalace Ubuntu === 
  
-Kicad má v linuxu dvě možnosti instalace. Obvykle je však nejvhodnější použít PPA.  
  
-== PPA Repozitář == 
  
-[[https://en.wikipedia.org/wiki/Personal_Package_Archive|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 
  
-   
-=== Další nastavení ===  
  
-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 === 
-Nyní je již instalace KiCAD jednoduší. Stačí si stáhnout pro Windows typický exe soubor a nainstalovat (používáme verzi Nightly Development Builds). 
  
-http://kicad-pcb.org/download/windows/ 
  
  
-=== Nastavení === 
- 
-== Knihovny == 
- 
-  * Standardní knihovny obsažené přímo v programu [[https://github.com/KiCad|KiCAD]] 
-  * [[https://github.com/MLAB-project/kicad-library|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 MLAB, které jsou dostupné na [[https://github.com/MLAB-project/kicad-mlab|GitHubu]]. Důvod k tomu je ten, že MLAB knihovny obsahují technologicky optimalizované varianty obecných pouzder, což je důležité zejména pro osazování a automatickou tvorbu dokumentace. 
- 
-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. 
- 
-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 
- 
- 
-=== Schéma - pojmenování 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 
-   Distributor 
-   Link 
-   Note 
-   UST_ID 
- 
-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 ručně u každé součástky znovu: 
- 
-V menu ''Preferences >> General options >> Field Name Templates'' 
-{{ :cs:sw:sch_1.jpg?400 |}} 
-{{ :cs:sw:sch_2.jpg?400 |}}   
- 
-Při otevření parametrů součástky vypadá tabulka následnovně: 
-{{ :cs:sw:sch_3.jpg?400 |}}  
- 
- 
- 
-Příklad vyplnění parametrů součástky: 
- 
-   Reference: C1 
-   Value: 10nF 
-   MFPN: 1812CA103JAT2A (přesný typ součástky, pro osazování) 
-   Distributor: Mouser 581-1812CA103JAT2A 
-   L{{ :cs:sw:sch_2.jpg?400 |}}ink: https://cz.mouser.com/ProductDetail/AVX/1812CA103JAT2A?qs=sGAEpiMZZMsh%252b1woXyUXjzY5digEXfcQu%252bp00y9d0Fc%3d 
-   Note: přesnost 20%, C0G 
-   UST_ID: pokud je přístup do UST skladu  
-   
- 
-Při kreslení modulu osob s přístupem do UST skladu, je potřeba při kreslení schéma vkládat rovnou UST_ID k daným součástkám. A pokud daná součástka ještě neexistuje, je potřeba jí rovnou vytvořit. Značně to usnadňuje následnou výrobu a jednoznačně definuje osazení. 
- 
-=== 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. 
- 
- 
-{{ :cs:navrh_prav.jpg?600 |}} 
-{{ :cs:navrh_prav01.jpg?600 |}} 
- 
-=== 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 (**výhradně 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í) 
-   ***Dwgs.User** - kóty a další potřebné popisy, které nepatří do výrobní nebo osazovací vrstvy 
-   ***Edge.Cuts** - obrys 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 vychází z [[https://github.com/KiCad/kicad-doc/blob/master/src/pcbnew/pcbnew_layers.adoc|dokumentace vrstev KiCADu]] 
  
- 
- 
- 
-  
-=== 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 [[https://github.com/MLAB-project/kicad-mlab/blob/master/plugins/bom_ust.py|bom_ust.py]]. 
-  - Je potřeba bom_ust.py uložit do místa instalace kicad. {{ :cs:sw:kicad_ust_bom.jpg?600 |}} 
-  - 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í výrobních dat=== 
-Při návrhu je dobré nepodlézat parametry v následující tabulce: 
-{{ :cs:sw:kicad_tridy.jpg?300 |}} 
- 
-Před počátkem generování výrobních dat je potřeba provést kontrolu DRC. Doporučené parametry: 
-{{ :cs:sw:kicad_drc.jpg?300 |}} 
-  
-== Gerber data== 
-U dvojvrstvého PCB nastavit tyto parametry: 
-{{ :cs:kicad_plot.jpg?300 |}} 
- 
-== Drill data== 
-Nastavení pro generování vrtaných děr: 
-{{ :cs:kicad_drill.jpg?300 |}} 
  
 ==== 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ů. +
- +
-=== Tvorba knihoven === +
- +
-Dopsat doporučení. +
- +
-=== 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é PDFPro 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 368: Řá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 440: Řádek 134:
 Nastavení skládání setu je v souboru [[http://www.gedasymbols.org/user/stefan_tauner/tools/gerbmerge/doc/layoutfile.html|layout.cfg]] a v soboru placement.merge.txt je uloženo požadované rozložení v setu. Soubor s rozložením setu se vygeneruje atomaticky při prvním spuštění programu gerbmerge. Nastavení skládání setu je v souboru [[http://www.gedasymbols.org/user/stefan_tauner/tools/gerbmerge/doc/layoutfile.html|layout.cfg]] a v soboru placement.merge.txt je uloženo požadované rozložení v setu. Soubor s rozložením setu se vygeneruje atomaticky při prvním spuštění programu gerbmerge.
 Vygenerování takto připravených dat se provede následujícím příkazem: Vygenerování takto připravených dat se provede následujícím příkazem:
-  ../../src/gerbmerge/gerbmerge.py --place-file=placement.merge.txt layout.cfg+  ../../src/gerbmerge/gerbmerge.py main.cfg layout.txt
  
 === Upravená verze programu gerbmerge pro MLAB === === Upravená verze programu gerbmerge pro MLAB ===
Řádek 490: Řádek 184:
 == GerberTools == == GerberTools ==
  
-[[https://github.com/ThisIsNotRocketScience/GerberTools|GerberTools]] je zatím nevyzkoušený open-source nástroj napsaný primárně pro Windows v C#.  +[[https://github.com/ThisIsNotRocketScience/GerberTools|GerberTools]] je vhodný pro ruční skládání s frézováním na můstky. Napsaný primárně pro Windows v C#. [[https://github.com/ThisIsNotRocketScience/GerberTools/releases|Sputitelná verze programu]]   
  
  
Řádek 539: Řá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 559: Řá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 
- 
- 
-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 
- 
- 
- 
- 
- 
- 
- 
- 
- 
  
  
 +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.1603571828.txt.gz · Poslední úprava: 2020/10/24 20:37 autor: kaklik