Merge branch 'master' of github.com:jackhumbert/qmk_firmware
commit
a226255c0b
|
@ -4,7 +4,7 @@ There are two main ways you could customize the ErgoDox EZ.
|
||||||
|
|
||||||
## The Easy Way: Use an existing firmware file and just flash it
|
## The Easy Way: Use an existing firmware file and just flash it
|
||||||
|
|
||||||
1. Download and install the [Teensy Loader](https://www.pjrc.com/teensy/loader.html)
|
1. Download and install the [Teensy Loader](https://www.pjrc.com/teensy/loader.html). Some Linux distributions already provide a binary (may be called `teensy-loader-cli`), so you may prefer to use this.
|
||||||
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](https://keyboard-configurator.massdrop.com/ext/ergodox) to create a firmware Hex file you like.
|
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](https://keyboard-configurator.massdrop.com/ext/ergodox) to create a firmware Hex file you like.
|
||||||
3. Download the firmware file
|
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.
|
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.
|
||||||
|
@ -20,7 +20,7 @@ This requires a little bit of familiarity with coding.
|
||||||
4. Copy `keyboard/ergodox_ez/keymaps/default/keymap.c` into `keymaps/your_name/keymap.c` (for example, `keymaps/german/keymap.c`)
|
4. Copy `keyboard/ergodox_ez/keymaps/default/keymap.c` into `keymaps/your_name/keymap.c` (for example, `keymaps/german/keymap.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. See below for more tips on sharing your work.
|
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. See below for more tips on sharing your work.
|
||||||
6. Compile your firmware by running `make clean` followed by `make KEYMAP=your_name`. 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.
|
6. Compile your firmware by running `make clean` followed by `make KEYMAP=your_name`. 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.
|
||||||
6. Flash this hex file using the [Teensy loader](https://www.pjrc.com/teensy/loader.html) as described in step 4 in the "Easy Way" above.
|
6. Flash this hex file using the [Teensy loader](https://www.pjrc.com/teensy/loader.html) as described in step 4 in the "Easy Way" above. If you prefer you can automatically flash the hex file after successfull build by running `make teensy KEYMAP=your_name`.
|
||||||
7. Submit your work as a pull request to this repository, so others can also use it. :) See below on specifics.
|
7. Submit your work as a pull request to this repository, so others can also use it. :) See below on specifics.
|
||||||
|
|
||||||
Good luck! :)
|
Good luck! :)
|
||||||
|
|
|
@ -317,7 +317,12 @@ REMOVE = rm -f
|
||||||
REMOVEDIR = rmdir
|
REMOVEDIR = rmdir
|
||||||
COPY = cp
|
COPY = cp
|
||||||
WINSHELL = cmd
|
WINSHELL = cmd
|
||||||
|
# Autodecct teensy loader
|
||||||
|
ifneq (, $(shell which teensy-loader-cli 2>/dev/null)))
|
||||||
|
TEENSY_LOADER_CLI = teensy-loader-cli
|
||||||
|
else
|
||||||
|
TEENSY_LOADER_CLI = teensy_loader_cli
|
||||||
|
endif
|
||||||
|
|
||||||
# Define Messages
|
# Define Messages
|
||||||
# English
|
# English
|
||||||
|
@ -425,7 +430,7 @@ program: $(TARGET).hex $(TARGET).eep
|
||||||
$(PROGRAM_CMD)
|
$(PROGRAM_CMD)
|
||||||
|
|
||||||
teensy: $(TARGET).hex
|
teensy: $(TARGET).hex
|
||||||
teensy_loader_cli -mmcu=$(MCU) -w -v $(TARGET).hex
|
$(TEENSY_LOADER_CLI) -mmcu=$(MCU) -w -v $(TARGET).hex
|
||||||
|
|
||||||
flip: $(TARGET).hex
|
flip: $(TARGET).hex
|
||||||
batchisp -hardware usb -device $(MCU) -operation erase f
|
batchisp -hardware usb -device $(MCU) -operation erase f
|
||||||
|
|
Loading…
Reference in New Issue