[Docs] Japanese translation of docs/custom_matrix.md (#8463)

* add docs/ja/custom_matrix.md

* add original document TAG

* update ja/custom_matrix.md

* 「マトリクス」to 「マトリックス」

* docs/ja/custom_matrix.md:update section title

* update docs/ja/custom_matrix.md

* update docs/ja/custom_matrix.md
This commit is contained in:
Takeshi ISHII 2020-03-19 03:37:59 +09:00 committed by GitHub
parent d44ca60cb0
commit 6ba383cc5f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 116 additions and 2 deletions

View File

@ -78,7 +78,7 @@
* [キーロック](ja/feature_key_lock.md) * [キーロック](ja/feature_key_lock.md)
* [レイアウト](ja/feature_layouts.md) * [レイアウト](ja/feature_layouts.md)
* [リーダー キー](ja/feature_leader_key.md) * [リーダー キー](ja/feature_leader_key.md)
* [LED マトリクス](ja/feature_led_matrix.md) * [LED マトリクス](ja/feature_led_matrix.md)
* [マクロ](ja/feature_macros.md) * [マクロ](ja/feature_macros.md)
* [マウスキー](ja/feature_mouse_keys.md) * [マウスキー](ja/feature_mouse_keys.md)
* [OLED ドライバ](ja/feature_oled_driver.md) * [OLED ドライバ](ja/feature_oled_driver.md)
@ -86,7 +86,7 @@
* [ポインティング デバイス](ja/feature_pointing_device.md) * [ポインティング デバイス](ja/feature_pointing_device.md)
* [PS/2 マウス](ja/feature_ps2_mouse.md) * [PS/2 マウス](ja/feature_ps2_mouse.md)
* [RGB ライト](ja/feature_rgblight.md) * [RGB ライト](ja/feature_rgblight.md)
* [RGB マトリクス](ja/feature_rgb_matrix.md) * [RGB マトリクス](ja/feature_rgb_matrix.md)
* [Space Cadet](ja/feature_space_cadet.md) * [Space Cadet](ja/feature_space_cadet.md)
* [分割キーボード](ja/feature_split_keyboard.md) * [分割キーボード](ja/feature_split_keyboard.md)
* [Stenography](ja/feature_stenography.md) * [Stenography](ja/feature_stenography.md)

114
docs/ja/custom_matrix.md Normal file
View File

@ -0,0 +1,114 @@
# カスタムマトリックス
<!---
grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
original document: 0.8.46:docs/custom_matrix.md
git diff 0.8.46 HEAD -- docs/custom_matrix.md | cat
-->
QMKは、デフォルトのマトリックススキャンルーチンを独自のコードで部分的に入れ替えたり全部入れ替えたりしたりするメカニズムを提供します。
この機能を使用する理由は次のとおりです:
* キーボードのスイッチと MCU ピンの間に追加のハードウェアがある場合
* I/O マルチプレクサ
* ラインデコーダー
* 一般的ではないキースイッチマトリックス
* `COL2ROW``ROW2COL` の同時使用
## 前提条件
カスタムマトリックスの実装には、通常、追加のソースファイルのコンパイルが含まれます。
一貫性を保つために、このソースファイルのファイル名は `matrix.c` とすることをお勧めします。
あなたのキーボードディレクトリに新しいファイルを追加します:
```text
keyboards/<keyboard>/matrix.c
```
そして、新しいファイルのコンパイルを指定するため、以下を `rules.mk` に追加します
```make
SRC += matrix.c
```
## マトリックスコードの部分置き換え
カスタムマトリックスを実装する際、定型コードを書かなくてすむように、さまざまなスキャン関数のデフォルト実装を提供しています。
設定するには、以下を `rules.mk` に追加します:
```make
CUSTOM_MATRIX = lite
```
そして、キーボードディレクトリの `matrix.c` ファイルに次の関数を実装します。
```c
void matrix_init_custom(void) {
// TODO: ここでハードウェアの初期化をする
}
bool matrix_scan_custom(matrix_row_t current_matrix[]) {
bool matrix_has_changed = false;
// TODO: ここで、マトリックススキャンを行なう
return matrix_has_changed;
}
```
## マトリックスコードの全面置き換え
スキャンルーチンをさらに変更する必要がある場合は、完全なスキャンルーチンを実装することを選択できます。
設定するには、以下を `rules.mk` に追加します:
```make
CUSTOM_MATRIX = yes
```
そして、キーボードディレクトリの `matrix.c` ファイルに次の関数を実装します。
```c
matrix_row_t matrix_get_row(uint8_t row) {
// TODO: 要求された行データを返します
}
void matrix_print(void) {
// TODO: printf() を使って現在のマトリックスの状態をコンソールにダンプします
}
void matrix_init(void) {
// TODO: ここでハードウェアとグローバルマトリックスの状態を初期化します
// ハードウェアによるデバウンスがない場合 - 設定されているデバウンスルーチンを初期化します
debounce_init(MATRIX_ROWS);
// 正しいキーボード動作のためにこれを呼び出す*必要があります*
matrix_init_quantum();
}
uint8_t matrix_scan(void) {
bool matrix_has_changed = false;
// TODO: ここにマトリックススキャンルーチンを追加します
// ハードウェアによるデバウンスがない場合 - 設定されているデバウンスルーチンを使用します
debounce(raw_matrix, matrix, MATRIX_ROWS, changed);
// 正しいキーボード動作のためにこれを呼び出す*必要があります*
matrix_scan_quantum();
return matrix_has_changed;
}
```
また、次のコールバックのデフォルトも提供します。
```c
__attribute__((weak)) void matrix_init_kb(void) { matrix_init_user(); }
__attribute__((weak)) void matrix_scan_kb(void) { matrix_scan_user(); }
__attribute__((weak)) void matrix_init_user(void) {}
__attribute__((weak)) void matrix_scan_user(void) {}
```