ログの説明¶

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

ログファイル仕様¶

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

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

ログの書式¶

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

書式¶

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

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

ログの例¶

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 通信¶

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

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 通信¶

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

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 を合わせて確認するのが有効です。