メインコンテンツ

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

target.create

ターゲット オブジェクトを作成

説明

targetObject = target.create(targetType) は指定されたクラスのオブジェクトを作成して返します。

targetObject = target.create(targetType,Name,Value) は 1 つ以上の名前と値の引数を使用してオブジェクトを設定します。

メモ

以下のクラスについては、オブジェクトの作成とプロパティの指定を 1 つのステップで実行できます。

すべて折りたたむ

この例では、新しいハードウェア デバイスを登録する方法を示します。

新しいハードウェア デバイス用の target.Processor オブジェクトを作成します。

myProc = target.create("Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

言語実装の詳細を指定するための target.LanguageImplementation オブジェクトを作成します。

myLanguageImplementation = target.create("LanguageImplementation", ...
                                          Name="MyProcessorImplementation");

言語実装の詳細を指定します。

myLanguageImplementation.Endianess = target.Endianess.Little;

myLanguageImplementation.AtomicIntegerSize = 64;
myLanguageImplementation.AtomicFloatSize = 64;
myLanguageImplementation.WordSize = 64;

myLanguageImplementation.DataTypes.Char.Size = 8;
myLanguageImplementation.DataTypes.Short.Size = 16;
myLanguageImplementation.DataTypes.Int.Size = 32;
myLanguageImplementation.DataTypes.Long.Size = 64;
myLanguageImplementation.DataTypes.LongLong.IsSupported = true;
myLanguageImplementation.DataTypes.LongLong.Size = 64;
myLanguageImplementation.DataTypes.Float.Size = 32;
myLanguageImplementation.DataTypes.Double.Size = 64;

myLanguageImplementation.DataTypes.Pointer.Size = 32;

myLanguageImplementation.DataTypes.SizeT.Size = 64;
myLanguageImplementation.DataTypes.PtrDiffT.Size = 64;

言語実装をハードウェア デバイスと関連付けます。

myProc.LanguageImplementations = myLanguageImplementation;

target.Processor オブジェクトを内部データベースに追加します。

objectsAdded = target.add(myProc);
target.add summary:

    Objects added to internal database for current MATLAB session:
        target.LanguageImplementation    "MyProcessorImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"
  • MATLAB® Coder™ を使用している場合: [ハードウェア] タブに新しいデバイスが表示されます。また、coder.hardware関数を使用して、このデバイスの coder.Hardware オブジェクトを作成できるようにもなりました。

  • Simulink® Coder™ を使用している場合: [ハードウェア実行] ペインで、[デバイス ベンダー][デバイス タイプ] をそれぞれ MyManufacturerMyProcessor に設定できるようになりました。

オブジェクトを内部データベースから削除するには、以下を入力します。

target.remove(objectsAdded)
target.remove summary:

    Objects removed from internal database:
        target.LanguageImplementation    "MyProcessorImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

新しいハードウェア実行で必要な値のほとんどが既存のハードウェア実行に含まれている場合は、既存の実行のコピーを作成して変更することで、新しい実行を迅速に作成することができます。

新しいハードウェア デバイス用の target.Processor オブジェクトを作成します。

myProc = target.create("Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

既存の言語実装をコピーする target.LanguageImplementation オブジェクトを作成します。

myCopiedImplementation = target.create("LanguageImplementation", ...
                                      Name="MyCopiedImplementation", ...
                                      Copy="Atmel-AVR");

必要な言語実装の詳細を指定します。たとえば、バイト順などです。

myCopiedImplementation.Endianess = target.Endianess.Big;

言語実装をハードウェア デバイスと関連付けます。

myProc.LanguageImplementations = myCopiedImplementation;

target.Processor オブジェクトを内部データベースに追加します。

objectsAdded = target.add(myProc);
target.add summary:

    Objects added to internal database for current MATLAB session:
        target.LanguageImplementation    "MyCopiedImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

オブジェクトを内部データベースから削除するには、以下を入力します。

target.remove(objectsAdded)
target.remove summary:

    Objects removed from internal database:
        target.LanguageImplementation    "MyCopiedImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

ハードウェア デバイスで既存の実行と同じハードウェア実行が必要な場合、既存の実行を再利用できます。

新しいハードウェア デバイス用の target.Processor オブジェクトを作成します。

myProc = target.create( "Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

デバイス ベンダーとタイプについての識別子を使用することで、既存の実行を取得します。

existingImplementation = target.get("LanguageImplementation", ...
                                  "ARM Compatible-ARM Cortex");

言語実装をハードウェア デバイスと関連付けます。

myProc.LanguageImplementations = existingImplementation;

target.Processor オブジェクトを内部データベースに追加します。

objectsAdded = target.add(myProc);
target.add summary:

    Objects added to internal database for current MATLAB session:
        target.Processor                 "MyManufacturer-MyProcessor"
    1 object not added because they already exist.

オブジェクトを内部データベースから削除するには、以下を入力します。

target.remove(objectsAdded);
target.remove summary:

    Objects removed from internal database:
        target.Processor    "MyManufacturer-MyProcessor"

入力引数

すべて折りたたむ

オブジェクトのクラスを指定します。たとえば、次のようになります。

  • 'Processor' を指定すると、target.Processor オブジェクトが作成されます。

  • 'LanguageImplementation' を指定すると、target.LanguageImplementation オブジェクトが作成されます。

  • 'Alias' を指定すると、target.Alias オブジェクトが作成されます。

サポートされるすべてのタイプのリストについては、target を参照してください。

例: 'Processor'

名前と値の引数

すべて折りたたむ

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

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

例: myProc = target.create('Processor', 'Name', 'myProcessor', 'Manufacturer', 'myProcessorManufacturer');

既存のターゲット オブジェクトから値をコピーしてターゲット オブジェクトを作成します。以下に例を示します。

myLangImp = target.create('LanguageImplementation', ...
                          'Name', 'myLanguageImplementation', ...
                          'Copy', 'ARM Compatible-ARM Cortex');

target.create によって生成された ID に接頭辞を追加します。

指定した値に設定されたプロパティでターゲット オブジェクトを作成します。

出力引数

すべて折りたたむ

作成して返されるオブジェクト。たとえば、次のオブジェクトになります。

  • targetType'Processor' の場合は target.Processor オブジェクト

  • targetType'LanguageImplementation' の場合は target.LanguageImplementation オブジェクト

  • targetType'Alias' の場合は target.Alias オブジェクト

バージョン履歴

R2019a で導入