Link Search Menu Expand Document

Install Instructions

WARNING: these instructions are by no means complete, feel free to ask in the Discord Server if you encounter any problems. As we are still in early test stages.

Alternative Docker Build Script

Checkout the docker build script provided by @zinosat.

Dockerfile

Get AnnePro2 Tools

If you want the executable instead of compiling it yourself, download it here. Windows and Linux versions are available. Otherwise, follow the steps below:

  1. Install the latest stable rust toolchain using rustup
  2. On Windows: also install Visual Studio Community edition including the C/C++ module to prevent errors while compiling on step 6 below.
  3. On Linux: make sure following software/packages pkg-config pkgconf libusb-1.0-0 libusb-dev are installed to prevent errors while compiling on step 6 below. If not, install them with
    sudo apt-get install pkg-config pkgconf libusb-1.0-0 libusb-dev 
    
  4. You might need to run below command to configure the right path for pkgconfig do its work on step 6 below.
    export PATH_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig/
    
  5. Download or Clone the AnnePro2-Tools project.
  6. Navigate to the folder you have just downloaded or cloned and compile the tool using
    cargo build --release
    
  7. The compiled tool should be in ./target/release/annepro2_tools (In later I will refer to this as annepro2_tools)

Get QMK firmware

Hint: If you are on windows, I recommend completing this step using WSL. YMMV

Manually compiling the QMK firmware is emphasized because this is what you modify to customize the keyboard.

  1. Clone our fork of the QMK firmware by using the command below. (Install Git if needed)
    git clone https://github.com/OpenAnnePro/qmk_firmware.git annepro-qmk --recursive --depth 1
    
  2. Obtain the gcc-arm-none-eabi toolchain so you can build the project.
  3. To compile the firmware type
    # For C15 Revision
    make annepro2/c15
    # For C18 Revision
    make annepro2/c18
    

    This should complete without any error. And you should be able to see a file named annepro2_c15(18)_default.bin in your directory. This is a compiled keymap profile. This will be flashed on your keyboard later. You can also see additional default and other user-made keymaps in the same directory. You can choose to flash one of these instead. For specific information on their differences, check their keymap.c file in annepro_qmk/keyboards/annepro2/keymaps/*profile*/keymap.c.

annepro2_c15(18)_default.bin has the exact same mapping as the default Obinskit, but with no caps-lock and layer indicators.

annepro2_c15(18)_default-full-caps.bin is the same as previous, but the keyboard changes to red LEDs to indicate caps-lock.

annepro2_c15(18)_default-layer-indicators.bin has the caps-lock indicator and it changes the LEDs to indicate what layer you’re on.

Check the customization page for more information on these keymaps and customizing your own keymap

Flashing the firmware

  1. Put the keyboard into DFU/IAP mode by unplugging the keyboard, then holding ESC while plugging it back in.
  2. Run annepro2_tools with the firmware you just built.

Please substitute with the correct paths and correct bin file if you chose another keymap profile

annepro2_tools annepro2_c15_default.bin

If the tool can’t find the keyboard please double check you have the keyboard in IAP mode.

Anne Pro 2 Shine

If you want the binary instead of compiling it yourself, download it here. Otherwise, follow the steps below:

Building the shine firmware is very similar to the QMK firmware.

  1. Checkout the repository using
    git clone https://github.com/OpenAnnePro/annepro2-shine.git --recursive
    
  2. Build using
    # for C15
    make C15
    # for C18
    make C18
    # for both
    make
    
  3. If built without error you can find the binary in build/ directory. You will flash the .bin file using annepro2 tools.
    # --boot automatically restarts the keyboard into normal mode. Remove it if you are going to flash something else next.
    # for C15
    annepro2_tools --boot -t led build/annepro2-shine-C15.bin
    # for C18
    annepro2_tools --boot -t led build/annepro2-shine-C18.bin
    

With QMK & Shine installed, you can now easily switch to IAP mode by pressing LSHIFT + RSHIFT + B. This will be useful for customizing your keyboard. Note: This shortcut will not set the LED MCU to IAP mode if Shine is not already flashed, meaning you will have to use the ESC method if you want to flash Shine and it currently isn’t already flashed.

Remember, you can always use the QMK docs and the Customization page for more info. Enjoy!

Automated Scripts

Having to type the previous commands to flash the firmware can be annoying and you might want a simple script that does it for you. The scripts below assume you have the script and firmware files in the same directory as the annepro2_tools.exe executable. They flash both the main firmware and annepro2-shine and automatically restarts the keyboard. Modify and change the filenames as needed.

Batch script (Windows)

Paste this script into a .bat file.

@ECHO OFF

.\annepro2_tools.exe .\annepro2_c18_default.bin
.\annepro2_tools.exe --boot -t led .\annepro2-shine-C18.bin

pause

Bash script (Linux/MacOS)

Paste this script into a .sh file. If preferred, make it executable by calling chmod +x nameOfScriptFile.sh in the terminal.

#!/bin/sh

./annepro2_tools ./annepro2_c18_default.bin
./annepro2_tools --boot -t led ./annepro2-shine-C18.bin