aboutsummaryrefslogtreecommitdiff
path: root/docs/faq_build.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/faq_build.md')
-rw-r--r--docs/faq_build.md35
1 files changed, 7 insertions, 28 deletions
diff --git a/docs/faq_build.md b/docs/faq_build.md
index f11cb76aa..618ae40f3 100644
--- a/docs/faq_build.md
+++ b/docs/faq_build.md
@@ -47,7 +47,7 @@ SUBSYSTEMS=="usb", ATTRS{idVendor}=="feed", MODE:="0666"
47SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", MODE:="0666" 47SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", MODE:="0666"
48``` 48```
49 49
50**/etc/udev/rules.d/55-catalina.rules:** 50**/etc/udev/rules.d/55-caterina.rules:**
51``` 51```
52# ModemManager should ignore the following devices 52# ModemManager should ignore the following devices
53ATTRS{idVendor}=="2a03", ENV{ID_MM_DEVICE_IGNORE}="1" 53ATTRS{idVendor}=="2a03", ENV{ID_MM_DEVICE_IGNORE}="1"
@@ -69,6 +69,12 @@ SUBSYSTEMS=="usb", ATTRS{idVendor}=="1eaf", ATTRS{idProduct}=="0003", MODE:="066
69SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE:="0666" 69SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE:="0666"
70``` 70```
71 71
72**/etc/udev/rules.d/57-bootloadhid.rules:**
73```
74# bootloadHID
75SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05df", MODE:="0666"
76```
77
72### Serial device is not detected in bootloader mode on Linux 78### Serial device is not detected in bootloader mode on Linux
73Make sure your kernel has appropriate support for your device. If your device uses USB ACM, such as 79Make sure your kernel has appropriate support for your device. If your device uses USB ACM, such as
74Pro Micro (Atmega32u4), make sure to include `CONFIG_USB_ACM=y`. Other devices may require `USB_SERIAL` and any of its sub options. 80Pro Micro (Atmega32u4), make sure to include `CONFIG_USB_ACM=y`. Other devices may require `USB_SERIAL` and any of its sub options.
@@ -81,10 +87,6 @@ Re-running the QMK installation script (`./util/qmk_install.sh` from the `qmk_fi
81 87
82If that doesn't work, then you may need to download and run Zadig. See [Bootloader Driver Installation with Zadig](driver_installation_zadig.md) for more detailed information. 88If that doesn't work, then you may need to download and run Zadig. See [Bootloader Driver Installation with Zadig](driver_installation_zadig.md) for more detailed information.
83 89
84## WINAVR is Obsolete
85It is no longer recommended and may cause some problem.
86See [TMK Issue #99](https://github.com/tmk/tmk_keyboard/issues/99).
87
88## USB VID and PID 90## USB VID and PID
89You can use any ID you want with editing `config.h`. Using any presumably unused ID will be no problem in fact except for very low chance of collision with other product. 91You can use any ID you want with editing `config.h`. Using any presumably unused ID will be no problem in fact except for very low chance of collision with other product.
90 92
@@ -97,29 +99,6 @@ You can buy a really unique VID:PID here. I don't think you need this for person
97- http://www.obdev.at/products/vusb/license.html 99- http://www.obdev.at/products/vusb/license.html
98- http://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=92&option=com_phpshop&Itemid=1 100- http://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=92&option=com_phpshop&Itemid=1
99 101
100## Cortex: `cstddef: No such file or directory`
101GCC 4.8 of Ubuntu 14.04 had this problem and had to update to 4.9 with this PPA.
102https://launchpad.net/~terry.guo/+archive/ubuntu/gcc-arm-embedded
103
104https://github.com/tmk/tmk_keyboard/issues/212
105https://github.com/tmk/tmk_keyboard/wiki/mbed-cortex-porting#compile-error-cstddef
106https://developer.mbed.org/forum/mbed/topic/5205/
107
108## `clock_prescale_set` and `clock_div_1` Not Available
109Your toolchain is too old to support the MCU. For example WinAVR 20100110 doesn't support ATMega32u2.
110
111```
112Compiling C: ../../tmk_core/protocol/lufa/lufa.c
113avr-gcc -c -mmcu=atmega32u2 -gdwarf-2 -DF_CPU=16000000UL -DINTERRUPT_CONTROL_ENDPOINT -DBOOTLOADER_SIZE=4096 -DF_USB=16000000UL -DARCH=ARCH_AVR8 -DUSB_DEVICE_ONLY -DUSE_FLASH_DESCRIPTORS -DUSE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)" -DFIXED_CONTROL_ENDPOINT_SIZE=8 -DFIXED_NUM_CONFIGURATIONS=1 -DPROTOCOL_LUFA -DEXTRAKEY_ENABLE -DCONSOLE_ENABLE -DCOMMAND_ENABLE -DVERSION=unknown -Os -funsigned-char -funsigned-bitfields -ffunction-sections -fdata-sections -fno-inline-small-functions -fpack-struct -fshort-enums -fno-strict-aliasing -Wall -Wstrict-prototypes -Wa,-adhlns=obj_alps64/protocol/lufa/lufa.lst -I. -I../../tmk_core -I../../tmk_core/protocol/lufa -I../../tmk_core/protocol/lufa/LUFA-git -I../../tmk_core/common -std=gnu99 -include config.h -MMD -MP -MF .dep/obj_alps64_protocol_lufa_lufa.o.d ../../tmk_core/protocol/lufa/lufa.c -o obj_alps64/protocol/lufa/lufa.o
114../../tmk_core/protocol/lufa/lufa.c: In function 'setup_mcu':
115../../tmk_core/protocol/lufa/lufa.c:575: warning: implicit declaration of function 'clock_prescale_set'
116../../tmk_core/protocol/lufa/lufa.c:575: error: 'clock_div_1' undeclared (first use in this function)
117../../tmk_core/protocol/lufa/lufa.c:575: error: (Each undeclared identifier is reported only once
118../../tmk_core/protocol/lufa/lufa.c:575: error: for each function it appears in.)
119make: *** [obj_alps64/protocol/lufa/lufa.o] Error 1
120```
121
122
123## BOOTLOADER_SIZE for AVR 102## BOOTLOADER_SIZE for AVR
124Note that Teensy2.0++ bootloader size is 2048byte. Some Makefiles may have wrong comment. 103Note that Teensy2.0++ bootloader size is 2048byte. Some Makefiles may have wrong comment.
125 104