\mainpage Main Page
MCP2003B Click is a compact add-on board with a physical interface to automotive and industrial LIN systems compliant with the LIN Bus Specification Revision 2.2, SAE J2602, and ISO 17987. This board features the MCP2003B, a LIN transceiver from Microchip. The LIN, which stands for a Local Interconnect Network, is used in conjunction with the CAN interface for communication between the components inside of vehicles. The MCP2003B is a bi-directional half-duplex LIN transceiver that supports baud rates up to 20Kbaud with a LIN-compatible output driver. According to the standard on which this LIN transceiver works, connecting up to 15 peripheral devices to a single controller device is possible.
- Author : Stefan Filipovic
- Date : Feb 2024.
- Type : UART type
We provide a library for the MCP2003B 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.
This library contains API for MCP2003B Click driver.
mcp2003b_cfg_setup
Config Object Initialization function.
void mcp2003b_cfg_setup ( mcp2003b_cfg_t *cfg );
mcp2003b_init
Initialization function.
err_t mcp2003b_init ( mcp2003b_t *ctx, mcp2003b_cfg_t *cfg );
mcp2003b_generic_write
This function writes a desired number of data bytes by using UART serial interface.
err_t mcp2003b_generic_write ( mcp2003b_t *ctx, uint8_t *data_in, uint16_t len );
mcp2003b_generic_read
This function reads a desired number of data bytes by using UART serial interface.
err_t mcp2003b_generic_read ( mcp2003b_t *ctx, uint8_t *data_out, uint16_t len );
mcp2003b_set_cs_pin
This function sets the chip select (CS) pin logic state.
void mcp2003b_set_cs_pin ( mcp2003b_t *ctx, uint8_t state );
This example demonstrates the use of an MCP2003B Click board by showing the communication between the two Click board configured as a receiver and transmitter.
The demo application is composed of two sections :
Initializes the driver and logger and displays the selected application mode.
void application_init ( void )
{
log_cfg_t log_cfg; /**< Logger config object. */
mcp2003b_cfg_t mcp2003b_cfg; /**< Click config object. */
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
mcp2003b_cfg_setup( &mcp2003b_cfg );
MCP2003B_MAP_MIKROBUS( mcp2003b_cfg, MIKROBUS_1 );
if ( UART_ERROR == mcp2003b_init( &mcp2003b, &mcp2003b_cfg ) )
{
log_error( &logger, " Communication init." );
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 " );
}
Depending on the selected mode, it reads all the received data or sends the desired message every 3 seconds.
void application_task ( void )
{
#ifdef DEMO_APP_TRANSMITTER
mcp2003b_generic_write( &mcp2003b, DEMO_TEXT_MESSAGE, strlen( DEMO_TEXT_MESSAGE ) );
log_printf( &logger, "%s", ( char * ) DEMO_TEXT_MESSAGE );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
#else
uint8_t rx_data = 0;
if ( mcp2003b_generic_read( &mcp2003b, &rx_data, 1 ) > 0 )
{
log_printf( &logger, "%c", rx_data );
}
#endif
}
The Click boards should be connected as follows: VBB->VBB, LBUS->LBUS, GND->GND. The communication power supply voltage provided on VBB pin should be in range from 5.5V to 30V.
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.MCP2003B
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. UART terminal is available in all MikroElektronika compilers.