説明

Windows で Vivado を実行していると、次のようなエラー メッセージが表示されます。

ERROR: [Common 17-143] Path length exceeds 260-Byte maximum allowed by Windows: <LongPathtoFileName>

このエラーは IP コアを生成するときやプロジェクトをアーカイブするときなどによく発生します。

たとえば、[File] → [Archive Project] をクリックして Vivado プロジェクトを圧縮しようとすると、次のようなエラー メッセージが表示されます。

ERROR: [Common 17-143] Path length exceeds 260-Byte maximum allowed by Windows: <LongPathtoFileName>
ERROR: [Coretcl 2-229] (archive_project): Project save_as failed due to the previous error(s).

Vivado の一部のバージョンでは次の警告メッセージが表示されます。

WARNING: [Coretcl 2-232] Detected issues while importing sources. Closing temporary saved as project...
ERROR: [Coretcl 2-230] (archive_project): Received exception while importing sources. Please check for any errors reported in the Tcl Console.

ソリューション

Windows OS が原因でこのエラーが発生します。Windows では、パスの文字数が 260 文字までに制限されます (http://msdn.microsoft.com/en-gb/library/windows/desktop/aa365247(v=vs.85).aspx#maxpath)。

この制限のため、パスの長さが 260 文字を超えると、Vivado Design Suite および Vivado に含まれるツールでエラーが発生することがあります。

このエラーは、IP コアを生成するときやプロジェクトをアーカイブしているときに最もよく発生しますが、これは一部の IP の階層構造が深くなっていることと ((Xilinx Answer 51997) の例を参照)、アーカイブ機能を使用するとプロジェクト内のすべてのパスにアクセスする必要があることが原因です。

コマンド全体およびパスの長さを短くする方法およびこの問題が発生した場合の回避策は、次のとおりです。

• パスの長さを短くするため、パス内の下位ディレクトリにドライブを割り当て、そのアルファベットを使用します。Windows OS では、共有ネットワーク パスをドライブとして割り当てることができます。
  
  たとえば、project_1 というプロジェクトを \\server21\shared\Users\username\workspace\vivado_projects\kintex7\ethernet_lite_hw_demo に作成する場合、\\server21\shared を Z ドライブに割り当ててプロジェクトを Z:\workspace\vivado_projects\kintex7\ethernet_lite_hw_demo に作成するのではなく、\\server21\shared\Users\username\workspace\vivado_projects\kintex7 にドライブを割り当ててプロジェクトを Z:\ethernet_lite_hw_demo
  に作成します。


• subst コマンドを使用します。subst コマンドをスクリプトで使用し、パスの一部を動的に仮想ドライブ文字に割り当てることができます。
  たとえば、Project_1 という Vivado プロジェクトを C:/Users/username/workspace/vivado_projects/kintex7/ethernet_lite_hw_demo/
  
  に作成する場合、次に示すように Vivado の Tcl コンソールまたはスクリプトで subst コマンドを使用して、ユーザー指定のパスを仮想ドライブ文字に割り当てることができます。
  
  exec subst V: C://Users/username/workspace/vivado_projects/kintex7/ethernet_lite_hw_demo
  create_project Project_1 V:/project_1 -part xc7k325tffg900-2
  set_property board xilinx.com:kintex7:kc705:1.0 [current_project]
  
  上記のように設定しておくと、Vivado で C:/Users/username/workspace/vivado_projects/kintex7/ethernet_lite_hw_demo/ の代わりに V: が使用されます。
  
  このプロジェクト用に作成された仮想ドライブを削除するには、Vivado Tcl シェルで「exec subst V: /d」を実行します。
  
  プロジェクトはこの後も C:/Users/username/workspace/vivado_projects/kintex7/ethernet_lite_hw_demo/ に存在します。
  


• Vivado Design Suite または PlanAhead を短くしたパスから起動します。


• 短いパス名の一時ディレクトリを指定して Vivado を起動します (例 : vivado -tempDir c:/temp)。

• アーカイブでパスの長さ制限に到達する場合は、次の例のようにパラメーターを使用して tempDir を指定します。
  
  
  • set_param "project.customTmpDirForArchive" c:/tmp
  • 注記 : Vivado 2015.4 リリースから、archive_project Tcl コマンドに新しいオプション -temp_dir が追加されています。
    このオプションを使用すると、そのコマンドに対してのみ一時ディレクトリを設定できます。
    


• プロジェクト ディレクトリ構造に短いパス名を使用します。


• [スタート] メニューから Vivado ツールを開いた場合、アーカイブが生成されるデフォルト ディレクトリは C:/Users/username/AppData/Roaming/Xilinx/Vivado/.Xil/ になりますが、これよりも短い最初のパスに cd で移動すると、それがアーカイブ パスになります。
  
  


• パスに字数制限のない Linux OS を使用します。