diff options
| author | shela <shelaf@users.noreply.github.com> | 2020-10-13 01:05:28 +0900 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-10-13 01:05:28 +0900 |
| commit | 216f9ed2c147b64b0134e33668121f681969aba9 (patch) | |
| tree | ced55e6bf1ffb8177edc9d617ec73dc2b7e205ed /docs | |
| parent | c66d65df5824510fd56081def55377415b8e136f (diff) | |
| download | qmk_firmware-216f9ed2c147b64b0134e33668121f681969aba9.tar.gz qmk_firmware-216f9ed2c147b64b0134e33668121f681969aba9.zip | |
Update Japanese document. (#10589)
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ja/faq_build.md | 149 |
1 files changed, 69 insertions, 80 deletions
diff --git a/docs/ja/faq_build.md b/docs/ja/faq_build.md index 62c36f249..3c93c0780 100644 --- a/docs/ja/faq_build.md +++ b/docs/ja/faq_build.md | |||
| @@ -1,8 +1,8 @@ | |||
| 1 | # よくあるビルドの質問 | 1 | # よくあるビルドの質問 |
| 2 | 2 | ||
| 3 | <!--- | 3 | <!--- |
| 4 | original document: 0.9.43:docs/faq_build.md | 4 | original document: 0.10.33:docs/faq_build.md |
| 5 | git diff 0.9.43 HEAD -- docs/faq_build.md | cat | 5 | git diff 0.10.33 HEAD -- docs/faq_build.md | cat |
| 6 | --> | 6 | --> |
| 7 | 7 | ||
| 8 | このページは QMK のビルドに関する質問を説明します。まだビルドをしていない場合は、[ビルド環境のセットアップ](ja/getting_started_build_tools.md) および [Make 手順](ja/getting_started_make_guide.md)ガイドを読むべきです。 | 8 | このページは QMK のビルドに関する質問を説明します。まだビルドをしていない場合は、[ビルド環境のセットアップ](ja/getting_started_build_tools.md) および [Make 手順](ja/getting_started_make_guide.md)ガイドを読むべきです。 |
| @@ -18,62 +18,91 @@ | |||
| 18 | 18 | ||
| 19 | あるいは、単純に: | 19 | あるいは、単純に: |
| 20 | 20 | ||
| 21 | $ sudo make <keyboard>:<keymap>:dfu | 21 | $ sudo make <keyboard>:<keymap>:flash |
| 22 | 22 | ||
| 23 | `make` を `sudo` で実行することは一般的には良い考えでは***なく***、可能であれば前者の方法のいずれかを使うべきです。 | 23 | `make` を `sudo` で実行することは一般的には良い考えでは***なく***、可能であれば前者の方法のいずれかを使うべきです。 |
| 24 | 24 | ||
| 25 | ### Linux の `udev` ルール | 25 | ### Linux の `udev` ルール |
| 26 | Linux では、MCU にアクセスするには適切な権限が必要です。ファームウェアを書き込む時に `sudo` を使うか、`/etc/udev/rules.d/` にこれらのファイルを配置することで、アクセスすることができます。権限の追加が完了したら、以下を実行します: | ||
| 27 | ```console | ||
| 28 | sudo udevadm control --reload-rules | ||
| 29 | sudo udevadm trigger | ||
| 30 | ``` | ||
| 31 | 26 | ||
| 32 | **/etc/udev/rules.d/50-atmel-dfu.rules:** | 27 | Linux では、ブートローダデバイスと通信するには適切な権限が必要です。ファームウェアを書き込む時に `sudo` を使うか、`/etc/udev/rules.d/` にこのファイルを配置することで、通信することができます。 |
| 33 | ``` | 28 | |
| 34 | # Atmel ATMega32U4 | 29 | **/etc/udev/rules.d/50-qmk.rules:** |
| 35 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff4", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 36 | # Atmel USBKEY AT90USB1287 | ||
| 37 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ffb", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 38 | # Atmel ATMega32U2 | ||
| 39 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff0", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 40 | ``` | 30 | ``` |
| 31 | # Atmel DFU | ||
| 32 | ### ATmega16U2 | ||
| 33 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FEF", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 34 | ### ATmega32U2 | ||
| 35 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF0", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 36 | ### ATmega16U4 | ||
| 37 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF3", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 38 | ### ATmega32U4 | ||
| 39 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF4", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 40 | ### AT90USB64 | ||
| 41 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF9", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 42 | ### AT90USB128 | ||
| 43 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FFB", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 41 | 44 | ||
| 42 | **/etc/udev/rules.d/54-input-club-keyboard.rules:** | 45 | # Input Club |
| 46 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1C11", ATTRS{idProduct}=="B007", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 43 | 47 | ||
| 44 | ``` | 48 | # STM32duino |
| 45 | # Input Club keyboard bootloader | 49 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1EAF", ATTRS{idProduct}=="0003", TAG+="uaccess", RUN{builtin}+="uaccess" |
| 46 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", ATTRS{idProduct}=="b007", TAG+="uaccess", RUN{builtin}+="uaccess" | 50 | # STM32 DFU |
| 47 | ``` | 51 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="DF11", TAG+="uaccess", RUN{builtin}+="uaccess" |
| 52 | |||
| 53 | # BootloadHID | ||
| 54 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="16C0", ATTRS{idProduct}=="05DF", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 55 | |||
| 56 | # USBAspLoader | ||
| 57 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="16C0", ATTRS{idProduct}=="05DC", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 48 | 58 | ||
| 49 | **/etc/udev/rules.d/55-caterina.rules:** | ||
| 50 | ``` | ||
| 51 | # ModemManager should ignore the following devices | 59 | # ModemManager should ignore the following devices |
| 52 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2a03", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | 60 | # Atmel SAM-BA (Massdrop) |
| 61 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="6124", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 62 | |||
| 63 | # Caterina (Pro Micro) | ||
| 64 | ## Spark Fun Electronics | ||
| 65 | ### Pro Micro 3V3/8MHz | ||
| 66 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1B4F", ATTRS{idProduct}=="9203", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 67 | ### Pro Micro 5V/16MHz | ||
| 68 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1B4F", ATTRS{idProduct}=="9205", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 69 | ### LilyPad 3V3/8MHz (and some Pro Micro clones) | ||
| 70 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1B4F", ATTRS{idProduct}=="9207", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 71 | ## Pololu Electronics | ||
| 72 | ### A-Star 32U4 | ||
| 73 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1FFB", ATTRS{idProduct}=="0101", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 74 | ## Arduino SA | ||
| 75 | ### Leonardo | ||
| 53 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | 76 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" |
| 54 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b4f", ATTRS{idProduct}=="9205", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | 77 | ### Micro |
| 55 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b4f", ATTRS{idProduct}=="9203", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | 78 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0037", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" |
| 79 | ## Adafruit Industries LLC | ||
| 80 | ### Feather 32U4 | ||
| 81 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000C", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 82 | ### ItsyBitsy 32U4 3V3/8MHz | ||
| 83 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000D", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 84 | ### ItsyBitsy 32U4 5V/16MHz | ||
| 85 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000E", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 86 | ## dog hunter AG | ||
| 87 | ### Leonardo | ||
| 88 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2A03", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 89 | ### Micro | ||
| 90 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="2A03", ATTRS{idProduct}=="0037", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" | ||
| 56 | ``` | 91 | ``` |
| 57 | 92 | ||
| 58 | **注意:** 古い(1.12以前の) ModemManager では、フィルタリングは厳密なモードではない場合にのみ動作し、以下のコマンドはその設定を更新することができます。 | 93 | 追加が完了したら、以下を実行します: |
| 59 | ```console | ||
| 60 | printf '[Service]\nExecStart=\nExecStart=/usr/sbin/ModemManager --filter-policy=default' | sudo tee /etc/systemd/system/ModemManager.service.d/policy.conf | ||
| 61 | sudo systemctl daemon-reload | ||
| 62 | sudo systemctl restart ModemManager | ||
| 63 | ``` | ||
| 64 | 94 | ||
| 65 | **/etc/udev/rules.d/56-dfu-util.rules:** | ||
| 66 | ``` | 95 | ``` |
| 67 | # stm32duino | 96 | sudo udevadm control --reload-rules |
| 68 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="1eaf", ATTRS{idProduct}=="0003", TAG+="uaccess", RUN{builtin}+="uaccess" | 97 | sudo udevadm trigger |
| 69 | # Generic stm32 | ||
| 70 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", TAG+="uaccess", RUN{builtin}+="uaccess" | ||
| 71 | ``` | 98 | ``` |
| 72 | 99 | ||
| 73 | **/etc/udev/rules.d/57-bootloadhid.rules:** | 100 | **注意:** 古い(1.12以前の) ModemManager では、フィルタリングは厳密なモードではない場合にのみ動作し、以下のコマンドはその設定を更新することができます。 |
| 101 | |||
| 74 | ``` | 102 | ``` |
| 75 | # bootloadHID | 103 | printf '[Service]\nExecStart=\nExecStart=/usr/sbin/ModemManager --filter-policy=default' | sudo tee /etc/systemd/system/ModemManager.service.d/policy.conf |
| 76 | SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05df", TAG+="uaccess", RUN{builtin}+="uaccess" | 104 | sudo systemctl daemon-reload |
| 105 | sudo systemctl restart ModemManager | ||
| 77 | ``` | 106 | ``` |
| 78 | 107 | ||
| 79 | ### Linux のブートローダモードで Serial デバイスが検知されない | 108 | ### Linux のブートローダモードで Serial デバイスが検知されない |
| @@ -99,46 +128,6 @@ https://github.com/tmk/tmk_keyboard/issues/150 | |||
| 99 | - http://www.obdev.at/products/vusb/license.html | 128 | - http://www.obdev.at/products/vusb/license.html |
| 100 | - http://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=92&option=com_phpshop&Itemid=1 | 129 | - http://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=92&option=com_phpshop&Itemid=1 |
| 101 | 130 | ||
| 102 | ## AVR のための BOOTLOADER_SIZE | ||
| 103 | Teensy2.0++ ブートローダのサイズは 2048 バイトであることに注意してください。一部の Makefile には間違ったコメントがあります。 | ||
| 104 | |||
| 105 | ``` | ||
| 106 | # Boot Section Size in *bytes* | ||
| 107 | # Teensy halfKay 512 | ||
| 108 | # Teensy++ halfKay 2048 | ||
| 109 | # Atmel DFU loader 4096 (TMK Alt Controller) | ||
| 110 | # LUFA bootloader 4096 | ||
| 111 | # USBaspLoader 2048 | ||
| 112 | OPT_DEFS += -DBOOTLOADER_SIZE=2048 | ||
| 113 | ``` | ||
| 114 | |||
| 115 | ## MacOS での `avr-gcc: internal compiler error: Abort trap: 6 (program cc1)` | ||
| 116 | |||
| 117 | これは brew での更新に関する問題で、avr-gcc が依存するシンボリックリンクを壊します。 | ||
| 118 | |||
| 119 | 解決法は全ての影響を受けたモジュールを削除し再インストールすることです。 | ||
| 120 | |||
| 121 | ``` | ||
| 122 | brew rm avr-gcc avr-gcc@8 dfu-programmer dfu-util gcc-arm-none-eabi arm-gcc-bin@8 avrdude qmk | ||
| 123 | brew install qmk/qmk/qmk | ||
| 124 | brew link --force avr-gcc@8 | ||
| 125 | brew link --force arm-gcc-bin@8 | ||
| 126 | ``` | ||
| 127 | |||
| 128 | ### `avr-gcc` と LUFA | ||
| 129 | |||
| 130 | `avr-gcc` を更新し、LUFA に関連するエラーが表示された場合、例えば: | ||
| 131 | |||
| 132 | `lib/lufa/LUFA/Drivers/USB/Class/Device/AudioClassDevice.h:380:5: error: 'const' attribute on function returning 'void'` | ||
| 133 | |||
| 134 | 今のところ、Homebrew で `avr-gcc` を 8 にロールバックする必要があります。 | ||
| 135 | |||
| 136 | ``` | ||
| 137 | brew uninstall --force avr-gcc | ||
| 138 | brew install avr-gcc@8 | ||
| 139 | brew link --force avr-gcc@8 | ||
| 140 | ``` | ||
| 141 | |||
| 142 | ### キーボードに書き込んだが何も起こらない、あるいはキーの押下が登録されない - ARM (rev6 planck、clueboard 60、hs60v2 など) でも同じ (Feb 2019) | 131 | ### キーボードに書き込んだが何も起こらない、あるいはキーの押下が登録されない - ARM (rev6 planck、clueboard 60、hs60v2 など) でも同じ (Feb 2019) |
| 143 | ARM ベースのチップ上での EEPROM の動作によって、保存された設定が無効になる場合があります。これはデフォルトレイヤに影響し、まだ調査中の特定の環境下でキーボードが使えなくなる*しれません*。EEPROM のリセットでこれが修正されます。 | 132 | ARM ベースのチップ上での EEPROM の動作によって、保存された設定が無効になる場合があります。これはデフォルトレイヤに影響し、まだ調査中の特定の環境下でキーボードが使えなくなる*しれません*。EEPROM のリセットでこれが修正されます。 |
| 144 | 133 | ||
