Real-Time Workshop Release Notes

旧リリースからのアップグレード

本節では、Real-Time Workshop 4.1 からVersion 5.0 への移行に関するアップグレードの問題を説明します。

4.1 より以前のバージョンからアップグレードする場合は、Upgrading from an Earlier Releaseを参照してください。

廃止されたヘッダファイルの#includesの置換

生成されたコードは、本リリースでは、小数のファイルにパッケージ化されます(Revised Packaging of Generated Code Filesを参照)。旧バージョンのReal-Time Workshopによって生成されたコード間のインタフェースがある場合は、生成されないヘッダファイル(model_common.h, model_export.h, model_prm.h, model_reg.hのような)への依存を削除し、#include model.h命令を追加する必要があります。

カスタマイズされたGRTおよびGRT-MallocターゲットをRelease 13で機能させるためのアップグレード

生成されるコードの効率を改良するために、Release 13ではGRTおよびGRT-Mallocターゲットが変更されています。いずれかのタイプのターゲットをカスタマイズした場合は、修正したファイルを、ターゲットがRelease 13 (Real-Time Workshop Version 5.0)で適切に動作することを保証するように、変更してください。

本リリースではターゲットのバージョンから開始し、カスタマイズを加えることを強く推奨します。このアップグレードパスに従えない場合は、下記のAおよびBで記述したすべてのステップを行う必要があります。

A. SimStruct とrtModelの置き換えの結果による変更:

Release 13のReal-Time Workshopより以前は、GRTおよびGRT-Mallocターゲットは、SimStructデータ構造体を利用して、モデル毎の情報をキャプチャし、格納しました。SimStructは非インラインS-functionによっても利用されたので、モデル毎の情報をキャプチャするために用いられたときに、未使用のまま残るフィールドがあるという欠点がありました。この欠点を回避するために、Version 5.0 は、rtModel と呼ばれる特殊なデータ構造体を導入して、モデル毎の情報をキャプチャします。

結果として、grt_main.cとgrt_malloc_main.cは、rtModelを利用するためにアップデートする必要があります。以下は、SimStructの代わりにrtModelを利用するために、これらのファイルに対して行う必要がある変更点です。

• 先頭でsimstruc.hの代わりにrtmodel.hをインクルードします。
• rtModelデータ構造体は、モデル名を含むタイプなので、ファイルの先頭でつぎの行を含める必要があります。

• #define EXPAND_CONCAT(name1,name2) name1 ## name2

  #define CONCAT(name1,name2) EXPAND_CONCAT(name1,name2)

  #define RT_MODEL CONCAT(MODEL,_rtModel)

• SimStructを作成し、初期化する関数のextern宣言を以下のように変更します。

• extern RT_MODEL *MODEL(void);

• rt_CreateIntegrationDataとrt_UpdateContinuousStatesの定義をRelease 13 version のgrt_main.c(あるいはgrt_malloc_main.c)で見られるように変更します。
• 引数'SimStruct'の代わりに引数'RT_MODEL'をもつようにすべての関数プロトタイプを変更します。
• 関数rt_GetNextSampleHit, rt_UpdateDiscreteTaskSampleHits, rt_UpdateContinuousStates, rt_UpdateDiscreteEvents, rt_UpdateDiscreteTaskTime, rt_InitTimingEngineに対するプロトタイプが変更されいます。rt_の代わりに接頭辞rt_Sim を利用するように名前を変更し、それらに渡す引数を変更する必要があります。

• 各巻数に渡される引数の一覧は、grt_main.c (あるいはgrt_malloc_main.c)を参照してください。

• SimStructを参照するすべてのマクロをrtModelを参照するように修正する必要があります。これらの修正の例は、以下の変更点を含みます。

• ssGetErrorStatus to rtmGetErrorStatus,

  ssGetSampleTime to rtmGetSampleTime,

  ssGetSampleHitPtr to rtmGetSampleHitPtr,

  ssGetStopRequested to rtmGetStopRequested,

  ssGetTFinal to rtmGetTFinal, and

  ssGetT to rtmGetT.

メインのCファイルへの変更に加えて、target TLCファイルとtemplate make filesを変更する必要があります。

• template make fileにおいて、シンボルUSE_RTMODELを定義する必要があります。例題は、GRTまたはGRT-Mallocのtemplate make filesを参照してください。
• ターゲットTLCファイルにおいて、以下のグローバル変数割り当てを追加する必要があります。

•      %assign UseRTModel = TLC_TRUE
  

B. ロギングコードをRTWライブラリに移動した結果の変更

Release 13 では、データロギング用に用いるすべてのサポート関数は、rtwlog.cからReal-Time Wrokshopライブラリに移動しています。結果として、新規ロギング関数との互換性のために、以下の変更を行う必要があります。

• すべてのtemplate make fileからrtwlog.cを削除します。
• ターゲットのメインCファイル(grt_main.cあるいはgrt_malloc_main.cから得られる)において、rtwlog.hの代わりにrt_loggin.hをインクルードします。
• ターゲットのメインCファイル(grt_main.cあるいはgrt_malloc_main.cから得られる)において、ロギング関連関数のプロトタイプが変更されているため、これらの関数呼び出しを変更する必要があります。各関数に渡される引数の一覧は、grt_main.c (またはgrt_malloc_main.c)を参照してください。

HPおよびIBMに対するプラットフォームの制限

既知のソフトウェアとドキュメントの問題