QMK Configurator Tutorial
QMK is open source software for configurating keyboards. It is one of the most powerful firmware to program the keys. And is the most popular tool in Do It Yourself keyboards.
Here's how to use the QMK Configurator to create your keyboard keymap and layouts.
We'll use the gergo keyboard as example.
![gmk configurator gergo 2020-06-23 p9z28](ilayout/gmk_configurator_gergo_2020-06-23_p9z28.png)
Goto the site https://config.qmk.fm/#/gergo/LAYOUT_gergo
WARNING: be sure the keyboard selection is gergo keyboard. If you clicked the link, the gergo keyboard will be selected.
Drag and drop keys to how you like it.
Press the Compile button. Takes about 1 minute.
When done, click Firmware to download it. You'll get a “.hex” file.
![qmk hex file 2020-06-13 ttvzh](imisc/qmk_hex_file_2020-06-13_ttvzh.png)
Download the qmk toolbox at https://github.com/qmk/qmk_toolbox/releases Open it.
![qmk toolbox 2020-06-13 5mncw](imisc/qmk_toolbox_2020-06-13_5mncw.png)
On Mac, if system says cannot open it for security reasons, goto your system preference, click the “Security and Privacy”, General tab, click Allow.
Unplug the Gergo keyboard. Now, hold the key on the lower right of the right keyboard (normally the Right shift position on traditional keyboard). Then plug Gergo in to computer. This will set the keyboard to Device Firmware Upgrade mode. You'll see the toolbox display “*** DFU device connected”.
In toolbox app, in the “Local file” popup, select the .hex file you just downloaded. Click “Flash” button to update the firmware in keyboard. You are done.
“no device present” error
On Microsoft Windows, you may get
dfu-programmer: no device present.
in qmk toolbox.
![qmk toolbox no device present 2020-06-23 sp3pv](ilayout/qmk_toolbox_no_device_present_2020-06-23_sp3pv.png)
here's what to do. Basically, you need to install the driver for the bootloader.
Here's the doc:
https://docs.qmk.fm/#/driver_installation_zadig?id=bootloader-driver-installation-with-zadig
Go download zadig. Install it. Open it.
Unplug the gergo.
plug in the gergo while holding the right side lower right key down.
The zadig should show:
![zadig ATm32U4DFU 2020-06-23 464f8](ilayout/zadig_ATm32U4DFU_2020-06-23_464f8.png)
Now, select “libusb-win32” on where the green arrow points to.
then click insall driver.
Now, back in qmk toolbox. Now, unplug gergo and replug in the gergo while holding the right side lower right key down.
you'll see the proper driver message:
DFU device connected: Atml Corp. ATm32U4DFU (03EB:2FF4:0000)
![qmk toolbox ATm32U4DFU 2020-06-23 bhxs9](ilayout/qmk_toolbox_ATm32U4DFU_2020-06-23_bhxs9.png)
Now, go ahead and click Flash.