You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qmk_firmware/keyboard/planck
Jack Humbert 71a8fd8b12
bluetooth working with usb
9 years ago
..
keymaps bluetooth working with usb 9 years ago
old_keymap_files making the extended keymap the default - no more 'common' 9 years ago
Makefile bluetooth working with usb 9 years ago
Makefile.pjrc added planck folder 10 years ago
PCB_GUIDE.md making the extended keymap the default - no more 'common' 9 years ago
README.md making the extended keymap the default - no more 'common' 9 years ago
__avr_gdbinit files 10 years ago
analog.c ok 9 years ago
analog.h ok 9 years ago
backlight.c ok 9 years ago
beeps.c beeps in an if 9 years ago
beeps.h beeps update 9 years ago
config.h bluetooth working with usb 9 years ago
config_definitions.h rows to col option, maybe 9 years ago
flash-pcb.sh ok 9 years ago
keymap_common.c unicode working, i think 9 years ago
keymap_common.h unicode working, i think 9 years ago
keymap_midi.c bluetooth 9 years ago
keymap_midi.h beeps update 9 years ago
keymap_unicode.c unicode working, i think 9 years ago
led.c quark 10 years ago
matrix.c BL 9 years ago
matrix_steno.c unicode working, i think 9 years ago
planck_pcb.hex pcb hex 9 years ago
planck_with_bootloader.hex bluetooth 9 years ago

README.md

Planck keyboard firmware

DIY/Assembled compact ortholinear 40% keyboard by Ortholinear Keyboards.

OLKB Keymap

You have access to a bunch of goodies:

  • Use LSFT(), LCTL(), et. al. (listed in keymap_common.h) as modifiers for keys (daisy-chain-able)
  • Use FUNC(1) instead of FN1 (etc.) to access the function layers beyond the 32 function layer limit
  • Use CM_F instead of KC_F to get the ColeMak equivilent for shortcuts (maps backwards)
  • Use MACRODOWN() instead of MACRO() to easily make a keydown macro (CM_* works here too)

Some notes on usage:

  • The KEYMAP() macro is unable to be used due to the bitwise modifications that take place - refer to extended_keymap_jack.c to see how to set things up with the KC_ prefix
  • Keep an eye on the Makefile - this needs to include the correct files to work
  • Don't forget to use const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { instead of the 8bit equivilent

Build

Follow this guide to setup your development environment before anything else. Abbreviated instructions are provide at the bottom of this document

Download the whole firmware here and navigate to the keyboard/planck folder. Once your dev env is setup, you'll be able to type make to generate your .hex that you can load with the Teensy app onto your Planck (once you've hit reset/shorted GND & RST).

Depending on which keymap you would like to use, you will have to compile slightly differently.

####Default To build with the default keymap, simply move to the tmk_keyboard/keyboard/planck/ and run make as follows:

$ make

Keymap

Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. To define your own keymap create file named keymap_<name>.c and see keymap document (you can find in top README.md) and existent keymap files.

####Keymaps

To build the firmware binary hex file with an extended keymap just do make with KEYMAP option like:

$ make KEYMAP=[default|jack|<name>]

The only applicable keymaps will work with this option. Keymaps follow the format keymap_<name>.c and are stored in the keymaps folder.

Notable TMK forks (which some of the keymap files are from)