Page locked

This page is currently locked for editing by another user. You have to wait until this user finishes editing or the lock expires.
Currently locked by: 216.73.216.88
Lock expires at: 2025/06/30 20:32 (6 min)
This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//

====== Software tools for MLAB kit development ======

This site deals with software tools necessary for MLAB kit development and design, for information about technical equipment see  [[en:navody|manuals]].

MLAB design and development is not restricted to one specific set of tools because different users have different demands of and approaches towards different types of sotware.

===== Electronic CADs =====

Tools for PCB design and schematics drawing, eventually also for simulation of connection. At the present time, we prefer KiCAD software, other tools are mentioned because they are still used to create some designs. 

==== KiCAD ====

[[http://www.kicad-pcb.org/display/KICAD/KiCad+EDA+Software+Suite|KiCad]] software suite is one of only [[http://en.wikipedia.org/wiki/Comparison_of_EDA_software|three OpenSource]] tools for electronic design automation (EDA) of electronic circuits.  

=== Ubuntu installation ===

There are two options for KiCAD installation in linux - usually it is advised to use the PPA.

== PPA Repository ==

[[https://en.wikipedia.org/wiki/Personal_Package_Archive|PPA]] is a system of remote access to an already prepared software packages. They usually contain a more actual version than the packages available from the standard system repositories.

In order to download and install the most stable KiCAD version, enter following commands into a terminal:

  sudo add-apt-repository --yes ppa:js-reynaud/ppa-kicad
  sudo apt-get update
  sudo apt-get install kicad

  
=== Further settings === 

In its default setting, Ubuntu has disabled contextual icons - therefore the installed KiCAD does not contain any menu icons simplifying the design process. The problem can be solved by typing a following commands:

  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.
  

=== Windows Installation ===
The KiCAD installation is nowadays much simpler - it is only necessary to download an exe file and install it.

http://kicad-pcb.org/download/windows/


=== Settings ===

== Libraries ==

  * Standard libraries included directly in the programm [[https://github.com/KiCad|KiCAD]]
  * [[https://github.com/MLAB-project/kicad-library|Libraries with components specific for MLAB]], which also contain a script for their download from Github and offline work in KiCAD.

It is convenient to use as many parts of MLAB libraries (available at [[https://github.com/MLAB-project/kicad-mlab|GitHubu]]) as possible when designing modules. MLAB libraries contain technologically optimised variants of general encasements, which is important especially during fitting and automatic generation of documentation.

Libraries are added to KiCAD separately during schematics drawing and separately during PCB designing - the procedure is very similar in both cases.

  * Preferences -> Manage Symbol Libraries -> "Global Libraries" - Browse Libraries -> Open Library


=== Schematics - components naming ===

During schematics drawing, it is necessary to stick to some convention so that the production and automatic generation of further documentation may occur without problems.

At the first start of Kicad Eeschema, you have to add the following fields describing components: 
   MFPN
   Distributor
   Link
   Note
   UST_ID

In case that a schematic contains variants of fitted components, the MFPN (?? Identifikace pole) has an additional serial number, for example “MFPN_1”, “MFPN_2” etc. Components with the same serial number belong to the same variant and components without a serial number are common to all fitted variants. 

When using a following procedure, it is no longer necessary to manually create all fields for every individual component.

V menu ''Preferences >> General options >> Field Name Templates''
{{ :cs:sw:sch_1.jpg?400 |}}
{{ :cs:sw:sch_2.jpg?400 |}}  

Opening the component’s parameters will show a following table:
{{ :cs:sw:sch_3.jpg?400 |}} 



An example of filled in component’s parameters:

   Reference: C1
   Value: 10nF
   MFPN: 1812CA103JAT2A (an exact type of component, for fitting purposes)
   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: accuracy 20%, C0G
   UST_ID: if there is an entry in UST stock (?? pokud je přístup do UST skladu) 
  



=== Rules for design ===

Before the beginning of PCB design, it is necessary to set up following rules. 
If you are not using circuits with small pitch of pins, following parameters are good to follow:

{{ :cs:navrh_prav.jpg?600 |}}
{{ :cs:navrh_prav01.jpg?600 |}}

=== Layers ===

Layers settings differ according to the total number of layers on PCB.

== Two layer PCB ==

   ***F.CU** - upper copper layer (usually GND layer)
   ***B.CU** - bottom layer (**exclusively for SMD components**)
   ***F.SilkS** - upper silkscreen (this layer is fabricated)
   ***B.Silks** - bottom silkscreen (layer is not routinely fabricated)
   ***Edge.Cuts** - PCB final outline
   ***F.Fab** - fabrication layer (??) strana součástek
   ***B.Fab** - potisk pro osazování - strana spojů (??)
 
This layer arrangement is based on [[https://github.com/KiCad/kicad-doc/blob/master/src/pcbnew/pcbnew_layers.adoc|KiCAD layers documentation ]]
  
=== Generating a list of components - BOM ===

== Linux ==

  - Press "set plugin cmd" and choose ///usr/lib/kicad/plugins/bom2csv.xsl// file
  - The “command line” field will automatically sett as xsltproc -o "%O.csv" "/usr/lib/kicad/plugins/bom2csv.xsl" "%I"
  - Press "Generate”, KiCAD will create a .csv file with a list of components


== Windows ==

Generating BOM files in a .CSV format is not directly possible in WIN. This problem can be solved using a following procedure:

  - Download [[http://sourceforge.net/projects/saxon/files/Saxon-HE/9.5/|Saxon]] and install it 
  - In KiCAD eeschema open "Tools > Generate Bill Of Materials"
  - Press "Add Plugin"
  - Name it as you wish
  - In a command line write a following path "C:\Saxonica\SaxonHE9.5N\bin\Transform.exe" -t "%I" -xsl:"C:\kicad\src\kicad\eeschema\plugins\bom2csv.xsl" -o:"%O.csv"
  - In the first part, there is a path leading to the installed Saxon program, the second part leads to a bom2csv.xsl file (found in a folder with an installed KiCAD)

[[https://forum.kicad.info/t/bom-generation-in-new-kicad-windows/228|Source]]

=== Generating production data ===

During designing, it is good not to undertake (?? Nepodlézat) parameters in a following table: 
{{ :cs:sw:kicad_tridy.jpg?300 |}}

Before you begin generating production data, it is necessary to carry out a DRC control.
Recommended parameters:
{{ :cs:sw:kicad_drc.jpg?300 |}}
 
== Gerber data==

Set following parameters for two layer PCB:
{{ :cs:sw:kicad_gerber.jpg?300 |}}

== Drill data==

Settings for generating bore holes: 
{{ :cs:sw:kicad_drill.jpg?300 |}}

==== Mentor Graphics PADS Layout ====

It is a proprietary software where most of the present MLAB modules are designed. However, we assume that it will be completely replace by Open-Source KiCAD in the future.

=== PCB design ===

== A use of layers ==

In case of fidu labels (?? fidu značek) and other similar objects (various holes etc.) it is helpful to turn off refdes - they are not needed on osazovák (??).

Filter = Labels, mark the text and delete it using Del key
Deleted labels can be laid (?? Položit) again.

Texts (labels on printing) belong to Silkscreen Top/Bottom layer. Do not forget to place module identification somewhere. The same text also belongs to the traces layer (vrstva spojů ??).

Font 80mils
Line 8mils

In case of diodes, we add A to the anode and in case of condensers we add + to the Assembly Drawing Top/Bottom layer.

Font 80mils
Line 8mils

Design Rules a elements size

Settings in Setup / Design Rules / Default / Clerance determine the with of the traces and insulators spaces between various objects. Set the values with respect to the density of design.

Trace widths
Trace Width / Minimum = 12mils (possibly up to 9mils)
Trace Width / Recomended = (12mils), 15mils, 20mils, 30mils or 45mils
Trace Width / Maximum = unlimited, however it is better to pour traces wider than 60mils with copper
Insulatory distances
Clearence = 10mils Clearence Copper = 20mils

Raster is suitable especially for components placement. For placing traces, raster can be in fact arbitrarily small. It can be easily set using G command, e.g. G10 directly from keyboard. 

==== OrCAD Schematic ====

A tool for creating electrical circuits of modules and a following export of netlists into PADS system for processing PCB designs. The vast majority of module schematics is drawn using this editor. Because it is used in combination with PADS and it is no longer notably developed, it is assumed to be replaced by KiCAD in a near future.

=== Schematics drawing ===

== Basic programme settings ==

Settings for an automatic stamp insertion Options /Design Template / Title Block

Library Name = C:\LIBRARY\ORCAD9x\SYMBOLS
Title Block Name = TITLE_MLAB

Page size settings (European settings) Options / Design Template / Page Size

Units = Millimeters
New Page Size = A4
Pin to Pin Spacing = 2.54

Raster settings Options / Design Template / Grid Reference

Vertical & Horizontal Width = 2.54

Allowed schematics’ font sizes are 8, 14 or 22.

== Where to place libraries   ==

During a schematics drawing, we save libraries into C:\LIBRARY\ORCAD9x directory, so that when there is a change in a library, all used library elements in the existing schematics can be updated with ease.

Every schematics’ element is saved together with its own schematics in the so called library cache - it is saved including a whole absolute path to the library it was copied from and at the same time, in case of update, it is also search for here. If all users have the same libraries at the same place, life would be easier :) 

We have following groups of libraries:

    * Libraries containing general schematics symbols (?? Značky), e.g. all kinds of different transistors. Such libraries serve as a depository of ‘structures’ during a creation of various components. 
    * Libraries containing a choice of a common representatives of certain groups, e.g. specific common transistors.  
    * Libraries containing a whole group of specific components, e.g. jumpers with different types of tips (?? Špička). 
    * Libraries containing components from a specific manufacturer. These are saved into subdirectories of specific manufacturers. 

When working with libraries, one must be extra cautious not to delete some of their elements by change (it is enough to press DEL and the element is gone). It is beneficial to set the finished libraries as Read Only. Elements of libraries can be dragged into an library from a library cache of an existing schematics.


=== How to create a library ===

=== Generating outputs ===

== Generating netlists ==

Netlist contains a list of connections in PCB design, values of components and names of their encasements. It can be generated via a Tools / Create Netlist option. 

Other
PCB Footprint / Combined Property String = {Device},{Value}@{PCB Footprint}
Formatters = padspcb.dll
Netlist File 1 – set a suffix .ASC
Generating list of components

Creating a list of components consists of two steps

      - Generating a list from a schematics
      - Conversion into an XLS table

A list of components from OrCADS is generated using a Bill of Material function, resulting in a TXT file.

Header: Quantity\tReference\tPart\tPCB Footprint
Combined property string: {Quantity}\t{Reference}\t{Value}\t{PCB Footprint}

The final form of components’ list is an XLS table. You can find an exemplar of table in VZOR_Seznam_součástí.xls. Save it into the SCH directory and open it. Proceed according to the instructions that are found in the exemplar. 
Generating .PDF

Printing usually uses A4 as its target format, even in case of schematics that are originally of A3 size. 600dpi resolution is sufficient for a good quality output.

File is named according to the name of the module with a _sch suffix - e.g. SAMPLE_sch.pdf.

Adobe Acrobat Distiller - preferred

Acrobat Distiller creates colourful PDF files. It does not need any specific parameter setting (600dpi, scale 100%).

When printing with OrCAD Capture, it is necessary to set up a reduction in scale of the print and its shift in order for borders to be satisfactory. 

A3 schematics – Scale=0,65; Print Offset X=12, Y=10
A4 schematics – Scale=0,91; Print Offset X=12, Y=10
Adobe Acrobat Writter

Acrobat Writter create black and white PDFs. In order to get a small size of the final PDF files, a compression has to be set. Neither the output size nor the shift cannot be altered. Advantage of this program is, that the schematics can be printed at once even if it contains lists in various formats. The final format does not have to be A4, however it is the most common case. Different versions of the program have different settings’ possibilities. 

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

Files cleanup

Delete all the unnecessary files, check the names of the final files and set Read Only attribute. 

The following files are not routinely loaded (?? Zavést) to database:

    * .OPJ project definitions
    * .DBK backup schematics file (.DSN)
    * .OBK backup library file (.OLB)

On the contrary, the following files do contain important data:

    * .DSN schematics file (also contains library cache of the used elements of libraries)
    * .OLB library file (common libraries, best when in C:\LIBRARY\ORCAD9x directory)
    * .ASC netlist
    * .PDF file with the printed schematics (name in the XXX_sch.pdf format)
    * .XLS file with the components’ list, including ordering (??) objednacích information

Mandatory actions

The list of mandatory actions serves as a quick check that you have not forgotten anything important. All the question should be answered either “yes” or “in this case intentionally no”. 

New schematics establishment:

    * Is the right page format chosen (A4 or A3) ?
    * Is there an information about the schematics history on the first page? 
    * Are the values of the components that will not be mounted marked by an underscore?
    * Does the schematics contain also componontents that will not be mounted onte the PCB
    * Are there at least 2 fidu marks (??) for each PCB side on every schematics? 

Actualisations:

    * Is the history on the first page up-to-date?
    * Is the title block on every page up-to-date?
    * Have you generated a valid netlist in .ASC format?
    * Have you generated schematics print file in .PDF format?
    * Is there a correct page order in the .PDF file?
    * Have you generated a list of components?
    * Are the files named correctly?
    * Do the files have Read Only attribute set?
    * Have you deleted any unnecessary files (and directories)?


==== Eagle ====

Some modules are designed in this system - however, due to a necessity of having different directory structure, they are published in SVN database MLAB_E that does not yet have web listings. In the future, we do not expect further using Eagle for module design.

=== Texts and labels ===

Eagle software uses different text fonts that a formerly used PADs, that is why its setting is slightly different. So far, the following setting seems to work best:

  * Copper layer = labels font "Vector", Size 80, Ratio 10%.

One module can contain more font sizes (usually less than 3 is enough). They are used in the following order: module name, labels, warnings, author identification. Different font sizes are of course only used in cases, when there is enough space on the module. Therefore, some modules only contain one font size, with respect to a good readability and module size. 


===== Mechanical CADs =====

==== LibreCAD ====

To draw flat technical drawings [[http://librecad.org/cms/home.html|LibreCAD]] can be used. In Ubuntu, it can be installed directly from the package (?? Z balíku):

  sudo apt-get install librecad
  
==== FreeCAD ====

[[https://www.freecadweb.org/|FreeCAD]] is on the other hand well suited for a classical 3D modelling, known from many proprietary CAD software. It seems convenient to use its daily build, available from PPA.

  sudo add-apt-repository ppa:freecad-maintainers/freecad-daily
  sudo apt-get update
  sudo apt-get dist-upgrade
  sudo apt-get install freecad-daily freecad-daily-doc 


==== OpenSCAD ====

[[http://www.openscad.org/|OpenSCAD]] is a tool for designing 3D models of technical devices. In contrast with most of the design tools, OpenSCAD uses a programming language to describe objects. This approach allows models parametrisation and their easy versioning with an accurate identification of changes. A basic introduction into its using can be found here [[http://blog.cubehero.com/2013/11/19/know-only-10-things-to-be-dangerous-in-openscad/|Know only 10 things to be dangerous in OpenSCAD]]. There is also an [[http://www.openscad.org/cheatsheet/|overview of basic functions]].


=== Ubuntu Installation ===

In order to instal the actual version for Ubuntu 14.10 and higher, there is a PPA repository ready:
  sudo add-apt-repository ppa:openscad/releases
  sudo apt-get update
    
Openscad can be then installed using a following command: 
  sudo apt-get install openscad

The programme can be opened in the usual from dashboard or using command line.

Pro použití nejnovějších funkcí je vhodné použít denní kompilaci openscadu. 
  sudo apt-get install openscad-nightly

Tu lze pak spustit z příkazového řádku jako openscad-nightly, obě verze proto mohou být naistalované paralelně. 

<WRAP center round tip 80%>
Pro zobrazení náhledů vygenerovaných STL souborů v prohlížeči Nautilus můžete využít nástroj [[https://github.com/MLAB-project/stl-thumbnailer|stl-thumbnailer]].
</WRAP>

=== Styl psaní kódu (coding style) ===

Je praktické dodržovat některá základní pravidla při vytváření modelů v openscadu.

  * Názvy proměnných vytvářet v mezinárodním jazyce (angličtina a globálně známé výrazy a zkratky) 
  * Příliš nezkracovat názvy proměnných
  * Proměnné a operátory oddělovat mezerami
  * Používat odsazení o 4 mezery (tabulátor) ve vnořeném bloku kódu

  
=== Použití editoru SublimeText ===

Editor integrovaný přímo do OpenSCADu není moc pohodlný pro užívání. Je proto vhodnější zdrojové kódy modelů editovat v editoru [[https://www.sublimetext.com/|SublimeText 3]].  K tomu je ale vhodné si do editoru nainstalovat plugin, který zná jazyk OpenSCADdu. 

Instalaci lze provést přes systém balíčků, který můžeme aktivovat volbou //Tools -> Install Package Control..//. 

{{:cs:sw:sublimetext3_package_control_install.png?400|}}

Otevřeme nástroj pro zacházení s balíčky volbou //Preferences -> Package Control//.

{{:cs:sw:sublimetext3_package_control.png?400|}}

V nabídce zvolíme "Install Package"

{{:cs:sw:sublimetext3_install_package.png?400|}}

Do filtračního pole napíšeme "openscad". A klikneme na odpovídající balíček.

{{:cs:sw:sublimetext3_install_openscad.png?400|}}

Nyní je potřeba SublimeText zavřít a znovu otevřít, aby se nová konfigurace projevila.
Potom je možné nastavit, aby všechny soubory s příponou //.scad// byly otevřeny s OpenSCAD zvýrazňováním syntaxe. To lze nastavit přes volbu v pravém dolním rohu a výběrem //Open all with current extension as.. -> OpenScad//

{{:cs:sw:sublimetext3_select_openscad.png?400|}}

Při následujícím otevření .scad souboru bude automaticky rozpoznán jako OpenSCAD zdrojový kód.

===== Generování a prohlížení výrobních dat =====

==== Gerber data ====

Pro prohlížení vygenerovaných dat jsou vhodné nástroje:

  * [[http://gerbv.sourceforge.net/|Gerbv]] - Linux
  * [[http://www.pentalogix.com/|ViewMate]] - Windows

=== Skládání gerber dat ===

Pro skládáni dat lze využít program gerbmerge. Který se na internetu vyskytuje v několika různých větvích vývoje. Pro použití s programem kicad je vvýhodné použít relativně novou vývojovou větev [[http://www.dent.med.uni-muenchen.de/~kkunzelm/htdocs/6_software-tools-panelize_metric-kicad-files.html| prof.
 Karl-heinz Kunzelmann]].  Ta vychází z prvotní verze 1.8. a dalších úprav. Poměrně významně se však liší od verze [[https://github.com/MLAB-project/gerbmerge3|gerbmerge3]], která ale má čistější zdrojový kód.  

Nejdříve nainstalujeme závislosti. 
  sudo apt-get install python-simpleparse python-simpleparse-mxtexttools

Následně stáhneme gerbmerge z githubu.
  git clone https://github.com/MLAB-project/gerbmerge
  cd gerbmerge
  sudo python setup.py install

Aby gerbmerge fungoval, tak je mu potřeba zadat způsob panelizace to se dělá konfiguračním souborem. Příklad konfiguračního souboru je vložen u zdrojových kódů programu. Přímo v něm jsou komentáře vysvětlující jeho použití.
Pakud ale máme připravený konfigurační soubor např. //layout-mm-3.3.cfg// tak gerbmerge můžeme spustit.

  kaklik@popelnice:~/git/gerbmerge/testdata-with-KiCAD-using-metric-units/MLAB_panel$ ../../src/gerbmerge/gerbmerge.py layout-mm-3.3.cfg

Program se pokusí nalézt optimální rozložení motivů na panelu podle zvolené konfigurace a vygeneruje výsledné složené soubory. 

Příklad pro složení SET10A (instalace se schoduje s předchozím příkladem)
Nejprve je potřeba se dostat do místa, kde jsou data setu: 
  MLAB@MLAB:~/MLAB-project/gerbmerge/MLAB_panel/SET10A$
Nastavení skládání setu je v souboru 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:
  ../../src/gerbmerge/gerbmerge.py --place-file=placement.merge.txt layout.cfg
  
== GerberTools ==

[[https://github.com/ThisIsNotRocketScience/GerberTools|GerberTools]] je zatím nevyzkoušený open-source nástroj napsaný primárně pro Windows v C#.  


==== Gkódy pro 3D tisk ====

Technologická data pro 3D tisk v MLABu generujeme programem [[http://slic3r.org/|Slic3r]]. Zatím od něj neexistují připravené balíky v použitelné verzi. Proto je nutné program přeložit přímo ze zdrojových souborů na githubu. 


=== Instalace Slic3r ===

  sudo apt-get install libextutils-cppguess-perl freeglut3-dev
=== Postup kompilace ===

Z githubu se aktuálně používá master větev, která je kompromisem mezi stabilitou a možnostmi software. Samotná kompilace pak probíhá vetšinou podle instrukcí v souboru README.md


===== Programátorské nástroje =====

Na většinu programování softwaru se používá se v MLABu používá Python, nebo C. Vývojové nástroje jsou pro tyto jazyky dobře obecně známé. Většina vývoje je navíc orientována na Linux.  Proto zde uvedeme jen seznam nástrojů, které používáme. 

==== Programovací GUI ====

Programovací prostředí v kterém je vytvářen zdrojový kód. Mezi uživateli jsou nejoblíbenější následující dvě volby. Jinak lze ale zdrojový kód psát v libovolném textovém editoru. 

=== Light Table ===

[[http://lighttable.com/|Light Table]] je programátorský editor kódu, který vyniká speciálními vlastnostmi, jako je například interaktivní spouštění částí zdrojových kódů, nebo přímé vyhledávání v dokumentaci. 
Jeho instalaci do systému provedeme stažením zkompilovaného balíku z stránky [[http://lighttable.com/|Light Table Download]], rozbalením staženého balíku a provedením následujících příkazů, které jej přesunou do systémových složek.

  sudo mv LightTable /opt/LightTable
  sudo ln -s /opt/LightTable/LightTable /usr/bin/lighttable
=== Sublime text ===

Multiplatformní placený editor pro linux, Windows, Mac OS.  Mezi jeho vyjímečné vlastnosti patří například náhled celého zdrojového kódu. Pro běžné použití stačí nezaplacená varze. 

== Instalace v Ubuntu ==


  sudo add-apt-repository ppa:webupd8team/sublime-text-3 
  sudo apt-get update
  sudo apt-get install sublime-text-installer
=== Code::Blocks ===

Jde o velmi rozřířený editor, jehož výhodou je, že běží na více platformách a mohou ho tedy používat i uživatelé windows.

[[http://www.codeblocks.org/|Code::Blocks]]

  sudo apt-get install codeblocks
  

==== Embeded systémy ====

Nástroje na programování jednotlivých typů mikrokontrolérů jsou většinou popsány v částech týkajících se programování u jednotlivých architektur: 

=== PIC ===
  * [[cs:pic_programming|PIC]]
=== ARM ===
  * [[cs:arm_programming|ARM]]
=== AVR ===
  * [[cs:avr_programming|AVR]]
===== Správa verzí =====





==== 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





 


=== Windows ===
[[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]].


===== Dokumentace vývoje =====

==== Textová dokumentace ====

Veškeré textové dokumenty jsou v MLABu kódovány v UTF-8 někteří uživatelé ale požívají na editaci souborů windows a výsledkem je nekompatibilní soubor, který je třeba překódovat.

Převod kódování textových souborů.

  iconv -f WINDOWS-1250 -t UTF-8 zprava.txt  -o zprava.txt


=== Dokuwiki ===

Dokuwiki je systém ve kterém běží tato dokumentace.

== Offline editace ==

Podstatné ale je, že je možné tuto dokumentaci editovat i offline, což se hodí zejména při cestování.
 
K tomu je potřeba si na svém notebooku zprovoznit lokální instanci wiki. Tu si zprovozníme podle [[https://www.dokuwiki.org/install:ubuntu#alternative_easier_custom_installation|návodu na instalaci Dokuwiki pod Ubuntu]]. Data pak mezi oběma instancemi wiki synchronizujeme pomocí [[https://www.dokuwiki.org/plugin:sync|pluginu sync]], který naistalujeme na svojí lokální instanci wiki. Po první synchronizaci se serverovou wiki můžeme stránky lokálně offline editovat a změny následně nahrát na veřejnou wiki MLAB. 

=== LaTeX ===

LaTeX je  je systém pro sazbu profesionálních dokumentů. V složce templates je pro něj šablona. 


V případě psaní dokumentace v Ubuntu se použivají následující balíky 

  sudo apt-get install texmaker texlive-lang-czechslovak
  
Po jejich istalaci je možné psát a editovat MLAB dokumenty napsané v [[http://cs.wikipedia.org/wiki/LaTeX|LaTeXu]]

=== Dokuwiki a Latex ===

Poslední dobou je poměrně častým dokumentačním problémem převod dokumentace postupně vznikající na wiki do formální podoby dokumentu. Přímé přepisování není příliš efektivní. Proto je vhodnější využít programové nástroje jako například [[http://johnmacfarlane.net/pandoc/try/|Pandoc]], ten umí vzájemně převádět mnoho formátů dokumentů. Ale neumí přímý převod Dokuwiki syntaxe na Latex. Lze si však pomoci použitím HTML kódu, který generuje dokuwiki a se kterým již Pandoc umí pracovat. 

Webová verze Pandoc umí zpracovat HTML kód o délce pouze do 1000 znaků. Je proto vhodné si nainstalovat lokální offline verzi. 

  sudo apt-get install pandoc
  
Převod pak můžeme realizovat příkazem:

  pandoc -f html -s -t latex temp_doc.html
  
Převedený dokument se nám pak vypíše do příkazové řádky, odkud jej pak stačí zkopírovat do Latexového editoru.


[[http://donaldmerand.com/code/2012/07/20/how-i-actually-convert-dokuwiki-to-latex.html| Offline metoda tohoto převodu]]

==== Obrázková dokumentace ====

=== Dia ===

Program dia slouží na tvorbu diagramů a blokových schémat.

=== Fritzing ===

Je snaha použít fritzing pro tvorbu dokumentace zapojení jednotlivých modulů v konstrukcích. Zatím však Fritzing nepodporuje mechanické umístění. Plošných spojů. Takže se tento nástroj reálně nepoužívá. 


=== Prezi ===

Je nástroj na tvorbu veřejných prezentací projektů. 

=== ImageMagick  ===

[[http://www.imagemagick.org/Usage/resize/#shrink|Změna velikosti obrázků]].

===== Kontrola kvality =====

Pro zkontrolování celkové kvality dokumentace návrhů slouží [[https://www.mlab.cz/modules/all|přehled dokumentace modulů]].  

Tento přehled lze řadit podle různých kriterií. Například 

  * https://www.mlab.cz/modules/all?order=status,name - řazení podle stavu a jména
  * https://www.mlab.cz/modules/all?order=id - podle id (výchozí)
  * https://www.mlab.cz/modules/all?order=root - podle složky (tedy kategorií)

Každý modul má přiřazenou známku kvality. Aktuálně se hodnotí kvalita fotografie podle následujících kritérií

  * 0 - žádná fotografie
  * 25 - render z KiCAD
  * 50 - nekvalitní fotografie např. z telefonu
  * 100 - profesionální fotografie z [[cs:designs:fotobedna|fotografického boxu]].


===== Organizace vývoje =====


==== Redmine ====

Je nástroj pro vytváření úkolů a dělbu práce na projektech. Jeho instance[[http://www.mlab.cz/redmine|běží na serveru]]. 

====== Nástroje pro zpracování dat ======

===== Interaktivní výpočetní nástroje =====
 
==== Jupyter notebook ====

Jupyter je softwarový nástroj, který umožňuje použít více výpočetních a programátorských balíků jako je například Python nebo Octave. Výhodou Jupyteru je interaktivní zpracování příkazů což oceníme hlavně při testování nebo psaní nových algoritmů.

=== Instalace ===

Postupujeme podle doporučení [[https://github.com/jupyter/notebook|v repozitáři se zdrojovými kódy]].

  sudo pip install notebook
  
Spuštění se naopak provede 

  jupyter notebook
 
Kde si pak zvolíme námi použitý kernel. 

  
===== gnuradio =====

[[http://gnuradio.org/|Gnuradio]] je nástroj pro zpracování signálových dat obvykle z SDR přijímačů.



====== Simulační nástroje ======

=====  Nec2++ =====

[[http://elec.otago.ac.nz/w/index.php/Necpp|Necpp]] je nástroje pro numerické výpočty anténních parametrů.

==== QAntenna ====

[[http://qantenna.sourceforge.net/download.php|QAntenna]]

=== Kompilace ===
   sudo apt-get install qtbase5-dev qttools5-dev

   git clone git://git.code.sf.net/p/qantenna/code qantenna-code  qttools5-dev-tools
   cd qantenna-code/
   qmake qantenna.pro
   make