メインコンテンツまでスキップ
バージョン: Ver.4.10

通信定義ファイルを取り込む

概要​

LDFから信号とフレームの定義をSignal Catalogへ取り込みます。取り込み後は、監視・解析・送信の用途に応じて利用先へ設定します。

ファイルの取り込み、Setへの所属、機器の通信設定は別の操作です。 通信定義を読み込んでも、Device Windowの通信設定や送信動作が自動で準備されたとは判断しないでください。

取り込み手順​

  1. モニタリングを停止し、メインツールバーからSignal Catalogを開きます。
  2. ImportをクリックしてLDFファイルを選択します。操作例にはサンプルLDFを使用できます。
  3. Import Communication Definitionsで文字コード、信号・フレームの件数、警告を確認します。
  4. Signalsで必要な対象を選択します。ノードやフレームを展開して、信号名とビット位置を確認します。
  5. FramesとLIN Schedulesで、フレームのpublisher、初期値、スケジュールの順序やDelayを確認します。LDF内のフレームとスケジュールは、Signalsでの選択にかかわらず自動登録の対象です。
  6. Importをクリックします。
  7. CatalogのSignals/Frames/LIN Schedulesで取り込み結果を確認し、SaveでMPXSIGへ保存します。
  8. 次の表で利用先を選びます。
サンプルLDFを開いたImport Communication Definitions。SpeedとStateを取り込む前のプレビュー

図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 SchedulesLDFのスケジュール定義を確認します。
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のままなので、フレームから参照する信号名と一致しません。

UTF-8の警告プレビュー。Signals2、Frames1、Schedules1、Warnings1、選択済みはSpeedの1信号。StateTypoはUnavailableで未選択、下端にLine19の未定義信号参照を表示

図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 の定義を次の順に確認します。

  1. Signalsで信号を確認する。 Speed と State のMessageが SensorFrame、Import sourceが signal-example.ldf であることを確認します。図3はFramesの対象行から「Show in Signals」で絞り込んだ2行です。In SetはOFFで、CHも未割当です。監視に使用する場合は、この後にSetとCHを設定します。
Show in Signalsで表示したSensorFrameのSpeedとState。Import sourceはsignal-example.ldf、In SetはOFFでCHは未割当

図3 取り込まれたSpeedとStateの行。

  1. 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を照合します。
Framesで選択したLINのSensorFrame。ID 10、2バイト、2信号、Publisher SensorNode、Source signal-example.ldfを表示

図4 取り込まれたSensorFrameの行と詳細。

  1. 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を確認できます。
SensorScheduleの一覧行と詳細。1スロット、MasterNode、Bitrate 19200、SensorFrame SensorNode Rx 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が割り当てられているかを先に確認します。続いて、実フレームの条件と表示対象を照合してください。詳細は表示されない場合の確認を参照してください。

保存ログの解析・結果出力、送信設定への利用は、それぞれの操作説明を参照してください。