X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=keyboards%2Fphantom%2Freadme.md;h=b25630958bc4b6462145893beb6c5032e1a6854b;hb=4be1dfcee48daeb77e966b08ad9ca51e02253acf;hp=614c21fda0fc205149835d4b3bff93fb2937da13;hpb=62214986013ee6596afa55023f7a95a8527d910f;p=qmk_firmware.git diff --git a/keyboards/phantom/readme.md b/keyboards/phantom/readme.md index 614c21fda..b25630958 100644 --- a/keyboards/phantom/readme.md +++ b/keyboards/phantom/readme.md @@ -1,48 +1,16 @@ -Phantom keyboard firmware -========================= +Phantom +======= A community-developed keyboard PCB designed to fit inside the case of a Filco Majestouch. See the [Deskthority wiki](https://deskthority.net/wiki/Phantom) for more information. -## Bootloader +Keyboard Maintainer: QMK Community +Hardware Supported: Phantom PCB +Hardware Availability: https://mechanicalkeyboards.com/shop/index.php?l=product_detail&p=536 -The Phantom uses a [Teensy 2.0](https://www.pjrc.com/store/teensy.html) as a controller. +Make example for this keyboard (after setting up your build environment): -The Teensy has a special bootloader that can be accessed by pressing the button on the Teensy PCB. It is also possible to use Boot Magic and Command to access the bootloader. + make phantom:default -To write the firmware to the Teensy use [Teensy loader](https://www.pjrc.com/teensy/loader.html). - -## Quantum MK Firmware - -For the full Quantum feature list, see the [documentation](https://docs.qmk.fm). - -## RGB underlight - -It is possible to connect a WS2812B LED strip to the Teensy for RGB underlight support. - -For this to work the DIN connection on the WS2812B strip should be soldered to PE2 on the Teensy (see reference image https://i.imgur.com/aDfNoHT.jpg). - -See [rgbmod](keymaps/rgbmod) for a keymap that utilizes the RGB underlight feature. - -## Building - -The Phantom allows for a huge amount of different layouts. - -Depending on which layout and keymap you would like to use, you will have to compile the firmware slightly differently. All of the commands should be run in the [keyboards/phantom](/keyboards/phantom) folder. - -### Custom keymaps - -To define your own keymap, copy one of the [existing keymap](keymaps) folders and give it the name of your keymap. Then check the [keymap documentation](https://docs.qmk.fm/Keymap.html) for details on how to modify the keymap. - -To make it easy to define keymaps for the most common layouts a few macros are provided. - -| Layout | Macro | -| --------------- | ------------------------- | -| Winkey ANSI | `KEYMAP()` | -| Winkeyless ANSI | `KEYMAP_WINKEYLESS()` | -| Winkey ISO | `KEYMAP_ISO()` | -| Winkeyless ISO | `KEYMAP_ISO_WINKEYLESS()` | -| 7BIT | `KEYMAP_7BIT()` | - -To build the firmware with a custom keymap, run `make ` +See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information.