メインコンテンツ

setDataStore

R2026b

コード生成とキャリブレーション ファイル (a2l) 生成用のローカル データ ストアまたは共有ローカル データ ストアを設定する

    説明

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

    例

    例

    すべて折りたたむ

    モデル ConfigurationRapidPrototypingInterface のモデル コード マッピングで、ローカル データ ストア mode のストレージ クラスを ExportedGlobal に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
    cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
    setDataStore(cm,"mode",StorageClass="ExportedGlobal");
    

    モデル ConfigurationRapidPrototypingInterface のモデル コード マッピングで、モデル全体のローカル データ ストアおよび共有ローカル データ ストアのストレージ クラスを Model default に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
    cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
    dsmHandles = find(cm,"DataStores")
    setDataStore(cm,dsmHandles,StorageClass="Model default");
    

    モデル ConfigurationRapidPrototypingInterface のモデル コード マッピングで、ローカル データ ストア mode のコード識別子を ds_mode に設定します。

    openExample("ConfigurationRapidPrototypingInterface");
    cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
    setDataStore(cm,"mode",Identifier="ds_mode");
    

    モデル ConfigurationRapidPrototypingInterface に対するモデル コード マッピングから、ローカル データ ストア mode に対して構成されたキャリブレーション プロパティを設定します。

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

    入力引数

    すべて折りたたむ

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

    例: myCM

    コード マッピング情報を返す Data Store Memory ブロックのパス。文字ベクトルまたは string スカラーとして指定します。あるいは、ブロック ハンドルまたはデータストアの名前を指定できます。データ ストアの名前を指定し、その名前がモデル内で一意でない場合、Simulink® は、ブロック パスまたはハンドルを指定するように指示するエラーを返します。複数のデータ ストアを指定するには、配列を使用します。

    例: blockHandle

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

    名前と値の引数

    すべて折りたたむ

    オプションの引数のペアを 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 で導入