summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEvan Travers2018-07-07 20:37:37 -0400
committerDrashna Jaelre2018-07-07 17:37:37 -0700
commit0d5a8b048a62aebdf5a699cae367dc0dd063d4e7 (patch)
tree8011aee4ea47c50939c598a7d82fe92f45f0464b
parent978fa700d8dc7e857518be4af30ff06d1469ccd3 (diff)
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.
-rw-r--r--docs/faq_build.md14
-rw-r--r--docs/getting_started_build_tools.md2
-rwxr-xr-xutil/macos_install.sh2
3 files changed, 16 insertions, 2 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
diff --git a/util/macos_install.sh b/util/macos_install.sh
index f53f26694..7bfb105ec 100755
--- a/util/macos_install.sh
+++ b/util/macos_install.sh
@@ -22,4 +22,4 @@ fi
brew tap osx-cross/avr
brew tap PX4/homebrew-px4
brew update
-brew install avr-gcc gcc-arm-none-eabi dfu-programmer avrdude
+brew install avr-gcc@7 gcc-arm-none-eabi dfu-programmer avrdude