aboutsummaryrefslogtreecommitdiff
path: root/keyboard/planck
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 /keyboard/planck
parent74761626f56476036246768f490a1389d4cc2fca (diff)
downloadqmk_firmware-bcf847e58a10b66cff3161dd3503bc839c9745f0.tar.gz
qmk_firmware-bcf847e58a10b66cff3161dd3503bc839c9745f0.zip
added "Troubleshooting" section to PCB guide
Diffstat (limited to 'keyboard/planck')
-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 @@
82. Install [DFU-Programmer][dfu-prog] (the -win one). 82. Install [DFU-Programmer][dfu-prog] (the -win one).
93. 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. 93. 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.
10 10
11
11### Mac 12### Mac
12 13
13If you're using homebrew, you can use the following commands: 14If you're using homebrew, you can use the following commands:
@@ -52,6 +53,27 @@ Generally, the instructions to flash the PCB are as follows:
524. Press the reset button on the PCB/press the key with the `RESET` keycode 534. Press the reset button on the PCB/press the key with the `RESET` keycode
535. `make <arguments> dfu` - use the necessary `KEYMAP=<keymap>` and/or `COMMON=true` arguments here. 545. `make <arguments> dfu` - use the necessary `KEYMAP=<keymap>` and/or `COMMON=true` arguments here.
54 55
56### Troubleshooting
57If you see something like this
58
59 0 [main] sh 13384 sync_with_child: child 9716(0x178) died before initialization with status code 0xC0000142
60 440 [main] sh 13384 sync_with_child: *** child state waiting for longjmp
61 /usr/bin/sh: fork: Resource temporarily unavailable
62
63after running 'make' on Windows than you are encountering a very popular issue with WinAVR on Windows 8.1 and 10.
64You 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).
65Restart your system and everything should work fine!
66
67If you see this
68
69 dfu-programmer atmega32u4 erase
70 process_begin: CreateProcess(NULL, dfu-programmer atmega32u4 erase, ...) failed.
71 make (e=2): The system cannot find the file specified.
72 make: *** [dfu] Error 2
73
74when trying to 'make dfu' on Windows you need to copy the dfu-programmer.exe to qmk_firmware/keyboard/planck.
75
76
55## Quantum MK Firmware 77## Quantum MK Firmware
56 78
57### Keymap 79### Keymap