Nios® V プロセッサー・ソフトウェア開発者ハンドブック

ID 743810
日付 7/08/2024
Public
ドキュメント目次

16.5.4.7. set_sw_property

使用方法

set_sw_property <property> <value>

オプション

  • <property>: 設定されているソフトウェア・プロパティーの種類です。
  • <value>: プロパティーに割り当てられた値です。

説明

指定された値を指定されたプロパティーに設定します。このコマンドがサポートするプロパティーは、1 つの値しか保持できません。このコマンドは、特定のプロパティーの既存の (または既定の) 内容を指定された値で上書きします。このコマンドは、デバイスドライバーとソフトウェア・パッケージに適用されます。

このコマンドは、以下のタスクを実行します。

  • hw_class_name—デバイスドライバーがサポートするハードウェアクラスの名前。 ハードウェア・クラス名は、コンポーネント エディタに表示されるComponent Nameでもあります。 例: altera_avalon_uart。 このプロパティーはデバイスドライバーでのみ使用できます。 このプロパティーはすべてのドライバーに必要です。
  • version— このパッケージのバージョン番号。 set_sw_property バージョン番号を使用して、ハードウェア (ペリフェラル) とそのソフトウェア (ドライバー) の間の互換性を判断し、複数の互換性のあるバージョンが利用可能な場合は最新のソフトウェアまたはドライバーを選択します。バージョンは任意の英数字文字列にすることができますが、通常はメジャー リビジョンと 1 つ以上のマイナー リビジョンの整数です。ドット (.) 文字は、メジャー リビジョン番号とマイナー リビジョン番号を区切ります。例: 9.05.0sp13.2.11.このプロパティーはオプションですが、推奨されます。バージョンを指定しない場合、パッケージの最新バージョンが使用されます。
  • min_compatible_hw_version— デバイスドライバーが、指定されたハードウェア・バージョン、またはそれ以降のすべてのバージョンをサポートすることを指定します。このプロパティ-はデバイスドライバーでのみ使用できます。 デバイスドライバーがハードウェア・クラスの 1 つ以上の特定のバージョンのみをサポートしている場合は、代わりにadd_sw_property specific_compatible_hw_versionコマンドを使用してください。 バージョン文字列については、versionプロパティーのドキュメントを参照してください。このプロパティーはオプションです。このプロパティーは、デバイスドライバーでのみ使用できます。
  • auto_initializealt_sys_init.cがパッケージを初期化する必要があることを指定するブール値。 有効にした場合は、INSTANCEマクロとINITマクロを含むヘッダー ファイルを提供する必要があります。

    このプロパティーはオプションです。指定されていない場合、alt_sys_init.c ドライバーまたはソフトウェアへの参照は含まれていません。このプロパティーは、デバイスドライバーとソフトウェア・パッケージでのみ使用できます。

  • bsp_subdirectory— nniosv-bspがこのパッケージのすべてのソースファイルをコピーする最上位ディレクトリーを指定します。 このプロパティーは、最上位の BSP ディレクトリに対する相対パスです。 このプロパティーはオプションです。 指定されていない場合、niosv-bspはドライバーまたはソフトウェア・パッケージを、このソフトウェアを含む BSP のdriversサブディレクトリーにコピーします。
  • alt_sys_init_priority— このプロパティーは、ソフトウェア・パッケージまたはデバイスドライバーに優先順位を割り当てます。このプロパティーを使用して、BSP alt_sys_init.cファイル内のマクロ呼び出しの順序をカスタマイズします。システム内の他のソフトウェアの前または後に、ソフトウェアまたはドライバーを初期化する必要がある場合は、優先度を指定すると便利です。たとえば、ドライバーは、既に初期化されている別のドライバーに依存している場合があります。このプロパティーはオプションです。デフォルトの優先度は1000です。このプロパティーは、デバイスドライバーとソフトウェア・パッケージでのみ使用できます。
  • display_name—このプロパティーは、.tclスクリプトで記述されているソフトウェアを識別するために人間が判読できる名前を表示したいユーザー・インターフェイスやその他のツールに使用されます。display_nameは、ソフトウェアに名前を付ける数単語のテキスト (引用符で囲まれた) に設定されます。例: Intel FPGA Nios V ドライバー。 このプロパティーはオプションです。 設定されていない場合、表示名を使用しようとするツールは、適切なcreate_コマンドで作成されたパッケージ名を使用します。
  • extends_bsp_type—このプロパティーは、オペレーティング・システム (create_osコマンドで作成) が拡張する BSP タイプ (存在する場合) を指定します。 現在、インテル FPGA HAL (HAL) のみがサポートされています。 このコマンドは、 Nios® VプロセッサーBSP ツールで HAL 互換ジェネレーターを使用するすべてのオペレーティング・システムに必要です。 また、オペレーティング・システムで作成された BSP で HAL と互換性のあるインテル HAL、デバイスドライバー、またはソフトウェア パッケージ ソースファイルを必要とするオペレーティング・システムにも必要です。 HAL を拡張するオペレーティング・システムは、HAL をサポートするデバイスドライバーと互換性があると見なされます。このコマンドは、オペレーティング・システムでのみ使用できます。
  • callback_source_file—このプロパティーは、コールバック関数を含む Tcl ソースファイルを指定します。
  • initialization_callback—このプロパティーは、次の環境で実行するための Tcl コールバック関数の名前を指定します。
    • 実行時: 初期化
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: コンポーネントのインスタンス名
  • validation_callback—このプロパティーは、次の環境で実行するための Tcl コールバック関数の名前を指定します。
    • 実行時: 検証
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: コンポーネントのインスタンス名
  • generation_callback—このプロパティーは、次の環境で実行するためのコールバック関数の名前を指定します。
    • 実行時間: 生成
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: コンポーネント・インスタンス名、BSP 生成ターゲット・ディレクトリー、ドライバー BSP サブディレクトリー
  • class_initialization_callback— このプロパティーは、次の環境で実行するためのコールバック関数の名前を指定します。
    • 実行時: 初期化
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: ドライバークラス名
  • class_validation_callback- このプロパティーは、次の環境で実行するためのコールバック関数の名前を指定します。
    • 実行時: 検証
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: ドライバークラス名
  • class_generation_callback- このプロパティーは、次の環境で実行するためのコールバック関数の名前を指定します。
    • 実行時間: 世代
    • スコープ: コンポーネント・インスタンス
    • 関数の引数: ドライバークラス名、BSP 生成ターゲット・ディレクトリー、ドライバー BSP サブディレクトリー
  • supported_interrupt_apis— デバイスドライバーがサポートする割り込み API を指定します。 Nios® Vプロセッサーは拡張 HAL 割り込み API のみをサポートするため、enhanced_interrupt_apiのみを指定します。
注: このプロパティーは、デバイスドライバーでのみ使用できます。
  • isr_preemption_supported— デバイスドライバー ISR がより優先度の高い ISR によってプリエンプトされる場合は、true を指定します。 ISR プリエンプションがサポートされているかどうかを指定しない場合、 Nios® Vプロセッサー・ツールはデバイスドライバーがプリエンプションをサポートしていないことを前提としています。ドライバーに ISR がなく、関連付けられているデバイスに割り込みポートがある場合は、このプロパティーを true に設定できます。
注: このプロパティーは、オペレーティング・システムとデバイスドライバーで有効です。