TLC ファイル

TLC プログラム

Target Language Compiler (TLC) は、Simulink^® ソフトウェアと連携してコードを生成します。

"TLC プログラム" は "スクリプト" と呼ばれる ASCII ファイルの集まりです。TLC はインタープリター型言語であるため、オブジェクトファイルはありません。プログラムに使用される他のターゲットファイルを (%include 命令で) 呼び出す単一のターゲットファイルを "エントリポイント" と呼びます。

使用可能なターゲットファイル

TLC は、一連のターゲットファイルを解釈し、Simulink モデルの部分表現 (model.rtw) をターゲット固有のコードに変換します。

ターゲットファイルは、コンパイラで生成されたコードをカスタマイズするための柔軟性を提供します。たとえば、使用可能なシステムターゲットファイルを使用すると、Simulink モデルから汎用の C または C++ コードが生成されます。この実行可能コードはプラットフォーム固有ではありません。

メモ

それを行う機能がありますが、TLC ファイルをカスタマイズしないでください。このような TLC のカスタマイズはコード生成プロセス中に適用されない可能性があり、予期しない結果になることがあります。カスタマイズするのは、自分で作成した TLC ファイルだけにしてください。

ターゲットファイル内のパラメーターは、model.rtw ファイルから読み取られ、ブロックのスコープルールを使用して参照されます。%assign ステートメントを使用して、ターゲットファイル内で追加のパラメーターを定義できます。

ターゲットファイルはターゲット言語の命令を使用して記述します。ブロックのスコープルールとターゲット言語の命令の詳細については、Target Language Compiler Directivesで説明しています。

model.rtw ファイルとスコープでは、ターゲットファイルの作成や変更に便利な model.rtw ファイルについて説明しています。

コード生成のコンテキストに関連するターゲットファイルは 2 種類あります。

システムターゲットファイル
システムターゲットファイルは、コード生成の全体的なフレームワークを決定します。ブロックをいつ実行するかや、ログデータをどのように記録するかなどが決まります。
ブロックターゲットファイル
各ブロックに、そのブロックのコードをどのように生成するかを決めるターゲットファイルがあります。ブロックの正確なパラメーターや接続のタイプ (幅のある入力かスカラー入力かなど) に応じて、コードはさまざまに異なります。詳細については、ブロックターゲットファイルのメソッドを参照してください。

モデル全体のターゲットファイルとシステムターゲットファイル

モデル全体のターゲットファイルは、モデル単位で全体に対して使用します。モデル全体のターゲットファイルは、model.rtw ファイルをターゲット固有のコードに変換するための基本的な情報を TLC に提供します。

システムターゲットファイルは、TLC のエントリポイントです。C プログラムの main() ルーチンに似ています。システムターゲットファイルは、コード生成プロセス全体を対象とします。たとえば、システムターゲットファイル grt.tlc は、システムターゲットファイルのエントリポイントとなる codegenentry.tlc のいくつかの変数を設定します。使用可能なシステムターゲットファイルの完全な一覧については、製品間でのシステムターゲットファイルのサポートの比較を参照してください。

ターゲットファイルの用途

ターゲットファイルは次の目的に使用します。

S-Function のインライン化
S-Function のインライン化とは、その S-Function ブロックのコードをどのように生成するかを TLC に指示するブロックターゲットファイルを記述することを意味します。コンパイラでは、インラインでない C MEX S-Function のコードを生成できます。C MEX S-Function をインライン化すると、より効率的なコードをコンパイラで生成できます。インラインでない C MEX S-Function は、S-Function のアプリケーションプログラムインターフェイス (API) を使用して実行され、非効率になる可能性があります。MATLAB^® ファイルまたは Fortran S-Function をインライン化できます。どちらの場合も TLC で S-Function のコードを生成できます。
すべてのモデルに対する生成コードのカスタマイズ
生成コードをプロファイリング用にインストルメント化したり、すべてのモデル用の全体的なコード生成について他の変更を加えたりする場合があります。このような変更を行うには、システムターゲットファイルの一部を変更します。

システムターゲットファイル

全体のコード生成プロセスは、[コンフィギュレーションパラメーター] ダイアログボックスの [コード生成] ペインで指定した単一のシステムターゲットファイルから始まります。[参照] ボタンをクリックすると、そのためのシステムターゲットファイルブラウザーがアクティブになります。システムターゲットファイルを詳しく調べることで、コード生成がどのように行われるかがわかります。次のリストは、汎用リアルタイム実行可能ファイルのコードを生成するターゲットファイル grt.tlc のコメント以外の行を示したものです。

%selectfile NULL_FILE
%assign TargetType = "RT" 
%assign Language   = "C"  
%assign MatFileLogging = 1 
%include "codegenentry.tlc"

3 つの変数 Language、TargetType、および MatFileLogging は、他の関数で使用されるグローバル TLC 変数です。この後に、コード生成のメインエントリポイントである codegenentry.tlc を呼び出してコード生成が開始されます。

全体的なコード生成に変更を加える場合は、システムターゲットファイルを変更しなければなりません。初期設定の後、codegenentry.tlc を呼び出す代わりに、独自の TLC ファイルを呼び出す必要があります。次のコードは、mygrt.tlc というシステムターゲットファイルの例を示しています。

%% Set up variables, etc.
%% Load my library functions 
%% Note that mylib.tlc should %include funclib.tlc at the  
%% beginning. 
%include "mylib.tlc"  
%include "commonsetup.tlc"  

%% Next, you can include TLC files that you need for 
%% preprocessing information about the model and to fill in 
%% hooks. The following is an example of including a single
%% TLC file that contains custom hooks. 
%include "myhooks.tlc"  

%% Finally, call the code generator. 
%include "commonentry.tlc"

生成コードは、モデルまたはサブシステムの関数に配置されます。生成される関連する関数の名前とその実行順序については、モデルから生成されたコードの実行および生成された C 関数インターフェイスをモデルのエントリポイント関数用に構成で説明しています。コード生成時に、ブロックターゲットファイルのそれぞれから関数が実行され、モデルまたはサブシステムの関数に生成コードが配置されます。