docs: Provide additional information on "make flash" failures

Add some additional information on "make flash" problems.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>

1 files changed, 23 insertions, 0 deletions

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)