From b889d770a588a30e491a955e996c7ea4bc227fe0 Mon Sep 17 00:00:00 2001 From: MRprusa3d Date: Tue, 8 May 2018 23:10:07 +0200 Subject: [PATCH] build instructions update Czech version added --- README.md | 3 +++ README_cz.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+) create mode 100644 README_cz.md diff --git a/README.md b/README.md index 0e2dea39..104a19c2 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/README_cz.md b/README_cz.md new file mode 100644 index 00000000..5c649963 --- /dev/null +++ b/README_cz.md @@ -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/"`_