usbtoi2c2 2.0.0.0
Main Page

USB to I2C 2 click

‍USB to I2C 2 Click is a compact add-on board that contains a general-purpose USB to I2C serial interface. This board features the FT201X, a full-speed USB to I2C protocol converter from FTDI. The FT201X converts USB2.0 full-speed to an I2C serial interface capable of operating up to 3.4MBit/s, with low power consumption (typical 8mA). The entire USB protocol is handled on the chip itself, where no USB-specific firmware programming is required. It also has a fully-integrated 2048 byte Multi-Time-Programmable (MTP) memory for storing device descriptors and CBUS I/O user-desirable configuration. This Click boardâ„¢ includes the complete FT-X series feature set and enables USB to be added into a system design quickly and easily over an I2C interface.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Dec 2021.
  • Type : I2C type

Software Support

We provide a library for the USB to I2C 2 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 USB to I2C 2 Click driver.

Standard key functions :

Example key functions :

  • usbtoi2c2_write_data This function writes a desired number of data bytes by using I2C serial interface.
    err_t usbtoi2c2_write_data ( usbtoi2c2_t *ctx, uint8_t *tx_buf, uint8_t tx_len );
    err_t usbtoi2c2_write_data(usbtoi2c2_t *ctx, uint8_t *tx_buf, uint8_t tx_len)
    USB to I2C 2 write data function.
  • usbtoi2c2_read_data This function reads a desired number of data bytes by using I2C serial interface.
    err_t usbtoi2c2_read_data ( usbtoi2c2_t *ctx, uint8_t *rx_buf, uint8_t rx_len );
    err_t usbtoi2c2_read_data(usbtoi2c2_t *ctx, uint8_t *rx_buf, uint8_t rx_len)
    USB to I2C 2 read data function.
  • usbtoi2c2_reset_device This function resets the device by toggling the RST pin state.
    void usbtoi2c2_reset_device(usbtoi2c2_t *ctx)
    USB to I2C 2 reset device function.

Example Description

‍This example demonstrates the use of USB to I2C 2 click by echoing back all the received messages.

The demo application is composed of two sections :

Application Init

‍Initializes the driver and performs the click default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
usbtoi2c2_cfg_t usbtoi2c2_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
usbtoi2c2_cfg_setup( &usbtoi2c2_cfg );
USBTOI2C2_MAP_MIKROBUS( usbtoi2c2_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == usbtoi2c2_init( &usbtoi2c2, &usbtoi2c2_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( USBTOI2C2_ERROR == usbtoi2c2_default_cfg ( &usbtoi2c2 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}
#define USBTOI2C2_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition usbtoi2c2.h:100
void application_init(void)
Definition main.c:33
@ USBTOI2C2_ERROR
Definition usbtoi2c2.h:157

Application Task

‍Any data which the host PC sends to the Virtual COM Port (for example, typed into the terminal

window in UART Terminal) will be sent over USB to the click board and then it will be read and echoed back by the MCU to the PC where the terminal program will display it.

void application_task ( void )
{
uint8_t rx_data = 0;
if ( USBTOI2C2_OK == usbtoi2c2_read_data ( &usbtoi2c2, &rx_data, 1 ) )
{
if ( USBTOI2C2_OK == usbtoi2c2_write_data ( &usbtoi2c2, &rx_data, 1 ) )
{
log_printf( &logger, "%c", rx_data );
}
}
}
void application_task(void)
Definition main.c:69
@ USBTOI2C2_OK
Definition usbtoi2c2.h:156

Note

‍Make sure to download and install appropriate VCP drivers on the host PC.

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.USBtoI2C2

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.