X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=keyboards%2Fclueboard%2Freadme.md;h=226bc079c65f79aa40320ade9b053acfab9fbdd5;hb=0ca6b53f8981312415c2bf54c8cef22fdc5e2478;hp=6c29c09eca23a6c9e6c3763d0d4bf81f0ccb81cb;hpb=1920c290a441db1355aa4b610539d0911c7d1477;p=qmk_firmware.git diff --git a/keyboards/clueboard/readme.md b/keyboards/clueboard/readme.md index 6c29c09ec..226bc079c 100644 --- a/keyboards/clueboard/readme.md +++ b/keyboards/clueboard/readme.md @@ -1,97 +1,12 @@ -Clueboard keyboard firmware -====================== - -DIY/Assembled compact 66% keyboard by [Clueboard](http://clueboard.co). - -For the full Quantum Mechanical Keyboard feature list, see [the parent readme.md](/readme.md). - -## First Time Setup - -Download or clone the whole firmware and navigate to the keyboards/clueboard directory. Once your dev env is setup, you'll be able to generate the default .hex: - -``` -$ make -``` - -You will see a lot of output and if everything worked correctly you will see something similar to this: - -``` -Size after: - text data bss dec hex filename - 0 19992 0 19992 4e18 clueboard_rev2_default.hex -``` - -At this point you can press RESET on your Clueboard and flash your keyboard with this command: - -``` -$ make dfu -``` - -If you would like to use one of the alternative keymaps, or create your own, see below. - -## Clueboard 1.0 - -If you have a first generation Clueboard (one with a black PCB) you will need to use the revision 1 code. To do so add `SUBPROJECT=rev1` to your make command, like this: - -``` -$ make SUBPROJECT=rev1 -``` - -And when flashing your keyboard: - -``` -$ make SUBPROJECT=rev1 dfu -``` - -If you are flashing an alternative layout to your rev1, include both `SUBPROJECT=rev1` and `KEYMAP=` in your command, for example when flashing max: - -``` -$ make SUBPROJECT=rev1 KEYMAP=max dfu -``` - -## Alternate Keymaps - -There are many alternative and user-contributed layouts available in the [keymaps/](keymaps/) directory. To compile and flash an alternative you will want to add `KEYMAP=` to your command: - -``` -$ make KEYMAP=skully -``` - -And when flashing your keyboard, put `KEYMAP=` between "make" and "dfu": - -``` -$ make KEYMAP=skully dfu -``` - -### Notable Layouts - -These layouts are notable for one reason or another. If you are looking for ideas or inspiration you should look at these first: - -* [keymaps/default](keymaps/default) - The default Clueboard layout -* [keymaps/max](keymaps/max) - A maximised layout that makes use of every key and feature of the Clueboard 2.0 PCB. -* [keymaps/skully](keymaps/skully) - The layout that @skullydazed uses on his own Clueboards. - -## Create Your Own Keymap - -There are a lot of possibilities when creating your own keymap, and the primary documentation for doing that is [Customizing Your Keymap](/readme.md##customizing-your-keymap) in the main readme.md. As a way to get started, here is the procedure I recommend: - -* Copy `[keymaps/default](keymaps/default/)` to `keymaps/`. -* Compile the firmware (`$ make KEYMAP=`) -* Flash the firmware (`$ make KEYMAP= dfu`) -* Make sure everything works like the default keyboard -* Modify `keymaps//readme.md` to tell others about your layout. -* Modify `keymaps//keymap.c` to reflect your desired layout. -* Compile your new custom firmware (`$ make KEYMAP=`) -** If you have warnings you may flash without fixing them, but something may not work right. -** If you have any errors you must fix them before continuing. -* Flash the firmware (`$ make KEYMAP= dfu`) - -## Share Your Keymap - -Got your layout dialed in? Please share it with the world so we can benefit from your work! Simply submit a pull request with your layout and we'll include it in the official repository. Please use the following guidelines when putting together your pull request: - -* Include a readme.md that states what your primary keyboard use is, how your layout differs from the default, and highlights anything you think makes your layout particularly great. -* If your layout requires certain features (EG, RGB underlight or backlighting) ensure you have a Makefile and config.h that reflects that -* If your layout requires special hardware to be added, please describe that in the readme.md - -TODO: Write up or link quick how-to on creating and submitting a PR. (Pull requests accepted. :) +![Clueboard Logo](https://static1.squarespace.com/static/55c13bdee4b099be5dcb82eb/t/59c9703318b27d1ab34f40df/1508257572555/) + +Clueboard makes fully customizable custom keyboards in a variety of formfactors. Inside this directory you'll find support for the entire line of Clueboard products. + +* Maintainer: [Zach White](https://github.com/skullydazed) +* Hardware Supported: + * [`17`](17/): Clueboard "Cluepad" PCB + * [`60`](60/): Clueboard 60% PCB + * [`66`](66/): Clueboard 66% PCB + * [`2x1800`](2x1800/): Clueboard 2x1800 PCB + * [`card`](card/): Special Cluecard PCB +* Hardware Availability: [clueboard.co](https://clueboard.co/)