less than 1 minute read

QMK Setup Guide (Window 10)

  1. Connect Keyboard to the computer.

  2. Download and install qmk_toolbox

    • link: https://github.com/qmk/qmk_toolbox/releases

      qmk_toolbox

    • You can see โ€˜HID console connected: โ€ฆโ€™.

  3. Download and Install QMK MSYS

    • link: https://github.com/qmk/qmk_distro_msys/releases
    • https://docs.qmk.fm/#/newbs_getting_started

      qmk_msys

    • Run โ€˜qmk setupโ€™ and select โ€˜yโ€™.

      install_qmk_firmware

  4. Clone and edit firmware

    • https://github.com/qmk/qmk_firmware
  5. Test Your Build Environment

    qmk compile -kb <keyboard> -km default
    

    compile

    • You can find the .hex file on qmk_firmware directory.
  6. Flash your setting using toolbox

    • Open the hex file

      open

    • Double click the reset button on your keyboard or receiver

      reset

    • flash

      done

** toolbox๋กœ ์‹คํ–‰ํ–ˆ์„ ๋•Œ port ์ž…๋ ฅ์— ๋Œ€ํ•œ ์˜ค๋ฅ˜๊ฐ€ ๋‚œ๋‹ค.

  • ๊ทธ๋Ÿฌ๋ฉด avrdude.exe๊ฐ€ ์žˆ๋Š” ํด๋”(~/AppData/Local/QMK/QMK Toolbox/0.1.1)์—์„œ ๋ช…๋ น์–ด๋ฅผ ์ ๊ณ  USB๊ฐ€ ๊ผฝํžŒ port๋ฅผ ์ ์–ด์ฃผ๊ณ (like COM9) ์‹คํ–‰ํ•˜๋ฉด ๋œ๋‹ค.
  • ์žฅ์น˜ ๊ด€๋ฆฌ์ž์— โ€œํฌํŠธ(COM & LPT)โ€๋ผ๋Š” ํŠธ๋ฆฌ์—์„œ ํ•ด๋‹น ํฌํŠธ๊ฐ€ ๋ฌด์—‡์ธ์ง€ ํ™•์ธํ•˜๊ณ  ์ƒ์„ฑ๋˜๋ฉด ์‚ฌ๋ผ์ง€๊ธฐ ์ „์— ์ฆ‰์‹œ ์‹คํ–‰์‹œํ‚จ๋‹ค.