MPLAB® Data Visualizer

Welcome to the early access program. You are using an early version of this software. We are working hard to improve your experience and appreciate your patience and support during this phase. Features and functionality are in active development and may change without notice. As early adopters, your feedback is invaluable to us. Please report any bugs or suggestions for enhancements.

Introduction

This package bundles the MPLAB Data Visualizer as an extension for Visual Studio Code. Please refer to the product landing page for more information and links to the User's Guide.

This extension provides mostly the same functionality as the classic plugin to MPLAB X and the standalone version. The Notes section below lists some notable exceptions.

Features

It can be difficult to troubleshoot data on an embedded target while your application is running. In the same way a debugger helps you debug your application code, MPLAB Data Visualizer helps you debug your data. With MPLAB Data Visualizer, you can see how key data points in your application change during runtime, e.g. visualize values captured by a sensor on your development board.

MPLAB Data Visualizer has the following features:

Capture data streamed from a running embedded target via serial port (CDC) or the Data Gateway Interface (DGI)
Decode data fields at runtime using the Data Stream (DS) Protocol format
Automatically load Data Stream and Dashboard configuration for the DS data stream
Stream and modify global variables using the run-time configurable Data Visualizer Run Time (DVRT) protocol
Visualize the raw or decoded data in a Graph as a time series or display the data in a terminal
Configure the Graph as a rolling time plot or as a simple oscilloscope with egde triggers
Analyze plotted data using cursors to measure bandwidth, pulse width and more
Log data to file as it is being captured, using CSV or compressed Apache Arrow format.
Save a snapshot of plotted data as CSV or JSON
Visualize and analyze power consumption on supported platforms
Monitor data for or input data to an application using a custom dashboard

Screenshot of Data Visualizer

Usage

To start the Data Visualizer, select 'MPLAB: Data Visualizer' from the VS Code command palette and the Data Visualizer view should appear shortly.

The Data Visualizer extension depends on the following extensions, which will be installed automatically.

MPLAB Extensions Core
MPLAB Extensions Platforms

The Data Visualizer process will log diagnostic output to the "MPLAB Platforms" and "MPLAB Data Visualizer" panels in the VS Code output window.

Notes

Please note the following differences between the classic MPLAB Data Visualizer and the integration with VS Code this extension currently provides.

There is no relation to an active code project or debug session as in MPLAB X. This means, e.g. that a DVRT session has to be configured manually, and that DGI program counter polling is not available.
Plugins that work with MPLAB X, such as MPLAB Touch and Machine Learning Partners, are not compatible with this version.
When a new folder is opened or a new folder is added to a multi-root workspace, VS Code can reload, or reset the state of installed extensions. The Data Visualizer session will then be terminated.
A small number of user settings does not have a UI for reverting them once set. This includes e.g. the setting for not showing the "Start visualizing data" dialog when activating a data source (DV-2606).
The default location for a data log file is undefined. Please explicitly select a location for the log file using the file browser to ensure it's location (DV-2602).
The Dashboard's full screen mode does not work. To achieve a similar effect, it is possible to maximize the Dashboard panel tab inside the DV Window manually, and then select the command 'View: Toggle Zen Mode' in the VS Code command palette (DV-2591).

📝 License Information

The MPLAB® Extensions for Visual Studio Code are distributed under a non-exclusive software license agreement provided by Microchip Technology Inc. To review the complete terms and conditions governing the use of this software, please consult the "license" file included with this package.