diff options
Diffstat (limited to 'keyboard/planck/PCB_GUIDE.md')
| -rw-r--r-- | keyboard/planck/PCB_GUIDE.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/keyboard/planck/PCB_GUIDE.md b/keyboard/planck/PCB_GUIDE.md index 797cee2e1..b36d8fb64 100644 --- a/keyboard/planck/PCB_GUIDE.md +++ b/keyboard/planck/PCB_GUIDE.md | |||
| @@ -9,6 +9,7 @@ | |||
| 9 | 4. Right-click on the 1-setup-path-win batch script, select "Run as administrator", and accept the User Account Control prompt. Press the spacebar to dismiss the success message in the command prompt that pops up. | 9 | 4. Right-click on the 1-setup-path-win batch script, select "Run as administrator", and accept the User Account Control prompt. Press the spacebar to dismiss the success message in the command prompt that pops up. |
| 10 | 5. Right-click on the 2-setup-environment-win batch script, select "Run as administrator", and accept the User Account Control prompt. This part may take a couple of minutes, and you'll need to approve a driver installation, but once it finishes, your environment is complete! | 10 | 5. Right-click on the 2-setup-environment-win batch script, select "Run as administrator", and accept the User Account Control prompt. This part may take a couple of minutes, and you'll need to approve a driver installation, but once it finishes, your environment is complete! |
| 11 | 11 | ||
| 12 | |||
| 12 | ### Mac | 13 | ### Mac |
| 13 | 14 | ||
| 14 | If you're using homebrew, you can use the following commands: | 15 | If you're using homebrew, you can use the following commands: |
| @@ -53,6 +54,28 @@ Generally, the instructions to flash the PCB are as follows: | |||
| 53 | 4. Press the reset button on the PCB/press the key with the `RESET` keycode | 54 | 4. Press the reset button on the PCB/press the key with the `RESET` keycode |
| 54 | 5. `make <arguments> dfu` - use the necessary `KEYMAP=<keymap>` and/or `COMMON=true` arguments here. | 55 | 5. `make <arguments> dfu` - use the necessary `KEYMAP=<keymap>` and/or `COMMON=true` arguments here. |
| 55 | 56 | ||
| 57 | ## Troubleshooting | ||
| 58 | If you see something like this | ||
| 59 | |||
| 60 | 0 [main] sh 13384 sync_with_child: child 9716(0x178) died before initialization with status code 0xC0000142 | ||
| 61 | 440 [main] sh 13384 sync_with_child: *** child state waiting for longjmp | ||
| 62 | /usr/bin/sh: fork: Resource temporarily unavailable | ||
| 63 | |||
| 64 | after running 'make' on Windows than you are encountering a very popular issue with WinAVR on Windows 8.1 and 10. | ||
| 65 | 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). | ||
| 66 | Restart your system and everything should work fine! | ||
| 67 | |||
| 68 | |||
| 69 | If you see this | ||
| 70 | |||
| 71 | dfu-programmer atmega32u4 erase | ||
| 72 | process_begin: CreateProcess(NULL, dfu-programmer atmega32u4 erase, ...) failed. | ||
| 73 | make (e=2): The system cannot find the file specified. | ||
| 74 | make: *** [dfu] Error 2 | ||
| 75 | |||
| 76 | when trying to 'make dfu' on Windows you need to copy the dfu-programmer.exe to qmk_firmware/keyboard/planck. | ||
| 77 | |||
| 78 | |||
| 56 | ## Quantum MK Firmware | 79 | ## Quantum MK Firmware |
| 57 | 80 | ||
| 58 | ### Keymap | 81 | ### Keymap |
