KVM シリーズ ▾

KVMチュートリアル 01 — 初期設定

対象: ファーストユーザー（Openterface KVMデバイスの初心者）

1. KVM-over-USBとは何か？

KVM (キーボード、ビデオ、マウス) デバイスは、あなたの ホストコンピュータ （ワークステーション）と ターゲットコンピュータ（サーバー、ミニPC、埋め込みデバイス）の間をつなぎます。これは：

  • ターゲットのHDMIビデオ出力（および音声、必要に応じて）をキャプチャ
  • あなたのキーボードとマウス入力をHIDエミュレーションを通じてリレー

USBケーブル一本で行います — ネットワークは必要ありません。

これはKVMデバイスがリモートデスクトップソフトウェアとは異なる点です：BIOS/UEFIの状態や、システムがクラッシュしたときでもターゲットをコントロールできます。

Openterface KVMデバイス

デバイス 形状 主な機能
Mini-KVM コンパクトUSBドングル デスクトップKVM-over-USB
KVM-Go ツールキット風のポータブル キーボードとマウスのエミュレーションを含む、持ち運び可能なKVM。iPadOSに対応（BLE経由）
uConsole KVM Extension 内部モジュール ClockworkPi uConsoleに組み込まれた内蔵KVM

KeyMod（キーボードとマウスエミュレーションのみ、ビデオなし）を探しているなら、KeyModチュートリアルを参照してください。

2. 必要なもの

ハードウェア

  • Openterface KVMデバイス — Mini-KVM、KVM-Go、またはuConsole KVM Extension
  • ホストコンピュータ — macOS、Windows、Linux、またはAndroidを実行している
  • ターゲットコンピュータ — HDMI出力のある任意のコンピュータ
  • HDMIケーブル — ターゲットのHDMI出力をKVMのHDMI入力に接続する
  • USBケーブル — KVMからホストコンピュータへの接続（電源とデータを供給）

任意

  • USBスイッチ用ケーブル — ターゲットデバイスのUSBポートへ接続してキーボード/マウスエミュレーションを行う
  • キーボードとマウス — KVMのUSBスイッチポートに接続してホストまたはターゲットをコントロールする

3. インストール

ホストアプリケーション

プラットフォーム アプリケーション ダウンロード
macOS Openterface for macOS App Store or DMG
Windows Openterface QT GitHub Releases
Linux Openterface QT Flatpak, .deb, .rpm, AppImage
Android Openterface for Android Google Play or GitHub Releases
iPadOS Openterface for iPadOS App Store — KVM-Goのみ

Androidの要件

Androidアプリは以下の要件を満たす必要があります：

  • Android 8.0 (API 26) 以上
  • USB OTGサポート — 大部分の現代スマートフォンがサポートしています（Samsung、Google Pixel、OnePlus）。接続用にUSBフラッシュドライブとOTGアダプターを確認してください
  • USB OTGケーブルまたはアダプタ を使用してKVMデバイスをスマートフォンへ接続する

iPadOSの要件

iPadOSアプリは以下の要件を満たす必要があります：

  • iPadOS 17.0 以上
  • KVM-Goデバイス — iPadOSはKVM-GoドングルとBluetooth Low Energy (BLE) を使用してキーボード/マウス入力を、USBキャプチャカードを使用してビデオを取得します
  • カメラとマイクの許可権 — ビデオプレビューとキャプチャカードからの音声監視が必要です
  • Bluetooth許可権 — KVM-GoドングルとのHID入力の発見と接続に必要な許可権
  • 写真ライブラリ許可権（任意） — 画像スクリーンショットや録画をフォトアプリに保存する

macOSの許可権

初めて起動すると、macOSは以下の許可権を求めます：

許可権 理由
カメラ HDMIキャプチャチップからのビデオキャプチャ
マイク ターゲットからの音声キャプチャ（有効にした場合）
アクセシビリティ 相対モードでのHIDマウスコントロールが必要

Linuxの許可権

  • sudo usermod -a -G dialout,video $USER でユーザーを dialoutとvideoグループに追加する
  • デバイスへのアクセス用udevルールをインストールする
  • BrlTTY衝突: brlttyを削除または、シリアルチップをブラックリスト化 — トラブルシューティング を参照

Windows

  • インストーラーはCH340シリアルドライバをバンドルしています。ポータブル版では別途インストールが必要です。

4. ハードウェア接続

┌─────────────┐ ┌──────────────────┐ │ TARGET │─── HDMI cable ────────▶│ Openterface │ │ COMPUTER │ │ KVM Device │ └─────────────┘ │ │ │ ◄── USB cable ──│── USB switch cable ──▶ Target USB port └──────────────────┘ │ ▼ ┌──────────────────┐ │ HOST COMPUTER │ │ (このアプリ) │ └──────────────────┘

  1. ターゲットの HDMI出力 をKVMの HDMI入力 に接続する
  2. KVMの USB をホストコンピュータの USBポート へ接続する
  3. (任意) USBスイッチケーブルをKVMからターゲットのUSBポートへ接続する
  4. (任意) キーボード/マウスをKVMのUSBスイッチポートに接続する
  5. 電源オン をターゲットデバイスで行う

デバイス検出

KVMは複数のUSBデバイスとしてエントリします：

  • ビデオキャプチャ (MS2109/MS2109S/MS2130S) — ウェブカメラとして表示されます
  • シリアル (CH9329 or CH32V208) — /dev/ttyUSB*（Linux）、COM*（Windows）、cu.usbserial-*（macOS）
  • HID — ファームウェア操作に使用されます

Androidスマートフォン経由での接続

Androidアプリを使用する場合、接続チェーンはUSB OTGを使用します：

┌──────────────┐ HDMI ┌──────────────────┐ │ │ ────────────▶ │ Openterface │ │ Target PC │ │ KVM Device │ │ (screen) │ ◀─────────── │ │ │ │ USB │ │ └──────────────┘ └────────┬─────────┘ │ USB OTG │ ┌─────────▼─────────┐ │ Android Phone │ │ (Openterface) │ └──────────────────┘


Androidへの接続順序：

1. **HDMI:** ターゲットのHDMI出力をKVMのHDMI **入力** に接続する
2. **USB（ターゲット）:** ターゲットのUSBポートをKVMのUSBポートへ接続 — マウス/キーボード信号を運搬します
3. **USB OTG（スマートフォン）:** KVMをAndroidスマートフォンへUSB OTGケーブルまたはアダプター経由で接続する
4. **電源:** KVMデバイスの電源（必要に応じて別途供給）とターゲットコンピュータを電源オンする

正常に接続されると、ビデオプレビューが占拠プレースホルダーからターゲットの実際の画面へ切り替わります。スマートフォンのスクリーンをタップすると、ターゲットでカーソルが移動します。

### iPadOS経由での接続

iPadOSアプリは異なる接続モデルを使用：**BLEによる入力** と **USBキャプチャによるビデオ**。

┌──────────────┐ HDMI ┌──────────────────┐ │ │ ────────────▶ │ KVM-Go Dongle │ │ Target PC │ │ │ │ (screen) │ ◀─── USB ──── │ │ └──────────────┘ └────────┬─────────┘ │ ┌─────────┴─────────┐ │ USB Capture │ (ビデオ) │ BLE (FFF2) │ (キーボード/マウス) └─────────┬─────────┘ │ ┌─────────▼─────────┐ │ iPad │ │ (Openterface) │ └───────────────────┘


iPadOSへの接続順序：

1. **ハードウェア:** KVM-GoドングルをターゲットPCのUSBポートへ接続し、HDMI入力へ接続する
2. **電源オン** をターゲットコンピュータで行う
3. **アプリを開く** そしてカメラ、マイク、Bluetooth許可権を許可する
4. **BLEボタンをタップ** ツールバー — アプリは`kvm*`と名付けられたデバイスをスキャンします
5. KVM-Goデバイスの横に表示された「接続」ボタンをタップし、緑色に変化してRSSI信号強度が表示される
6. **確認:** ビデオプレビューがターゲットの画面に切り替わり、タップするとクリックが送られ、タイプするとキーボード入力が行われます

> **注意:** iPadOSアプリはKVM-Goのみに対応します。Mini-KVMとuConsole KVM ExtensionにはBLEサポートがありません。

---

## 5. 初回起動

### メインウィンドウ

┌─────────────────────────────────────────────────────────┐ │ Menu Bar / Toolbar │ ├─────────────────────────────────────────────────────────┤ │ │ │ VIDEO DISPLAY AREA │ │ (ターゲットデバイスの画面を表示) │ │ │ ├─────────────────────────────────────────────────────────┤ │ Status Bar │ Port │ Keys │ Mouse │ Resolution │ │ └─────────────────────────────────────────────────────────┘


### Androidの許可権

初めて起動すると、Androidアプリは以下の許可権を求めます：

| 許可権 | 理由 | 拒否された場合に起こること |
|---|---|---|
| **USBホスト** | Openterfaceハードウェアと通信する | KVMデバイスが検出されない |
| **カメラ** | HDMIキャプチャチップからのビデオ受信 | ビデオプレビューがない |
| **ストレージ** | スクリーンショットや録画の保存 | キャプチャを保存できない |

すべての許可権を許可することでフル機能が使用できます。KVMデバイスが検出されたときにシステムUSB許可権ダイアログも表示されます — **許可** をタップします。

### iPadOSの許可権

初めて起動すると、iPadOSアプリは以下の許可権を求めます：

| 許可権 | 理由 | 拒否された場合に起こること |
|---|---|---|
| **カメラ** | HDMIキャプチャカードからのビデオ受信 | ビデオプレビューがない |
| **マイク** | ターゲットPCの音声をiPadスピーカーで監視する | 音声監視ができない |
| **Bluetooth** | KVM-Goとの接続とHID入力の発見 | キーボード/マウス入力を送信できない |
| **写真ライブラリ** | スクリーンショットや録画を保存する | 画像はアプリドキュメントフォルダに保存される |

許可権を拒否してしまった場合は、[設定 > プライバシー & セキュリティ] を開いて再許可します。

### 接続確認

- **HDMIインジケーター:** 緑 = 信号検出、オレンジ = 信号なし、グレー = 不明
- **キーボードインジケーター:** 緑 = 接続、オレンジ = 找からない、グレー = 不明
- **マウスインジケーター:** 緑 = 接続、オレンジ = 找からない、グレー = 不明
- **シリアルポート:** ポート名とバーボードレート（9600または115200）が表示されるべきです

インジケーターがオレンジやグレーに表示された場合は、[トラブルシューティング](04-troubleshooting.md) を参照してください。

---

## 6. 基本的なKVMコントロール

### マウスモード

| モード | 説明 | 最適な用途 |
|------|-------------|----------|
| **絶対値**（デフォルト） | ホストのカーソルがターゲット画面に直接マッピングされる | 一般的な使用、GUIナビゲーション |
| **相対値 (HID)** | HID経由でマウス移動をdeltaとして送信する | ゲーミング、高速なインタラクション |

ツールバーの切り替えまたは**Control > マウスモード** で切り替える。

### キーボード入力

アプリウィンドウがフォーカスしている間はすべてのキーボード入力をターゲットに転送されます：
- 標準キー、機能キー、modifierキー
- 特殊キー: Ctrl+Alt+Del, Print Screen
- **ペースト:** クリップボードテキストをエミュレートしたキーボード入力として送信

### USBスイッチング

USBスイッチポートを以下に切り替える：
- **ホスト** — あなたのキーボード/マウスがホストコンピュータをコントロールする
- **ターゲット** — あなたのキーボード/マウスがターゲットコンピュータをコントロールする

---

## 7. 次のステップ

- **[基本操作 →](02-basic-operations.md)** — マウス、キーボード、ビデオ、音声、録画
- **[高度な機能 →](03-advanced-features.md)** — EDID、ファームウェア、マクロ、スクリプト
- **[トラブルシューティング →](04-troubleshooting.md)** — 常見の問題と解決策