Updating Readme with more detailed instructions.

README.md

@@ -1,16 +1,25 @@
-##DaVinci FW based on Repetier (0.92)
+##Da Vinci Firmware based on Repetier (0.92)
 ============================
 
-This fw is based on repetier fw and modified to work with DaVinci 1.0, 2.0 single fan and 2.0.   
-###It does not support latest boards generation! Check you board first!  
-It works with host software like [repetier host](http://repetier.com), or as stand alone if you use a WIFI SD Card.    
+This firmware is based on the popular repetier firmware and modified to work with first generation Da Vinci 1.0, 2.0 single fan and 2.0.
 
-You can see more on [Voltivo forum](http://voltivo.com/forum/davinci-firmware).     
+***
+###WARNING! It does not currently support the latest board generations! Check you board first!
 
-Current firmware is based on version of  modified [repetier FW](https://github.com/repetier/Repetier-Firmware) 0.92 : [bgm370 Da Vinci 1.0 FW](https://github.com/bgm370/Repetier-Firmware)    
+The board can be easily exposed by removing the back panel of the printer secured by two torx screws.  Supported boards have a jumper labeled JP1.  Unsupported second generation boards have a jumper labeled J37. More info can be found on the [Voltivo forum](http://voltivo.com/forum/davinci-peersupport/340-new-kind-of-mainboard-no-j1-erase-jumper).
+***
+
+Here are just a few of the benifits of using this firmware:
+
+* It works with host software such as [repetier host](http://repetier.com) and [OctoPrint](http://octoprint.org/) giving you full control of your hardware.
+* It works stand alone if you use a WIFI SD Card. 
+* It allows the use of clear ABS (by disabling optical sensors), as well as other arbitrary filament brands/types as temperatures can be controlled freely and there is no requirement for chiped cartridges. 
+
+You can find more info on the [Voltivo forum](http://voltivo.com/forum/davinci-firmware).     
+
+The current firmware is based on [repetier Firmware](https://github.com/repetier/Repetier-Firmware) 0.92 : [bgm370 Da Vinci 1.0 FW](https://github.com/bgm370/Repetier-Firmware)    
 Sources are [here](https://github.com/luc-github/Repetier-Firmware-0.92)   
 The previous version (based on repetier v0.91) can be found [here](https://github.com/luc-github/Repetier-Firmware)   
-It gets rid off Da Vinci software and filament restrictions: it allows to use clear ABS because it allows to disable sensors, as well as others brand name filaments because it does not use cartridge chip, it allows any slicer or third-party host software usage in normal way.  
 
 ***
 ##Current Status
@@ -18,26 +27,35 @@ It gets rid off Da Vinci software and filament restrictions: it allows to use cl
 
 ***
 ##Installation
-Use arduino IDE supporting arduino DUE, [version 1.5.8+](http://arduino.cc/en/Main/Software#toc3)    
-Update arduino sources files (variants.cpp and USBcore.cpp) with the ones prensent in src\ArduinoDUE\AdditionalArduinoFiles\1.5.8    
-The project file is the repetier.ino located in src\ArduinoDUE\Repetier directory.    
-For upgrade from stock FW and revert to, please check DaVinci forum.    
+1. With the machine off remove the back panel and short the jumper JP1.  Some Boards do not have jumper pins exposed but can still be shorted with a conductive wire.
+2. Turn the machine on and wait a few seconds then turn it off again.  The machine will have been flashed removing the current stock firmware and allowing it to be detected as a normal arduino DUE. NOTE: Windows users may need to install drivers to detect the board.  Consult the Voltivo forums.
+3. Use an arduino IDE supporting arduino DUE, [version 1.5.8+](http://arduino.cc/en/Main/Software#toc3)    
+4. Update arduino files (variants.cpp and USBcore.cpp) with the ones prensent in src\ArduinoDUE\AdditionalArduinoFiles\1.5.8.  NOTE: You do not need to compile arduino from source these files are in the arduino directory structure.  On Mac you will need to right click on the Arduino.app to Show Package Contents.    
+5. Open the project file named repetier.ino located in src\ArduinoDUE\Repetier directory in the arduino IDE. 
+6. Modify the DAVINCI define in Configuration.h file to match your targeted Da Vinci.  See below.
+7. Under the tools menu select the board type as Arduino DUE (Native USB Port) and the proper port you have connected to the printer.  NOTE: You can usually find this out by looking at the tools -> port menu both before and after plugging in the printer to your computer's USB.
+8. Press the usual arduino compile and upload button.
+If done correctly you will see the arduino sketch compile successfully and output in the log showing the upload status.
+9. Once flash is done <B>do not forget to send G-Code M502 then M500 </B>from repetier's Print Panel tab <B>or from the printer menu "Settings/Load Fail-Safe"</B> and accept to save the new eeprom settings. 
+10. When update is complete <B>you must calibrate your bed height!</B>  
+You can do so by homeing all axis, turning off the printer and manually adjusting the bed leveling screws until the glass bed is just under the nozzle at each end of the bed.  While the printer is powered off you can move the print head by hand and slide a piece of paper over the glass bed and under the nozzle with a slight pull on the paper from the nozzle.
+11. Next you can calibrate your filament as usual.
 
-Do not forget to modify the configuration.h to match the targeted Da Vinci: 1.0, 2.0 SF or 2.0.   
+For information on upgrading from or reverting to stock FW and other procedures please check [Da Vinci Voltivo forum](http://voltivo.com/forum/davinci).    
+
+Do not forget to modify the configuration.h to match your targeted Da Vinci: 1.0, 2.0 SF or 2.0.   
 for basic installation just change :   
-'#define DAVINCI 1 // "1" For DAVINCI 1.0, "2" For DAVINCI 2.0 with 1 FAN, "3" For DAVINCI 2.0 with 2 FANS</code>'    
+'<code>#define DAVINCI 1 // "1" For DAVINCI 1.0, "2" For DAVINCI 2.0 with 1 FAN, "3" For DAVINCI 2.0 with 2 FANS</code>'    
 
   1 for DaVinci 1.0 (1Fan, 1 Extruder)   
   2 for DaVinci 2.0 SF (1Fan, 2 Extruders)   
   3 for DaVinci 2.0  (2Fans, 2 Extruders)   
 
-For some board having slow response time heatbed sensor that generated a defect temperature :   
-Set WARMUP_BED_ON_INIT to 1, it will preheat bed if it is necessary to increase sensor response time when starting printer if defect is detected, if it is real sensor issue - it will stop after 10 seconds and generate temperature defect error.   
+For some boards that have a heatbed sensor with a slow response time and generate a defect temperature :   
+Set WARMUP_BED_ON_INIT to 1, it will preheat bed if it is necessary to increase sensor response time when starting printer if a defect is detected, if it is a real sensor issue - it will stop after 10 seconds and generate a temperature defect error.   
 
-To repurpose the main Extruder cooling fan to be controlled VIA M106/M107:   
-Set REPURPOSE_FAN_TO_COOL_EXTRUSIONS to 1, do not for get to add a fan with power source to cool extruder permanently if you use this option.   
-
-Once flash is done <B>do not forget to use M502 then M500 </B>from repetier <B>or got select printer menu "Settings/Load Fail-Safe"</B> and accept to save in eeprom to have correct eeprom settings.   
+To repurpose the main Extruder cooling fan to be controlled VIA G-Code instructions M106/M107:   
+Set REPURPOSE_FAN_TO_COOL_EXTRUSIONS to 1, do not forget to add a fan with power source to cool extruder permanently if you use this option.     
 
 ***
 ##TODO