Move Alice to TGR Directory (#6502)
* git mv alice into the tgr directory * update readme with new build instructionspull/6509/head
parent
8479dd65d4
commit
2c0c25d014
@ -1,60 +0,0 @@
|
||||
# TGR Alice
|
||||
|
||||
![TGR Alice](https://i.imgur.com/cJohEqS.jpg)
|
||||
|
||||
An ergonomic 60% keyboard.
|
||||
|
||||
Keyboard Maintainer: [Felipe Coury](https://github.com/fcoury)
|
||||
Hardware Supported: TGR Alice
|
||||
Hardware Availability: Group buy finished
|
||||
|
||||
Make example for this keyboard (after setting up your build environment):
|
||||
|
||||
make alice:default
|
||||
|
||||
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.
|
||||
|
||||
|
||||
ps2avrGB keyboard firmware
|
||||
==========================
|
||||
|
||||
This keyboard uses the port of the QMK firmware for boards that are based on the
|
||||
ps2avrGB firmware.
|
||||
|
||||
Note that this is a complete replacement for the firmware, so you won't be
|
||||
using Bootmapper Client to change any keyboard settings, since not all the
|
||||
USB report options are supported.
|
||||
|
||||
## Installing
|
||||
|
||||
First, install the requirements. These commands are for OSX, but all you
|
||||
need is the AVR toolchain and `bootloadHID` for flashing:
|
||||
|
||||
```
|
||||
$ brew cask install crosspack-avr
|
||||
$ brew install --HEAD https://raw.githubusercontent.com/robertgzr/homebrew-tap/master/bootloadhid.rb
|
||||
$ pip install pyusb
|
||||
```
|
||||
|
||||
Then, with the keyboard plugged in, simply run this command from the
|
||||
`qmk_firmware` directory:
|
||||
|
||||
```
|
||||
$ make alice
|
||||
$ bootloadHID -r alice_default.hex
|
||||
```
|
||||
|
||||
## Setting the board to bootloader mode
|
||||
|
||||
Hold the ESC key (the one before the 1! key, in case you remaped it).
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
From my experience, it's really hard to brick these boards. But these
|
||||
tricks have been useful when it got stuck in a weird scenario.
|
||||
|
||||
1. Try plugging the board in while holding the bootloader key. This will force
|
||||
it to boot only the bootloader without loading the firmware. Once this is
|
||||
done, just reflash the board with the original firmware.
|
||||
2. Sometimes USB hubs can act weird, so try connecting the board directly
|
||||
to your computer or plugging/unplugging the USB hub.
|
@ -0,0 +1,48 @@
|
||||
# Alice
|
||||
|
||||
![TGR Alice](https://i.imgur.com/cJohEqS.jpg)
|
||||
|
||||
An ergonomic 60% keyboard.
|
||||
|
||||
Keyboard Maintainer: [Felipe Coury](https://github.com/fcoury)
|
||||
Hardware Supported: TGR Alice
|
||||
Hardware Availability: Group buy finished
|
||||
|
||||
Make example for this keyboard (after setting up your build environment):
|
||||
|
||||
make tgr/alice:default
|
||||
|
||||
Flashing
|
||||
|
||||
ps2avr(GB) boards use an atmega32a microcontroller and a different bootloader. It is not flashable using the regular QMK methods.
|
||||
|
||||
**Reset Key:** Hold down the key located at `K00`, commonly programmed as `Esc` while plugging in the keyboard.
|
||||
|
||||
Windows:
|
||||
1. Download [HIDBootFlash](http://vusb.wikidot.com/project: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](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).
|
Loading…
Reference in new issue