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.

114 lines
3.9 KiB

[Docs] Japanese translation of docs/pr_checklist.md (#10415) * japanese translation of docs/pr_checklist.md * update docs/ja/pr_checklist.md * update docs/ja/pr_checklist.md * update docs/ja/pr_checklist.md * add :id=lite to docs/ja/custom_matrix.md * add :id=... to docs/ja/custom_quantum_functions.md * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md Co-authored-by: shela <shelaf@users.noreply.github.com> * Update docs/ja/pr_checklist.md * Update docs/ja/pr_checklist.md * Update docs/ja/pr_checklist.md Co-authored-by: s-show <s1shimz@gmail.com> * Update docs/ja/pr_checklist.md Co-authored-by: s-show <s1shimz@gmail.com> Co-authored-by: shela <shelaf@users.noreply.github.com> Co-authored-by: s-show <s1shimz@gmail.com>
3 years ago
  1. # カスタムマトリックス
  2. <!---
  3. grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
  4. original document: 0.8.46:docs/custom_matrix.md
  5. git diff 0.8.46 HEAD -- docs/custom_matrix.md | cat
  6. -->
  7. QMKは、デフォルトのマトリックススキャンルーチンを独自のコードで部分的に入れ替えたり全部入れ替えたりしたりするメカニズムを提供します。
  8. この機能を使用する理由は次のとおりです:
  9. * キーボードのスイッチと MCU ピンの間に追加のハードウェアがある場合
  10. * I/O マルチプレクサ
  11. * ラインデコーダー
  12. * 一般的ではないキースイッチマトリックス
  13. * `COL2ROW``ROW2COL` の同時使用
  14. ## 前提条件
  15. カスタムマトリックスの実装には、通常、追加のソースファイルのコンパイルが含まれます。
  16. 一貫性を保つために、このソースファイルのファイル名は `matrix.c` とすることをお勧めします。
  17. あなたのキーボードディレクトリに新しいファイルを追加します:
  18. ```text
  19. keyboards/<keyboard>/matrix.c
  20. ```
  21. そして、新しいファイルのコンパイルを指定するため、以下を `rules.mk` に追加します
  22. ```make
  23. SRC += matrix.c
  24. ```
  25. ## マトリックスコードの部分置き換え :id=lite
  26. カスタムマトリックスを実装する際、定型コードを書かなくてすむように、さまざまなスキャン関数のデフォルト実装を提供しています。
  27. 設定するには、以下を `rules.mk` に追加します:
  28. ```make
  29. CUSTOM_MATRIX = lite
  30. ```
  31. そして、キーボードディレクトリの `matrix.c` ファイルに次の関数を実装します。
  32. ```c
  33. void matrix_init_custom(void) {
  34. // TODO: ここでハードウェアの初期化をする
  35. }
  36. bool matrix_scan_custom(matrix_row_t current_matrix[]) {
  37. bool matrix_has_changed = false;
  38. // TODO: ここで、マトリックススキャンを行なう
  39. return matrix_has_changed;
  40. }
  41. ```
  42. ## マトリックスコードの全面置き換え
  43. スキャンルーチンをさらに変更する必要がある場合は、完全なスキャンルーチンを実装することを選択できます。
  44. 設定するには、以下を `rules.mk` に追加します:
  45. ```make
  46. CUSTOM_MATRIX = yes
  47. ```
  48. そして、キーボードディレクトリの `matrix.c` ファイルに次の関数を実装します。
  49. ```c
  50. matrix_row_t matrix_get_row(uint8_t row) {
  51. // TODO: 要求された行データを返します
  52. }
  53. void matrix_print(void) {
  54. // TODO: printf() を使って現在のマトリックスの状態をコンソールにダンプします
  55. }
  56. void matrix_init(void) {
  57. // TODO: ここでハードウェアとグローバルマトリックスの状態を初期化します
  58. // ハードウェアによるデバウンスがない場合 - 設定されているデバウンスルーチンを初期化します
  59. debounce_init(MATRIX_ROWS);
  60. // 正しいキーボード動作のためにこれを呼び出す*必要があります*
  61. matrix_init_quantum();
  62. }
  63. uint8_t matrix_scan(void) {
  64. bool matrix_has_changed = false;
  65. // TODO: ここにマトリックススキャンルーチンを追加します
  66. // ハードウェアによるデバウンスがない場合 - 設定されているデバウンスルーチンを使用します
  67. debounce(raw_matrix, matrix, MATRIX_ROWS, changed);
  68. // 正しいキーボード動作のためにこれを呼び出す*必要があります*
  69. matrix_scan_quantum();
  70. return matrix_has_changed;
  71. }
  72. ```
  73. また、次のコールバックのデフォルトも提供します。
  74. ```c
  75. __attribute__((weak)) void matrix_init_kb(void) { matrix_init_user(); }
  76. __attribute__((weak)) void matrix_scan_kb(void) { matrix_scan_user(); }
  77. __attribute__((weak)) void matrix_init_user(void) {}
  78. __attribute__((weak)) void matrix_scan_user(void) {}
  79. ```