qmk_firmware/BUILD_GUIDE.md
2016-03-02 22:38:22 -05:00

1023 B

Build Guide

Build Environment Setup

Windows

What these instructions look like depends on whether NoahAndrews's setup scripts get merged

Mac

If you're using homebrew, you can use the following commands:

brew tap osx-cross/avr
brew install avr-libc
brew install dfu-programmer

This is the recommended method. If you don't have homebrew, install it! It's very much worth it for anyone who works in the command line.

You can also try these instructions:

  1. Install Xcode from the App Store.
  2. Install the Command Line Tools from Xcode->Preferences->Downloads.
  3. Install [DFU-Programmer][dfu-prog].

Linux

Vagrant

If you have any problems building the firmware, you can try using a tool called Vagrant. It will set up a virtual computer with a known configuration that's ready-to-go for firmware building. OLKB does NOT host the files for this virtual computer. Details on how to set up Vagrant are in the VAGRANT_GUIDE file.