aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorkuchosauronad0 <22005492+kuchosauronad0@users.noreply.github.com>2019-10-21 20:05:33 -0700
committerfauxpark <fauxpark@gmail.com>2019-10-22 14:05:33 +1100
commit80ded60cad8d7ec8b46f5e3acd7948275ead5f2e (patch)
treedd9ad334cc0303ffc7ea1ac0442b29a3d3719f81
parentf033d8113d627c6950dc87936dfdb70e2b1ebf5f (diff)
downloadqmk_firmware-80ded60cad8d7ec8b46f5e3acd7948275ead5f2e.tar.gz
qmk_firmware-80ded60cad8d7ec8b46f5e3acd7948275ead5f2e.zip
Add a short explanation to Zadig the troubleshooting section (#7110)
* Add a short explanation to the troubleshooting section While translating I noticed that the troubleshooting section could use a little bit more explanation. @Yanfali was so kind to chime in on this on discord and explained that this was ment for people who accidently forget to put their board in bootloader mode, so I added this as a possible common mistake. Also fixed the spelling of Msys2 to MSYS2 and Halfkay to HalfKay as these are the official spellings they use themselves. * Update driver_installation_zadig.md * Update driver_installation_zadig.md English is hard. * Update docs/driver_installation_zadig.md Co-Authored-By: fauxpark <fauxpark@gmail.com> * Update docs/driver_installation_zadig.md Co-Authored-By: fauxpark <fauxpark@gmail.com>
-rw-r--r--docs/driver_installation_zadig.md8
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/driver_installation_zadig.md b/docs/driver_installation_zadig.md
index 71e4cc440..b04a6fbef 100644
--- a/docs/driver_installation_zadig.md
+++ b/docs/driver_installation_zadig.md
@@ -2,9 +2,9 @@
2 2
3QMK presents itself to the host as a regular HID keyboard device, and as such requires no special drivers. However, in order to flash your keyboard on Windows, the bootloader device that appears when you reset the board often *does*. 3QMK presents itself to the host as a regular HID keyboard device, and as such requires no special drivers. However, in order to flash your keyboard on Windows, the bootloader device that appears when you reset the board often *does*.
4 4
5There are two notable exceptions: the Caterina bootloader, usually seen on Pro Micros, and the Halfkay bootloader shipped with PJRC Teensys, appear as a serial port and a generic HID device respectively, and so do not require a driver. 5There are two notable exceptions: the Caterina bootloader, usually seen on Pro Micros, and the HalfKay bootloader shipped with PJRC Teensys, appear as a serial port and a generic HID device respectively, and so do not require a driver.
6 6
7We recommend the use of the [Zadig](https://zadig.akeo.ie/) utility. If you have set up the development environment with Msys2 or WSL, the `qmk_install.sh` script will have asked if you want it to install the drivers for you. 7We recommend the use of the [Zadig](https://zadig.akeo.ie/) utility. If you have set up the development environment with MSYS2 or WSL, the `qmk_install.sh` script will have asked if you want it to install the drivers for you.
8 8
9## Installation 9## Installation
10 10
@@ -31,7 +31,7 @@ Finally, unplug and replug the keyboard to make sure the new driver has been loa
31 31
32## Recovering from Installation to Wrong Device 32## Recovering from Installation to Wrong Device
33 33
34If you find that you can no longer type with the keyboard, you may have installed the driver onto the keyboard itself instead of the bootloader. You can easily confirm this in Zadig - a healthy keyboard has the `HidUsb` driver installed on all of its interfaces: 34If you find that you can no longer type with the keyboard, you may have accidentally replaced the driver for the keyboard itself instead of for the bootloader. This can happen when the keyboard is not in the bootloader mode. You can easily confirm this in Zadig - a healthy keyboard has the `HidUsb` driver installed on all of its interfaces:
35 35
36![A healthy keyboard as seen by Zadig](https://i.imgur.com/Hx0E5kC.png) 36![A healthy keyboard as seen by Zadig](https://i.imgur.com/Hx0E5kC.png)
37 37
@@ -44,3 +44,5 @@ Right-click it and hit **Uninstall device**. Make sure to tick **Delete the driv
44![The Device Uninstall dialog, with the "delete driver" checkbox ticked](https://i.imgur.com/aEs2RuA.png) 44![The Device Uninstall dialog, with the "delete driver" checkbox ticked](https://i.imgur.com/aEs2RuA.png)
45 45
46Click **Action → Scan for hardware changes**. At this point, you should be able to type again. Double check in Zadig that the keyboard device(s) are using the `HidUsb` driver. If so, you're all done, and your board should be functional again! 46Click **Action → Scan for hardware changes**. At this point, you should be able to type again. Double check in Zadig that the keyboard device(s) are using the `HidUsb` driver. If so, you're all done, and your board should be functional again!
47
48?> A full reboot of your computer may sometimes be necessary at this point, to get Windows to pick up the new driver.