コード構成の関数

LibAddSourceFileCustomSection
(file, builtInSection, newSection)

ソースファイルにカスタムセクションを追加します。カスタムセクションはいずれかの組み込みセクションに関連付けなければなりません。Includes、Defines、Types、Enums、Definitions、Declarations、Functions、Documentation のいずれかです。セクションが既に存在する場合は何も起きませんが、組み込みセクションの関連付けに矛盾がある場合はエラーが報告されます。LibAddSourceFileCustomSection は Embedded Coder^® 製品でのみ使用できます。

Arguments

file — ソースファイルの参照

builtInSection — 関連付けられる組み込みセクションの名前

newSection — 新しい (カスタム) セクションの名前

codetemplatelib.tlc の LibAddSourceFileCustomSection を参照してください。

LibAddToCommonIncludes(incFileName)

#include /package の指定項目のリストに項目を追加します。リストのメンバーはそれぞれ一意です。重複するメンバーを追加しようとした場合は何も起こりません。

model.h での #include ステートメントの生成を指定するには、ブロックの TLC メソッドから LibAddToCommonIncludes を呼び出す必要があります。インクルードパスにあるファイルの名前は山かっこで囲んで指定します (例: <sysinclude.h>)。ローカルファイルの名前は山かっこなしで指定します (例: myinclude.h)。LibAddToCommonIncludes の各呼び出しで、指定したファイルがまだ存在していなければリストに追加されます。山かっこで囲んだ名前と囲んでいないファイル名 (例: <math.h> と math.h) は別のものと見なされます。#include ステートメントは model.h の内部に配置されます。

例

LibAddToCommonIncludes("tpu332lib.h")

cachelib.tlc の LibAddToCommonIncludes を参照してください。

LibAddToModelSources(newFile)

LibAddToModelSources は 2 つの目的に使用します。

指定したソースファイルでビルドする必要があることをビルドプロセスに通知します。
生成コード内の SOURCES: file1.c file2.c ... のコメントを更新します。

インライン化 S-Function については、一般に BlockTypeSetup から LibAddToModelSources が呼び出されます。LibAddToModelSources は、このモデルのビルドに使用するソースのリストにファイル名を追加します。LibAddToModelSources は、渡されたファイル名が重複している (つまりソースのリストに既に存在している) 場合は 1、重複していない場合は 0 を返します。

関数 LibAddToModelSources は、S-Function を記述することに加え、TLC で他の目的にも使用できます。独自の S-Function を記述する場合は、LibAddToModelSources の代わりに SFunctionModules ブロックパラメーターを使用します。utils_api.tlc の LibAddToModelSources を参照してください。

LibCacheDefine(buffer)

LibCacheDefine の各呼び出しで、既存のキャッシュバッファーにバッファーが追加されます。ブロックについては、一般に BlockTypeSetup から LibCacheDefine が呼び出されます。

LibCacheDefine は、model_private.h または model.c に含めるために #define ステートメントをキャッシュします。#define ステートメントをキャッシュするには、BlockTypeSetup の内部から LibCacheDefine を呼び出します。LibCacheDefine の各呼び出しで、既存のキャッシュバッファーにバッファーが追加されます。#define ステートメントは model_private.h または model.c の内部に配置されます。

例

%openfile buffer
#define INTERP(x,x1,x2,y1,y2) ( y1+((y2 - y1)/(x2 - x1))*(x-x1))
#define this that
%closefile buffer
%<LibCacheDefine(buffer)>

codecache_api.tlc の LibCacheDefine を参照してください。

LibCacheExtern(buffer)

extern ステートメントをキャッシュするには、BlockTypeSetup の内部から LibCacheExtern を呼び出す必要があります。LibCacheExtern の各呼び出しで、既存のキャッシュバッファーにバッファーが追加されます。extern ステートメントは model_private.h の内部に配置されます。

例

%openfile buffer
 extern real_T mydata;
%closefile buffer
%<LibCacheExtern(buffer)>

codecache_api.tlc の LibCacheExtern を参照してください。

LibCacheFunctionPrototype(buffer)

関数プロトタイプをキャッシュするには、BlockTypeSetup の内部から LibCacheFunctionPrototype を呼び出す必要があります。LibCacheFunctionPrototype の各呼び出しで、既存のキャッシュバッファーにバッファーが追加されます。プロトタイプは model_private.h の内部に配置されます。

例

%openfile buffer
 extern int_T fun1(real_T x);
 extern real_T fun2(real_T y, int_T i);
%closefile buffer
%<LibCacheFunctionPrototype(buffer)>

codecache_api.tlc の LibCacheFunctionPrototype を参照してください。

LibCacheTypedefs(buffer)

typedef 宣言をキャッシュするには、BlockTypeSetup の内部から LibCacheTypedefs を呼び出す必要があります。LibCacheTypedefs の各呼び出しで、既存のキャッシュバッファーにバッファーが追加されます。typedef ステートメントは model.h (または model_common.h) の内部に配置されます。

例

%openfile buffer
typedef foo bar;
%closefile buffer
%<LibCacheTypedefs(buffer)>

codecache_api.tlc の LibCacheTypedefs を参照してください。

LibCallModelInitialize()

モデルの初期化関数を呼び出すコードを返します (ERT でのみ有効)。

codetemplatelib.tlc の LibCallModelInitialize を参照してください。

LibCallModelStep(tid)

モデルのステップ関数を呼び出すコードを返します (ERT でのみ有効)。

codetemplatelib.tlc の LibCallModelStep を参照してください。

LibCallModelTerminate()

モデルの終了関数を呼び出すコードを返します (ERT でのみ有効)。

codetemplatelib.tlc の LibCallModelTerminate を参照してください。

LibCallSetEventForThisBaseStep(buffername)

モデルの設定イベント関数を呼び出すコードを返します (ERT でのみ有効)。

引数

buffername — イベントのバッファーに使用する変数の名前。これは、ert_main.c の例では eventFlags です。

codetemplatelib.tlc の LibCallSetEventForThisBaseStep を参照してください。

LibClearFileSectionContents(fileIdx, attrib)

ファイルをディスクに書き込む前に、カスタム値を含むファイルのセクションをクリアします。

Arguments

fileIdx (スコープまたは数値) — ファイルのインデックス

attrib (文字列) — モデルの属性の名前

codetemplatelib.tlc の LibGetSourceFileAttribute を参照してください。

LibCreateSourceFile(type, creator, name)

新しい C または C++ ファイルを作成し、その参照を返します。ファイルが既に存在する場合、LibCreateSourceFile は既存のファイルの参照を返します。

構文

%assign fileH = LibCreateSourceFile
                ("Source", "Custom", "foofile")

Arguments

type (文字列) — 有効な値は、.c ファイルの場合は "Source"、.h ファイルの場合は "Header" です。

creator (文字列) — ファイルの作成者。別の作成者が同じファイルを作成しようとするとエラーが報告されます。

name (文字列) — ファイルのベース名 (つまり拡張子は除く)。ファイルが空の場合はディスクに書き込まれないことに注意してください。

戻り値

モデルファイルの参照 (スコープ)。

codetemplatelib.tlc の LibCreateSourceFile を参照してください。

LibGetFileRecordName(file)

モデルファイルのファイル拡張子を除く名前 (パスを含む) を返します。ファイル拡張子を含むファイル名 (パスを含む) を取得するには、LibGetSourceFileSection を使用します。

Arguments

file — ソースファイルの参照

codetemplatelib.tlc の LibGetFileRecordName を参照してください。

LibGetMdlPrvHdrBaseName()

モデルのプライベートヘッダーファイル (例: model_private.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlPrvHdrBaseName を参照してください。

LibGetMdlPubHdrBaseName()

モデルのパブリックヘッダーファイル (例: model.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlPubHdrBaseName を参照してください。

LibGetMdlSrcBaseName()

モデルのメインソースファイル (例: model.c) のベース名を返します。

codetemplatelib.tlc の LibGetMdlSrcBaseName を参照してください。

LibGetMdlDataSrcBaseName()

モデルのデータファイル (例: model_data.c) のベース名を返します。

codetemplatelib.tlc の LibGetMdlDataSrcBaseName を参照してください。

LibGetMdlTypesHdrBaseName()

モデルの型ファイル (例: model_types.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlTypesHdrBaseName を参照してください。

LibGetMdlCapiHdrBaseName()

モデルの capi ヘッダーファイル (例: model_capi.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlCapiHdrBaseName を参照してください。

LibGetMdlCapiSrcBaseName()

モデルの capi ソースファイル (例: model_capi.c) のベース名を返します。

codetemplatelib.tlc の LibGetMdlCapiSrcBaseName を参照してください。

LibGetMdlCapiHostHdrBaseName()

モデルの capi ホストヘッダーファイル (例: model_host_capi.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlCapiHostHdrBaseName を参照してください。

LibGetMdlTestIfHdrBaseName()

モデルの testinterface ヘッダーファイル (例: model_testinterface.h) のベース名を返します。

codetemplatelib.tlc の LibGetMdlTestIfHdrBaseName を参照してください。

LibGetMdlTestIfSrcBaseName()

モデルの testinterface ソースファイル (例: model_testinterface.c) のベース名を返します。

codetemplatelib.tlc の LibGetMdlTestIfSrcBaseName を参照してください。

LibGetDataTypeTransHdrBaseName()

データ型変換ファイル (例: コード生成の Real-Time および Embedded-C コード形式用の model_dt.h) のベース名を返します。

codetemplatelib.tlc の LibGetDataTypeTransHdrBaseName を参照してください。

LibGetModelDotCFile()

model.c または .cpp ソースファイルの参照を返します。その後、LibSetSourceFileSection を使用して追加のコードをキャッシュできます。

構文

%assign srcFile = LibGetModelDotCFile()
%<LibSetSourceFileSection(srcFile, "Functions", mybuf)>

戻り値

model.c または .cpp ソースファイルの参照を返します。

codetemplatelib.tlc の LibGetModelDotCFile を参照してください。

LibGetModelDotHFile()

model.h ソースファイルの参照を返します。その後、LibSetSourceFileSection を使用して追加のコードをキャッシュできます。

構文

%assign hdrFile = LibGetModelDotHFile()
%<LibSetSourceFileSection(hdrFile, "Functions", mybuf)>

戻り値

model.h ソースファイルの参照を返します。

codetemplatelib.tlc の LibGetModelDotHFile を参照してください。

LibGetModelName()

モデルの名前 (拡張子は除く) を返します。

codetemplatelib.tlc の LibGetModelName を参照してください。

LibGetNumSourceFiles()

作成されているソースファイル (.c または .cpp と .h) の数を返します。

構文

%assign numFiles = LibGetNumSourceFiles()

戻り値

ファイルの数 (数値) を返します。

codetemplatelib.tlc の LibGetNumSourceFiles を参照してください。

LibGetRTModelErrorStatus()

モデルのエラーステータスを取得するために必要なコードを返します。

構文

%<LibGetRTModelErrorStatus()>;

codetemplatelib.tlc の LibGetRTModelErrorStatus を参照してください。

LibGetSourceFileAttribute(fileIdx, attrib)

ファイルの指定された属性を返します。次の表に有効な属性を示します。

属性
Name (ファイル拡張子を含む)	SystemsInFile	IsEmpty	SharedType
BaseName	RequiredIncludes	Indent	CodeTemplate
Type	UtilityIncludes	WrittenToDisk	OutputDirectory
Creator	Filter	Shared	Group

Arguments

fileIdx (スコープまたは数値) — ファイルのインデックス

attrib (文字列) — モデルの属性の名前

codetemplatelib.tlc の LibGetSourceFileAttribute を参照してください。

LibGetSourceFileFromIdx(fileIdx)

モデルファイルの参照をインデックスに基づいて返します。この参照は、すべてのファイルの先頭のファイルバナーを設定するなど、すべてのファイルに対する共通の操作を行う場合に役立ちます。

構文

%assign fileH = LibGetSourceFileFromIdx(fileIdx)

引数

fileIdx (数値) — モデルファイルのインデックス

戻り値

モデルファイルの参照 (スコープ)。

codetemplatelib.tlc の LibGetSourceFileFromIdx を参照してください。

LibGetSourceFileSection(fileIdx, section)

ファイルの内容を返します。有効なセクションの一覧については、LibSetSourceFileSection(fileH, section, value)を参照してください。

Arguments

fileIdx (スコープまたは数値) — ファイルのインデックス

section (文字列) — 目的のファイルのセクション

codetemplatelib.tlc の LibGetSourceFileSection を参照してください。

LibGetSourceFileTag(fileIdx)

ヘッダーファイルの場合は fileName_h、ソースファイルの場合は fileName_c を返します。ここで、fileName はモデルファイルの名前です。

構文

%assign tag = LibGetSourceFileTag(fileIdx)

引数

fileIndex (数値) — ファイルのインデックス

戻り値

タグ (文字列) を返します。

codetemplatelib.tlc の LibGetSourceFileTag を参照してください。

LibMdlRegCustomCode(buffer, location)

関数 model_initialize の内部に宣言ステートメントと実行可能コードを配置します。

Arguments

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

hookslib.tlc の LibMdlRegCustomCode を参照してください。

LibMdlStartCustomCode(buffer, location)

開始関数の内部に宣言ステートメントと実行可能コードを配置します。開始コードはモデルの初期化フェーズで 1 回実行されます。

構文

LibMdlStartCustomCode(buffer, location)

Arguments

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibMdlStartCustomCode は、開始関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`model_initialize`	`Embedded-C` (`ModelReferenceCoderTarget` でない場合)
`mdlStart`	`Embedded-C` (`ModelReferenceCoderTarget` の場合)
`mdlStart`	`S-Function`
`MdlStart`	`RealTime`

LibMdlStartCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

hookslib.tlc の LibMdlStartCustomCode を参照してください。

LibMdlTerminateCustomCode(buffer, location)

目的

終了関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibMdlTerminateCustomCode(buffer, location)

Arguments

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibMdlTerminateCustomCode は、終了関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`model_terminate`	`Embedded-C`
`mdlTerminate`	`S-Function`
`MdlTerminate`	`RealTime`

LibMdlTerminateCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

メモ

カスタムストレージクラスの TLC コードの "case 'content' " セクションの外側で LibMdlTerminateCustomCode を使用しないでください。

hookslib.tlc の LibMdlTerminateCustomCode を参照してください。

LibNotifySymbolExportedFromFile

コード生成インフラストラクチャに、シンボルがファイルからエクスポートされることを通知します。

この関数は、変数、型、マクロ、関数の宣言などのカスタムユーザーシンボルに推奨されます。関数はコード生成インフラストラクチャに、渡されたシンボルが自動生成ファイルで使用される場合に該当するヘッダーをインクルードするように通知します。

Arguments

symbol — マクロ、変数、型、または関数名。string として指定します。

fileNameWithExtension — ファイル名と言語拡張子。string として指定します。例: <modelName>.h。

例

%openfile myFcnDecl
  extern real_T myCustomFcn(void);
%closefile myFcnDecl
%<LibCacheFunctionPrototype(myFcnDecl)>
%assign modelPrivateFile = "%<LibGetMdlPrvHdrBaseName()>.h
%<LibNotifySymbolExportedFromFile("myCustomFcn",modelPrivateFile)>

LibNotifySymbolUsedByFile

コード生成インフラストラクチャに、シンボルがファイルで使用されることを通知します。

この関数は、変数、型、マクロ、関数の宣言などのカスタムユーザーシンボルに推奨されます。関数はコード生成インフラストラクチャに、関数に渡されたシンボルに関するヘッダーをインクルードするように通知します。

Arguments

symbol — マクロ、変数、型、または関数名。string として指定します。

fileNameWithExtension — ファイル名と言語拡張子。string として指定します。例: <modelName>.h。

例

%% The following line is expanded and placed in <model>.c
%<y> = myCustomFcn();
%assign modelSrcFile = LibGetModelDotCFile()
%<LibNotifySymbolUsedByFile("myCustomFcn",modelSrcFile)>

LibSetRTModelErrorStatus(str)

モデルのエラーステータスを設定するために必要なコードを返します。

構文

LibSetRTModelErrorStatus("\"Overrun\"")

引数

str (文字列) — C の文字列に対する char *

codetemplatelib.tlc の LibSetRTModelErrorStatus を参照してください。

LibSetSourceFileCodeTemplate(opFile, name)

既定では、*.c ファイルと *.h ファイルは、[コンフィギュレーションパラメーター] ダイアログボックスの [コード生成]、[テンプレート] ペインで指定されたコードテンプレートを使用して生成されます。LibSetSourceFileCodeTemplate を使用して、ファイルのテンプレートを変更できます。

メモ

カスタムテンプレートは Embedded Coder 製品の機能です。

構文

%assign tag = LibSetSourceFileCodeTemplate(opFile,name)

Arguments

opFile (スコープ) — ファイルの参照

name (文字列) — 目的のテンプレートの名前

戻り値

なし

codetemplatelib.tlc の LibSetSourceFileCodeTemplate を参照してください。

LibSetSourceFileCustomSection(file, attrib, value)

前に LibAddSourceFileCustomSection で作成したカスタムセクションに内容を追加します。Embedded Coder ソフトウェアでのみ使用できます。

Arguments

file (スコープまたは数値) — ソースファイルの参照またはインデックス

attrib (文字列) — カスタムセクションの名前

value (文字列) — セクションに追加する値

codetemplatelib.tlc の LibSetSourceFileCustomSection を参照してください。

LibSetSourceFileOutputDirectory(opFile, name)

既定では、*.c ファイルと *.h ファイルは、現在の場所のビルドフォルダーに生成されます。LibSetSourceFileOutputDirectory を使用して、指定したソースファイルを生成するフォルダーを変更できます。呼び出し側で有効なフォルダーを指定する必要があることに注意してください。

構文

%assign tag = LibSetSourceFileOutputDirectory(opFile,dirName)

Arguments

opFile (スコープ) — ファイルの参照

dirName (文字列) — 目的の出力フォルダーの名前

戻り値

なし

codetemplatelib.tlc の LibSetSourceFileOutputDirectory を参照してください。

LibSetSourceFileSection(fileH, section, value)

指定したファイル内の指定したセクションに内容を追加します。有効なファイルのセクションは次のとおりです。

ファイルのセクション	説明
`Banner`	ファイルの最上部のファイルバナー (コメント) を設定します。
`Includes`	`#include` のセクションに追加します。
`Defines`	`#define` のセクションに追加します。
`IntrinsicTypes`	固有型の `typedef` のセクションに追加します。固有型は、C の固有の型にのみ依存する型です。
`PrimitiveTypedefs`	プリミティブ型の `typedef` のセクションに追加します。プリミティブ型の `typedef` は、C の固有の型と `IntrinsicTypes` セクションで前に定義した `typedef` にのみ依存する型です。
`UserTop`	User Top セクションに追加します。
`Typedefs`	`typedef` のセクションに追加します。`typedef` は、前に定義した型に依存できます。
`Enums`	列挙型のセクションに追加します。
`Definitions`	データ定義のセクションに追加します。
`ExternData`	(予備) コードジェネレーターの `extern` のデータ。
`ExternFcns`	(予備) コードジェネレーターの `extern` の関数。
`FcnPrototypes`	(予備) コードジェネレーターの関数プロトタイプ。
`Declarations`	データ宣言のセクションに追加します。
`Functions`	C 関数のセクションに追加します。
`CompilerErrors`	`#error` のセクションに追加します。
`CompilerWarnings`	`#warning` のセクションに追加します。
`Documentation`	ドキュメンテーション (コメント) のセクションに追加します。
`UserBottom`	User Bottom セクションに追加します。

コードジェネレーターでは、上記の順序でコードを並べ替えます。

構文

例 (ファイルを反復処理):

%openfile tmpBuf
  whatever
%closefile tmpBuf
  
%foreach fileIdx = LibGetNumSourceFiles()
  %assign fileH = LibGetSourceFileFromIdx(fileIdx)
  %<LibSetSourceFileSection(fileH,"SectionOfInterest",tmpBuf)>
%endforeach
  
%assign fileH = LibCreateSourceFile("Header","Custom","foofile")
%<LibSetSourceFileSection(fileH,"Defines","#define FOO 5.0\n")>

Arguments

fileH (スコープまたは数値) — ファイルの参照またはインデックス

section (文字列) — 目的のファイルのセクション

value (文字列) — 値

codetemplatelib.tlc の LibSetSourceFileSection を参照してください。

LibSystemDerivativeCustomCode
(system, buffer, location)

目的

サブシステムの導関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibSystemDerivativeCustomCode(system, buffer, location)

Arguments

system — 導関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemDerivativeCustomCode は、system で指定されたサブシステムの導関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`mdlDerivatives`	`S-Function`
`model_derivatives`	`RealTime`

LibSystemDerivativeCustomCode は、TLC 変数 CodeFormat の値が Embedded-C の場合は意味をもちません。連続状態をもつブロックは使用できないためです。

LibSystemDerivativeCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。連続状態がないサブシステムにコードを追加しようとするとエラーが生成されます。

hookslib.tlc の LibSystemDerivativeCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemDerivativeCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibSystemDisableCustomCode
(system, buffer, location)

目的

サブシステムの無効化関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibSystemDisableCustomCode(system, buffer, location)

Arguments

system — 無効化関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemDisableCustomCode は、system で指定されたサブシステムの無効化関数の内部に宣言ステートメントと実行可能コードを配置します。LibSystemDisableCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

無効化関数がないサブシステムにコードを追加しようとするとエラーが生成されます。

hookslib.tlc の LibSystemDisableCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemDisableCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibSystemEnableCustomCode
(system, buffer, location)

目的

サブシステムの有効化関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibSystemEnableCustomCode(system, buffer, location)

Arguments

system — 有効化関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemEnableCustomCode は、system で指定されたサブシステムの有効化関数の内部に宣言ステートメントと実行可能コードを配置します。LibSystemEnableCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

有効化関数がないサブシステムにコードを追加しようとするとエラーが生成されます。

hookslib.tlc の LibSystemEnableCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemEnableCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibSystemInitializeCustomCode
(system, buffer, location)

目的

サブシステムの初期化関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibSystemInitializeCustomCode(system, buffer, location)

Arguments

system — 初期化関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemInitializeCustomCode は、system で指定されたサブシステムの初期化関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`model_initialize`	`Embedded-C`
`mdlInitializeConditions`	`S-Function`
`MdlStart`	`RealTime`

サブシステムのコードは、サブシステムの初期化関数に出力されます。LibSystemInitializeCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

メモ

有効になったときにリセットするように構成されていない Enable システムは MdlStart にインライン化されます。この場合、サブシステムのカスタムコードは、Enable Subsystem の初期化コードの上下の MdlStart にあります。

hookslib.tlc の LibSystemInitializeCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemInitializeCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibSystemOutputCustomCode
(system, buffer, location)

目的

サブシステムの出力関数の内部に宣言ステートメントと実行可能コードを配置します。

構文

LibSystemOutputCustomCode(system, buffer, location)

Arguments

system — 出力関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemOutputCustomCode は、system で指定されたサブシステムの出力関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`model_step`	`Embedded-C` (`CombineOutputUpdateFcns` が `1`)
`model_output`	`Embedded-C` (`CombineOutputUpdateFcns` が `0`)
`mdlOutputs`	`S-Function`
`MdlOutputs`	`RealTime`

LibSystemOutputCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

hookslib.tlc の LibSystemOutputCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemOutputCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibSystemUpdateCustomCode
(system, buffer, location)

目的

サブシステムの更新関数の内部にコードを配置します。

構文

LibSystemUpdateCustomCode(system, buffer, location)

Arguments

system — 更新関数を変更するサブシステムの参照。

buffer — 内部のキャッシュバッファーに追加するテキストを含む文字列バッファー。

location — バッファーの内容を配置する位置を指定する文字列。可能な値は以下のとおりです。

"header" — 関数の最上部にバッファーを配置
"declaration" — 関数の最上部にバッファーを配置
"execution" — 関数の最上部のヘッダーの後にバッファーを配置
"trailer" — 関数の最下部にバッファーを配置

戻り値

なし

説明

LibSystemUpdateCustomCode は、system で指定されたサブシステムの更新関数の内部に宣言ステートメントと実行可能コードを配置します。このコードは、TLC 変数 CodeFormat の現在の値に応じて次の関数に出力されます。

関数名	TLC 変数 `CodeFormat` の値
`model_step`	`Embedded-C` (`CombineOutputUpdateFcns` が `1`)
`model_update`	Embedded-C (`CombineOutputUpdateFcns` が `0`)
`mdlUpdate`	`S-Function`
`MdlUpdate`	RealTime

LibSystemUpdateCustomCode の各呼び出しで、内部のキャッシュバッファーにバッファーが追加されます。

hookslib.tlc の LibSystemUpdateCustomCode を参照してください。

メモ

シミュレーションとコード生成の結果の間で不一致が生じる可能性を回避するために、グローバル Simulink データ (信号、状態、およびブロックパラメーター) の読み取りと書き込みには LibSystemUpdateCustomCode を使用しないでください。代わりに、適切なモデル化パターン (たとえば、Data Store Read、Data Store Write、State Reader および State Writer ブロック) を使用します。

LibWriteModelData()

モデルのデータを返します (ERT でのみ有効)。

codetemplatelib.tlc の LibWriteModelData を参照してください。

LibWriteModelInput(tid, rollThreshold)

指定されたルート入力 (つまりモデルの Inport ブロック) に書き込むコードを返します。この関数は ERT のみで有効であり、参照モデルに対しては有効ではありません。

Arguments

tid (数値) — タスク識別子 (0 が最も速いレートで n が最も遅い)

rollThreshold — for ループでラップする前の信号の幅。

codetemplatelib.tlc の LibWriteModelInput を参照してください。

LibWriteModelInputs()

すべてのルート入力 (つまりモデルの Inport ブロック) に書き込むコードを返します。この関数は ERT のみで有効であり、参照モデルに対しては有効ではありません。

codetemplatelib.tlc の LibWriteModelInputs を参照してください。

LibWriteModelOutput(tid, rollThreshold)

指定されたルート出力 (つまりモデルの Outport ブロック) に書き込むコードを返します。この関数は ERT のみで有効であり、参照モデルに対しては有効ではありません。

Arguments

tid (数値) — タスク識別子 (0 が最も速いレートで n が最も遅い)

rollThreshold — for ループでラップする前の信号の幅。

codetemplatelib.tlc の LibWriteModelOutput を参照してください。

LibWriteModelOutputs()

すべてのルート出力 (つまりモデルの Outport ブロック) に書き込むコードを返します。この関数は ERT のみで有効であり、参照モデルに対しては有効ではありません。

codetemplatelib.tlc の LibWriteModelOutputs を参照してください。