bitclock parameter for programmers, speedier uploads

app/src/processing/app/debug/AvrdudeUploader.java

@@ -104,6 +104,10 @@ private Collection getProgrammerCommands(Target target, String programmer) {
     Map<String, String> programmerPreferences = target.getProgrammers().get(programmer);
     List params = new ArrayList();
     params.add("-c" + programmerPreferences.get("protocol"));
+
+    if (programmerPreferences.get("bitclock") != null) {
+      params.add("-B" + Integer.parseInt(programmerPreferences.get("bitclock")));
+    }
 
     if ("usb".equals(programmerPreferences.get("communication"))) {
       params.add("-Pusb");

build/shared/examples/ArduinoISP/ArduinoISP.pde

@@ -5,6 +5,22 @@
 // 12: MISO
 // 13: SCK
 
+//
+// target boards with an ICSP connector:
+//
+// -----------
+// - 5  3  1 -
+// - 6  4  2 -
+// -----------
+//
+// 1: MOSI
+// 2: +5V
+// 3: SCK
+// 4: MISO
+// 5: RESET
+// 6: GND
+//
+
 // Put an LED (with resistor) on the following pins:
 // 9: Heartbeat - shows the programmer is running
 // 8: Error - Lights up if something goes wrong (use red if that makes sense)

hardware/arduino/boards.txt.readme

@@ -0,0 +1,12 @@
+#
+# There really should be proper documentation for 'boards.txt'
+# Currently finding the required information is unnecessarily painful.
+#
+# Available options + real-life examples
+#
+#
+# useful links:
+# -------------
+#
+# online fuse calculator: "http://www.engbedded.com/fusecalc"
+#