AI エンジンのエラーイベント

このセクションでは、前述の XRT エラーレポート API を使用して取得したエラーの説明と関連するデバッグ情報を示します。これらは AI エンジンアレイから伝搬されるエラーで、ハードウェアでアプリケーション固有のエラーをデバッグする際に役立ちます。

https://github.com/Xilinx/XRT/blob/master/src/runtime_src/core/include/xrt_error_code.h にあるようなクラス XRT_ERROR_CLASS_AIE のエラーの場合、エラーの原因を提供する dmesg ログを有効にすることで詳細情報を取得できます (次の表で詳細を説明)。次に、ログの例を示します。

[18.462615] aie aie0: Asserted tile error event 56 at col 6 row 7
[18.471397] aie aie0: Asserted tile error event 60 at col 25 row 1

注記: タイルの場所は、col と row で示されます。row 0 は SHIM (インターフェイス) タイルで、AI エンジンは row 1 から開始します。

次の表に、エラーのカテゴリ、エラー番号、説明、およびエラーをデバッグして修正するためのヒントを示します。

表 1. CORE モジュールのエラーイベント
エラーグループ	番号	名前	説明	デバッグのヒント
命令エラー	59	Instruction Decompression Error	フェッチされた命令を AI エンジンが解凍できない場合に生成されるエラーイベント。プログラム命令が破損している場合に発生する可能性があります。ELF 生成を検証します。	Vitis コンパイラ (V++) の `--package` コマンドを使用して ELF ファイルを再生成します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
アクセスエラー	55	PM Reg Access Failure	メモリマップド AXI インターフェイスと AI エンジンによる PM へのバンクアクセスの競合により発生するエラー。	AMD サポートまでお問い合わせください。
	60	DM address out of range	AI エンジンが 0x20000 ～ 0x3FFFF 外のメモリロケーションにアクセスしようとすると生成されるイベント。	AI エンジンシミュレータ (`aiesimulator`) を、アクセス違反を通知する `–-enable-memory-check` をイネーブルにして実行します。 `x86simulator` を、アクセス違反を通知する `--valgrind` を使用して実行します。
	65	PM address out of range	PC が範囲外の場合に生成されるイベント。	AI エンジンシミュレータ (`aiesimulator`) を、アクセス違反を通知する `– enable-memory-check` をイネーブルにして実行します。`x86simulator` を、アクセス違反を通知する `--valgrind` を使用して実行します。
	66	DM access to unavailable	AI エンジンが隣接する分離されたタイルへのアクセスを発行した場合に生成されるイベント。	AI エンジンで実行されているカーネルが、分離されたタイル (異なるパーティション) のデータメモリにアクセスしていないかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
バスエラー	58	AXI MM Slave Error	メモリマップド AXI インターフェイススレーブの読み出し/書き込み要求が AI エンジンタイルに存在しないアドレスを指定している場合に生成されるイベント。	PL IP が、メモリマップド AXI インターフェイスを使用して AI エンジンレジスタにアクセスしている場合は、PL IP が無効なレジスタにアクセスしていないかを確認する。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
ストリームエラー	54	TLAST in WSS words 0-2	TLAST が幅の広いストリームの 4 番目のワードにない場合に生成されるイベント。	PL IP を使用してストリームを生成する場合は、TLAST が正しく生成されていることを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	56	Stream Pkt Parity Error	パケットヘッダーにパリティエラーがある場合に生成されるイベント。	パケットを生成する PL IP などのデータソースをチェックし、パケットが有効であるか、またパリティビットが正しく計算されているかを確認します。データが PL IP から出力される場合は、PL IP で生成されたパケットヘッダーを確認します。
	57	Control Pkt Error	制御パケットエラー	パケットを生成する PL IP などのデータソースをチェックし、パケットが正しく生成されているかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
ECC エラー	64	PM ECC Error 2bit	2 ビット ECC エラーが検出された場合に生成されるイベント。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
ECC エラー	62	PM ECC Error Scrub 2bit	ECC スクラバーにより 2 ビット ECC エラーが検出された場合に生成されるイベント。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
ロックエラー	67	Lock Access to unavailable	AI エンジンが隣接する分離されたタイルへのアクセスを発行した場合に生成されるイベント。	AI エンジンシミュレータ (`aiesimulator`) を、アクセス違反を通知する `–-enable-memory-check` をイネーブルにして実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。`x86simulator` を、アクセス違反を通知する `--valgrind` を使用して実行します。
CORE は、AI エンジンタイルの AI エンジンを指します。

表 2. MEMORY モジュールのエラーイベント
エラーグループ	番号	名前	説明	デバッグのヒント
ECC エラー	88	DM ECC Error Scrub 2bit	ECC スクラバーにより DM のバンク 0 またはバンク 1 で 2 ビット ECC エラーが検出された場合に生成されるイベント。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
ECC エラー	90	DM ECC Error 2bit	DM のバンク 0 またはバンク 1 にアクセス中に 2 ビット ECC エラーが検出された場合に生成されるイベント。この DM ECC エラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
メモリパリティエラー	91	DM Parity Error Bank 2	DM バンク 2 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	92	DM Parity Error Bank 3	DM バンク 3 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	93	DM Parity Error Bank 4	DM バンク 4 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	94	DM Parity Error Bank 5	DM バンク 5 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	95	DM Parity Error Bank 6	DM バンク 6 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	96	DM Parity Error Bank 7	DM バンク 7 にアクセス中にパリティエラーが検出された場合に生成されるイベント。この DM パリティエラーは、AI エンジン、タイル DMA、またはメモリマップド AXI インターフェイスからの DM アクセスが原因で発生することがあります。	アプリケーションを再実行します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
DMA エラー	97	DMA S2MM 0 Error	S2MM チャネル 0 の BD タスクキューがフルのときに書き込みを実行すると生成されるエラー。	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	98	DMA S2MM 1 Error	S2MM チャネル 1 の BD タスクキューがフルのときに書き込みを実行すると生成されるエラー。	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	99	DMA MM2S 0 Error	MM2S チャネル 0 の BD タスクキューがフルのときに書き込みを実行すると生成されるエラー。	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	100	DMA MM2S 1 Error	MM2S チャネル 1 の BD タスクキューがフルのときに書き込みを実行すると生成されるエラー。	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。

表 3. SHIM モジュールのエラーイベント
エラーグループ	番号	名前	説明	デバッグのヒント
バスエラー	62	AXI MM Slave Tile Error	インターフェイスタイルに到達したメモリマップド AXI インターフェイススレーブ要求のアドレスが無効な場合に生成されるイベント。	PL IP を使用して、メモリマップド AXI インターフェイスを介して AI エンジンレジスタにアクセスする場合は、IP が間違ったアドレスにアクセスしようとしていないかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	64	AXI MM Decode NSU Error	メモリマップド AXI インターフェイストラフィック内部で DECERR が生成された。たとえば、タイルの列または複数のタイルがクロックゲートされている場合、デコードエラーが内部で生成されると、メモリマップド AXI インターフェイスを介してインターフェイスタイルに伝搬され、このエラーイベントが生成されます。	PL IP を使用して、メモリマップド AXI インターフェイスを介して AI エンジンレジスタにアクセスする場合は、ゲーティングされているタイルに IP がアクセスしようとしているかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	65	AXI MM Slave NSU Error	メモリマップド AXI インターフェイストラフィック内部で SLVERR が生成された。たとえば、そのインターフェイスタイル列にある AI エンジンタイルがスレーブエラーで応答した場合などです。スレーブエラーは、メモリマップド AXI インターフェイスを経由してインターフェイスタイルにスレーブエラーとして伝搬されます。	PL IP を使用して、メモリマップド AXI インターフェイスを介して AI エンジンレジスタにアクセスする場合は、IP が間違ったアドレスにアクセスしようとしていないかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	66	AXI MM Unsupported Traffic	NoC からのメモリマップド AXI インターフェイスが、AI エンジンでサポートされない要求を発行した場合に生成されるイベント。	PL IP を使用して、メモリマップド AXI インターフェイスを介して AI エンジンレジスタにアクセスする場合は、IP がサポートされていないメモリマップド AXI インターフェイス要求を生成していないかを確認します。
	67	AXI MM Unsecure Access in Secure Mode	NoC からのメモリマップド AXI インターフェイスがセキュアモードに違反している (AI エンジンでセキュアトラフィックのみがサポートされる場合に、非セキュアなトラフィックを送信しようとしている)。	AI エンジンアレイがセキュアモードに設定されているかを確認します。
	68	AXI MM Byte Strobe Error	NoC からのメモリマップド AXI インターフェイスが、不完全な 32 ビットワードの書き込みを実行している (32 ビットワード内ですべてのバイトストローブを設定する必要あり)。	PL IP を使用して、メモリマップド AXI インターフェイス経由で AI エンジンレジスタにアクセスする場合は、32 ビットワードに対してすべてのバイトストローブが設定されていることを確認する。
ストリームエラー	63	Control Pkt Error	制御パケットエラー	PL IP が制御パケットを生成している場合は、IP がパケットを正しく生成しているかを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
DMA エラー	69	DMA S2MM 0 Error	DMA S2MM チャネル 0 の DMA エラーを示します。次の原因が考えられます。 BD タスクキューがフルのときに書き込みを実行したメモリアクセス時のデコードエラーメモリアクセス時のスレーブエラー	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。アプリケーションでバッファーディスクリプターを管理する場合は、インターフェイスタイルの DMA バッファーディスクリプターに送信するメモリアドレスが有効であることを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	70	DMA S2MM 1 Error	DMA S2MM チャネル 1 の DMA エラーを示します。次の原因が考えられます。 BD タスクキューがフルのときに書き込みを実行したメモリアクセス時のデコードエラーメモリアクセス時のスレーブエラー	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。アプリケーションでバッファーディスクリプターを管理する場合は、インターフェイスタイルの DMA バッファーディスクリプターに送信するメモリアドレスが有効であることを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	71	DMA MM2S 0 Error	DMA MM2S チャネル 0 の DMA エラーを示します。次の原因が考えられます。 BD タスクキューがフルのときに書き込みを実行したメモリアクセス時のデコードエラーメモリアクセス時のスレーブエラー	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。アプリケーションでバッファーディスクリプターを管理する場合は、インターフェイスタイルの DMA バッファーディスクリプターに送信するメモリアドレスが有効であることを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
	72	DMA MM2S 1 Error	DMA MM2S チャネル 1 の DMA エラーを示します。次の原因が考えられます。 BD タスクキューがフルのときに書き込みを実行したメモリアクセス時のデコードエラーメモリアクセス時のスレーブエラー	アプリケーションでバッファーディスクリプターを管理する場合は、キューがフルのときに新しいバッファーディスクリプターをプッシュしていないことを確認します。アプリケーションでバッファーディスクリプターを管理する場合は、インターフェイスタイルの DMA バッファーディスクリプターに送信するメモリアドレスが有効であることを確認します。これで問題が解決しない場合は、AMD サポートまで問い合わせください。
SHIM は、AI エンジンアレイのインターフェイスタイルを指します。

AI エンジンのエラーイベント - 2023.2 日本語

AI エンジンツールおよびフローユーザーガイド (UG1076)