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

coder.asap2.Function

関数オブジェクトを作成する

R2022b 以降

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

説明

関数オブジェクトを作成して、関数の説明を定義して ASAP2 ファイルにエクスポートします。

作成

userFunction = coder.asap2.Function は関数オブジェクトを作成します。このオブジェクトを使用して、新しい関数の説明を定義して ASAP2 ファイルにエクスポートできます。

プロパティ

すべて展開する

関数の名前を指定します。

例: "CustomFunction_1"

カスタム関数のコメントや説明を指定します。

例: "Description of the function"

カスタム関数のバージョンを指定します。

例: "Custom_Function_version"

複数行の ASCII 説明テキストとして表された一連のメモ。

例: "Custom_Function_Annotation"

入力測定値の配列を指定します。

例: ["measurement1","measurement2"]

出力測定値の配列を指定します。

例: ["measurement1","measurement2"]

ローカル測定値の配列を指定します。

例: ["measurement1","measurement2"]

定義済み特性の配列を指定します。

例: ["characteristic1","characteristic2"]

基準特性の配列を指定します。

例: ["characteristic1","characteristic2"]

サブ関数の配列を指定します。

例: ["function1","function2"]

例

すべて折りたたむ

ライブ スクリプトを開く

この例では、カスタム関数を ASAP2 ファイルに追加する方法について説明します。

ECU 説明オブジェクトの作成

モデルを開いてビルドし、ECU 説明オブジェクトを作成します。

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 21.673s 

Top model targets:

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

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

descObj=coder.asap2.getEcuDescriptions("ASAP2Demo")
descObj = 
  Data with no properties.

カスタム関数の作成

関数オブジェクト テンプレートを作成し、必要なフィールドを追加します。 

userFunction = coder.asap2.Function
userFunction = 
  Function with properties:

                  Name: "undefined"
       FunctionVersion: [1×0 char]
        LongIdentifier: [1×0 char]
            Annotation: [1×0 char]
        InMeasurements: [1×0 string]
       OutMeasurements: [1×0 string]
       LocMeasurements: [1×0 string]
    DefCharacteristics: [1×0 string]
    RefCharacteristics: [1×0 string]
          SubFunctions: [1×0 string]


userFunction.Name = 'Custom_Function1'
userFunction = 
  Function with properties:

                  Name: 'Custom_Function1'
       FunctionVersion: [1×0 char]
        LongIdentifier: [1×0 char]
            Annotation: [1×0 char]
        InMeasurements: [1×0 string]
       OutMeasurements: [1×0 string]
       LocMeasurements: [1×0 string]
    DefCharacteristics: [1×0 string]
    RefCharacteristics: [1×0 string]
          SubFunctions: [1×0 string]


userFunction.LongIdentifier = 'Custom Function by user'
userFunction = 
  Function with properties:

                  Name: 'Custom_Function1'
       FunctionVersion: [1×0 char]
        LongIdentifier: 'Custom Function by user'
            Annotation: [1×0 char]
        InMeasurements: [1×0 string]
       OutMeasurements: [1×0 string]
       LocMeasurements: [1×0 string]
    DefCharacteristics: [1×0 string]
    RefCharacteristics: [1×0 string]
          SubFunctions: [1×0 string]

ASAP2 ファイルへの関数のエクスポート

関数を ECU 説明オブジェクトに追加し、説明オブジェクトを使用して ASAP2 ファイルを生成します。

add(descObj,userFunction)
coder.asap2.export("ASAP2Demo",CustomEcuDescriptions=descObj)
Following Characteristics or Measurements with unsupported data types are not exported in ASAP2 file. "ASAP2Demo_DW.ASAP2DemoModelRef_InstanceData"

バージョン履歴

R2022b で導入

参考

|

トピック