qmk_firmware/keyboards/durgod/k320/readme.md
Donald Kjer 88ca4ec2cb
Add support for the DURGOD Taurus K320 keyboard (#11399)
* Initial support for Durgod K320 with BootMagic Lite

- Adding missing files
- Add Unicode Map Support & new user keymap
- Remove personalized features from Default keymap
- Added Unicode Map to both Default and kuenhlee keymap.c
- Updated readme.md
- Added additional Fn Shortcut keys

* Additional support for Durgod K320

- Simplifying default keymap
- Renaming durgod_k320 => durgod/k320
- Removing copy of ST_NUCLEO64_F070RB from K320. Replacing with local board.h
- Adding Mac keyboard layout for K320 as alternative via Fn+F12
- Implementing Windows Key lock on K320
- Cleaning up duplicated core functionality
- Adding default_toggle_mac_windows keymap with:
  - Ability to toggle between Windows and MacOS layout
  - Mac Media Lock functionality.

* Updating K320 keymap readme

Co-authored-by: kuenhlee <eos.camera.lee@gmail.com>
2021-01-26 04:30:17 +11:00

60 lines
2.1 KiB
Markdown

# K320
This is a standard fixed ANSI TKL from off the shelf Durgod Taurus K320 without Backlight.
* Keyboard Maintainer: [dkjer](https://github.com/dkjer)
* Hardware Supported: Durgod Taurus K320 board with STM32F070RBT6
* Hardware Availability: https://www.durgod.com/page9?product_id=47&_l=en
## Instructions
### Build
Make command example for this keyboard (after setting up your build environment):
make durgod/k320:default
Flashing example for this keyboard:
make durgod/k320:default:flash
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
### Initial Flash
For first Flashing from initial Stock's Firmware
1. Back up original Firmware Image:
- Unplug
- Short Boot0 to Vdd (See below)
- Plug In USB
- Make a Flash Image's Backup in case you wanted to restore the Keyboard to Stock's Image:
- Using DFUseDemo.exe from ST's STSW-STM32080: https://www.st.com/en/development-tools/stsw-stm32080.html
- Using dfu-util (thanks to [tylert](https://github.com/tylert) for instructions!):
dfu-util --list
dfu-util --alt 0 --dfuse-address 0x08000000 --upload ${OLD_STOCK_BIN}
2. Flash the QMK Firmware Image.
- Put board into Bootloader mode, using the same method as when backing up the original Firmware (above)
- Here are a few options for performing the initial Flash:
- Using [QMK Toolbox](https://github.com/qmk/qmk_toolbox)
- Using DFuseDemo.exe if STTub30 driver is used.
- Using dfu-util:
dfu-util --alt 0 --dfuse-address 0x08000000 --upload ${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">
### Subsequent Flashing
For repeating Flashing you can use BootMagic:
- BootMagic Lite has been enabled with Assigned "Esc" key
- Unplug USB Cable
- Holding Esc Button
- Plug in USB Cable, Keyboard should be in ST-Bootloader state