From 319221ee235bf01674eb014a9dcb0a062acf48d3 Mon Sep 17 00:00:00 2001 From: Kevin O'Connor Date: Mon, 11 Dec 2017 17:28:59 -0500 Subject: docs: Provide additional information on "make flash" failures Add some additional information on "make flash" problems. Signed-off-by: Kevin O'Connor --- docs/FAQ.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) (limited to 'docs') diff --git a/docs/FAQ.md b/docs/FAQ.md index 6fb69b1e..76307d96 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -29,6 +29,29 @@ serial: /dev/serial/by-id/usb-UltiMachine__ultimachine.com__RAMBo_12345678912345 Be sure to copy-and-paste the name from the "ls" command above as the name will be different on each printer. +### The "make flash" command doesn't work. + +The code attempts to flash the device using the most common method for +each platform. Unfortunately, there is a lot of variance in flashing +methods, so the "make flash" command may not work on all boards. + +If you're having an intermittent failure or you do have a standard +setup, then double check that Klipper isn't running when flashing +(sudo service klipper stop), make sure Octoprint isn't trying to +connect directly to the device (open the Connection tab in the web +page and click Disconnect if the Serial Port is set to the device), +and make sure FLASH_DEVICE is set correctly for your board (see the +[question above](#when-i-restart-my-micro-controller-the-device-changes-to-devttyacm1)). + +However, if "make flash" just doesn't work for your board, then you +will need to manually flash. See if there is a config file in the +[config directory](../config) with specific instructions for flashing +the device. Also, check the board manufacturer's documentation to see +if it describes how to flash the device. Finally, on AVR devices, it +may be possible to manually flash the device using +[avrdude](http://www.nongnu.org/avrdude/) with custom command-line +parameters - see the avrdude documentation for further information. + ### Can I run Klipper on something other than a Raspberry Pi? Klipper only requires Python running on a Linux (or similar) -- cgit v1.2.3-70-g09d2