[Altera][TSR] get_pins
[Altera][TSR] get_pins
Usage
get_pins [-compatibility_mode] [-hierarchical] [-no_duplicates] [-nocase] [-nowarn] <filter>
Options
-compatibility_mode | Use simple Tcl matching (Classic Timing Analyzer style) |
-hierarchical | Specifies use of a hierarchical searching method |
-no_duplicates | Do not match duplicated pin names |
-nocase | Specifies case-insensitive node name matching |
-nowarn | Do not issue warnings messages about unmatched patterns |
Valid destinations (string patterns are matched using Tcl string matching) |
Description
デザイン内のピンのコレクションを返します.コレクション内の全てのピン名は,指定パターンとしてマッチします.ワイルドカードは,一度に複数のピンを選択するのに使えます.
このコマンドでは,以下の3つのTcl文字列マッチング方法があります.
- デフォルトの方法
- "-hierarchical"オプションを使う方法
- "-compatibility_mode"オプションを使う方法
デフォルトでは,1階層レベルを分割するために,次から'|'が使われます.特殊文字として扱われ,ワイルドカードにあわせる文字列マッチング実行時に,考慮に入れられます.
デフォルトマッチングスキームが有効なとき,指定されたパターンは絶対ピン名(absolute pin names)(全体の階層パスを含んだ名前)に対してマッチングされます.
パターン内の全ての階層レベルはレベルごとにマッチングされます.書式"
どんな含まれたワイルドカードも,たった1階層レベルしか参照しません.例えば,"*|*"と"*|*|*"は,それぞれ最も高い階層レベルと2番目の階層レベルとを参照するので,異なるコレクションを提供します.
"-hierarchical"マッチングスキームを使うとき,パイプ文字'|'は,特殊文字として扱われ,文字列マッチングの実行時に適用されます.このマッチングスキームは,階層構造を通して強制的に再帰的にに実行します.
指定されたパターンは関係するピンに対してマッチングされる.(どんな階層構造情報も含まれない,直接名(immediate name))
様式"
例えば,"*" と "*|*" は,前者が後者に拡張されるので,性格に同じピンにマッチします.
"-compatibility_mode"マッチングスキームは,全て,絶対的なピン名に対して(for full, absolute pin names.)Classic timing analyzerの文字列マッチング挙動を模擬します.
パイプ文字('|')は,ワイルドカードと使ったときに特殊文字として扱われません.デフォルトマッチングスキームは,ピンのみだけではなく,それらのピンから複製されたピンも返します.(前者のピンから,Quartusによって自動生成されるピンを参照ください(どこかにリンクしてるのかな))
複製されたピンを含めないようにするには,"-no_duplicates"オプションを使ってください.特定の型のコレクションを生成するのに使うwildcardのTcl list,または,TimeQuestextension置換規約が必要です.詳細は,"use_timequest_style_escaping"を参照ください.
Example
# Get regout pin of "reg" cell get_pins -nocase reg|regout # Create a collection of all pins of "reg" cell get_pins reg|* # Create a collection of all pins on the highest hierarachical level set mycollection [get_pins *] # Output pin names. foreach_in_collection pin $mycollection { puts [get_pin_info -name $pin] } # Create a collection of all pins in the design set fullcollection [get_pins -hierarchical *] # Output pin IDs and names. foreach_in_collection pin $fullcollection { puts -nonewline $pin puts -nonewline ": " puts [get_pin_info -name $pin] }
注意事項
英語力の弱い人が適当に訳しています.自分では意味がわかるようにとれたものと,そうでないものとがあります.概要理解の参考にしていただければ幸いですが,オリジナルの英文を参照されることを強く推奨いたします.