readme.md (3335B)
1 # K3X0 = K310, K320, etc. 2 3 This K3X0 code is shared between both the ANSI and ISO variants of both the 4 K310 full-sized 104/105-key and K320 TKL 87/88-key keyboards. 5 6 * Keyboard Maintainers: [dkjer](https://github.com/dkjer) and [tylert](https://github.com/tylert) 7 * Hardware Supported: 8 * [Durgod Taurus K310 with STM32F070RBT6](https://www.durgod.com/product/k310-space-gray/) 9 * [Durgod Taurus K320 with STM32F070RBT6](https://www.durgod.com/product/k320-space-gray/) 10 * Hardware Availability: 11 * [K310 on Amazon.com](https://www.amazon.com/Durgod-Taurus-K310-Mechanical-Keyboard/dp/B07TXB4XF3) 12 * [K320 on Amazon.com](https://www.amazon.com/Durgod-Taurus-Corona-Mechanical-Keyboard/dp/B078H3WPHM) 13 14 ## Instructions 15 16 ### Build 17 18 Instructions for building the K310 and K320 firmware can be found here: 19 * [K310](../k310/readme.md) 20 * [K320](../k320/readme.md) 21 22 ### Initial Flash 23 24 #### Requirements 25 26 - The Durgod K320/K310 - different batches have different controllers, so when opening the keyboard, you will have to make sure it's using SMT32 controller. 27 - Another keyboard - when on bootloader mode, you can't use the keyboard to type and execute the commands (not really required if you can use any mouse interface to type and execute the commands). 28 - 2 prying tools - to open the keyboard. 29 - Another helping hand - it can be also done with just two hands, but it will require a lot of dexterity. 30 - A small cable with both ends cut. 31 32 #### Enter bootloader while using the original firmware 33 34 1. Unplug USB cable. 35 2. Open the keyboard case - there are plenty of youtube videos in that, but you will basically need 2 prying tools and a certain amount of force. 36 3. After opening the keyboard, put the PCB upsides down, and the controller should be near the LEDs, and make sure it's using the right controller (SMT32). 37 4. Use the cable to short Boot0 to Vdd, by shorting R21 to C27 on the sides closest to the processor, as shown: 38 39 <img src="https://i.imgur.com/hvDnw5a.jpg" width="520" height="693" alt="Shorting Boot0 to Vdd on K320"> 40 41 5. While shorting both contacts as instructed in step 4, plug in the USB cable. 42 6. When the USB cable is fully inserted, the LEDs should not turn on and the keyboard it's not able to type, you are probably on bootloader mode, to be sure: 43 - Using dfu-util, it should show something like "Found DFU…" after using this command: 44 ``` 45 dfu-util --list 46 ``` 47 48 Now that you are sure to be in bootloader mode, you can backup the original firmware and flash QMK Firmware. 49 50 If it does not behave like described, remove the cable and go back to step 4. 51 52 #### Backup original firmware 53 54 1. Be in Bootloader mode. 55 2. Execute this command to backup: 56 - Using dfu-util: 57 ```bash 58 dfu-util -a 0 -d 0483:DF11 -s 0x08000000 -U k3x0_original.bin 59 ``` 60 61 #### Flash the QMK Firmware Image 62 63 1. Be in Bootloader mode. 64 2. Here are a few options for performing the initial Flash: 65 - Using [QMK Toolbox](https://github.com/qmk/qmk_toolbox) 66 - Using qmk on command line: 67 68 ```bash 69 # k310 70 qmk flash -kb durgod/k310 -km default 71 72 # k320 73 qmk flash -kb durgod/k320 -km default 74 ``` 75 76 ### Subsequent Flashing 77 78 For repeating Flashing you can use BootMagic Lite has been enabled by default and assigned to the "Esc" key: 79 80 1. Unplug USB Cable. 81 2. Hold the "Esc" key. 82 2. Plug in the USB Cable, the Keyboard should be in ST-Bootloader state.