qmk_firmware/keyboards/unikorn
fauxpark efa28d0f5c Convert some PS2AVRGB boards to I2C WS2812 driver (#7241)
* Convert some PS2AVRGB boards to I2C WS2812 driver

* Fix Travis failure for bface
2019-11-04 16:05:03 -08:00
..
keymaps
config.h
info.json
readme.md
rules.mk
unikorn.c
unikorn.h
usbconfig.h

readme.md

Unikorn 60

60% PCB made for the TGR x SINGA Unikorn60.

Keyboard Maintainer: MechMerlin
Hardware Supported: Unikorn 60 PCB
Hardware Availability: Geekhack GB

Make example for this keyboard (after setting up your build environment):

make unikorn:default

This PCB can support RGB underglow. There are pads on the bottom of the PCB for the LED controller chip and for 17 RGB underglow LEDs. The Unikorn 60 case does not have acrylic pieces to properly display underglow effects.

To enable RGB lighting support, install the necessary components and set RGBLIGHT features in rules.mk like so:

RGBLIGHT_ENABLE = yes

Flashing

ps2avr(GB) boards use an atmega32a microcontroller and a different bootloader. It is not flashable using the regular QMK methods.

Reset Key: Short the two holes labeled FW_JP underneath the PCB, beside the Tab key while plugging in the keyboard.

Do not confuse this with the LED holes of the switch in the Tab position. FW_JP is not reachable from the top as the plate blocks access to it.

It is recommended to program a RESET key in your keymap.

Windows:

  1. Download HIDBootFlash.
  2. Place your keyboard into reset.
  3. Press the Find Device button and ensure that your keyboard is found.
  4. Press the Open .hex File button and locate the .hex file you created.
  5. Press the Flash Device button and wait for the process to complete.

macOS:

  1. Install homebrew by typing the following:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Install crosspack-avr.

    brew cask install crosspack-avr
    
  3. Install the following packages:

    brew install python3
    pip3 install pyusb
    brew install --HEAD https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb
    
    
  4. Place your keyboard into reset.

  5. Flash the board by typing bootloadHID -r followed by the path to your .hex file.

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.