Simulink.dictionary.ArchitecturalData

Simulink データ ディクショナリ内のアーキテクチャ データをプログラムで編集する

R2023b 以降

説明

Simulink.dictionary.ArchitecturalData オブジェクトは、Simulink^® データ ディクショナリの [Architectural Data] セクションを表します。アーキテクチャ データ オブジェクトにより、端子インターフェイス、データ型、システム全体の定数、およびそれらのプラットフォーム プロパティの Simulink およびアーキテクチャ モデル全体における共有定義にプログラムでアクセスできます。アーキテクチャ データ エディターを使用してアーキテクチャ データを管理することもできます。

作成

Simulink.dictionary.archdata.create 関数を使用して新しいデータ ディクショナリを作成できます。この関数は Simulink.dictionary.ArchitecturalData オブジェクトを返します。

dictName = "MyInterfaces.sldd";
archDataObj = Simulink.dictionary.archdata.create(dictName);

既にデータ ディクショナリが作成済みの場合は、Simulink.dictionary.archdata.open 関数を使用してアーキテクチャ データ オブジェクトを作成できます。

dictName = "MyInterfaces.sldd";
archDataObj = Simulink.dictionary.archdata.open(dictName);

プロパティ

DictionaryFileName — データ ディクショナリの名前

文字ベクトル | string スカラー

データ ディクショナリのファイル名。文字ベクトルまたは string スカラーとして指定します。名前には .sldd 拡張子を含める必要があり、有効な MATLAB^® 識別子でなければなりません。

Interfaces — [Architectural Data] セクションで定義されているインターフェイス

インターフェイス オブジェクトの配列

データ ディクショナリの [Architectural Data] セクションで定義されているインターフェイス。プロパティ Description、Elements、Name、および Owner を含む Simulink.dictionary.archdata.DataInterface、Simulink.dictionary.archdata.ServiceInterface、および Simulink.dictionary.archdata.PhysicalInterface オブジェクトの配列として指定します。

DataTypes — [Architectural Data] セクションで定義されているデータ型

Simulink.dictionary.archdata.DataType オブジェクトの配列

データ ディクショナリの [Architectural Data] セクションで定義されているデータ型。プロパティ Name および Owner を含む Simulink.dictionary.archdata.DataType オブジェクトの配列として指定します。

Constants — [Architectural Data] セクションで定義されている定数

Simulink.dictionary.archdata.Constant オブジェクトの配列

定義されている定数。プロパティ Value、Description、DataType、Name、および Owner を含む Simulink.dictionary.archdata.Constant オブジェクトの配列として指定します。

オブジェクト関数

addAliasType	Add Simulink alias type to Architectural Data section of Simulink data dictionary
addConstant	Add constant to Architectural Data section of Simulink data dictionary
addDataInterface	Add data interface to Architectural Data section of Simulink data dictionary
addEnumType	Add enumerated type to Architectural Data section of Simulink data dictionary
addNumericType	Add Simulink numeric type to Architectural Data section of Simulink data dictionary
addPhysicalInterface	Add physical interface to Architectural Data section of Simulink data dictionary
addPlatformMapping	Add AUTOSAR Classic mapping to Architectural Data section of Simulink data dictionary
addReference	データ ディクショナリ参照を Simulink データ ディクショナリの [アーキテクチャ データ] セクションに追加する
addServiceInterface	Add service interface to Architectural Data section of Simulink data dictionary
addStructType	Add structure type to Architectural Data section of Simulink data dictionary
addValueType	Add value type to Architectural Data section of Simulink data dictionary
close	Simulink データ ディクショナリへの開いている接続を閉じる
discardChanges	Discard changes to Simulink data dictionary
findEntryByName	Get object by name in Architectural Data section of Simulink data dictionary
getConstant	Get Simulink.dictionary.archdata.Constant object in Architectural Data section of Simulink data dictionary
getConstantNames	Get constant names in Architectural Data section of Simulink data dictionary
getDataType	Get data type in Architectural Data section of Simulink data dictionary
getDataTypeNames	Get names of data types in Architectural Data section of Simulink data dictionary
getInterface	Get interface object for interface in Architectural Data section of Simulink data dictionary
getInterfaceNames	Get interface names in Architectural Data section of Simulink data dictionary
getPlatformMapping	Get platform mapping object for platform of Simulink data dictionary
getReferences	Get full paths of Simulink data dictionaries referenced by another Simulink data dictionary
importFromBaseWorkspace	Import Simulink object definitions from base workspace to Architectural Data section of Simulink data dictionary
importFromFile	Import Simulink object definitions from file to Architectural Data section of data dictionary
isDirty	Check for unsaved changes in Simulink data dictionary
moveToDesignData	Move interfaces, data types, and constants in Architectural Data section of Simulink data dictionary to design data
moveToDictionary	Move architectural data of Simulink data dictionary to another data dictionary
removeConstant	Remove constant from Architectural Data section of Simulink data dictionary
removeDataType	Remove data type from Architectural Data section of Simulink data dictionary
removeInterface	Remove interface from Architectural Data section of Simulink data dictionary
removeReference	別の Simulink データ ディクショナリの Simulink データ ディクショナリ参照を削除する
removePlatformMapping	Remove platform mapping of Architectural Data section of data dictionary
save	Save changes to Architectural Data section of Simulink data dictionary
show	View architectural data of Simulink data dictionary in Architectural Data Editor
showChanges	View changes to architectural data of Simulink data dictionary in Comparison Tool

例

アーキテクチャ データ オブジェクトの作成と、それを使用したアーキテクチャ データの構成

Simulink データ ディクショナリを作成し、関連付けられているアーキテクチャ データ オブジェクトを返します。

dictName = "MyArchitecturalData.sldd";
archDataObj = Simulink.dictionary.archdata.create(dictName);

型固有の関数を使用して、エイリアス タイプおよび列挙をデータ ディクショナリに追加します。

myAliasType1Obj = addAliasType(archDataObj,"aliasType",BaseType="single");
myAliasType1Obj.Name = "myAliasType1";
myAliasType1Obj.BaseType = "fixdt(1,32,16)";
myAliasType2Obj = addAliasType(archDataObj,"myAliasType2");
myAliasType2Obj.BaseType = myAliasType1Obj;

myEnumType1Obj = addEnumType(archDataObj,"myColor");
addEnumeral(myEnumType1Obj,"RED",'0',"Red Sunset");
addEnumeral(myEnumType1Obj,"BLUE",'1',"Blue Skies");
myEnumType1Obj.DefaultValue = "BLUE";
myEnumType1Obj.Description = "I am a Simulink Enumeration";
myEnumType1Obj.StorageType = 'int16'; 

作成されたエイリアス タイプの基本型を、作成された列挙データ型 myColor に設定できます。

myAliasType3Obj = addAliasType(archDataObj,"myAliasType3");
myAliasType3Obj.BaseType = myEnumType1Obj;
 

addNumericType 関数を使用して、数値型をデータ ディクショナリに追加します。

myNumericType1Obj = addNumericType(archDataObj,"myNumericType1");
myNumericType1Obj.DataTypeMode = "Single";

addValueType を使用して、値のタイプをデータ ディクショナリに追加します。値のタイプのデータ型を、既存のデータ型または作成された列挙データ型に設定することもできます。

myValueType1Obj = addValueType(archDataObj,"myValueType1");
myValueType1Obj.DataType = "int32";
myValueType1Obj.Dimensions = '[2 3]';
myValueType1Obj.Description = "I am a Simulink ValueType";

addStructType 関数を使用して、struct 型をデータ ディクショナリに追加します。

myStructType1Obj = addStructType(archDataObj,"myStructType1");
structElement1 = myStructType1Obj.addElement("Element1");
structElement1.Type.DataType = "single";
structElement1.Type.Dimensions = "3";
structElement2 = addElement(myStructType1Obj,"Element2");
structElement3 = addElement(myStructType1Obj,"Element3");

struct 要素のデータ型を設定するには、データ型オブジェクトを使用するか、string スカラーまたは文字ベクトルとして指定されたデータ型の名前を使用します。

structElement2.Type = myValueType1Obj;
% or
structElement3.Type = "ValueType: myValueType1";

addConstant 関数を使用して定数を追加できます。

myConstantObj = addConstant(archDataObj, "myConst", Value=4);

Simulink.dictionary.archdata.DataInterface オブジェクトの関数を使用して、通信インターフェイスとそのデータ要素を追加できます。

dataInterface1Obj = addDataInterface(archDataObj,"DataInterface");
 
dataElm1 = addElement(dataInterface1Obj,"DE1");
dataElm1.Type = myValueType1Obj;
 
dataElm2 = addElement(dataInterface1Obj,"DE2");
dataElm2.Type = myStructType1Obj;
dataElm2.Dimensions = "4";
dataElm2.Description = "I am a data element with datatype = array of struct type";
 
dataElm3 = addElement(dataInterface1Obj,"DE3");
dataElm3.Type.DataType = "single";
dataElm3.Type.Dimensions = "10";
dataElm3.Type.Minimum = "-5";

サポートされている製品のプラットフォーム マッピングを、データ ディクショナリの [Architectural Data] セクションに追加できます。たとえば、次のプログラムのステップでは、addPlatformMapping 関数を使用して AUTOSAR Classic マッピングを追加しています。

platformMapping = addPlatformMapping(archDataObj,"AUTOSARClassic");

getPlatformProperties (AUTOSAR Blockset) および setPlatformProperty (AUTOSAR Blockset) 関数を使用して、AUTOSAR 通信インターフェイスおよびパッケージ プロパティを取得および設定します。

setPlatformProperty(platformMapping, dataInterface1Obj,...
    "Package","/Interface2","InterfaceKind","NvDataInterface");
[pNames, pValues] = getPlatformProperties(platformMapping,dataInterface1Obj);

データ ディクショナリ コンテンツ用の ARXML コードを生成できるようになりました。

exportedFolder = exportDictionary(platformMapping);

Exporting dictionary, please wait...
Exported dictionary ARXML files are located in: C:\work\MyArchitecturalData.

AUTOSAR Classic プラットフォーム関連の要素、ソフトウェア アドレス メソッド、およびキャリブレーション プロパティを管理します。これらの要素には Simulink へのマッピングはありません。

arProps = autosar.api.getAUTOSARProperties(dictName);
addPackageableElement(arProps,"SwAddrMethod", ... 
    "/SwAddressMethods","VAR1","SectionType","Var");
setPlatformProperty(platformMapping,dataElm1, ...
    SwAddrMethod="VAR1",SwCalibrationAccess="ReadWrite",... 
     DisplayFormat="%.3f");

バージョン履歴

R2023b で導入

参考

ツール

• アーキテクチャ データ エディター

オブジェクト

• Simulink.dictionary.archdata.AliasType | Simulink.dictionary.archdata.Constant | Simulink.dictionary.archdata.DataInterface | Simulink.dictionary.archdata.DataElement | Simulink.dictionary.archdata.EnumType | Simulink.dictionary.archdata.Enumeral | Simulink.dictionary.archdata.FunctionElement | Simulink.dictionary.archdata.FunctionArgument | Simulink.dictionary.archdata.NumericType | Simulink.dictionary.archdata.PhysicalInterface | Simulink.dictionary.archdata.ServiceInterface | Simulink.dictionary.archdata.StructElement | Simulink.dictionary.archdata.ValueType | Simulink.dictionary.archdata.StructType | autosar.dictionary.ARClassicPlatformMapping (AUTOSAR Blockset)

関数

• Simulink.dictionary.archdata.create | Simulink.dictionary.archdata.open | moveToDesignData | moveToDictionary

トピック

• Store Shared Data in Architectural Data Section
• Store Data in Architectural Data Section Programmatically