[Keyboard] Improve the durgot k3x0 readme.md (#17214)
This commit is contained in:
parent
2f8704143e
commit
9316023290
|
@ -18,34 +18,62 @@ Instructions for building the K310 and K320 firmware can be found here:
|
||||||
|
|
||||||
### Initial Flash
|
### Initial Flash
|
||||||
|
|
||||||
For first Flashing from initial Stock Firmware
|
#### Requirements
|
||||||
|
|
||||||
1. Back up original Firmware Image:
|
- 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.
|
||||||
- Unplug
|
- 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).
|
||||||
- Short Boot0 to Vdd (See below)
|
- 2 prying tools - to open the keyboard.
|
||||||
- Plug In USB
|
- Another helping hand - it can be also done with just two hands, but it will require a lot of dexterity.
|
||||||
- Make a Flash Image's Backup in case you wanted to restore the Keyboard to Stock's Image:
|
- A small cable with both ends cut.
|
||||||
- Using dfu-util:
|
|
||||||
|
|
||||||
dfu-util --list
|
#### Enter bootloader while using the original firmware
|
||||||
dfu-util --alt 0 --dfuse-address 0x08000000 --upload ${OLD_STOCK_BIN}
|
|
||||||
|
|
||||||
2. Flash the QMK Firmware Image.
|
1. Unplug USB cable.
|
||||||
- Put board into Bootloader mode, using the same method as when backing up the original Firmware (above)
|
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.
|
||||||
- Here are a few options for performing the initial Flash:
|
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).
|
||||||
- Using [QMK Toolbox](https://github.com/qmk/qmk_toolbox)
|
4. Use the cable to short Boot0 to Vdd, by shorting R21 to C27 on the sides closest to the processor, as shown:
|
||||||
- Using dfu-util:
|
|
||||||
|
|
||||||
dfu-util --alt 0 --dfuse-address 0x08000000 --download ${NEW_QMK_BIN}
|
|
||||||
|
|
||||||
You can short Boot0 to Vdd by shorting R21 to C27 on the sides closest to the processor, as shown:
|
|
||||||
|
|
||||||
<img src="https://i.imgur.com/hvDnw5a.jpg" width="520" height="693" alt="Shorting Boot0 to Vdd on K320">
|
<img src="https://i.imgur.com/hvDnw5a.jpg" width="520" height="693" alt="Shorting Boot0 to Vdd on K320">
|
||||||
|
|
||||||
|
5. While shorting both contacts as instructed in step 4, plug in the USB cable.
|
||||||
|
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:
|
||||||
|
- Using dfu-util, it should show something like "Found DFU…" after using this command:
|
||||||
|
```
|
||||||
|
dfu-util --list
|
||||||
|
```
|
||||||
|
|
||||||
|
Now that you are sure to be in bootloader mode, you can backup the original firmware and flash QMK Firmware.
|
||||||
|
|
||||||
|
If it does not behave like described, remove the cable and go back to step 4.
|
||||||
|
|
||||||
|
#### Backup original firmware
|
||||||
|
|
||||||
|
1. Be in Bootloader mode.
|
||||||
|
2. Execute this command to backup:
|
||||||
|
- Using dfu-util:
|
||||||
|
```bash
|
||||||
|
dfu-util -a 0 -d 0483:DF11 -s 0x08000000 -U k3x0_original.bin
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Flash the QMK Firmware Image
|
||||||
|
|
||||||
|
1. Be in Bootloader mode.
|
||||||
|
2. Here are a few options for performing the initial Flash:
|
||||||
|
- Using [QMK Toolbox](https://github.com/qmk/qmk_toolbox)
|
||||||
|
- Using qmk on command line:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# k310
|
||||||
|
qmk flash -kb durgod/k3x0/k310 -km default
|
||||||
|
|
||||||
|
# k320
|
||||||
|
qmk flash -kb durgod/k3x0/k320 -km default
|
||||||
|
```
|
||||||
|
|
||||||
### Subsequent Flashing
|
### Subsequent Flashing
|
||||||
|
|
||||||
For repeating Flashing you can use BootMagic:
|
For repeating Flashing you can use BootMagic Lite has been enabled by default and assigned to the "Esc" key:
|
||||||
- BootMagic Lite has been enabled with Assigned "Esc" key
|
|
||||||
- Unplug USB Cable
|
1. Unplug USB Cable.
|
||||||
- Holding Esc Button
|
2. Hold the "Esc" key.
|
||||||
- Plug in USB Cable, Keyboard should be in ST-Bootloader state
|
2. Plug in the USB Cable, the Keyboard should be in ST-Bootloader state.
|
||||||
|
|
Loading…
Reference in a new issue