Skip to content

Commit 0d5a8b0

Browse files
evantraversdrashna
authored andcommitted
Instruct macos users to use avr-gcc@7 (qmk#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.
1 parent 978fa70 commit 0d5a8b0

File tree

3 files changed

+16
-2
lines changed

3 files changed

+16
-2
lines changed

docs/faq_build.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,3 +104,17 @@ brew install dfu-programmer
104104
brew install gcc-arm-none-eabi
105105
brew install avrdude
106106
```
107+
108+
### avr-gcc 8.1 and LUFA
109+
110+
If you updated your avr-gcc to above 7 you may see errors involving LUFA. For example:
111+
112+
`lib/lufa/LUFA/Drivers/USB/Class/Device/AudioClassDevice.h:380:5: error: 'const' attribute on function returning 'void'`
113+
114+
For now, you need to rollback avr-gcc to 7 in brew.
115+
116+
```
117+
brew uninstall --force avr-gcc
118+
brew install avr-gcc@7
119+
brew link avr-gcc@7
120+
```

docs/getting_started_build_tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ If you're using [homebrew,](http://brew.sh/) you can use the following commands:
5656
brew tap osx-cross/avr
5757
brew tap PX4/homebrew-px4
5858
brew update
59-
brew install avr-gcc
59+
brew install avr-gcc@7
6060
brew install dfu-programmer
6161
brew install gcc-arm-none-eabi
6262
brew install avrdude

util/macos_install.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,4 @@ fi
2222
brew tap osx-cross/avr
2323
brew tap PX4/homebrew-px4
2424
brew update
25-
brew install avr-gcc gcc-arm-none-eabi dfu-programmer avrdude
25+
brew install avr-gcc@7 gcc-arm-none-eabi dfu-programmer avrdude

0 commit comments

Comments
 (0)