keychron_qmk_firmware/docs/ja/newbs_testing_debugging.md

テストとデバッグ

カスタムファームウェアをキーボードへ書き込んだら、テストする準備が整います。運が良ければ全て問題なく動作しているはずですが、もしそうでなければこのドキュメントがどこが悪いのか調べるのに役立ちます。

テスト

通常、キーボードをテストするのは非常に簡単です。 全てのキーをひとつずつ押して、期待されるキーが送信されていることを確認します。 QMK を実行していなくても、QMK Configurator のテストモードを使ってキーボードを確認することができます。

デバッグ :id=debugging

rules.mkへCONSOLE_ENABLE = yesの設定をするとキーボードはデバッグ情報を出力します。デフォルトの出力は非常に限られたものですが、デバッグモードをオンにすることでデバッグ情報の量を増やすことが出来ます。キーマップのDEBUGキーコードを使用するか、デバッグモードを有効にする コマンド 機能を使用するか、以下のコードをキーマップに追加します。

void keyboard_post_init_user(void) {
  // Customise these values to desired behaviour
  debug_enable=true;
  debug_matrix=true;
  //debug_keyboard=true;
  //debug_mouse=true;
}

デバッグツール :id=debugging-tools

キーボードのデバッグに使えるツールは2つあります。

QMK Toolboxを使ったデバッグ

互換性のある環境では、QMK Toolboxを使うことでキーボードからのデバッグメッセージを表示できます。

hid_listenを使ったデバッグ

ターミナルベースの方法がお好みですか？PJRC が提供するhid_listenもデバッグメッセージの表示に使用できます。ビルド済みの実行ファイルは Windows, Linux, MacOS 用が用意されています。

独自のデバッグメッセージを送信する

custom code内からデバッグメッセージを出力すると便利な場合があります。それはとても簡単です。ファイルの先頭にprint.hのインクルードを追加します:

#include <print.h>

そのあとは、いくつかの異なった print 関数を使用することが出来ます。

• print("string"): シンプルな文字列を出力します
• uprintf("%s string", var): フォーマットされた文字列を出力します
• dprint("string") デバッグモードが有効な場合のみ、シンプルな文字列を出力します
• dprintf("%s string", var): デバッグモードが有効な場合のみ、フォーマットされた文字列を出力します

デバッグの例

以下は現実世界での実際のデバッグ手法の例を集めたものです。追加情報はDebugging/Troubleshooting QMKを参照してください。

マトリックス上のどの場所でキー押下が起こったか？

移植する、PCBの問題を診断する場合、キー入力が正しくスキャンされているかどうかを確認することが役立つ場合があります。この手法でのロギングを有効化するには、keymap.cへ以下のコードを追加します。

bool process_record_user(uint16_t keycode, keyrecord_t *record) {
  // コンソールが有効化されている場合、マトリックス上の位置とキー押下状態を出力します
#ifdef CONSOLE_ENABLE
    uprintf("KL: kc: %u, col: %u, row: %u, pressed: %u\n", keycode, record->event.key.col, record->event.key.row, record->event.pressed);
#endif 
  return true;
}

出力の例

Waiting for device:.......
Listening:
KL: kc: 169, col: 0, row: 0, pressed: 1
KL: kc: 169, col: 0, row: 0, pressed: 0
KL: kc: 174, col: 1, row: 0, pressed: 1
KL: kc: 174, col: 1, row: 0, pressed: 0
KL: kc: 172, col: 2, row: 0, pressed: 1
KL: kc: 172, col: 2, row: 0, pressed: 0

キースキャンにかかる時間の測定

パフォーマンスの問題をテストする場合、スイッチマトリックスをスキャンする頻度を知ることが役立ちます。この手法でのロギングを有効化するにはconfig.hへ以下のコードを追加します。

#define DEBUG_MATRIX_SCAN_RATE

出力例

  > matrix scan frequency: 315
  > matrix scan frequency: 313
  > matrix scan frequency: 316
  > matrix scan frequency: 316
  > matrix scan frequency: 316
  > matrix scan frequency: 316