Merge pull request #722 from MRprusa3d/MK3

build instructions update

Firmware/ultralcd.cpp

@@ -1586,7 +1586,7 @@ static void lcd_menu_extruder_info()
     if (lcd_clicked())
     {
         lcd_quick_feedback();
-        lcd_return_to_status();
+        menu_action_back();
     }
 }
 
@@ -1707,7 +1707,7 @@ static void lcd_menu_temperatures()
 	if (lcd_clicked())
     {
         lcd_quick_feedback();
-        lcd_return_to_status();
+        menu_action_back();
     }
 }
 
@@ -1725,7 +1725,7 @@ static void lcd_menu_voltages()
     if (lcd_clicked())
     {
         lcd_quick_feedback();
-        lcd_return_to_status();
+        menu_action_back();
     }
 }
 #endif //defined VOLT_BED_PIN || defined VOLT_PWR_PIN
@@ -1737,7 +1737,7 @@ static void lcd_menu_belt_status()
     if (lcd_clicked())
     {
         lcd_quick_feedback();
-        lcd_return_to_status();
+        menu_action_back();
     }
 }
 #endif //TMC2130
@@ -2161,7 +2161,7 @@ void lcd_menu_statistics()
 		if (lcd_clicked())
 		{
 			lcd_quick_feedback();
-			lcd_return_to_status();
+               menu_action_back();
 		}
 	}
 	else
@@ -2234,7 +2234,7 @@ void lcd_menu_statistics()
 		KEEPALIVE_STATE(NOT_BUSY);
 
 		lcd_quick_feedback();
-		lcd_return_to_status();
+          menu_action_back();
 	}
 }
 
@@ -3178,7 +3178,7 @@ static void lcd_show_end_stops() {
 
 static void menu_show_end_stops() {
     lcd_show_end_stops();
-    if (LCD_CLICKED) lcd_goto_menu(lcd_calibration_menu); //doesn't break menuStack
+    if (LCD_CLICKED) menu_action_back();
 }
 
 // Lets the user move the Z carriage up to the end stoppers.

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  

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