aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorshela <shelaf@users.noreply.github.com>2020-10-13 01:05:28 +0900
committerGitHub <noreply@github.com>2020-10-13 01:05:28 +0900
commit216f9ed2c147b64b0134e33668121f681969aba9 (patch)
treeced55e6bf1ffb8177edc9d617ec73dc2b7e205ed /docs
parentc66d65df5824510fd56081def55377415b8e136f (diff)
downloadqmk_firmware-216f9ed2c147b64b0134e33668121f681969aba9.tar.gz
qmk_firmware-216f9ed2c147b64b0134e33668121f681969aba9.zip
Update Japanese document. (#10589)
Diffstat (limited to 'docs')
-rw-r--r--docs/ja/faq_build.md149
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` ルール
26Linux では、MCU にアクセスするには適切な権限が必要です。ファームウェアを書き込む時に `sudo` を使うか、`/etc/udev/rules.d/` にこれらのファイルを配置することで、アクセスすることができます。権限の追加が完了したら、以下を実行します:
27```console
28sudo udevadm control --reload-rules
29sudo udevadm trigger
30```
31 26
32**/etc/udev/rules.d/50-atmel-dfu.rules:** 27Linux では、ブートローダデバイスと通信するには適切な権限が必要です。ファームウェアを書き込む時に `sudo` を使うか、`/etc/udev/rules.d/` にこのファイルを配置することで、通信することができます。
33``` 28
34# Atmel ATMega32U4 29**/etc/udev/rules.d/50-qmk.rules:**
35SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff4", TAG+="uaccess", RUN{builtin}+="uaccess"
36# Atmel USBKEY AT90USB1287
37SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ffb", TAG+="uaccess", RUN{builtin}+="uaccess"
38# Atmel ATMega32U2
39SUBSYSTEMS=="usb", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="2ff0", TAG+="uaccess", RUN{builtin}+="uaccess"
40``` 30```
31# Atmel DFU
32### ATmega16U2
33SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FEF", TAG+="uaccess", RUN{builtin}+="uaccess"
34### ATmega32U2
35SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF0", TAG+="uaccess", RUN{builtin}+="uaccess"
36### ATmega16U4
37SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF3", TAG+="uaccess", RUN{builtin}+="uaccess"
38### ATmega32U4
39SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF4", TAG+="uaccess", RUN{builtin}+="uaccess"
40### AT90USB64
41SUBSYSTEMS=="usb", ATTRS{idVendor}=="03EB", ATTRS{idProduct}=="2FF9", TAG+="uaccess", RUN{builtin}+="uaccess"
42### AT90USB128
43SUBSYSTEMS=="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
46SUBSYSTEMS=="usb", ATTRS{idVendor}=="1C11", ATTRS{idProduct}=="B007", TAG+="uaccess", RUN{builtin}+="uaccess"
43 47
44``` 48# STM32duino
45# Input Club keyboard bootloader 49SUBSYSTEMS=="usb", ATTRS{idVendor}=="1EAF", ATTRS{idProduct}=="0003", TAG+="uaccess", RUN{builtin}+="uaccess"
46SUBSYSTEMS=="usb", ATTRS{idVendor}=="1c11", ATTRS{idProduct}=="b007", TAG+="uaccess", RUN{builtin}+="uaccess" 50# STM32 DFU
47``` 51SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="DF11", TAG+="uaccess", RUN{builtin}+="uaccess"
52
53# BootloadHID
54SUBSYSTEMS=="usb", ATTRS{idVendor}=="16C0", ATTRS{idProduct}=="05DF", TAG+="uaccess", RUN{builtin}+="uaccess"
55
56# USBAspLoader
57SUBSYSTEMS=="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
52SUBSYSTEMS=="usb", ATTRS{idVendor}=="2a03", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" 60# Atmel SAM-BA (Massdrop)
61SUBSYSTEMS=="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
66SUBSYSTEMS=="usb", ATTRS{idVendor}=="1B4F", ATTRS{idProduct}=="9203", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
67### Pro Micro 5V/16MHz
68SUBSYSTEMS=="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)
70SUBSYSTEMS=="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
73SUBSYSTEMS=="usb", ATTRS{idVendor}=="1FFB", ATTRS{idProduct}=="0101", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
74## Arduino SA
75### Leonardo
53SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" 76SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
54SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b4f", ATTRS{idProduct}=="9205", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" 77### Micro
55SUBSYSTEMS=="usb", ATTRS{idVendor}=="1b4f", ATTRS{idProduct}=="9203", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1" 78SUBSYSTEMS=="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
81SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000C", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
82### ItsyBitsy 32U4 3V3/8MHz
83SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000D", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
84### ItsyBitsy 32U4 5V/16MHz
85SUBSYSTEMS=="usb", ATTRS{idVendor}=="239A", ATTRS{idProduct}=="000E", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
86## dog hunter AG
87### Leonardo
88SUBSYSTEMS=="usb", ATTRS{idVendor}=="2A03", ATTRS{idProduct}=="0036", TAG+="uaccess", RUN{builtin}+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
89### Micro
90SUBSYSTEMS=="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
60printf '[Service]\nExecStart=\nExecStart=/usr/sbin/ModemManager --filter-policy=default' | sudo tee /etc/systemd/system/ModemManager.service.d/policy.conf
61sudo systemctl daemon-reload
62sudo systemctl restart ModemManager
63```
64 94
65**/etc/udev/rules.d/56-dfu-util.rules:**
66``` 95```
67# stm32duino 96sudo udevadm control --reload-rules
68SUBSYSTEMS=="usb", ATTRS{idVendor}=="1eaf", ATTRS{idProduct}=="0003", TAG+="uaccess", RUN{builtin}+="uaccess" 97sudo udevadm trigger
69# Generic stm32
70SUBSYSTEMS=="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 103printf '[Service]\nExecStart=\nExecStart=/usr/sbin/ModemManager --filter-policy=default' | sudo tee /etc/systemd/system/ModemManager.service.d/policy.conf
76SUBSYSTEMS=="usb", ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05df", TAG+="uaccess", RUN{builtin}+="uaccess" 104sudo systemctl daemon-reload
105sudo 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
103Teensy2.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
112OPT_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```
122brew rm avr-gcc avr-gcc@8 dfu-programmer dfu-util gcc-arm-none-eabi arm-gcc-bin@8 avrdude qmk
123brew install qmk/qmk/qmk
124brew link --force avr-gcc@8
125brew 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```
137brew uninstall --force avr-gcc
138brew install avr-gcc@8
139brew 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)
143ARM ベースのチップ上での EEPROM の動作によって、保存された設定が無効になる場合があります。これはデフォルトレイヤに影響し、まだ調査中の特定の環境下でキーボードが使えなくなる*しれません*。EEPROM のリセットでこれが修正されます。 132ARM ベースのチップ上での EEPROM の動作によって、保存された設定が無効になる場合があります。これはデフォルトレイヤに影響し、まだ調査中の特定の環境下でキーボードが使えなくなる*しれません*。EEPROM のリセットでこれが修正されます。
144 133