通信定義ファイルを取り込む
概要
LDFから信号とフレームの定義をSignal Catalogへ取り込みます。取り込み後は、監視・解析・送信の用途に応じて利用先へ設定します。
ファイルの取り込み、Setへの所属、機器の通信設定は別の操作です。 通信定義を読み込んでも、Device Windowの通信設定や送信動作が自動で準備されたとは判断しないでください。
取り込み手順
- モニタリングを停止し、メインツールバーからSignal Catalogを開きます。
- ImportをクリックしてLDFファイルを選択します。操作例にはサンプルLDFを使用できます。
- Import Communication Definitionsで文字コード、信号・フレームの件数、警告を確認します。
- Signalsで必要な対象を選択します。ノードやフレームを展開して、信号名とビット位置を確認します。
- FramesとLIN Schedulesで、フレームのpublisher、初期値、スケジュールの順序やDelayを確認します。LDF内のフレームとスケジュールは、Signalsでの選択にかかわらず自動登録の対象です。
- Importをクリックします。
- CatalogのSignals/Frames/LIN Schedulesで取り込み結果を確認し、SaveでMPXSIGへ保存します。
- 次の表で利用先を選びます。
図1 サンプルLDFの取り込みプレビュー。
サンプルには2信号(Speed・State)、1フレーム(SensorFrame)、1スケジュール(SensorSchedule)が含まれます。取り込み前に件数と対象名を照合します。この画面でImportを実行しても、受信や送信は開始されません。
| 用途 | 取り込み後の操作 |
|---|---|
| リアルタイム監視 | Setへ所属・CH割当・表示・Currentを設定 |
| 保存ログ解析 | ログと対応定義を選び、CHを照合 |
| スケジュール・レスポンス送信 | Simulationへ採用。監視用Setの設定は採用の必須条件ではありません。 |
取り込み画面の説明
| 項目 | 内容 |
|---|---|
| Detected/used | 検出・使用した文字コードを表示します。 |
| 文字コード選択/Reload | 自動判定または指定した文字コードで読み直します。名称が文字化けする場合に確認します。 |
| Signals/Frames/Schedules/Warnings | 解析した定義と警告の件数を表示します。 |
| Selected Signals/Auto-register Frames | 選択した信号数と、自動登録の対象となるフレーム数・スケジュール数を表示します。 |
| Search/Status | 対象名や状態で表示を絞ります。見つからない場合は絞り込みを解除します。 |
| Signals | 信号をノード・フレームの階層で確認し、取り込み対象を選択します。 |
| Frames | フレーム定義を確認します。 |
| LIN Schedules | LDFのスケジュール定義を確認します。 |
| Select visible/Clear visible/Invert visible | 表示中の対象を選択/選択解除/反転します。 |
| 下部の結果・説明欄 | 追加・更新候補や、選択項目の説明などを確認します。 |
| Import/Cancel | 取り込みを実行/この取り込みを中止します。 |
取り込み不可・未対応・警告が表示された項目は、説明を確認してから使用してください。ファイルを開けたことだけでは、すべての定義を正しく使用できることを意味しません。
エラーや警告を確認する
ファイルを読み取れない場合や解析に失敗した場合は「Import Errors」が表示されます。Line・Column・Descriptionで箇所と理由を確認し、行を選択して詳細と修正の手がかりを確認します。位置が表示されない場合は、ファイルの存在・読み取り権限と表示された理由を確認してください。修正後はエラー画面を閉じ、CatalogのImportからファイルを開き直します。
プレビューまで進んだ場合は「Warnings (件数)」で警告を確認します。文字化けは文字コードを選び直して「Reload」し、選択対象と警告を改めて確認します。
図1はWarnings 0の正常例です。図2は公開サンプルのコピー「signal-example-warning.ldf」で、FramesのSensorFrame内の19行目だけをState, 8;からStateTypo, 8;へ変更した警告例です。Signals内の宣言はStateのままなので、フレームから参照する信号名と一致しません。
図2 警告例の取り込みプレビュー上部と説明欄の抜粋。
図2の文字コードはUTF-8、Signalsは2、Framesは1、Schedulesは1、Warningsは1ですが、Selected Signalsは1です。SensorNode→LIN ID 0x10 SensorFrameの下ではSpeed(Bit=0:8)だけがチェックされ、[Unavailable] StateTypo(Bit=8:0)は未選択になっています。
「Warnings (1)」をクリックすると、下端に「Line 19: Frame references an undefined signal: StateTypo」と表示されます。ボタンが「Back to selection details」に変わるので、選択項目の説明へ戻す場合はこのボタンをクリックします。項目を選択したときの説明でも、フレームが未定義の信号を参照していることを確認できます。
この例ではCancelで閉じ、コピーの参照名をState, 8;へ戻して、CatalogのImportから開き直しました。修正後はWarnings 0、Selected Signals 2となり、Speed(Bit=0:8)とState(Bit=8:8)の両方がチェックされました。図1の正常例と照合してください。警告例・修正確認とも、Importは確定していません。
LDFを取り込んだ後の確認
「Import」でSignal Catalogに戻ったら、同じ取込元 signal-example.ldf の定義を次の順に確認します。
- Signalsで信号を確認する。
SpeedとStateのMessageがSensorFrame、Import sourceがsignal-example.ldfであることを確認します。図3はFramesの対象行から「Show in Signals」で絞り込んだ2行です。In SetはOFFで、CHも未割当です。監視に使用する場合は、この後にSetとCHを設定します。
図3 取り込まれたSpeedとStateの行。
- Framesでフレーム条件を確認する。 Sourceが
signal-example.ldfのSensorFrameを選びます。ProtocolはLIN、IDは10(16進数の0x10、LDF内では10進数の16)、Bytesは2、Signalsは2、PublisherはSensorNodeです。図4には他のファイルの定義もあるため、同名のCANフレームと取り違えないようSourceとProtocolを照合します。
図4 取り込まれたSensorFrameの行と詳細。
- LIN Schedulesでスロットを確認する。 Sourceが
signal-example.ldfのSensorScheduleを選びます。Slotsは1、MasterはMasterNode、Bitrateは19200(19.2 kbps)です。下部の詳細は1 SensorFrame SensorNode Rx 100 msで、SensorFrameのスロットとDelay 100 msを確認できます。
図5 取り込まれたSensorScheduleの行とスロット詳細。
- Signal_encoding_typesとSignal_representationによる物理値・状態名の対応を確認します。
- LDFのFramesは信号の配置先、Schedule_tablesは送信するフレームの順序とDelayの定義です。CatalogのLIN Schedulesに候補がない場合は、対象LDFにSchedule_tablesがあるか確認し、取り込みプレビューのLIN Schedulesで候補を確認してImportします。フレームとスケジュールはまとめて登録され、実際に使用する項目はSimulation側で選びます。
- 通信速度、Master/Slaveの役割はDevice/Simulationの設定でも確認します。
現行版では、Catalogへ取り込んだ通信定義をSimulation側で選んで採用します。スケジュール・レスポンス設定の操作手順を参照し、Catalogへの登録と送信設定への採用を区別してください。
サンプルのSpeedはByte 0の8ビット、StateはByte 1の8ビットです。SpeedのRaw値100は45 km/hになります。Signal SettingのConversion Previewで、入力値と結果を照合できます。
同じ定義を再度取り込む場合
現在のCatalogを別名のMPXSIGへ保存してから実行してください。同じ場所にあるファイルの再取込では、同じ取込元の定義を照合します。同名でも保存場所が異なるファイルは別の取込元として扱われます。プレビューのAdd/Updateで追加・更新される信号定義を確認します。フレームやLINスケジュールの内容は各タブで確認し、Importで反映します。信号定義に変更がなくAdd/Updateが0でも、フレームやスケジュールの変更は反映されます。
元ファイルの該当定義が変わっていなければ、手動編集した変換は保持されます。元ファイルとCatalogで同じ定義が別々に変更されて競合した場合は、Cannot applyと表示され、取り込みを確定できません。採用する定義を確認し、競合を解消してから読み込み直してください。
Signalsでチェックを外しても、自動登録の対象となるフレーム内の信号定義は追加・更新の対象になることがあります。Importの前にプレビューで対象を確認してください。
元ファイルの名前・版、信号数、フレーム条件、ビット位置、単位を記録しておくと、定義変更の確認に役立ちます。CatalogのLoadは全Catalog・全Setの置き換えなので、通信定義ファイルのImportと使い分けてください。
取り込み後に表示されない場合
Catalog内で対象が見つかるか、In SetがONか、CHが割り当てられているかを先に確認します。続いて、実フレームの条件と表示対象を照合してください。詳細は表示されない場合の確認を参照してください。