summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLucas Hecht <Lucas Hecht>2016-02-27 01:26:54 +0100
committerLucas Hecht <Lucas Hecht>2016-02-27 01:26:54 +0100
commitbcf847e58a10b66cff3161dd3503bc839c9745f0 (patch)
tree957d49403605529f8308a5d0059ce471b67cd025
parent74761626f56476036246768f490a1389d4cc2fca (diff)
downloadqmk_firmware-bcf847e58a10b66cff3161dd3503bc839c9745f0.tar.gz
qmk_firmware-bcf847e58a10b66cff3161dd3503bc839c9745f0.tar.xz
added "Troubleshooting" section to PCB guide
-rw-r--r--keyboard/planck/PCB_GUIDE.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/keyboard/planck/PCB_GUIDE.md b/keyboard/planck/PCB_GUIDE.md
index 3daf0e009..e676c4428 100644
--- a/keyboard/planck/PCB_GUIDE.md
+++ b/keyboard/planck/PCB_GUIDE.md
@@ -8,6 +8,7 @@
2. Install [DFU-Programmer][dfu-prog] (the -win one).
3. Start DFU bootloader on the chip first time you will see 'Found New Hardware Wizard' to install driver. If you install device driver properly you can find chip name like 'ATmega32U4' under 'LibUSB-Win32 Devices' tree on 'Device Manager'. If not you will need to update its driver on 'Device Manager' to the `dfu-programmer` driver.
+
### Mac
If you're using homebrew, you can use the following commands:
@@ -52,6 +53,27 @@ Generally, the instructions to flash the PCB are as follows:
4. Press the reset button on the PCB/press the key with the `RESET` keycode
5. `make <arguments> dfu` - use the necessary `KEYMAP=<keymap>` and/or `COMMON=true` arguments here.
+### Troubleshooting
+If you see something like this
+
+ 0 [main] sh 13384 sync_with_child: child 9716(0x178) died before initialization with status code 0xC0000142
+ 440 [main] sh 13384 sync_with_child: *** child state waiting for longjmp
+ /usr/bin/sh: fork: Resource temporarily unavailable
+
+after running 'make' on Windows than you are encountering a very popular issue with WinAVR on Windows 8.1 and 10.
+You can easily fix this problem by replacing msys-1.0.dll in WinAVR/utils/bin with [this one](http://www.madwizard.org/download/electronics/msys-1.0-vista64.zip).
+Restart your system and everything should work fine!
+
+If you see this
+
+ dfu-programmer atmega32u4 erase
+ process_begin: CreateProcess(NULL, dfu-programmer atmega32u4 erase, ...) failed.
+ make (e=2): The system cannot find the file specified.
+ make: *** [dfu] Error 2
+
+when trying to 'make dfu' on Windows you need to copy the dfu-programmer.exe to qmk_firmware/keyboard/planck.
+
+
## Quantum MK Firmware
### Keymap