Main Content

setState

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

R2020b 以降

    説明

    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

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

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

    データ型: hexadecimal

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

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

    データ型: char | string

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

    データ型: char | string

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

    バージョン履歴

    R2020b で導入