Main Content

setState

コードとキャリブレーション ファイル (a2l) の生成用のブロック状態の設定

R2020b 以降

ページ内をすべて折りたたむ

    構文

    setState(myCodeMappingObj,block,Name,Value)

    説明

    例

    setState(myCodeMappingObj,block,Name,Value) は、コードとキャリブレーション ファイル (a2l) の生成用に指定されたブロック状態を設定します。この関数を使用して、指定されたブロック状態をストレージ クラスおよびストレージ クラス プロパティの設定にマッピングします。これらの設定は、C コードを生成するためにコード ジェネレーターによって使用されます。または、状態に対するキャリブレーション アクセスを設定します。

    例

    すべて折りたたむ

    モデル ConfigurationRapidPrototypingInterface に対するモデル コード マッピングで、Unit Delay ブロック Delay の状態 X のストレージ クラスを ExportedGlobal に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
setState(cm,"ConfigurationRapidPrototypingInterface/Delay",StorageClass="ExportedGlobal");

    モデル ConfigurationRapidPrototypingInterface に対するモデル コード マッピングで、モデル全体のブロック状態のストレージ クラスを Model default に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
blockHandles = find(cm,"States");
setState(cm,blockHandles,StorageClass="Model default");

    モデル ConfigurationRapidPrototypingInterface に対するモデル コード マッピングで、Unit Delay ブロック Delay の状態 X のコード識別子を dstate_X に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
blockHandles = find(cm,"States");
setState(cm,blockHandles,StorageClass="Model default");
setState(cm,blockHandles,Identifier="dstate_X");

    モデル ConfigurationRapidPrototypingInterface に対するモデル コード マッピングから、Unit Delay ブロック Delay の状態 X に対して構成されたキャリブレーション プロパティを設定します。

    openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
state = find(cm,"State");
setState(cm,state,Export=true);
setState(cm,state,CalibrationAccess="Calibration");
setState(cm,state,CompuMethod="CM_state");
setState(cm,state,DisplayIdentifier="state_X");
setState(cm,state,Format="%4.2");

    入力引数

    すべて折りたたむ

    関数 coder.mapping.api.get の呼び出しによって返されるコード マッピング オブジェクト (モデル コード マッピング)。

    例: myCM

    設定する状態を含むブロックのパスまたはハンドル。複数のブロック状態を指定するには、cell 配列を使用します。

    例: blockHandle

    データ型: char | string | block_handle | cell

    名前と値の引数

    オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に配置しなければなりませんが、ペアの順序は重要ではありません。

    R2021a より前では、コンマを使用して各名前と値を区切り、Name を引用符で囲みます。

    例: StorageClass="ExportedGlobal"

    指定されたブロック状態用に設定するストレージ クラス。事前定義済みのストレージ クラスまたはモデルに関連付けられた Embedded Coder ディクショナリで定義されているストレージ クラスの名前。C コード生成のためのブロックの状態の構成を参照してください。

    生成されたコード内でブロック状態を表す変数の名前。

    データ型: char | string

    データ要素および外部コードによって読み取られるグローバル データの定義を含む C ソース ファイルのファイル名。ストレージ クラス ExportToFile および Volatile に適用されます。

    データ型: char | string

    データ要素が生成コードで呼び出す get 関数の名前。ストレージ クラス GetSet に適用されます。

    データ型: char | string

    データ要素および外部コードによって読み取られるグローバル データの宣言を含む C ヘッダー ファイルのファイル名。ストレージ クラス ExportToFile、GetSet、ImportFromFile、および Volatile に適用されます。

    データ型: char | string

    同じモデルの階層構造の他のモデルで使用されるグローバル データを所有するモデルの名前。グローバル データ定義は、データを所有するモデル用に生成されたコードに含まれます。ストレージ クラス ExportToFile および Volatile に適用されます。

    データ型: char | string

    モデル コンフィギュレーション パラメーター [配列のレイアウト] が [行優先] に設定されている場合、生成されたコード内で多次元配列として表されるデータ要素の次元を保持するかどうかを示すフラグ。ストレージ クラス ExportToFile、GetSet、ImportFromFile、Localizable、および Volatile に適用されます。

    データ型: logical

    データ要素が生成コードで呼び出す set 関数の名前。ストレージ クラス GetSet に適用されます。

    データ型: char | string

    コード ジェネレーターが生成されたコード内でデータ要素の構造体を識別するために使用する名前。ストレージ クラス Bitfield および Struct に適用されます。

    データ型: char | string

    Embedded Coder ディクショナリで定義されたストレージ クラス プロパティ。指定可能な値は、ストレージ クラスの定義に応じて異なります。

    キャリブレーション ファイル (a2l) でブロック状態を生成するには、このプロパティを有効にします。

    キャリブレーション中にブロック状態から単一ビットを抽出する 16 進数形式のマスク値。このプロパティは整数にのみ適用されます。

    データ型: hexadecimal

    ブロック状態のキャリブレーションを有効にするには、Calibration を選択します。ブロック状態の値を表示し、キャリブレーションを無効にするには、NoCalibration を選択します。

    読みやすくするために ECU 内部値を物理値に変換するメソッド名。

    データ型: char | string

    キャリブレーション ツールでの測定目的に応じたブロック状態のオプションの表示名。Simulink モデルのブロックの状態名とは異なります。

    データ型: char | string

    キャリブレーション ツールの測定に指定される特殊な表示形式。この形式の指定は状態の CompuMethod で指定される表示形式よりも優先されます。

    Embedded Coder ディクショナリで定義されている測定サービス インターフェイスの名前を含む string または文字ベクトル。信号、状態、およびデータ ストアの測定サービス インターフェイスを構成することで、データを測定用に生成コードで保持できます。ディクショナリの既定値を使用するには、"Dictionary default" を指定します。状態のデータをコードで保持する必要がない場合は、"Not measured" を指定します。

    測定サービス インターフェイスを構成するには、サービス インターフェイス構成を定義する Embedded Coder ディクショナリをモデルに接続しなければなりません。詳細については、Configure Measurement Service Interfaces for Signals, States, and Data Storesを参照してください。

    データ型: char | string

    バージョン履歴

    R2020b で導入

    参考

    | | | | |

    トピック