mcp2517fd  2.0.0.0
Main Page

MCP2517FD click

MCP2517FD click is a complete CAN solution which carries the MCP2517FD CAN FD controller and ATA6563 high-speed CAN transceiver from Microchip, as well as a DB9 9-pin connector.

click Product page


Click library

  • Author : Mikroe Team
  • Date : Oct 2021.
  • Type : SPI type

Software Support

We provide a library for the MCP2517FD Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for MCP2517FD Click driver.

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of an MCP2517FD click board by showing

the communication between the two click boards configured as a receiver and transmitter.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger, performs the click default configuration and displays the selected application mode.

void application_init ( void )
{
log_cfg_t log_cfg;
mcp2517fd_cfg_t mcp2517fd_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
mcp2517fd_cfg_setup( &mcp2517fd_cfg );
MCP2517FD_MAP_MIKROBUS( mcp2517fd_cfg, MIKROBUS_1 );
if ( SPI_MASTER_ERROR == mcp2517fd_init( &mcp2517fd, &mcp2517fd_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( MCP2517FD_ERROR == mcp2517fd_default_cfg ( &mcp2517fd ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
#ifdef DEMO_APP_TRANSMITTER
log_printf( &logger, " Application Mode: Transmitter\r\n" );
#else
log_printf( &logger, " Application Mode: Receiver\r\n" );
#endif
log_info( &logger, " Application Task " );
}

Application Task

Depending on the selected mode, it sends a desired message using CAN protocol or reads all the received data and displays them on the USB UART.

void application_task ( void )
{
#ifdef DEMO_APP_TRANSMITTER
{
log_printf( &logger, " The message \"%s\" has been sent!\r\n", ( char * ) DEMO_TEXT_MESSAGE );
}
Delay_ms( 2000 );
#else
uint8_t data_buf[ 256 ] = { 0 };
uint16_t data_len = 0;
if ( MCP2517FD_OK == mcp2517fd_receive_message( &mcp2517fd, data_buf, &data_len ) )
{
log_printf( &logger, " A new message has received: \"" );
for ( uint16_t cnt = 0; cnt < data_len; cnt++ )
{
log_printf( &logger, "%c", data_buf[ cnt ] );
}
log_printf( &logger, "\"\r\n" );
}
#endif
}

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.MCP2517FD

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.


MCP2517FD_ERROR
@ MCP2517FD_ERROR
Definition: mcp2517fd.h:1921
mcp2517fd_cfg_t
MCP2517FD Click configuration object.
Definition: mcp2517fd.h:1895
application_task
void application_task(void)
Definition: main.c:77
mcp2517fd_cfg_setup
void mcp2517fd_cfg_setup(mcp2517fd_cfg_t *cfg)
MCP2517FD configuration object setup function.
MCP2517FD_MAP_MIKROBUS
#define MCP2517FD_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: mcp2517fd.h:842
mcp2517fd_t
MCP2517FD Click context object.
Definition: mcp2517fd.h:1872
mcp2517fd_init
err_t mcp2517fd_init(mcp2517fd_t *ctx, mcp2517fd_cfg_t *cfg)
MCP2517FD initialization function.
mcp2517fd_transmit_message
err_t mcp2517fd_transmit_message(mcp2517fd_t *ctx, uint8_t *data_in, uint16_t data_len)
Message Transmit function.
application_init
void application_init(void)
Definition: main.c:36
mcp2517fd_default_cfg
err_t mcp2517fd_default_cfg(mcp2517fd_t *ctx)
MCP2517FD default configuration function.
mcp2517fd_reset
err_t mcp2517fd_reset(mcp2517fd_t *ctx)
Reset function.
DEMO_TEXT_MESSAGE
#define DEMO_TEXT_MESSAGE
Definition: main.c:31
mcp2517fd_receive_message
err_t mcp2517fd_receive_message(mcp2517fd_t *ctx, uint8_t *data_out, uint16_t *data_len)
Message Receive function.
MCP2517FD_OK
@ MCP2517FD_OK
Definition: mcp2517fd.h:1920