coder.asap2.Group

グループ オブジェクトを作成する

R2023b 以降

このページをすべて展開する

説明

グループ オブジェクトを作成して、特性と測定をまとめて表示し、ASAP2 ファイルにエクスポートします。

作成

groupObj = coder.asap2.Group はグループ オブジェクトを作成します。このオブジェクトを使用して、特性、測定、サブグループのリストをグループに対して定義し、ASAP2 ファイルにエクスポートできます。

プロパティ

すべて展開する

カスタム グループの名前を指定します。

例: "CustomGroup_1"

グループのコメントと説明を指定します。

例: "Description of the group"

グループで参照されるパラメーターのリストを指定します。

例: ["Parameter1", "Parameter2"]

グループで参照される信号のリストを指定します。

例: ["Signal1", "Signal2"]

グループの階層のルートを指定します。

例: 1

グループで参照されるサブグループのリストを指定します。

例: ["Subgroup1", "Subgroup2"]

グループに追加で記述する必要のある説明を指定します。

例: "additional information"

例

すべて折りたたむ

ライブ スクリプトを開く

ASAP2 ファイル内のグループの ECU の説明の追加、更新、フィルター処理、検索、および削除を行います。

モデル例を開いて作成

モデル例 "ASAP2Demo" を開きます。 

open_system("ASAP2Demo");

モデルをビルドします。

slbuild("ASAP2Demo");
### Searching for referenced models in model 'ASAP2Demo'.
### Total of 2 models to build.
### Starting serial code generation build.
### Successfully updated the model reference code generation target for: ASAP2DemoModelRef
### Starting build procedure for: ASAP2Demo
### Successful completion of build procedure for: ASAP2Demo

Build Summary

Model reference code generation targets:

Model              Build Reason                                 Status                        Build Duration
============================================================================================================
ASAP2DemoModelRef  Target (ASAP2DemoModelRef.c) did not exist.  Code generated and compiled.  0h 0m 5.4698s

Top model targets:

Model      Build Reason                                         Status                        Build Duration
============================================================================================================
ASAP2Demo  Information cache folder or artifacts were missing.  Code generated and compiled.  0h 0m 11.634s

2 of 2 models built (0 models already up to date)
Build duration: 0h 0m 18.14s

モデルの ECU 説明オブジェクトを作成します。

descObj = coder.asap2.getEcuDescriptions("ASAP2Demo");
Export duration: 0h 0m 0s 93ms

説明オブジェクトで使用可能なグループのリストを取得します。

find(descObj,"Group")
ans = 1×2 string
    "ASAP2Demo"    "ASAP2Demo.ASAP2DemoModelRef.ASAP2DemoModelRef"

グループにフィルターを適用して、Root の設定が true であるグループのリストを取得します。

find(descObj,"Group",Root=true)
ans = 
"ASAP2Demo"

カスタム グループの作成と追加

ASAP2 ファイルに新しいグループを追加するには、カスタム グループを作成します。

GroupObj_GR1 = coder.asap2.Group;
GroupObj_GR1.Name = 'CustomGroup_1';
GroupObj_GR1.LongIdentifier = 'New test group';
GroupObj_GR1.RefCharacteristic = ["ydata3", "ydata4"];
GroupObj_GR1.RefMeasurement = ["ASAP2Demo_Y.Out3", "ASAP2Demo_Y.Out3"];
GroupObj_GR1.Root = true;

カスタム グループを ECU 説明オブジェクトに追加します。

add(descObj,GroupObj_GR1);

グループ プロパティの取得

次のコマンドを使用して、新規に追加されたグループのプロパティを取得します。

get(descObj,"Group","CustomGroup_1")
ans = 
  Group with properties:

                 Name: 'CustomGroup_1'
       LongIdentifier: 'New test group'
    RefCharacteristic: ["ydata3"    "ydata4"]
       RefMeasurement: ["ASAP2Demo_Y.Out3"    "ASAP2Demo_Y.Out3"]
                 Root: 1
             SubGroup: [1×0 string]
           CustomData: [1×0 string]

グループ プロパティの更新

グループのプロパティを変更するには、set 関数を使用します。グループの LongIdentifier フィールドを更新します。

set(descObj,"Group","CustomGroup_1",LongIdentifier="Group 1 new long identifier")

更新した ECU 説明オブジェクトを使用して ASAP2 ファイルを生成し、ASAP2 ファイルにグループ CustomGroup_1 が含まれていることを確認します。

coder.asap2.export("ASAP2Demo",CustomEcuDescriptions=descObj);

グループの削除

新規に追加したグループを説明オブジェクトから削除します。

delete(descObj,"Group","CustomGroup_1");

バージョン履歴

R2023b で導入

参考

| |

トピック