Browse Source

build instructions update
Czech version added

MRprusa3d 6 years ago
parent
commit
b889d770a5
2 changed files with 56 additions and 0 deletions
  1. 3 0
      README.md
  2. 53 0
      README_cz.md

+ 3 - 0
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  

+ 53 - 0
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/"`_