| name | hardware-harness |
| description | swbt-python で Nintendo Switch、Bluetooth Classic HID、専用 USB Bluetooth dongle、Bumble adapter、WinUSB/libusb、pairing、HID advertising、report loop、hardware pytest marker を扱う検証の安全境界と記録項目を確認する skill。Bumble adapter open、Switch-facing command、実機テスト、manual bring-up を実行、設計、報告する前に使う。 |
実機検証
Nintendo Switch または専用 USB Bluetooth dongle と通信し得る作業の前に使う。
承認境界
ユーザが範囲を明示承認していない限り、次を実行しない。
- Bumble から USB Bluetooth dongle を開く。
- Bluetooth Classic HID Device として初期化する。
- discoverable / connectable / HID advertising に入る。
- Switch pairing。
- HID control / interrupt channel を開く。
- periodic input report loop。
@pytest.mark.bumble または @pytest.mark.hardware のテスト。
環境変数による実行遮断は採用しない。承認は、会話上の明示承認、対象 adapter、実行 command、Switch-facing 動作の範囲、cleanup plan が揃っているかで判断する。
実行前チェック
- 専用 USB Bluetooth dongle を使っている。
- 内蔵 Bluetooth や常用 adapter を使っていない。
- adapter string が具体的である。例:
usb:0。
- OS と driver state を記録する。Windows では WinUSB assignment を確認する。
- Python version と Bumble version を記録する。
- branch、commit、未コミット変更の有無を確認する。
- Switch model と firmware が分かる場合は記録する。
- cleanup behavior が分かる。
- neutral fail-safe が必要な操作では、送信停止と neutral 復帰の扱いを確認する。
Stop Conditions
- adapter が曖昧である。
- 常用 Bluetooth adapter の可能性がある。
- 承認が adapter open、advertising、pairing、report loop、test scope のどれを対象にするか示していない。
- cleanup behavior が不明である。
- button pressed が残り得るのに neutral fail-safe がない。
記録先
実機観測は spec/hardware-test-log.md に記録する。ファイルがなければ作る。
## YYYY-MM-DD: <短い題名>
- OS:
- environment:
- adapter:
- dongle:
- driver:
- Python:
- Bumble:
- swbt-python:
- Switch model:
- Switch firmware:
- report period:
- command / test:
- approval:
- result:
- artifact:
- cleanup:
- notes:
pytest marker
@pytest.mark.bumble: Switch 実機なしでも USB Bluetooth dongle と Bumble adapter が必要。@pytest.mark.hardware: Switch 実機、pairing、HID channel、input reflection が必要。
CI ではどちらも必須 gate にしない。
報告
実機または dongle を使っていない場合も理由を明示する。使った場合は、承認範囲、command、adapter identity、結果、artifact、cleanup result を報告する。
