3.2.2.1 System Hardware Definition (SHD) Based Click Board (CAN-mcp25625) Example on PIC32CM GV VL Curiosity Nano Evaluation Kit + Nano Explorer

Description

This application demonstrates the use of the MCP25625 CAN Click board for transmitting and receiving CAN data with the PIC32CM GV-Value Line Curiosity Nano+ Touch evaluation kit. The mikroBUS interface on the Curiosity Nano Explorer provides a seamless connection to the MCP25625 Click board, ensuring reliable communication between the microcontroller and the CAN transceiver.

The application is built using the System Hardware Definition (SHD) feature, which automatically configures and enables the necessary peripheral access for the Curiosity Nano Explorer. This includes the SPI interface and GPIO connections required for communication with the MCP25625 Click board, as well as the UART interface used for data display.

To demonstrate CAN communication, the setup consists of two hardware configurations:

• Transmitter Setup: PIC32CM GV-Value Line Curiosity Nano+ Touch evaluation kit and MCP25625 CAN Click board mounted on the Curiosity Nano Explorer board, configured to send CAN messages
• Receiver Setup: PIC32CM GV-Value Line Curiosity Nano+ Touch evaluation kit and MCP25625 CAN Click board mounted on the Curiosity Nano Explorer board, configured to receive CAN messages

Both setups are connected through the CAN bus using the CAN_H and CAN_L lines, and both setups are capable of transmitting and receiving CAN messages.

The transmitted and received CAN messages are displayed on a serial terminal through UART, allowing users to easily monitor the flow of CAN data. This demo highlights the integration of SHD with MPLAB Harmony, simplifying peripheral setup and reducing manual configuration effort while showcasing end-to-end CAN communication using MCP25625 Click boards.

Modules/Technology Used

The following figure provides the MCC Harmony project graph with all the components.

Hardware Used

Software/Tools Used

This project has been verified to work with the following versions of software tools:

Refer to the Project Manifest present in harmony-manifest-success.yml under the project folder firmware/src/config/pic32cm_gv_vl_cnano.

• Refer to the Release Notes to know the MPLAB X IDE and MCC Plug-in version
• Any Serial Terminal application, such as Tera Term/PuTTY terminal application

Due to Microchip regularly updates tools, occasionally issue(s) could be discovered while using the newer versions of the tools. If the project does not seem to work and version incompatibility is suspected, it is recommended to double-check and use the same versions that the project was tested with. To download original version of MPLAB Harmony v3 packages, refer to the document How to Use the MPLAB Harmony v3 Project Manifest Feature (DS90003305).

Hardware Setup

Programming Hex File

The pre-built hex file can be programmed by following the below steps.

Programming/Debugging Application Project

Running the Demo

Instructions to Add MCP25625 Functionality to the Application

The user could use this demonstration as an example to add MCP25625 functionality to the MPLAB Harmony v3-based application. Follow the below steps.

1. If the user has not downloaded the pic32cm_gv_mcp25625 demo yet, click here to download, otherwise go to the next step.

2. Unzip the downloaded .zip file.

3. From the unzipped folder pic32cm_gv_mcp25625/firmware/src, copy the folder click_routines to the folder firmware/src under the MPLAB Harmony v3 application project.

4. Open MPLAB X IDE.

5. Open the application project.

6. In the project explorer, right click on the Header Files folder and add a sub folder, click_routines, by selecting Add Existing Items from Folders...

   

7. Click the Add Folder... button.

   

8. Select the click_routines folder and select Files of Types as Header Files.

   

9. Click the Add button to add the selected folder.

   

10. The MCP25625 click example header files gets added to the project.

    

11. In the project explorer, right click on the Source Files folder and add a sub folder, click_routines, by selecting Add Existing Items from Folders...

    

12. Click the Add Folder... button.

    

13. Select the click_routines folder and select Files of Types as Source Files.

    

14. Click the Add button to add the selected folder.

    

15. The MCP25625 click example source files gets added to the project.

    

16. The MCP25625 Click example requires specific peripheral and pin configurations. The exact configuration depends on the PIC32CM GV-Value Line Curiosity Nano board used in conjunction with the Curiosity Nano Explorer board, which provides connectivity to the MCP25625 Click board.
    • Configure the SHD:
      • Add the SHD component of PIC32CMGV-Curiosity-Nano-Explorer block to the MCC project graph.

        

      • Select PIC32CMGV-Curiosity-Nano-Explorer block in the project graph. In the Configuration Options window, go to External Connectors>Curiosity Nano Explorer mikroBUS and select MCP25625 click.

        

      • MCC automatically adds the peripheral configuration to the Project Graph after MCP25625 selection.

        

      • For Curiosity Nano Explorer mikroBus - MCP25625 configuration, only the AN, SPI, RST configurations are required.

        Disable additional, unused configurations (PWM, INT, UART and I²C) in the Curiosity Nano Base mikroBUS 1 Configuration Options window.

        

      • Enable the Virtual COM Port interface in the On-Board Nano Debugger interface

        

      • Users can view the pin configuration for RST, AN, UART, and SPI lines in the pin settings window, which are used for CAN communication.

        

      • Map Generic Macros:
        • After generating the project, following the above configuration, map the generic macros used in the click routines to the Harmony PLIB APIs of the 32-bit MCU the project is running on.
        • The generic macros should be mapped in the click_interface.h header file.

          

          As an example, the MCP25625 click routines for the example on PIC32CM GV-Value Line Curiosity Nano evaluation kit uses the following Harmony PLIB APIs.

          

        • The click_routines folder contain an example C source file mcp25625_example.c. The user could use mcp25625_example.c as a reference to add MCP25625 functionality to the application.

Comments