Mikkel Jeppesen feeee4e40d | 6 years ago | |
---|---|---|
.. | ||
keymaps | 6 years ago | |
rev1 | 6 years ago | |
config.h | 6 years ago | |
i2c.c | 6 years ago | |
i2c.h | 6 years ago | |
lets_split.c | 6 years ago | |
lets_split.h | 6 years ago | |
matrix.c | 6 years ago | |
readme.md | 6 years ago | |
rules.mk | 6 years ago | |
serial.c | 6 years ago | |
serial.h | 6 years ago | |
split_util.c | 6 years ago | |
split_util.h | 6 years ago |
This readme and most of the code are from https://github.com/ahtn/tmk_keyboard/
Hardware files for the Let's Split vitamins included are stored here
Clone the qmk_firmware
repo and navigate to its top level directory. Once your build environment is setup, you'll be able to generate the default .hex using:
make lets_split_vitamins/rev1:default
You will see a lot of output and if everything worked correctly you will see the built hex file:
lets_split_vitamins_rev1_default.hex
If you would like to use one of the alternative keymaps, or create your own, copy one of the existing keymaps and run make like so:
make lets_split_vitamins/rev1:YOUR_KEYMAP_NAME
If everything worked correctly you will see a file:
lets_split_vitamins_rev1_YOUR_KEYMAP_NAME.hex
If you are on linux, you can also flash the hex file to the keyboard right after compilation, by adding :avrdude
to the end of the make command like so:
make lets_split_vitamins/rev1:default:avrdude
For more information on customizing keymaps, take a look at the primary documentation for Customizing Your Keymap in the main readme.md.
For the full Quantum Mechanical Keyboard feature list, see the parent readme.md.
Some features supported by the firmware:
Amount | Description |
---|---|
1 | PCB kit from novelkeys |
48 | MX compatible switches |
48 | 1U keycaps |
2 | Half cases. A 3D model for the left half is available here. Mirror that to get a right-half case. Plate cases will be designed in the future. |
1 | USB-mini-B cable of your choice |
1 | TRS / TRRS cable |
A speaker can be hooked-up to the footprint on the PCBs. It is already enabled in the default firmware from github.
A strip of WS2812 LEDs can be hooked up too, a guide will be written on how to do that once I get mine in the mail.
The PCB and connectors can safely handle 1A of current, but the USB standard is only rated at 500mA. Keep that in mind when picking the amount of LEDs.
On the left half PCB, there's two pads labled I2C Pullup if you want to use I2C, you need to bridge those two solder jumpers with a soldering iron.
You can change your configuration between serial and i2c by modifying your config.h
file.
Configuring the firmware is similar to any other QMK project. One thing
to note is that MATRIX_ROWS
in config.h
is the total number of rows between
the two halves, so because the let's split vitamins included has 4 rows in each half, it's
MATRIX_ROWS=8
.
Also, the current implementation assumes a maximum of 8 columns, but it would not be very difficult to adapt it to support more if required.
If the keyboard isn't new, and has been flashed before, you need to enter bootloader. To enter bootloader, either use the assigned keys on the keymap, or if none have been put in the keymap, quickly short the reset to gnd twice. (Bottom pins of programming header, see image)
If using the default keymap, there's a reset key-combination on each half:
Lower (SW23) and left-shift (SW13) on the left half, or
Raise(SW44) and Enter(SW42) on the right half
It is recommended to add such reset keys to any custom keymaps. It shouldn't be necesarry to have one on each half, but the default layout has that.
The board exits bootloader mode after 8 seconds, if you haven't started flashing.
If this is the first time you're flashing the boards, it's easier to also flash EEPROM at the same time.
make lets_split_vitamins/rev1:default
dmesg | tail -10 | grep tty
avrdude -c avr109 -p m32u4 -P /dev/ttyACM0 -U flash:w:"lets_split_vitamins_rev1_default.hex":a -U eeprom:w:"./keyboards/lets_split_vitamins/eeprom-lefthand.eep":a
for the left hand. Replace /dev/ttyACM0 with the port you noted down earlier. For the right hand, change it to eeprom-righthand.eepYour keyboard should be flashed :)
In the future, you shouldn't need to flash EEPROM (it will in fact wear the eeprom memory, so don't) In the future just run:
make lets_split_vitamins/rev1:[KEYMAP]:avrdude
from the qmk_firmware folder.
Follow this guide here to get ubuntu bash on windows. Then, in ubuntu bash for windows, follow the linux instructions here
Then install AVRDUDESS.
/mnt/[DRIVE LETTER no caps]/
make lets_split_vitamins/rev1:default
keyboards/lets_split_vitamins/
and pick eeprom-lefthand.eep
or eeprom-righthand.eep
depending on which half you are flashing.Your board should be flashed :) For further flashes, you should clear the eeprom field, as you shouldn't wear the eeprom unnecessarily.
You can plug either half into USB and it will work. you can also remove the TRS/TRRS cable, and plug both halves in. (which is why the default layout has reset on both halves)
Enjoy your keyboard! :D