diff options
| author | Evan Travers <evantravers@gmail.com> | 2018-07-08 02:37:37 +0200 |
|---|---|---|
| committer | Drashna Jaelre <drashna@live.com> | 2018-07-08 02:37:37 +0200 |
| commit | 0d5a8b048a62aebdf5a699cae367dc0dd063d4e7 (patch) | |
| tree | 8011aee4ea47c50939c598a7d82fe92f45f0464b /docs | |
| parent | 978fa700d8dc7e857518be4af30ff06d1469ccd3 (diff) | |
| download | qmk_firmware-0d5a8b048a62aebdf5a699cae367dc0dd063d4e7.tar.gz qmk_firmware-0d5a8b048a62aebdf5a699cae367dc0dd063d4e7.tar.xz | |
Instruct macos users to use avr-gcc@7 (#3337)
If you run `brew install avr-gcc`, you get a version that has
compatibility issues with LUFA. I updated the getting started guide for
osx, the qmk_install setup script, and added a section to the FAQ for
folks like me who accidentally updated avr-gcc past 7.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/faq_build.md | 14 | ||||
| -rw-r--r-- | docs/getting_started_build_tools.md | 2 |
2 files changed, 15 insertions, 1 deletions
diff --git a/docs/faq_build.md b/docs/faq_build.md index 2d1b91b60..7d17df074 100644 --- a/docs/faq_build.md +++ b/docs/faq_build.md @@ -104,3 +104,17 @@ brew install dfu-programmer brew install gcc-arm-none-eabi brew install avrdude ``` + +### avr-gcc 8.1 and LUFA + +If you updated your avr-gcc to above 7 you may see errors involving LUFA. For example: + +`lib/lufa/LUFA/Drivers/USB/Class/Device/AudioClassDevice.h:380:5: error: 'const' attribute on function returning 'void'` + +For now, you need to rollback avr-gcc to 7 in brew. + +``` +brew uninstall --force avr-gcc +brew install avr-gcc@7 +brew link avr-gcc@7 +``` diff --git a/docs/getting_started_build_tools.md b/docs/getting_started_build_tools.md index 45b51b2cc..c1e02d4e0 100644 --- a/docs/getting_started_build_tools.md +++ b/docs/getting_started_build_tools.md @@ -56,7 +56,7 @@ If you're using [homebrew,](http://brew.sh/) you can use the following commands: brew tap osx-cross/avr brew tap PX4/homebrew-px4 brew update - brew install avr-gcc + brew install avr-gcc@7 brew install dfu-programmer brew install gcc-arm-none-eabi brew install avrdude |