ボード ファイル リンターを使用するには、次の手順を実行します。
- 有効性を検証する際は、XML ファイルに DOCTYPE 宣言を追加する必要があります。これは、手動で追加するか、
validate_board_fileコマンドに-doctype_injectオプションを使用します。詳細は、次の手順 5 のコマンドの long help 部分を参照してください。次に、DOCTYPE 宣言の例を示します。<!DOCTYPE board SYSTEM "/proj/xbuilds/<2020.2>_daily_latest/installs/lin64/Vivado/2020.2/data/boards/board_schemas/current/board.dtd"> - DOCTYPE 宣言は、XML ファイルを実際に公開する前に削除する必要があります。これは、DOCTYPE はユーザーには無効なパス (Vivado インストール) が含まれているからです。
- DOCTYPE が含まれていない場合、Vivado で次のような警告メッセージが表示されます。
Warning: [Board 49-117] Board file '/home/mccrohan/tmp/board.xml' did not contain a DOCTYPE declaration or the DOCTYPE declaration did not reference a valid DTD so XML validation is ignored for this file. -
Vivado を起動し、[Tcl Console] ウィンドウで
validate_board_filesを実行します。 -
validate_board_filesは、リンターを起動する新しい Tcl コマンドです。パラメーターとして、ボード XML ファイル (board.xml、preset.xml、part0_pins.xml) を含むディレクトリの名前を指定します。Description: Check whether the XML files describing a board in the given directory are valid. Only supported for board XML files with schema_version>=2.0. The XML files must contain an appropriate DOCTYPE declaration to be fully validated. Examples: <!DOCTYPE board SYSTEM "board.dtd"> <!-- for board.xml --> <!DOCTYPE ip_presets SYSTEM "preset.dtd"> <!-- for preset.xml --> <!DOCTYPE part_info SYSTEM "part0_pins.dtd"> <!-- for part0_pins.xml --> Note that if a project is open and an IP repository loaded, this command will also validate certain IP and Interface attributes used in the board definition against the current IP repository. Syntax: validate_board_files [-doctype_inject <arg>] [-quiet] [-verbose] [<dir>] Returns: ok if all board files are valid Usage: Name Description ------------------------------ [-doctype_inject] The name of a directory containing the dtd files (board.dtd, part0_pins.dtd, preset.dtd) for DOCTYPE injection in board files. If the path is invalid (or does not contain the dtd files), then the injection will not happen. Use "" to inject the default dtd files from the vivado install data path. [-quiet] Ignore command errors [-verbose] Suspend message limits during command execution [<dir>] The name of a directory containing the board files (board.xml, part0_pins.xml, preset.xml) to be checked Categories: Object, Project, XPS, Board