qmk_firmware

QMK firmware for my keyboards (Corne, Sweep Ferris) and trackball (Ploopy Adept)
Log | Files | Refs | Submodules | LICENSE

readme.md (2068B)

      1 # System76 Launch Configurable Keyboard (launch_1)
      2 
      3 ![System76 Launch Configurable Keyboard](https://images.prismic.io/system76/b71307ac-dae6-4863-b7ca-804cd61c7ef8_launch_overhead.png?auto=compress,format&w=750)
      4 
      5 The Launch Configurable Keyboard is engineered to be comfortable, fully customizable, and make your workflow more efficient.
      6 
      7 - High-speed USB Hub
      8 - Works on Linux, Windows and macOS
      9 - 100% Open Source
     10 - Made in Colorado
     11 
     12 Additional Launch Keyboard resources:
     13 
     14 - Keyboard Maintainer: [System76](https://github.com/system76)
     15 - Hardware Supported: [System76 Launch GitHub Repository](https://github.com/system76/launch)
     16 - Hardware Availability: [Shop System76](https://system76.com/accessories/launch)
     17 
     18 ## Building Firmware
     19 
     20 To build the firmware using `make` (after setting up the build environment), e.g.:
     21 
     22 ```bash
     23 make -r system76/launch_1:default
     24 ```
     25 
     26 Equivalently, using the QMK CLI:
     27 
     28 ```bash
     29 qmk compile -kb system76/launch_1 -km default
     30 ```
     31 
     32 ## Flashing Firmware (DFU)
     33 
     34 To build and flash the firmware on the keyboard, e.g.:
     35 
     36 ```bash
     37 make -r system76/launch_1:default:flash
     38 ```
     39 
     40 Equivalently, using the QMK CLI:
     41 
     42 ```bash
     43 qmk flash -kb system76/launch_1 -km default
     44 ```
     45 
     46 ## Flashing Firmware (ISP)
     47 
     48 To flash the firmware (and/or bootloader) using ISP refer to the [_ISP Flashing Guide_](https://docs.qmk.fm/#/isp_flashing_guide).
     49 
     50 > **Factory fuse values** => Low: `0x5E`, High: `0x99`, Extended: `0xF3`, Lock Bits: `0xFF`
     51 
     52 ## Environment Setup
     53 
     54 See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. If new to QMK, start with the [_Complete Newbs Guide_](https://docs.qmk.fm/#/newbs).
     55 
     56 ## Bootloader
     57 
     58 Enter the bootloader in 3 ways:
     59 
     60 - **Bootmagic reset**: Hold down the key at (0,0) in the matrix (Escape) and plug in the keyboard.
     61 - **Keycode in layout**: Press the key mapped to `QK_BOOT` in the second layer (Escape).
     62 - **Electrical reset**: Briefly short AVR ISP's GND (6) and RST (5) pads on the back of the PCB.