# ユーザーガイド

haniwers を使用するための総合ガイドです。

:::{admonition} 📌 はじめての方へ

まず [クイックスタート](../quickstart.md) を読んでください。10分で最初の測定ができます。

:::

## 📋 このセクションについて

このセクションでは、haniwers の基本的な使用方法と一般的なワークフローを説明しています。

**段階的に進む場合：**

1. **[クイックスタート](../quickstart.md)** ← 最初にここ
2. **このページ** ← 基本的な概要
3. **[詳細ガイド](../usage/index.md)** ← より詳しい情報

## 🚀 基本的な測定フロー

### ステップ 1: インストール

```bash
pipx install haniwers
haniwers version  # 確認
```

詳細は [インストールガイド](../install.md) を参照。

### ステップ 2: 接続確認

```bash
haniwers ports
```

### ステップ 3: スレッショルド設定

```bash
# 自動検出（推奨）
haniwers scan --ch 1 --duration 10 --vmin 250 --vmax 350
haniwers fit scan_results.csv

# または手動設定
haniwers vth --ch 1 --vth 300
```

### ステップ 4: データ測定

```bash
haniwers daq --duration 60
```

### ステップ 5: データ確認

```bash
haniwers run2csv 1 --save
```

## 📚 詳細ドキュメント

各トピックの詳細な説明：

- **[測定手順](../usage/setup.md)** - 実際の測定プロセス
- **[設定方法](../usage/settings.md)** - 設定ファイルの詳細
- **[標準的なワークフロー](../usage/workflows.md)** - よくあるシナリオ別ガイド
- **[コマンドリファレンス](../command/index.md)** - 全コマンド一覧
- **[設定ファイルリファレンス](../config/index.md)** - TOML 設定の詳細

## 🆘 よくある問題

### ポートが認識されない

```bash
# ポート確認
haniwers ports

# USB接続を確認
# Linux: ls -la /dev/ttyUSB*
# macOS: ls -la /dev/cu.usbserial-*
```

### 測定が開始しない

1. USB接続を確認
2. スレッショルドが設定されているか確認
3. ログを確認：`haniwers daq --log-level DEBUG`

### スレッショルド設定に失敗

```bash
# リトライ回数を増やす
haniwers vth --ch 1 --vth 300 --max-retry 5
```

詳細は [トラブルシューティング](../install.md#トラブルシューティング) を参照。

## 🔗 関連ドキュメント

- **[クイックスタート](../quickstart.md)** - 10分ガイド
- **[インストール](../install.md)** - 詳細なインストール手順
- **[詳細ガイド](../usage/index.md)** - より詳しい説明
- **[API リファレンス](../apidocs/index.md)** - Python API ドキュメント