# ログの説明

このドキュメントでは、SDK から出力されるログファイルのフォーマットおよび  
コマンド送受信ログの確認方法について説明します。

---

## ログファイル仕様

SDK 内部での通信ステータス、送受信データ、エラー情報などが記録されます。

```{list-table}
:align: left
:class: list-table

* - 項目
  - 内容
* - **用途**
  - SDK の内部動作確認、障害解析、通信状況の把握
* - **ファイル名形式**
  - `SDK_yyyyMMdd_HHmmss.log`
* - **ファイル生成タイミング**
  - アプリを再起動するたびに新しいログファイルを作成
* - **保存場所**
  - アプリの内部ストレージ  
  [LogType](api/Enum.md#logtype)を参照

```

---

## ログの書式

ログは、以下の形式で出力されます。


```{code-block}
:caption: 書式

Time + [LogLevelName] + TagName + Content + [WriteThreadID] [LogThreadID]
```

```{list-table}
:align: left
:class: list-table

* - 要素
  - 説明
* - **Time**
  - ログの出力タイムスタンプ（書式: `yyyy/MM/dd HH:mm:ss`）
* - **LogLevelName**
  - ログレベル  
    - `Fatal`: USB通信スレッドイベントの Exception 発生時  
    - `Error`: 通信エラー  
    - `Warn`: タイムアウト監視  
    - `Info` / `Debug`: SDK内部のメソッド呼び出し
* - **TagName**
  - 出力元のクラス名
* - **Content**
  - ログ内容
* - **WriteThreadID**
  - ログを出力したスレッド ID
* - **LogThreadID**
  - ログ処理を行ったスレッド ID
```

```{code-block}
:caption: ログの例

2025/07/07 15:34:31 [Info ] BLEConnect TX: 02 01 00 07 00 00 FF FF FF FF 03 04 [Write Thread ID : 763 ] [Log Thread ID : 52]
```

---

## コマンド送受信ログの確認方法

### BLE 通信

```{list-table}
:align: left
:class: list-table

* - 内容
  - キーワード
* - **送信**
  - `BLEConnect TX:`
* - **受信**
  - `BLEConnect RX:`
* - **送信したデータ**
  - `onDataSent`
```

```{code-block}
:caption: BLE ログ例

2025/07/07 15:34:31 [Info ] BLEConnect TX: 02 01 00 07 00 00 FF FF FF FF 03 04 [Write Thread ID : 763 ] [Log Thread ID : 52]

2025/07/07 15:34:31 [Info ] BLEConnect onDataSent : (0x) 02-01-00-07-00-00-FF-FF-FF-FF-03-04 [Write Thread ID : 2 ] [Log Thread ID : 52]

2025/07/07 15:34:32 [Info ] BLEConnect RX: 02 01 00 07 00 01 FF FF FF FF 03 05 [Write Thread ID : 2 ] [Log Thread ID : 52]
```

---

### USB 通信

```{list-table}
:align: left
:class: list-table

* - 内容
  - キーワード
* - **送信**
  - `USBManager bulkTransfer send :`
* - **受信**
  - `USBManager Receive data read:`
* - **エラー**
  - `[Error]`
* - **API 呼び出し**
  - `API`
```

```{code-block}
:caption: USB ログ例

2025/07/07 16:49:32 [Info ] USBManager bulkTransfer send : 02 01 00 07 00 00 FF FF FF FF 03 04 [Write Thread ID : 66 ] [Log Thread ID : 57]

2025/07/07 16:49:33 [Info ] USBManager Receive data read: [RX] 02 01 00 07 00 01 FF FF FF FF 03 05 [Write Thread ID : 64 ] [Log Thread ID : 57]

2025/07/07 16:49:53 [Error] 【ASR-A60D SDK】DeviceManager AsReaderが接続されていません [Write Thread ID : 2 ] [Log Thread ID : 57]

2025/07/07 15:02:30 [Info ] AsReaderSDK API: getVersion:2.1.1 [Write Thread ID : 2 ] [Log Thread ID : 52]
```

---

## 補足

- ログは SDK 内部の通信状況・エラー・API 呼び出しを確認するために使用してください。
- トラブル時は送受信データの前後やスレッド ID を合わせて確認するのが有効です。