sporq/qmk-firmware
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
beb4a12c9d
qmk-firmware/keyboards/ymdk/bface/README.md
Ethan Durrant d137fdea78 [Keyboard] Adding YMDK "Bface" keyboard (#6731) 
* making a new board setup for ymdk bface clone

* removing extra keymaps that copied over

* documentation and edits for new ymdk_bface board

* cleaning up config and keymaps

* removed extra keymap and working on READMEs

* readme edits

* shorter aliexpress link in ymdk_bface readme

* added images to readmes and edited the keymaps

* more flashing directions

* Mac directions formatting

* editing and creating the all layout

* cleanign up ymdk_bface keymaps

* fixed typos in layout

* removed tabs

* cleaned up the LED and Backlight configuration.

* adding more to info.josn and cleaning up readme

* fixing JSON typos

* made a ymdk folder and moved the bface into it.

* fixing file names for the new folder structure
2019-09-17 10:19:16 -07:00

2.7 KiB
Raw Blame History

The YMDK "Bface" PCB

ymdk_bface

A 60% keyboard that runs ps2avrgb natively and fits the popular GH60 form factor. Another "bfake" or clone of the original B.face PCB by Winkeyless. This PCB has slightly different switch matrix than the origninal B.face, and is also different than the bfake. It commonly comes as the PCB in 60% keyboard kits sold by YMDK on Aliexpress.

Keyboard Maintainer: QMK Community
Hardware Supported: White Bface Mini USB PCB with no RGB.
Hardware Availability: Shenzhen YMD Tech Co. (YMDK) on Aliexpress

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

make ymdk/bface:default

Flashing:

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

This board has a pair of jumper holes on the left edge of the PCB marked "Jb", near TAB and CAPS LOCK. If you short the contacts with tweezers or wire the board will enter into the bootloader and you can flash it.

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 python
pip3 install pyusb
brew install --HEAD`https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb

  4. Place your keyboard into reset by shorting the jumper on the left edge of the PCB..

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

Another method for Mac or Linux: After installing bootloadHID, you can use the ./util/atmega32a_program.py program included in QMK. You will need to have python and the pyusb library installed.

Then you can run this to compile the firmware and flash the board without using the jumper:

make ymdk/bface:default:program

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