build instructions update

Czech version added
This commit is contained in:
MRprusa3d 2018-05-08 23:10:07 +02:00
parent 737cb9608c
commit b889d770a5
2 changed files with 56 additions and 0 deletions

View File

@ -4,6 +4,9 @@
`https://www.arduino.cc -> Software->Downloads`
it is strongly recommended to use older version `"1.6.8"`, by which we can assure correct compilation results
_note: in versions `1.7.x` and `1.8.x` there are known some C/C++ compilator disasters, which disallow correct source code compilation (you can obtain `"... internal compiler error: in extract_insn, at ..."` error message, for example); we are not able to affect this situation afraid_
_note: in the case of persistent compilation problems, check the version of the currently used C/C++ compiler (GCC) - should be `4.8.1`; version can be verified by entering the command
`avr-gcc --version`
if you are not sure where the file is placed (depends on how `"Arduino Software IDE"` was installed), you can use the search feature within the file system_
_note: name collision for `"LiquidCrystal"` library known from previous versions is now obsolete (so there is no need to delete or rename original file/-s)_
2. add (`UltiMachine`) `RAMBo` board into the list of Arduino target boards

53
README_cz.md Normal file
View File

@ -0,0 +1,53 @@
# 1. Příprava vývojového prostředí
1. nainstalujte vývojové prostředí `"Arduino Software IDE"` pro operační prostředí, které jste zvyklí používat
`https://www.arduino.cc -> Software->Downloads`
důrazně doporučujeme použít starší verzi `"1.6.8"`, u které jsme schopni garantovat bezproblémový překlad a správné výsledky
_pozn.: ve verzích `1.7.x` a `1.8.x` jsou k datu vydání tohoto dokumentu evidovány chyby v překladači jazyka C/C++, které znemožňují překlad zdrojového kódu (můžete např. obdržet chybové hlášení `"... internal compiler error: in extract_insn, at ..."`); tuto nepříjemnou situaci bohužel nedokážeme nijak ovlivnit_
_pozn.: v případě přetrvávajících potíží s překladem zkontrolujte verzi aktuálně použitého překladače jazyka C/C++ (GCC) - měla by být `4.8.1`; verzi ověříte zadáním příkazu
`avr-gcc --version`
pokud si nejste jisti umístěním souboru (závisí na způsobu, jakým bylo `"Arduino Software IDE"` nainstalováno), použijte funkci vyhledání v rámci systému souborů_
_pozn.: konflikt názvů knihoven / modulů `"LiquidCrystal"` známý v předchozích verzích již není aktuální (původní knihovnu tudíž není nutné mazat ani přejmenovat)_
2. do nabídky podporovaných cílových desek Arduino přidejte desku (`UltiMachine`) `RAMBo`
`File->Preferences->Settings`
do pole `"Additional Boards Manager URLs"`
vložte adresu / text
`"https://raw.githubusercontent.com/ultimachine/ArduinoAddons/master/package_ultimachine_index.json"`
ev. je možno 'ručně upravit' položku
`"boardsmanager.additional.urls=....."`
v souboru `"preferences.txt"` (parametr umožňuje zápis seznamu adres oddělených čárkami)
_pozn.: konkrétní umístění tohoto souboru na Vašem disku lze zjistit následujícím způsobem:
`File->Preferences->Settings` (`"More preferences can be edited in file ..."`)_
následně proveďte
`Tools->Board->BoardsManager`
ze zobrazeného seznamu vyberte položku `"RAMBo"` (pravděpodobně bude označena jako `"RepRap Arduino-compatible Mother Board (RAMBo) by UltiMachine"`
_pozn.: tuto položku zvolte pro všechny varianty desek použitých v tiskárnách `'Prusa i3 MKx'`, tzn. pro `RAMBo-mini x.y` i `EINSy x.y`_
'kliknutím' na položku se zobrazí tlačítko pro instalaci; ve výběrovém seznamu zvolte verzi `"1.0.1"` (poslední známá verze k datu vydání tohoto dokumentu)
_(po provedení instalace je položka označena poznámkou `"INSTALLED"` a lze ji následně použít při výběru cílové desky)_
# 2. Překlad zdrojoveho kódu
do zvoleného adresáře umístěte zdrojové kódy odpovídající modelu Vaší tiskárny získané z repozitáře
`https://github.com/prusa3d/Prusa-Firmware/`
v podadresáři `"Firmware/variants/"` vyberte konfigurační soubor (`.h`) odpovídající modelu Vaší tiskárny, vytvořte kopii s názvem `"Configuration_prusa.h"` (popř. proveďte prosté přejmenování) a překopírujte do adresáře `"Firmware/"`
spusťte vývojové prostředí `"Arduino IDE"`; v adresáři, kam jste umístili zdrojové kódy, vyberte z podadresáře `"Firmware/"` soubor `"Firmware.ino"`
`File->Open`
proveďte požadované úpravy kódu; **veškeré změny ovšem provádíte na svou vlastní odpovědnost!**
jako cílovou desku pro překlad vyberte `"RAMBo"`
`Tools->Board->RAMBo`
_pozn.: nelze použít žádnou z variant `"Arduino Mega …"`, přestože se jedná o shodný MCU_
spusťte překlad
`Sketch->Verify/Compile`
výsledný kód nahrajte do připojené tiskárny
`Sketch->Upload`
přeložený kód můžete také nechat uložit do souboru (v tzv. `HEX`-formátu) `"Firmware.ino.rambo.hex"`:
`Sketch->ExportCompiledBinary`
a do tiskárny ho následně nahrát pomocí programu `"FirmwareUpdater"`
_pozn.: soubor je vytvořen v adresáři `"Firmware/"`_