aboutsummaryrefslogtreecommitdiff
path: root/docs/ja/newbs_testing_debugging.md
diff options
context:
space:
mode:
authorshela <shelaf@users.noreply.github.com>2021-06-24 21:54:54 +0900
committerGitHub <noreply@github.com>2021-06-24 21:54:54 +0900
commita53128e9580ff436ff9dfcef041b20363eba7839 (patch)
treedb80b0bb62a0902444c4b0ba909322117f75cf00 /docs/ja/newbs_testing_debugging.md
parenta726ada59b63e45d7d01d8e61b0515ac714f7325 (diff)
downloadqmk_firmware-a53128e9580ff436ff9dfcef041b20363eba7839.tar.gz
qmk_firmware-a53128e9580ff436ff9dfcef041b20363eba7839.zip
[Docs] Update Japanese faq documents (#12842)
* Update Japanese faq documents. * Update Japanese summary. * Update docs/ja/faq_debug.md Co-authored-by: s-show <s1shimz@gmail.com> * Update docs/ja/faq_misc.md Co-authored-by: s-show <s1shimz@gmail.com> * Apply suggestions from code review Co-authored-by: s-show <s1shimz@gmail.com>
Diffstat (limited to 'docs/ja/newbs_testing_debugging.md')
-rw-r--r--docs/ja/newbs_testing_debugging.md99
1 files changed, 4 insertions, 95 deletions
diff --git a/docs/ja/newbs_testing_debugging.md b/docs/ja/newbs_testing_debugging.md
index 41103bae9..d64f0f6df 100644
--- a/docs/ja/newbs_testing_debugging.md
+++ b/docs/ja/newbs_testing_debugging.md
@@ -2,105 +2,14 @@
2 2
3<!--- 3<!---
4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh 4 grep --no-filename "^[ ]*git diff" docs/ja/*.md | sh
5 original document: 0.9.0:docs/newbs_testing_debugging.md 5 original document: 0.12.45:docs/newbs_testing_debugging.md
6 git diff 0.9.0 HEAD -- docs/newbs_testing_debugging.md | cat 6 git diff 0.12.45 HEAD -- docs/newbs_testing_debugging.md | cat
7--> 7-->
8 8
9カスタムファームウェアをキーボードへ書き込んだら、テストする準備が整います。運が良ければ全て問題なく動作しているはずですが、もしそうでなければこのドキュメントがどこが悪いのか調べるのに役立ちます。
10
11## テスト 9## テスト
12 10
13通常、キーボードをテストするのは非常に簡単です。 11[ここに移動しました](ja/faq_misc.md#testing)
14全てのキーをひとつずつ押して、期待されるキーが送信されていることを確認します。
15QMK を実行していなくても、[QMK Configurator](https://config.qmk.fm/#/test/) のテストモードを使ってキーボードを確認することができます。
16 12
17## デバッグ :id=debugging 13## デバッグ :id=debugging
18 14
19`rules.mk`へ`CONSOLE_ENABLE = yes`の設定をするとキーボードはデバッグ情報を出力します。デフォルトの出力は非常に限られたものですが、デバッグモードをオンにすることでデバッグ情報の量を増やすことが出来ます。キーマップの`DEBUG`キーコードを使用するか、デバッグモードを有効にする [コマンド](ja/feature_command.md) 機能を使用するか、以下のコードをキーマップに追加します。 15[ここに移動しました](ja/faq_debug.md#debugging)
20
21```c
22void keyboard_post_init_user(void) {
23 // Customise these values to desired behaviour
24 debug_enable=true;
25 debug_matrix=true;
26 //debug_keyboard=true;
27 //debug_mouse=true;
28}
29```
30
31## デバッグツール :id=debugging-tools
32
33キーボードのデバッグに使えるツールは2つあります。
34
35### QMK Toolboxを使ったデバッグ
36
37互換性のある環境では、[QMK Toolbox](https://github.com/qmk/qmk_toolbox)を使うことでキーボードからのデバッグメッセージを表示できます。
38
39### hid_listenを使ったデバッグ
40
41ターミナルベースの方法がお好みですか?PJRC が提供する[hid_listen](https://www.pjrc.com/teensy/hid_listen.html)もデバッグメッセージの表示に使用できます。ビルド済みの実行ファイルは Windows, Linux, MacOS 用が用意されています。
42
43
44## 独自のデバッグメッセージを送信する
45
46[custom code](ja/custom_quantum_functions.md)内からデバッグメッセージを出力すると便利な場合があります。それはとても簡単です。ファイルの先頭に`print.h`のインクルードを追加します:
47
48```c
49#include "print.h"
50```
51
52そのあとは、いくつかの異なった print 関数を使用することが出来ます。
53
54* `print("string")`: シンプルな文字列を出力します
55* `uprintf("%s string", var)`: フォーマットされた文字列を出力します
56* `dprint("string")` デバッグモードが有効な場合のみ、シンプルな文字列を出力します
57* `dprintf("%s string", var)`: デバッグモードが有効な場合のみ、フォーマットされた文字列を出力します
58
59## デバッグの例
60
61以下は現実世界での実際のデバッグ手法の例を集めたものです。追加情報は[Debugging/Troubleshooting QMK](ja/faq_debug.md)を参照してください。
62
63### マトリックス上のどの場所でキー押下が起こったか?
64
65移植する、PCBの問題を診断する場合、キー入力が正しくスキャンされているかどうかを確認することが役立つ場合があります。この手法でのロギングを有効化するには、`keymap.c`へ以下のコードを追加します。
66
67```c
68bool process_record_user(uint16_t keycode, keyrecord_t *record) {
69 // コンソールが有効化されている場合、マトリックス上の位置とキー押下状態を出力します
70#ifdef CONSOLE_ENABLE
71 uprintf("KL: kc: %u, col: %u, row: %u, pressed: %u\n", keycode, record->event.key.col, record->event.key.row, record->event.pressed);
72#endif
73 return true;
74}
75```
76
77出力の例
78```text
79Waiting for device:.......
80Listening:
81KL: kc: 169, col: 0, row: 0, pressed: 1
82KL: kc: 169, col: 0, row: 0, pressed: 0
83KL: kc: 174, col: 1, row: 0, pressed: 1
84KL: kc: 174, col: 1, row: 0, pressed: 0
85KL: kc: 172, col: 2, row: 0, pressed: 1
86KL: kc: 172, col: 2, row: 0, pressed: 0
87```
88
89### キースキャンにかかる時間の測定
90
91パフォーマンスの問題をテストする場合、スイッチマトリックスをスキャンする頻度を知ることが役立ちます。この手法でのロギングを有効化するには`config.h`へ以下のコードを追加します。
92
93
94```c
95#define DEBUG_MATRIX_SCAN_RATE
96```
97
98出力例
99```text
100 > matrix scan frequency: 315
101 > matrix scan frequency: 313
102 > matrix scan frequency: 316
103 > matrix scan frequency: 316
104 > matrix scan frequency: 316
105 > matrix scan frequency: 316
106```