mirrors/keychron_qmk_firmware
mirrors/keychron_qmk_firmware
0
0
Fork 0
mirror of https://github.com/Keychron/qmk_firmware.git synced 2024-11-24 01:17:07 +06:00
Code Issues Packages Projects Releases Wiki Activity
8607859c77
keychron_qmk_firmware/keyboard/ergodox_ez
History
Aron Griffis 8607859c77 Add ergodox_ez keymap to match Kinesis Contoured. 
This keymap attempts to match the Kinesis Contoured (aka Advantage) default
layout as closely as possible. See
http://www.kinesis-ergo.com/wp-content/uploads/2013/06/advantage_layout_win.pdf

Apart from the obvious mappings, this keymap also:

* removes the dual-purpose momentary layer/normal keys: Z, /, and Grv;
  because the author--coming from a Kinesis keyboard--finds the delays and
  accidental modifiers to be more disconcerting than helpful.

* puts Esc in the bottom left since there's no place for it in the top
  left to match the Kinesis.

* changes the bottom-right key into an L2 toggle since there's otherwise no
  way to get to L2.

* adds PrScr, ScrLk and Pause to the L1 keymap, down the left side, since
  they're present on the Kinesis but not available in the default
  ergodox_ez keymap.
2016-01-09 13:17:25 -05:00
..
keymaps Add ergodox_ez keymap to match Kinesis Contoured. 2016-01-09 13:17:25 -05:00
config.h Fixes rolling combos for mod-tap keys 2015-10-28 04:19:13 +02:00
ergodox_ez.c Dave's custom keymap 2016-01-02 11:19:52 +00:00
ergodox_ez.h Dave's custom keymap 2016-01-02 11:19:52 +00:00
i2cmaster.h [Jack & Erez] Comments + tiny updates and cleanup 2015-10-27 00:54:46 +02:00
Makefile Enabled NKRO by default, drops irrelevant makefile options 2015-11-10 03:56:52 +02:00
matrix.c More work on ErgoDox EZ default keymap 2015-10-28 04:07:15 +02:00
README.md Fix homebrew references 2016-01-06 09:41:42 -06:00
reference_compiled_default_firmware.hex Adds Hyper key, tweaks ErgoDox EZ default keymap 2015-10-29 00:16:53 +02:00
twimaster.c [Jack & Erez] Comments + tiny updates and cleanup 2015-10-27 00:54:46 +02:00

README.md

Getting started

There are two main ways you could customize the ErgoDox EZ.

The Easy Way: Use an existing firmware file and just flash it

  1. Download and install the Teensy Loader
  2. Find a firmware file you like. You can find a few if these in the keymaps subdirectory right here. The file you need ends with .hex, and you can look at its .c counterpart (or its PNG image) to see what you'll be getting. You can also use the Massdrop configurator to create a firmware Hex file you like.
  3. Download the firmware file
  4. Connect the keyboard, press its Reset button (gently insert a paperclip into the hole in the top-right corner) and flash it using the Teensy loader you installed on step 1 and the firmware you downloaded.

More technical: create your own totally custom firmware by editing the source files.

This requires a little bit of familiarity with coding.

  1. Go to https://github.com/jackhumbert/qmk_firmware and read the Readme at the base of this repository, top to bottom. Then come back here :)
  2. Clone the repository (download it)
  3. Set up a build environment as per pjrc.com/teensy/gcc.html
    • Using a Mac and have homebrew? just run brew tap osx-cross/avr && brew install avr-libc
  4. Copy keymaps/keymap_default.c into keymaps/keymap_your_name.c (for example, keymaps/keymap_german.c)
  5. Edit this file, changing keycodes to your liking (see "Finding the keycodes you need" below). Try to edit the comments as well, so the "text graphics" represent your layout correctly.
  6. Compile your firmware by running make clean followed by make KEYMAP=your_name. Note that you must omit the keymap_ prefix for your filename in this command -- for example, make KEYMAP=german. This will result in a hex file, which will always be called ergodox_ez.hex, regardless of your keymap name.
  7. Flash this hex file using the Teensy loader as described in step 4 in the "Easy Way" above.
  8. Submit your work as a pull request to this repository, so others can also use it. :)

Good luck! :)

Finding the keycodes you need

Let's say you want a certain key in your layout to send a colon; to figure out what keycode to use to make it do that, you're going to need quantum/keymap_common.h.

That file contains a big list of all of the special, fancy keys (like, being able to shend % on its own and whatnot).

If you want to send a plain vanilla key, you can look up its code under doc/keycode.txt. That's where all the boring keys hang out.