qmk/qmk_firmware

[Bug] Random input lag delay when mousekey feature is on

Open

#25,835 opened on 2025年11月28日

GitHub で見る
 (0 comments) (0 reactions) (0 assignees)C (43,867 forks)batch import
bughelp wanted

Repository metrics

Stars
 (20,368 stars)
PR merge metrics
 (平均マージ 20d 9h) (30d で 27 merged PRs)

説明

Describe the Bug

If mousekey is on, keyboard latency is completely random. But if define KEYBOARD_SHARED_EP = yes, this fixes issue, so it might be related to the mouse endpoint. Tested on multiple QMK keyboards, the same random delay behaviour is found on all keyboards with mousekey enabled. All measurements are done via keyboard latency tester. Here are my measurements with 2 variables: mousekey and keyboard shared ep:

Keyboard Used

darkproject/kd83a_bfg_edition

Link to product page (if applicable)

No response

Operating System

Any

qmk doctor Output

Is AutoHotKey / Karabiner installed

  • AutoHotKey (Windows)
  • Karabiner (macOS)

Other keyboard-related software installed

No response

Additional Context

No response

コントリビューターガイド

調査方針
KEYBOARD SHARED EP 設定が USB エンドポイント構成とレポートスケジューリングにどのように影響するかを調査してください。mousekey 機能のエンドポイント割り当てと、それがキーボードエンドポイントとどのように相互作用するかに焦点を当ててください。QMK ファームウェアの USB ディスクリプタ生成とエンドポイント選択コードを調べ、なぜ KEYBOARD SHARED EP を有効にするとランダムな入力遅延が解決されるのかを特定してください。HID レポート転送パスに競合状態やバッファ管理の問題がないか確認してください。
技術スタック
c
領域
backend
Issue 種別
バグ
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
4
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-2日
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
アクティブ
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
明確
前提条件
CUSB protocol basicsQMK basics
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
30