i2cextend  2.0.0.0
Main Page

I2C Extend click

I2C Extend Click is a compact add-on board for applications that require extending the I2C communication bus over a long distance. This board features the LTC4331 - an I2C slave device extender over a rugged differential link, from Analog Devices.

click Product page


Click library

  • Author : Stefan Ilic
  • Date : Jul 2021.
  • Type : I2C type

Software Support

We provide a library for the I2CExtend 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 I2CExtend Click driver.

Standard key functions :

Example key functions :

Example Description

This is an example which demonstrates the use of I2C Extend Click board.

The demo application is composed of two sections :

Application Init

Initialization driver enables - I2C, check communication with device 6DOF IMU 11 Click connected to the I2C Extend Click ( Remote Mode ), set default configuration and start measurement.

void application_init ( void ) {
log_cfg_t log_cfg;
i2cextend_cfg_t i2cextend_cfg;
// Logger initialization.
LOG_MAP_USB_UART( log_cfg );
log_cfg.level = LOG_LEVEL_DEBUG;
log_cfg.baud = 115200;
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
i2cextend_cfg_setup( &i2cextend_cfg );
I2CEXTEND_MAP_MIKROBUS( i2cextend_cfg, MIKROBUS_1 );
err_t init_flag = i2cextend_init( &i2cextend, &i2cextend_cfg );
if ( I2C_MASTER_ERROR == init_flag ) {
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
log_printf( &logger, " SUCCESS \r\n" );
log_printf( &logger, "------------------------\r\n" );
} else {
log_printf( &logger, " ERROR \r\n" );
log_printf( &logger, " Reset the device \r\n" );
log_printf( &logger, "------------------------\r\n" );
for ( ; ; );
}
log_info( &logger, " Application Task " );
log_printf( &logger, "------------------------\r\n" );
}

Application Task

In this example, we read Accel and Mag axis of the connected 6DOF IMU 11 Click boards to the I2C Extend Click ( Remote Mode ) which is connected by a LAN cable to I2C Extend Click ( Local Mode ). Results are being sent to the Usart Terminal where you can track their changes. All data logs write on USB uart changes for every 2 sec.

void application_task ( void ) {
log_printf( &logger, "\t Accel \t|\t Mag \r\n" );
log_printf( &logger, "------------------------------------------------\r\n" );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_ACCEL_XOUT_L );
log_printf( &logger, "\t Accel X: %d\t|", axis );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_MAG_XOUT_L );
log_printf( &logger, "\t Mag X: %d\r\n", axis );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_ACCEL_YOUT_L );
log_printf( &logger, "\t Accel Y: %d\t|", axis );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_MAG_YOUT_L );
log_printf( &logger, "\t Mag Y: %d\r\n", axis );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_ACCEL_ZOUT_L );
log_printf( &logger, "\t Accel Z: %d\t|", axis );
i2cbuffer2_6dofimu11_get_axis( &i2cextend, C6DOFIMU11_REG_MAG_ZOUT_L );
log_printf( &logger, "\t Mag Z: %d\r\n", axis );
log_printf( &logger, "------------------------------------------------\r\n" );
Delay_ms( 1000 );
}

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

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.


C6DOFIMU11_CNTL2_ACCEL_EN_OPERATING_MODE
#define C6DOFIMU11_CNTL2_ACCEL_EN_OPERATING_MODE
Definition: i2cextend.h:139
C6DOFIMU11_INC3_IEL2_FIFO_TRIG
#define C6DOFIMU11_INC3_IEL2_FIFO_TRIG
Definition: i2cextend.h:137
C6DOFIMU11_CNTL2_TEMP_EN_STANDBY_MODE
#define C6DOFIMU11_CNTL2_TEMP_EN_STANDBY_MODE
6DOF IMU 11 bit mask.
Definition: i2cextend.h:134
C6DOFIMU11_REG_MAG_XOUT_L
#define C6DOFIMU11_REG_MAG_XOUT_L
Definition: i2cextend.h:78
C6DOFIMU11_I2C_SLAVE_ADDRESS_GND
#define C6DOFIMU11_I2C_SLAVE_ADDRESS_GND
6DOF IMU 11 device address setting.
Definition: i2cextend.h:160
i2cextend_rmt_multi_read
void i2cextend_rmt_multi_read(i2cextend_t *ctx, uint8_t rmt_slave_addr, uint8_t reg, uint8_t *p_rx_data, uint8_t n_bytes)
Generic multi read data in Remote Mode function.
i2cextend_set_config
void i2cextend_set_config(i2cextend_t *ctx, uint8_t intr_mode, uint8_t ctrl_sel)
Set the configuration function.
C6DOFIMU11_CNTL2_RES_MAX2
#define C6DOFIMU11_CNTL2_RES_MAX2
Definition: i2cextend.h:141
i2cextend_init
err_t i2cextend_init(i2cextend_t *ctx, i2cextend_cfg_t *cfg)
I2C Extend initialization function.
C6DOFIMU11_REG_ACCEL_ZOUT_L
#define C6DOFIMU11_REG_ACCEL_ZOUT_L
Definition: i2cextend.h:77
C6DOFIMU11_WHO_AM_I_WIA_ID
#define C6DOFIMU11_WHO_AM_I_WIA_ID
Definition: i2cextend.h:143
C6DOFIMU11_CNTL2_GSEL_8G
#define C6DOFIMU11_CNTL2_GSEL_8G
Definition: i2cextend.h:140
application_task
void application_task(void)
Definition: main.c:94
i2cextend_cfg_t
I2C Extend Click configuration object.
Definition: i2cextend.h:215
i2cextend_set_out_slave_address
void i2cextend_set_out_slave_address(i2cextend_t *ctx, uint8_t out_slave_address)
Set out slave address function.
C6DOFIMU11_REG_INC3
#define C6DOFIMU11_REG_INC3
Definition: i2cextend.h:74
C6DOFIMU11_CNTL2_ACCEL_EN_STANDBY_MODE
#define C6DOFIMU11_CNTL2_ACCEL_EN_STANDBY_MODE
Definition: i2cextend.h:136
C6DOFIMU11_REG_CNTL2
#define C6DOFIMU11_REG_CNTL2
Definition: i2cextend.h:73
axis
int16_t axis
Definition: main.c:33
i2cextend_t
I2C Extend Click context object.
Definition: i2cextend.h:194
C6DOFIMU11_CNTL2_MAG_EN_OPERATING_MODE
#define C6DOFIMU11_CNTL2_MAG_EN_OPERATING_MODE
Definition: i2cextend.h:142
C6DOFIMU11_REG_MAG_YOUT_L
#define C6DOFIMU11_REG_MAG_YOUT_L
Definition: i2cextend.h:79
C6DOFIMU11_CNTL2_MAG_EN_STANDBY_MODE
#define C6DOFIMU11_CNTL2_MAG_EN_STANDBY_MODE
Definition: i2cextend.h:135
application_init
void application_init(void)
Definition: main.c:48
i2cextend_cfg_setup
void i2cextend_cfg_setup(i2cextend_cfg_t *cfg)
I2C Extend configuration object setup function.
C6DOFIMU11_REG_ACCEL_YOUT_L
#define C6DOFIMU11_REG_ACCEL_YOUT_L
Definition: i2cextend.h:76
C6DOFIMU11_REG_MAG_ZOUT_L
#define C6DOFIMU11_REG_MAG_ZOUT_L
Definition: i2cextend.h:80
C6DOFIMU11_REG_ACCEL_XOUT_L
#define C6DOFIMU11_REG_ACCEL_XOUT_L
Definition: i2cextend.h:75
C6DOFIMU11_REG_WHO_AM_I
#define C6DOFIMU11_REG_WHO_AM_I
6DOF IMU 11 description register.
Definition: i2cextend.h:72
I2CEXTEND_MAP_MIKROBUS
#define I2CEXTEND_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: i2cextend.h:179
C6DOFIMU11_INC3_IEL1_FIFO_TRIG
#define C6DOFIMU11_INC3_IEL1_FIFO_TRIG
Definition: i2cextend.h:138