qmk_firmware

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

readme.md (2054B)


      1 # Junco <!-- omit from toc -->
      2 
      3 ![Junco](https://i.imgur.com/WzZaIgQh.jpg)
      4 
      5 Junco is a 60% Raspberry Pi Pico powered split keyboard boasting a 4x6 layout with an aggressive columnar stagger. It has 5 "thumb" keys on either side, support for 2-4 rotary encoders, and per-key RGB lighting.
      6 
      7 - Keyboard Maintainer: [Dane Skalski](https://github.com/Daneski13)
      8 - Hardware Supported: Junco PCB, Raspberry Pi Pico
      9 - Hardware Availability: [PCB, Case, Parts List](https://github.com/Daneski13/Junco)
     10 
     11 Remember you have to flash both halves of the keyboard for it to work!
     12 
     13 Make example for this keyboard (after setting up your build environment):
     14 
     15     make junco:default
     16 
     17 Flashing example for this keyboard:
     18 
     19 ```bash
     20 # For flashing the left half...
     21 make junco:default:uf2-split-left
     22 # or the qmk cli equivalent:
     23 qmk flash -kb junco --keymap default -bl uf2-split-left
     24 
     25 # For flashing the right half...
     26 make junco:default:uf2-split-right
     27 # or the qmk cli equivalent:
     28 qmk flash -kb junco --keymap default -bl uf2-split-right
     29 ```
     30 
     31 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. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
     32 
     33 ## Bootloader <!-- omit from toc -->
     34 
     35 Enter the bootloader in 3 ways:
     36 
     37 - **Bootmagic reset** (works after you have flashed once): Hold down the top far corner key while plugging in the keyboard (`~` left half, `-` right half). This will also clear the EEPROM.
     38 - **Physical reset button**: Hold the `BOOT` button on the Pico and press the `RST` button on the Pico, release the the `RST` button before the `BOOT` button.
     39 - **Keycode in layout**: In the default layout, the `Bootloader` keycode is above home row pinky on the right side's adjust layer.
     40 
     41 Once you enter the bootloader, the keyboard will show up as a USB device on your computer, you could drag and drop a firmware file to flash it, but I recommend using the flash commands for the respective side.