#stm32-robotics

This is the template project for student semestral projects in classes MRBT
and BROB.

Author:
 
Ing. Frantisek Burian

Laboratory of Robotics,

Department of Control and Instrumentation

Faculty of electrical engineering and communication

Brno University of Technology

- - -

## Česky:

Tento repozitář slouží jako vzorový projekt pro vytváření projektů v předmětech
Základy Robotiky (BROB) a Robotika (MRBT).

## Návod k použití:

### Stažení repozitáře

1. Zaregistrujte se na http://www.github.com a přihlaste se. Pro účely postupu
   budu předpokládat váš login &lt;login&gt;.

2. Proveďte "fork" na tomto repozitáři (ikona vpravo nahoře), tím si vytvoříte
   vlastní kopii, do které můžete odesílat své změny a můžete tímto způsobem
   též projekt odevzdat na konci semestru. 
   Adresa bude https://github.com/&lt;login&gt;/stm32-robotics.git

3. Nainstalujte aktuální verzi TortoiseGIT (ze sourceforge). Nedoporučuji český
   překlad, protože při případné konzultaci Vám budu radit anglickou verzí názvu.

4. Na disku v adresáři, kde chcete spravovat zdrojáky klikněte pravým tlačítkem,
   a vyberte "Git clone"
   
   Do políčka URL zadejte adresu Vašeho veřejného repozitáře -
       "https://github.com/&lt;login&gt;/stm32-robotics.git".

   Do políčka Directory zadejte cestu končící názvem složky jak chcete aby se
   jmenovala na Vašem disku. (např. projekt)

   Vše ostatní nechte výchozí a klikněte na OK. Nyní by se vám měl obsah
   veřejného repozitáře přesunout k Vám na disk.
   
5. Nyní musíte aktualizovat submoduly třetích stran:

   Klik pravým tlačítkem na složce s projektem, menu "TortoiseGIT" položka 
   "Submodule update". Je potřeba vybrat "init" a "update", klik na OK, a
   všechny závislé repozitáře se Vám přesunou na disk (zejména ovladače k
   mikrokontroleru - libopencm3). 

   HOTOVO.

   Pokud máte nainstalovaný správně kompilátor gcc (postup dále v tomto souboru),
   již stačí otevřít projekt v Code::Blocks a překompilovat projekt, případně
   rovnou spustit ladění.
   
### Odesílání změn na server

TODO

### Stahování změn ze serveru

TODO

### Instalace kompilátoru (Code::Blocks)

TODO

### Instalace kompilátoru (Eclipse)

TODO

### Tipy pro ladění

- zásek na blocking_handler z důvodu nějakého FAULT. Stáhnout
   https://github.com/Laurenceb/STM32-Logger/blob/master/jtag/armv7m-macros.gdb
   a pak v GDB v okamžiku FAULTu
   ``` 
   source armv7m-macros.gdb; vecstate
   ```

