Skip to content

Latest commit

 

History

History
117 lines (113 loc) · 6.74 KB

README.md

File metadata and controls

117 lines (113 loc) · 6.74 KB
Raw

DataVisualizer

This library is intended to simplify the use from Microchip Data Visualizer via the Atmel Data Protocol. The Atmel Data Protocol is a content independent protocol intended for transferring data from a target MCU to a host PC. The connection can be established via a Serial Port or the Data Gateway Interface (EDBG-based Debugger).

Quick Guide

  1. Download Michrochip Data Visualizer. Link
  2. Download Arduino Data Visualizer Library.
  3. Open Arduino, select default example, compile and upload project.
  4. Open Data Visualizer, select Serial Port Panel and press Connect.

Known Issues & Solution

  • No Y-Values displayed in Graph Visualization

In the left Top Corner select Configuration. At the bottom in Configuration Window switch Theme (Dark/Light).

  • Not all possible Graph Settings are available

The Graph Module is bad supported. This is related to the Atmel Data Protocol.

  • After connect there is a ADP Control Panel but nothing else

This sometimes happens at a Baudrate of 9600. Just push Disconnect & Connect again.

  • Received Dashboard Slider values are inconsistent

The Samplingrate of the Dashboard Slider is vague. The Slider has to be moved slowly.

Reference

Functions Tree Overview

DataVisualizer
├── bool setup(Configuration config);
├── bool request(void);
├── void refresh(void);
├── void reset(void);   
├── void onTransmit(void (*)(uint8_t*, uint16_t));
├── void onReceive(uint16_t (*)(uint8_t*, uint16_t));
├── void onTransceive(uint16_t (*)(uint8_t*, uint8_t*, uint16_t));
├── void begin(DataGateway com);
├── void begin(Stream* uart);
├── void begin(TwoWire* twi, uint8_t address);    
├── void begin(SPIClass* spi, uint8_t ss);
├── void addInfo(const char* title, const char* description);
├── Terminal addTerminal(const char* title);
├── Terminal addTerminal(const char* title, RgbColor bgColor, RgbColor fgColor);
│   ├── uint16_t available(void);
│   ├── void print(int n);
│   ├── void print(long n);
│   ├── void print(char c);
│   ├── void print(const char *c);
│   ├── void println(int n);
│   ├── void println(long n);
│   ├── void println(char c);
│   ├── void println(const char *c);
│   ├── char read(void);
│   └── void read(char* buffer);
├── Graph addGraph(const char* title);
├── Graph addGraph(const char* title, RgbColor bgColor);
├── GraphAxis addAxis(const char *title, RgbColor color);
└── GraphAxis addAxis(const char *title, RgbColor color, int32_t yMin, int32_t yMax);
│   ├── GraphAxisChannel addChannel(const char *label);
│   └── GraphAxisChannel addChannel(const char *label, RgbColor color);
│       ├── GraphAxisCursor addCursor(const char *label);
│       └── GraphAxisCursor addCursor(const char *label, RgbColor color);
├── Dashboard addDashboard(const char* title);
├── Dashboard addDashboard(const char* title);
└── Dashboard addDashboard(const char* title, uint16_t height, RgbColor color, uint16_t height);
    ├── DashboardButton addButton(const uint8_t* config);
    ├── DashboardButton addButton(const char* text, ConfigDashboardButton config);
    ├── DashboardButton addButton(const char* textOn, const char* textOff, ConfigDashboardButton config);
    │   ├── bool pressed(void);
    │   └── bool toggled(void);
    ├── DashboardLabel addLabel(const uint8_t* config);
    ├── DashboardLabel addLabel(const char* text, ConfigDashboardLabel config);
    ├── DashboardSlider addSlider(const uint8_t* config);
    ├── DashboardSlider addSlider(ConfigDashboardSlider config);
    │   ├── bool feed(void);
    │   └── int32_t read(void);
    ├── DashboardSignal addSignal(const uint8_t* config);
    ├── DashboardSignal addSignal(ConfigDashboardSignal config);
    │   ├── void on(void);
    │   └── void off(void);
    ├── DashboardProgressBar addProgressBar(const uint8_t* config);
    ├── DashboardProgressBar addProgressBar(ConfigDashboardProgressBar config);
    │   └── void write(int32_t value);
    ├── DashboardSegmentDisplay addSegmentDisplay(const uint8_t* config);
    ├── DashboardSegmentDisplay addSegmentDisplay(ConfigDashboardSegmentDisplay config);
    │   └── void write(int32_t value);
    ├── DashboardGraph addGraph(const uint8_t* config);
    ├── DashboardGraph addGraph(const char* text, ConfigDashboardGraph config);
    │   └── DataVisualizerDashboardGraphChannel addChannel(const char* text);
    │       └── void write(int32_t value);
    ├── DashboardRadioGroup addRadioGroup(const uint8_t* config);
    ├── DashboardRadioGroup addRadioGroup(ConfigDashboardRadioGroup config);
    │   ├── bool pressed(void);
    │   └── uint8_t selected(void);
    ├── DashboardPieChart addPieChart(const uint8_t* config);
    ├── DashboardPieChart addPieChart(const char* text, ConfigDashboardPieChart config);
    │   └── DataVisualizerDashboardPieChartSlice addSlice(const char* text);
    │       └── void write(int32_t value);
    ├── DashboardNumericInput addNumericInput(const uint8_t* config);
    ├── DashboardNumericInput addNumericInput(ConfigDashboardNumericInput config);
    │   ├── bool feed(void);
    │   └── int32_t read(void);
    ├── DashboardCheckBox addCheckBox(const uint8_t* config);
    ├── DashboardCheckBox addCheckBox(const char* text, ConfigDashboardCheckBox config);
    │   ├── bool pressed(void);
    │   └── bool selected(void);
    ├── DashboardRectangle addRectangle(const uint8_t* config);
    ├── DashboardRectangle addRectangle(ConfigDashboardRectangle config);
    ├── DataVisualizerDashboardSurfaceGrid addSurfaceGrid(const uint8_t* config);
    ├── DataVisualizerDashboardSurfaceGrid addSurfaceGrid(ConfigDashboardSurfaceGrid config);
    ├── DataVisualizerDashboardTable addTable(const uint8_t* config);
    └── DataVisualizerDashboardTableCell addCell(const char* text);
            └── void write(int32_t value);