aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTakeshi ISHII <2170248+mtei@users.noreply.github.com>2020-08-17 17:19:52 +0900
committerGitHub <noreply@github.com>2020-08-17 01:19:52 -0700
commit00af37a659c8ef4a1de08830536853fb60dc71a6 (patch)
treeef3334c1a1f2a56a45935392cad647099e6aa9d9
parent792a4802446d0d5b97924bcb305ac0686b4539d8 (diff)
downloadqmk_firmware-00af37a659c8ef4a1de08830536853fb60dc71a6.tar.gz
qmk_firmware-00af37a659c8ef4a1de08830536853fb60dc71a6.zip
[Docs] Japanese translation of docs/proton_c_conversion.md (#9927)
* start translation docs/ja/proton_c_conversion.md * Japanese translation is in progress. * Japanese translation is in progress. * update * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * Update docs/ja/proton_c_conversion.md * update docs/ja/_summary.md: GPIO congtrol
-rw-r--r--docs/ja/_summary.md2
-rw-r--r--docs/ja/proton_c_conversion.md97
2 files changed, 98 insertions, 1 deletions
diff --git a/docs/ja/_summary.md b/docs/ja/_summary.md
index 06c048275..b44b76abc 100644
--- a/docs/ja/_summary.md
+++ b/docs/ja/_summary.md
@@ -132,7 +132,7 @@
132 * [WS2812 ドライバ](ja/ws2812_driver.md) 132 * [WS2812 ドライバ](ja/ws2812_driver.md)
133 * [EEPROM ドライバ](ja/eeprom_driver.md) 133 * [EEPROM ドライバ](ja/eeprom_driver.md)
134 * [シリアル ドライバ](ja/serial_driver.md) 134 * [シリアル ドライバ](ja/serial_driver.md)
135 * [GPIO コンロール](ja/internals_gpio_control.md) 135 * [GPIO ](ja/internals_gpio_control.md)
136 * [キーボード ガイドライン](ja/hardware_keyboard_guidelines.md) 136 * [キーボード ガイドライン](ja/hardware_keyboard_guidelines.md)
137 137
138 * Python 開発 138 * Python 開発
diff --git a/docs/ja/proton_c_conversion.md b/docs/ja/proton_c_conversion.md
new file mode 100644
index 000000000..6e4f7dcb6
--- /dev/null
+++ b/docs/ja/proton_c_conversion.md
@@ -0,0 +1,97 @@
1# キーボードを Proton C を使うように変更
2
3<!---
4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
5 original document: 0.9.46:docs/proton_c_conversion.md
6 git diff 0.9.46 HEAD -- docs/proton_c_conversion.md | cat
7-->
8
9Proton C は Pro Micro の差し替え可能品であるため、簡単に使用することができます。
10このページでは、キーボードを変換するための便利な自動化されたプロセスと、Pro Micro では利用できない Proton C の機能を利用したい場合の手動プロセスについて説明しています。
11
12## 自動で変換
13
14QMK で現在サポートされているキーボードが Pro Micro(または互換ボード)を使用しており、Proton C を使用したい場合は、以下のように make 引数に `CONVERT_TO_PROTON_C=yes` (または `CTPC=yes`) を追加することでファームウェアを生成することができます。
15
16 make 40percentclub/mf68:default CTPC=yes
17
18同じ引数をキーマップの `rules.mk` に追加しても同じことができます。
19
20これは、次のように、`#ifdef` を使用してコード内で使用できる `CONVERT_TO_PROTON_C` フラグを公開します。
21
22```c
23#ifdef CONVERT_TO_PROTON_C
24 // Proton C code
25#else
26 // Pro Micro code
27#endif
28```
29
30`PORTB/DDRB` などが定義されていないというエラーが発生した場合は、ARM と AVR の両方で機能する [GPIO 制御](ja/internals_gpio_control.md) を使用するようにキーボードのコードを変換する必要があります。これは AVR ビルドにまったく影響を与えません。
31
32Proton C には1つのオンボード LED(C13)しかなく、デフォルトでは TXLED(D5) がそれにマップされています。代わりに RXLED(B0) をそれにマッピングしたい場合は、`config.h` に次のように追加してください。
33
34 #define CONVERT_TO_PROTON_C_RXLED
35
36## 機能の変換
37
38下記は ARM ボードに実装されているものに基づいたデフォルトです。
39
40| 機能 | 説明 |
41|--------------------------------------|------------------------------------------------------------------------------------|
42| [オーディオ](ja/feature_audio.md) | 有効 |
43| [RGB ライト](ja/feature_rgblight.md) | 無効 |
44| [バックライト](feature_backlight.md) | ARM が自動コンフィギュレーションを提供できるようになるまで、[タスク駆動 PWM](ja/(feature_backlight.md#software-pwm-driver))が強制されます |
45| USB ホスト (例えば USB-USB コンバータ) | 未サポート (USB ホストコードは AVR 固有のもので、現在 ARM ではサポートされていません。 |
46| [分割キーボード](ja/feature_split_keyboard.md) | 部分的 - 有効にする機能に大きく依存します |
47
48## 手動で変換
49
50`CTPC = yes` を指定せずに Proton C をネイティブで使用するには、`rules.mk` の `MCU`行を変更する必要があります:
51
52```
53MCU = STM32F303
54```
55
56次の変数が存在する場合は削除します。
57
58* `BOOTLOADER`
59* `EXTRA_FLAGS`
60
61最後に、`config.h`のすべてのピン割り当てを STM32 上の同等のものに変換します。
62
63| Pro Micro 左側| Proton C 左側 | | Proton C 右側 | Pro Micro 右側 |
64|--------------|--------------|-|--------------|---------------|
65| `D3` | `A9` | | 5v | RAW (5v) |
66| `D2` | `A10` | | GND | GND |
67| GND | GND | | FLASH | RESET |
68| GND | GND | | 3.3v | Vcc <sup>1</sup> |
69| `D1` | `B7` | | `A2` | `F4` |
70| `D0` | `B6` | | `A1` | `F5` |
71| `D4` | `B5` | | `A0` | `F6` |
72| `C6` | `B4` | | `B8` | `F7` |
73| `D7` | `B3` | | `B13` | `B1` |
74| `E6` | `B2` | | `B14` | `B3` |
75| `B4` | `B1` | | `B15` | `B2` |
76| `B5` | `B0` | | `B9` | `B6` |
77| `B0` (RX LED) | `C13` <sup>2</sup> | | `C13` <sup>2</sup> | `D5` (TX LED) |
78
79また、Proton C の拡張部分にあるいくつかの新しいピンを利用することもできます。
80
81| 左側 | | 右側 |
82|------|-|-------|
83| `A4`<sup>3</sup> | | `B10` |
84| `A5`<sup>4</sup> | | `B11` |
85| `A6` | | `B12` |
86| `A7` | | `A14`<sup>5</sup> (SWCLK) |
87| `A8` | | `A13`<sup>5</sup> (SWDIO) |
88| `A15` | | RESET<sup>6</sup> |
89
90注釈:
91
921. Pro Micro の Vcc は 3.3V または 5V にすることができます。
932. Proton C のオンボード LED は、Pro Micro のように2つはありません、1つだけです。Pro Micro には、RX LED(`D5`) と TX LED(`B0`)があります。
943. `A4` ピンは、スピーカーと共有されています。
954. `A5` ピンは、スピーカーと共有されています。
965. `A13` と `A14` ピンはハードウェアデバッグ (SWD) に使用されます。GPIO にも使えますが、最後に使ってください。
976. RESET を 3.3V とショート(プルアップ)して MCU をリブートします。これは Pro Micro のようにブートローダモードにはならず、MCU をリセットするだけです。