You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

154 lines
7.1 KiB

  1. # Foire aux questions sur la compilation
  2. Cette page couvre les questions concernant la compilation de QMK. Si vous ne l'avez pas encore fait, vous devriez lire les guides [Configuration de l'environnement de build](getting_started_build_tools.md) et [Instructions pour Make](getting_started_make_guide.md).
  3. ## Je ne peux pas programmer sous Linux
  4. Vous aurez besoin des permissions appropriées pour utiliser un périphérique. Pour les utilisateurs de Linux, référez-vous aux instructions concernant les règles `udev` ci-dessous. Si `udev` vous pose des problèmes, une alternative est d'utiliser la commande `sudo`. Si vous ne connaissez pas cette commande, référez-vous à son manuel d'utilisation en utilisant `man sudo` ou [regardez cette page](https://linux.die.net/man/8/sudo).
  5. Un exemple utilisant `sudo`, lorsque votre contrôleur est un ATMega32u4 :
  6. $ sudo dfu-programmer atmega32u4 erase --force
  7. $ sudo dfu-programmer atmega32u4 flash your.hex
  8. $ sudo dfu-programmer atmega32u4 reset
  9. ou simplement :
  10. $ sudo make <keyboard>:<keymap>:dfu
  11. Veuillez noter que lancer `make` avec `sudo` est généralement une **mauvaise** idée, et vous devriez préférer une des méthodes précédente, si possible.
  12. ### Règles `udev` pour Linux
  13. Sous Linux, vous aurez besoin des permissions appropriées pour accéder au MCU (le micro-contrôleur). Vous avez le choix d'utiliser `sudo` en flashant le firmware, ou placer ces fichiers dans `/etc/udev/rules.d`. Une fois ajouté, lancez les commandes suivantes:
  14. ```console
  15. sudo udevadm control --reload-rules
  16. sudo udevadm trigger
  17. ```
  18. **/etc/udev/rules.d/50-atmel-dfu.rules:**
  19. ```
  20. # Atmel ATMega32U4
  21. SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff4", MODE:="0666"
  22. # Atmel USBKEY AT90USB1287
  23. SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ffb", MODE:="0666"
  24. # Atmel ATMega32U2
  25. SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff0", MODE:="0666"
  26. ```
  27. **/etc/udev/rules.d/52-tmk-keyboard.rules:**
  28. ```
  29. # tmk keyboard products https://github.com/tmk/tmk_keyboard
  30. SUBSYSTEMS=="usb", ATTRS{idVendor}=="feed", MODE:="0666"
  31. ```
  32. **/etc/udev/rules.d/54-input-club-keyboard.rules:**
  33. ```
  34. # Input Club keyboard bootloader
  35. SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", MODE:="0666"
  36. ```
  37. **/etc/udev/rules.d/55-catalina.rules:**
  38. ```
  39. # ModemManager should ignore the following devices
  40. ATTRS{idVendor}=="2a03", ENV{ID_MM_DEVICE_IGNORE}="1"
  41. ATTRS{idVendor}=="2341", ENV{ID_MM_DEVICE_IGNORE}="1"
  42. ```
  43. **Note:** Le filtrage utilisant ModemManager fonctionnera uniquement si vous n'êtes pas en mode strict. Les commandes suivantes peuvent changer cette option :
  44. ```console
  45. sudo sed -i 's/--filter-policy=strict/--filter-policy=default/' /lib/systemd/system/ModemManager.service
  46. sudo systemctl daemon-reload
  47. sudo systemctl restart ModemManager
  48. ```
  49. **/etc/udev/rules.d/56-dfu-util.rules:**
  50. ```
  51. # stm32duino
  52. SUBSYSTEMS=="usb", ATTRS{idVendor}=="1eaf", ATTRS{idProduct}=="0003", MODE:="0666"
  53. # Generic stm32
  54. SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE:="0666"
  55. ```
  56. ### Le périphérique sériel n'est pas détecté en mode bootloader sous Linux
  57. Assurez-vous que votre kernel ait un support approprié pour votre périphérique. Si votre périphérique utilise USB ACM, par exemple pour les Pro Micro (AtMega32u4), assurez-vous d'inclure `CONFIG_USB_ACM=y`. D'autres périphériques peuvent avoir besoin de `USB_SERIAL` et de ses sous-options.
  58. ## Périphérique inconnu pour le bootloader DFU
  59. Les problèmes rencontrés lorsque l'on flash des claviers sous Windows sont, la plupart du temps, dus à une installation du mauvais pilote, ou un pilote manquant.
  60. Relancer le script d'installation de QMK (`./util/qmk_install.sh` situé dans répertoire `qmk_firmware`sous MSYS2 ou WSL) ou réinstaller la QMK Toolbox peut résoudre le problème. Une alternative est de télécharger et lancer manuellement le package [`qmk_driver_installer`](https://github.com/qmk/qmk_driver_installer).
  61. Si vous rencontrez toujours des problèmes, essayez de télécharger et lancer Zadig. Voir [Installation du driver du bootloader avec Zadig](driver_installation_zadig.md) pour plus d'informations.
  62. ## USB VID et PID
  63. Vous pouvez utiliser l'ID de votre choix en modifier `config.h`. Il y a peu de chance de conflit avec d'autres produits.
  64. La plupart des boards QMK utilisent `0xFEED` comme vendor ID. Vérifiez les autres claviers pour être sûr de choisir un Product ID unique.
  65. Étudiez aussi ce ticket
  66. https://github.com/tmk/tmk_keyboard/issues/150
  67. Vous pouvez acheter un VID:PID unique ici. Je ne pense pas que ce soit nécessaire pour un usage personnel.
  68. - https://www.obdev.at/products/vusb/license.html
  69. - https://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=92&option=com_phpshop&Itemid=1
  70. ## BOOTLOADER_SIZE pour AVR
  71. Notez que la taille du bootloader pour les Teensy2.0++ est de 2048bytes. Quelques Makefiles peuvent contenir une erreur et avoir le mauvais commentaire.
  72. ```
  73. # Boot Section Size in *bytes*
  74. # Teensy halfKay 512
  75. # Teensy++ halfKay 2048
  76. # Atmel DFU loader 4096 (TMK Alt Controller)
  77. # LUFA bootloader 4096
  78. # USBaspLoader 2048
  79. OPT_DEFS += -DBOOTLOADER_SIZE=2048
  80. ```
  81. ## `avr-gcc: internal compiler error: Abort trap: 6 (program cc1)` sous MacOS
  82. C'est un problème de mise à jour avec brew, causée par des liens symboliques (symlinks) dont dépend avr-gcc qui sont détruits.
  83. La solution est de supprimer et réinstaller tous les modules affectés.
  84. ```
  85. brew rm avr-gcc
  86. brew rm dfu-programmer
  87. brew rm dfu-util
  88. brew rm gcc-arm-none-eabi
  89. brew rm avrdude
  90. brew install avr-gcc
  91. brew install dfu-programmer
  92. brew install dfu-util
  93. brew install gcc-arm-none-eabi
  94. brew install avrdude
  95. ```
  96. ### avr-gcc 8.1 et LUFA
  97. Si vous avez mis à jour votre avr-gcc au-dessus de la version 7, vous risquez de voir des erreurs impliquant LUA. Par exemple :
  98. `lib/lufa/LUFA/Drivers/USB/Class/Device/AudioClassDevice.h:380:5: error: 'const' attribute on function returning 'void'`
  99. Pour le moment, vous devrez revenir à la version 7 de avr-gcc dans brew.
  100. ```
  101. brew uninstall --force avr-gcc
  102. brew install avr-gcc@8
  103. brew link --force avr-gcc@8
  104. ```
  105. ### Je viens de flasher mon clavier et il ne fait rien/l'appui des touches n'est pas enregistré - c'est aussi un ARM(rev6 plank, clueboard 60, hs60v2, etc.) (Février 2019)
  106. A cause de la manière dont les EEPROM fonctionnent sur les puces ARM, les options sauvegardées peuvent ne plus être valides. Ceci affecte les calques par défaut et *peut*, sous certaines conditions que nous essayons encore de déterminer, rendre le clavier inutilisable. Réinitialiser l'EEPROM corrigera le problème.
  107. [Réinitialiser EEPROM sur Planck rev6](https://cdn.discordapp.com/attachments/473506116718952450/539284620861243409/planck_rev6_default.bin) peut être utilisé pour forcer une réinitialisation d'EEPROM. Une fois cette image flashée, flashez à nouveau votre firmware standard. Cela devrait rétablir le fonctionnement de votre clavier.
  108. Si bootmagic est activé dans n'importe quel forme, vous devriez être capable de faire aussi ceci (regardez [Documentation Bootmagic](feature_bootmagic.md) et les informations spécifiques à votre clavier).