MCC Melody ADC Data Streamer Example - Callbacks Implementation (PIC18F57Q43)

The ADC Data Streamer example, of the MCC Melody ADCC Example Component, is used in the Callbacks implementation and displays ADCC samples visualized with the Data Streamer. An Analog-to-Digital Conversion measurement is taken every 100 ms on the selected analog channel, also toggling an LED and Debug GPIO.

Video Building This Example

Video: Introducing MCC Melody Example Components (while building the Polled version of the Timer Toggle LED example).

MCC Melody Example Components

Example Components are a tight integration of learning material directly into MCC. This allows users to conveniently place configuration instructions side-by-side to the components they are configuring. For more information, refer to the MCC Melody Example Components Introduction.

Note: The image below shows the ADCC Example Component, as it would be moving to the ADCC Data Streamer, having implemented the ADCC Basic Printf, both of which are part of the Callbacks implementation. In this case. a diff between the two examples is shown.

Complete projects, available in MPLAB® Discover or GitHub, are specific to a board and microcontroller. However, the current project could be recreated on a range of supported microcontrollers by following the steps in the example component.

To explore what an example component is, as well as the difference between example and implementation, see MCC Melody Example Components - The Basics.

Example Components are related to MCC Melody Design Patterns for Control Flow, which shows different standard ways to organize main.c and other application-level files, such as Polling, Interrupt and Callback, or State Machine Design Patterns. Users might be familiar with each of these patterns, but...

• What support does MCC Melody provide for each?
• What are the recommended ways of building on the MCC Melody generated code? 

Software Used

• MPLAB® X IDE 6.20.0 or newer (MPLAB® X IDE 6.20)

• MPLAB® XC8 2.46.0 or newer (MPLAB® XC8 2.46)

• MPLAB® Code Configurator (MCC) Plugin Version 5.5.1 or newer (Tools>Plugins>Installed, search: "MCC")

• ADC Converter with Computation (ADCC) Example Component 1.0.0 or newer

• MCC Core 5.7.1 or newer

• MCC Melody Core 2.7.1 or newer (Communicates with the MCC core, providing views and other functionality for MCC Melody)

Hardware Used

• PIC18F57Q43 Curiosity Nano (DM164150)
• Curiosity Nano Explorer (EV58G97A)

Setup

All instructions required to recreate this example are listed below, under Configuration Instructions.

Once the project is loaded in MPLAB X IDE, the user will be able to find more information from Tooltips and links next to the instructions .

Operation

The image below shows the ADCC Basic Printf example running, using the MPLAB Data Visualizer.

Data Visualizer Configuration

1. Click the icon to open the MPLAB Data Visualizer.
2. Under the Variable Streamers tab (on the left-hand side), click the button, to import a .ds file.
3. From your project root, navigate into mcc_generated_files/data_streamer/ directory.
4. Click the data_streamer.ds file to select it.
5. Then click the button to load the ds file.

The data_streamer Properties window will open up, displaying the loaded adcResult and adcSampleCount variables.

1. Click the button to load this data streamer configuration.

2. Click the button.

3. Select your board from those available.

   Note: If your board is not recognised by the MPLAB Data Visualizer, go to the Device Manager (Windows) to determine the COMx number.

4. Click the icon to bring up the COMx Settings.

5. Set the baud rate to 115200, then click out of the window to close the settings.

6. Click the icon to plot all variables.

1. Click the Connections button.
2. Under Debug GPIO, click the icon to add to the time plot.

For more example components, open the stand-alone Content Manager in MCC.