keyboards/gherkin/keymaps/wanleg/readme.md

   1 ![Gherkin Wanleg Layout Image](https://i.imgur.com/mXsgoro.png)
   2
   3 # Gherkin Wanleg Layout
   4 Here is the layout I came up with to preserve a standard QWERTY layout as much as possible, in as few layers as possible for a 30 key board.
   5 I originally set up a few Tap Dance keys, but dropped half of them in favor of chorded versions, since in actual use, they tended to impede typing speed more than their (current) two-key versions.
   6 I've left them in my layout ready for use if anyone wants to try them out:
   7
   8 Legend Name | Single Tap | Double Tap | Hold
   9 --- | --- | --- | ---
  10 *null* | space | enter | shift
  11 *null* | backspace | delete | control
  12 Sft//Cp | shift | caps lock | *null*
  13 Q//Esc | KC_Q | escape | *null*
  14
  15 # Gherkin Flashing
  16 ## Linux
  17 The ProMicro doesn't like dfu-programmer, so we have to use AVRdude. What follows below are instructions for Linux taken from https://deskthority.net/workshop-f7/how-to-use-a-pro-micro-as-a-cheap-controller-converter-like-soarer-s-t8448.html
  18
  19 `ls /dev/tty*`
  20
  21 Next, plug in your device and re-run the command, the same as before:
  22
  23 `ls /dev/tty*`
  24
  25 There should be one more output device than was seen previously. For me, it's /dev/ttyACM0.
  26 To flash the device, you need to have AVRdude installed. On Linux, you can do this with your normal package manager.
  27 Once you have AVRdude set up, navigate to the directory with your .hex file in it. Then, run the following:
  28
  29 `avrdude -p atmega32u4 -P YOUR_SERIAL_PORT  -c avr109  -U flash:w:YOUR_FILENAME.hex`
  30
  31 Of course, replace YOUR_SERIAL_PORT with your serial port's device name, and YOUR_FILENAME.hex with the appropriate filename. For me, this line looks like this:
  32
  33 `avrdude -p atmega32u4 -P /dev/ttyACM0  -c avr109  -U flash:w:Soarer_at2usb_v1.12_atmega32u4.hex`
  34
  35 If it says ''device not in sync'' or similar, your device is no longer in bootloader mode. Unplug it, and get it back into bootloader mode like you did in the previous step (or short the reset pin), and try again.
  36 If this still doesn't work, try running the command again as root
  37
  38 `sudo avrdude -p atmega32u4 -P /dev/ttyACM0  -c avr109  -U flash:w:Soarer_at2usb_v1.12_atmega32u4.hex`
  39
  40 ## Windows
  41 1. Install the latest version of AVRdude for Windows from http://savannah.nongnu.org/projects/avrdude/
  42 Test that it installed correctly by running "avrdude" from Command Prompt. It should display a usage message with version information at the end
  43 2. Open Device Manager and take a look at your "Ports (COM & LPT)" section
  44 3. Plug in the Gherkin and short the RESET pin on the microcontroller to Ground to put it into bootloader mode. Take note of the new COM device that shows up. After 8 seconds or so the microcontroller will leave bootloader mode and it will disappear from that section
  45 4. Open Command Prompt and run the following (substituting "com7" with whatever port you saw earlier)
  46
  47 `avrdude -p atmega32u4 -P com7  -c avr109  -U flash:w:YOURHEX.hex`