The Virtual Bus Monitor provides the ability to monitor (in real-time or after) the Run messages sent on the Virtual Buses in MxVDev. This monitor provides a current view of the messages being sent in the system. You can use filters to control which messages to capture and display. CAN and LIN are currently supported. To view bus traffic in MxTransIt, use a Virtual Bus Transform.

Selecting a Monitor

If you have any Virtual Buses, they are listed under View‑>Virtual Bus Monitor on the main menu.

VBusMonitorMenu

Select a bus to display the monitor at the bottom of your screen.  An example is shown below. You can drag the edges of the window to re-size the monitor. If you are using a MOST bus, see MOST Virtual Bus Monitor and Filter.

VBusMonitor

Logging Data

You can capture bus trace data (all message traffic) in the Scenario Results Log (.mxlog file). To enable this feature, select Include Virtual Network Trace in the log file in the Project Settings Logging tab. This captures a large amount of data, which may reduce the performance of your bus and test, so use this option with caution.

Views

By Message: Groups all messages captured by the monitor by Message Name. This view can be sorted (at any time) by Message Name or Arb Id.

By Time: A linear display of all messages captured by the monitor.

Filtering Data

VBusMonitorFilters

CAN or LIN messages are stored in the Capture Buffer.

History Duration: Specifies the last n seconds of messages to be stored in the Capture Buffer.

The Capture Filter limits the data stored in the Capture Buffer to messages that match the specified Arb ID. Values entered are HEX values with the 0x being optional. (0x12F4 and 12F4 are equivalent)

The Display Filter enables you to display a subset of the messages in the Capture Buffer. Only messages with the specified Arb ID are displayed. The messages are retained in the Capture Buffer, so you can change the Display Filter to view different message types.

Show Master Requests: When this box is checked, the Virtual Bus Monitor displays messages from the LIN master node. In most cases, this is not necessary, however it is useful for testing the master node. This option is only available for LIN buses.

Pause/Resume: A button to stop the monitor from updating. When paused, the monitor does not capture messages.

VBusMonitorPRIcon

Capture of large amounts of bus traffic over a long period uses a significant amount of RAM. VM Usage in the Status bar gives you an indication of how much RAM is used. You can use the Capture Filter and History Duration to limit the amount of data captured.

Note: The Virtual Bus Monitor operates independently of the Network Configuration Receive From filter.

Viewing the Data

During a run or after the fields and values are available by clicking on a Message in the monitor. The details display in the right side of the monitor window and look similar to the following:

VBusMonitorMsgData

Using the Captured Data

You can use the copy buttons to copy data into your Windows Clipboard. Only data that has passed through both the Capture Filter and the Display Filter is copied. There are two buttons:

Copy Displayed Data VBusMonitorSnapIco :

oWhen using By Message view, click to copy the most recent capture of each Message to your Clipboard.

oWhen using By Time view, a direct CSV copy of the monitor output is placed in your Clipboard.

Copy Message Trace (in Vector format) VBusMonitorTraceIco : Places a formatted version of the captured data in your Clipboard. This data is the same no matter which view you use. It can be used with tools such as Vector's CANoe.

Save Message Trace (in Vector format) VBusMonitorTraceIco : Saves a formatted version of the captured data to a subfolder in the Project Folder. This data is the same no matter which view you use. It can be used with tools such as Vector's CANoe.

Related Topics:

Bus Overview

MOST Virtual Bus Monitor and Filter

Network Configuration

Virtual Bus Transform