2.1 Data Streamer Library Overview

• Add the Data Streamer to the project (Libraries > Data Visualizer > Data Streamer)

• Check the schematics of the board to see the UART that is connected to the debugger, which has a COM PORT that the PC/Data Visualizer can see  

• Configure the Data Streamer as described in the example

• Check the Tx/Rx pin configurations in Pin Manager (LED pin where applicable)

• Generate the code

• Add the code snippet to the application code (adding the required headers and calling relevant code snippet(s))

• Program the board

• Open a terminal (e.g. MPLAB Data Visualizer) and connect at configured baud rate

• Data Streamer:

  1. UART Dependency Selection: Select the UART that is connected to the debugger, which in turn has a COM PORT that PC/Data Visualizer can see (Check the schematics of your board).

• Data Streamer Table: Create the following variables, with the specified types:

  1. Count, uint8_t

  2. Count16, uint16_t

  3. Count32, uint32_t

  4. Count_f, float

• System > Pins:

  1. Pin Grid View: Select LED pin as output (Check the schematic for your board).

  2. Pins: Rename Custom Name to "LED".

#include "mcc_generated_files/system/system.h" 

volatile bool SEND_FRAME = false;
//Include delay header if needed. 

void DS_Frame_Update(void){
    DataStreamer.count +=5; /*Update variable values */
    DataStreamer.count16 += 1000;
    DataStreamer.count32 += 50000000;
    DataStreamer.count_f += 1.5;
    SEND_FRAME = true;   /* Variable values updated, a new Data Streamer frame can be sent. */
}

int main(void)
{
    SYSTEM_Initialize();
    
    DataStreamer.count = 0;
    DataStreamer.count16 = 0;
    DataStreamer.count32 = 0;
    DataStreamer.count_f = 1.5;
    
    while(1)
    {
        DS_Frame_Update();
        if(SEND_FRAME){
            WriteFrame();
            SEND_FRAME = false;
            LED_Toggle();
        }
        // add delay here if needed 
    }
}

• Data Streamer:

  1. UART Dependency Selection: Select the UART that is connected to the debugger, which in turn has a COM PORT that PC/Data Visualizer can see (Check the schematics of your board)

• Data Streamer Table: Create the following variables, with the specified types:

  1. Count, uint8_t

  2. Count16, uint16_t

  3. Count32, uint32_t

  4. Count_f, float

• System > Pins:

  1. Pin Grid View: Select LED pin as output (Check the schematic for your board).

  2. Pins: Rename Custom Name to "LED".

• data_streamer.ds file

  1. Double click to open: ./mcc_generated_files/data_streamer/data_streamer.ds.

  2. Add: W,1,1,new32 (after count32 variable, as shown in the code snippet below).

/* mcc_generated_files/data_streamer/data_streamer.ds */
B,1,1,count
-D,1,1,count16
W,1,1,count32
W,1,1,new32   /* This line is added manually */
F,1,1,count_f

#include "mcc_generated_files/system/system.h"   

volatile bool SEND_FRAME = false;

struct{
    uint8_t count;
    uint16_t count16;
    uint32_t count32;
    uint32_t new32;
    float count_f;
}my_struct;

void DS_Frame_Update(void){
    my_struct.count +=5; /*Update variable values */
    my_struct.count16 += 1000;
    my_struct.count32 += 50000000;
    my_struct.new32 += 30000000;
    my_struct.count_f += 1.5;
    SEND_FRAME = true;  /* Variable values updated, a new Data Streamer frame can be sent. */
}

int main(void)
{
    SYSTEM_Initialize();
    DataStreamer_PackageSet(&my_struct,sizeof(my_struct));
    
    my_struct.count = 0;
    my_struct.count16 = 0;
    my_struct.count32 = 0;
    my_struct.new32 = 0;
    my_struct.count_f = 1.5;
    
    while(1)
    {
        DS_Frame_Update();
        if(SEND_FRAME){
            WriteFrame();
            SEND_FRAME = false;
            LED_Toggle();
        }
        // add delay here if needed
    }
}

• Data Streamer:

  1. UART Dependency Selection: Select the UART that is connected to the debugger, which in turn has a COM PORT that PC/Data Visualizer can see (Check the schematics of your board).

• Data Streamer Table: Create the following variables, with the specified types:

  1. Count, uint8_t

  2. Count16, uint16_t

  3. Count32, uint32_t

  4. Count_f, float

• System > Pins:

  1. Pin Grid View: Select LED pin as output (Check the schematic for your board).

  2. Pins: Rename Custom Name to "LED".

• Timer:  

  1. Add a timer to your project, follow instructions for 100 ms timer, configure it as directed.

#include "mcc_generated_files/system/system.h"   

/* Create a pointer of type TMR_INTERFACE and assign it to the address of the TCA0_Interface TMR_INTERFACE struct.
Add a Timer to your project, look for: const struct TMR_INTERFACE TMRx_xxx in TMRx.c. */
const struct TMR_INTERFACE *Timer = &TCA0_Interface;

volatile bool SEND_FRAME = false;

void Timer_Callback(void){
    LED_Toggle();
    DataStreamer.count +=5; /*Update variable values */
    DataStreamer.count16 += 1000;
    DataStreamer.count32 += 50000000;
    DataStreamer.bobs32 += 30000000;
    DataStreamer.count_f += 1.5;
    SEND_FRAME = true;  /* Variable values updated, a new Data Streamer frame can be sent. */
}

int main(void)
{
    SYSTEM_Initialize();
    Timer->TimeoutCallbackRegister(Timer_Callback);
    
    DataStreamer.count = 0;
    DataStreamer.count16 = 0;
    DataStreamer.count32 = 0;
    DataStreamer.count_f = 1.5;
    
    while(1)
    {
        if(SEND_FRAME){
            WriteFrame();
            SEND_FRAME = false;
            LED_Toggle();
        }
    }
}