コードの定義とマッピングに関する制限と考慮事項

制限

コードマッピングを使用して、ブロックパラメーターとして使用されている MATLAB^® 変数を設定することはできません。モデルワークスペースで変数を Simulink.Parameter オブジェクトに変換します。結果のデータオブジェクトがモデルパラメーターとしてコードマッピングエディターに表示されます。
コードマッピングを使用して構成できるのは、モデル内のブロックごとに 1 つの離散状態のみです。
コードマッピングエディター (または同等のプログラムインターフェイス) を使用している場合、組み込みの Simulink^® ライブラリにリンクされたブロック内の状態に個別にアクセスしたり構成したりすることはできません。そのような状態からコードを生成する場合、コードジェネレーターはモデルマッピングの Data Defaults セクションにある Signals, states, and internal data カテゴリに従います。
モデルに調整可能な非有限パラメーターが含まれている場合 (たとえば、inf の値をもつ場合など)、コードジェネレーターは指定された既定のパラメーターマッピングを適用しません。パラメーターが既定のパラメーターデータ構造体 rtP のフィールドとして表示されます (リアルタイムモデルデータ構造体を参照)。

既定のコードマッピングに関する制約

カテゴリ [External parameters] および [Global data stores] の既定のコードマッピングは、モデル参照階層全体のモデルで同じでなければなりません。

モデルの編集操作と個々のデータ要素のコードマッピング

コーダーアプリのコンテキストでモデルを編集している間、コピー、元に戻す、コードマッピングなど、Simulink モデルの編集ツール間の関係を認識する必要があります。コーダーアプリのコンテキストでは、モデル内でコピーと貼り付けまたは切り取りと貼り付けの編集操作を実行すると、コーダーアプリによって個々のデータ要素のコードマッピングが保持されます。たとえば、モデル内で、特定のストレージクラスを使用して構成されている信号のソースブロックをコピーして貼り付ける場合、貼り付けられた信号端子は同じストレージクラスを保持します。

モデルデータ要素に行った編集アクションに対して元に戻す操作およびやり直し操作を使用できますが、コードマッピングの設定中は使用できません。たとえば、State ブロックを削除してから [元に戻す] をクリックする場合、そのブロックはモデルキャンバスに再表示され、状態のコード構成がコードマッピングに再表示されます。コードマッピングエディターで、状態のストレージクラス設定を Auto から Model default に変更してから [元に戻す] をクリックする場合、ストレージクラスは Auto に戻りません。この場合、変更は、モデルのデータ要素ではなくコードマッピングに関連しています。

ストレージクラスと再呼び出し可能なマルチインスタンスモデルとコンポーネント

モデルまたはコンポーネント (参照モデルまたはサブシステム) から生成したコードは、実行中にアプリケーションでコンポーネントの複数の独立したインスタンスを維持できる場合、"マルチインスタンスコード" となります。たとえば、モデルコンフィギュレーションパラメーター [コードインターフェイスのパッケージ化] を [再利用可能な関数] に設定して、モデル全体から再呼び出し可能なマルチインスタンスコードを生成できます。マルチインスタンスモデルとコンポーネントの詳細については、モデルのコンポジションと再利用を参照してください。

状況によっては、ストレージクラスの適用により次のことが起こる可能性があります。

マルチインスタンスコードの生成ができなくなる。
一部のデータ要素が生成されたコードでシングルトンとして表示される。これにより、モデルまたはコンポーネントの各インスタンスが直接同一の共有グローバルデータにアクセスし、インスタンス間での依存関係が作成される。

エラーや予期しない単一インスタンスのコードおよびシングルトンデータの生成を回避するため、以下のガイドラインおよび制限を遵守してください。

直接適用されるストレージクラス

ストレージクラスをデータ要素に直接適用する場合、次についての考慮が必要です (C Data Code Interface Configuration for Model Interface Elementsを参照)。

マルチインスタンスコードを生成するには、ストレージクラスを、パラメーターオブジェクト、グローバルデータストア、共有ローカルデータストア、ルートレベル I/O のみに適用しなければならない。
ストレージクラスはシングルトンデータのみを生成する。

既定で適用されるストレージクラス

既定のストレージクラスを適用する場合、次についての考慮が必要です (C Data Code Interface Configuration for Model Interface Elementsを参照)。

次のデータカテゴリーについてはシングルトンデータのみ生成できる。
- Model parameters
- External parameters
- Global data stores
- Shared local data stores
[内部データ] については、インスタンス固有のデータのみ生成できる。すなわち、モデルまたはコンポーネントの各インスタンスは個別のデータのコピーに対して動作する。これらのカテゴリについては、クイックスタートツールを使用してコード生成用のモデルを準備すると表示される、組み込みストレージクラス SignalStruct を使用しなければなりません。あるいは、Embedded Coder^® ディクショナリを使用して、独自の構造体化されたストレージクラスを作成して使用できます。

詳細については、再呼び出し可能なコードとはおよび生成されたコードでのデータ表示を制御するストレージクラスの選択を参照してください。

サブシステムを参照モデルに変換するときにコードマッピングをコピー

サブシステムを参照モデルに変換するときに、コードマッピングをコピーできます。

モデル参照変換アドバイザーで、[コードマッピングをコピー] を選択します。
MATLAB コマンドウィンドウで、'CopyCodeMappings' と true で構成されるコンマ区切りのペアを指定して関数 Simulink.SubSystem.convertToModelReference を使用します。