expand16 2.1.0.0
Main Page

Expand 16 click

PRVIH_PAR_RECENICA_SA_PRODUCT_PAGE_DA_ISPRATE_CELINU

[click Product page](CLICK_PRODUCT_PAGE_LINK)


Click library

  • Author : Stefan Ilic
  • Date : Oct 2023.
  • Type : I2C type

Software Support

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

Standard key functions :

Example key functions :

  • expand16_write_reg Expand 16 register write function.
    err_t expand16_write_reg ( expand16_t *ctx, uint8_t reg, uint8_t data_in );
    err_t expand16_write_reg(expand16_t *ctx, uint8_t reg, uint8_t data_in)
    Expand 16 register write function.
  • expand16_set_io_dir Expand 16 set pin input or output direction function.
    err_t expand16_set_io_dir ( expand16_t *ctx, uint8_t input_pins, uint8_t output_pins );
    err_t expand16_set_io_dir(expand16_t *ctx, uint8_t input_pins, uint8_t output_pins)
    Expand 16 set pin input or output direction function.
  • expand16_set_output_state Expand 16 set output pins state function.
    err_t expand16_set_output_state ( expand16_t *ctx, uint8_t clr_mask, uint8_t set_mask );
    err_t expand16_set_output_state(expand16_t *ctx, uint8_t clr_mask, uint8_t set_mask)
    Expand 16 set output pins state function.

Example Description

This example demonstrates the use of Expand 16 click board by setting and reading

the ports state.

The demo application is composed of two sections :

Application Init

Initializes the driver and performs the click default configuration which sets

half of the pins as output ( GPIO4, GPIO5, GPIO6 and GPIO7 ) and the other half of the pins as inputs ( GPIO0, GPIO1, GPIO2 and GPIO3 ).

void application_init ( void )
{
log_cfg_t log_cfg;
expand16_cfg_t expand16_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
expand16_cfg_setup( &expand16_cfg );
EXPAND16_MAP_MIKROBUS( expand16_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == expand16_init( &expand16, &expand16_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
uint8_t dev_id = 0;
if ( EXPAND16_DEVICE_ID != ( dev_id & EXPAND16_DEVICE_ID ) )
{
log_error( &logger, " Communication error." );
for ( ; ; );
}
if ( EXPAND16_ERROR == expand16_default_cfg ( &expand16 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}
@ EXPAND16_ERROR
Definition: expand16.h:193
#define EXPAND16_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: expand16.h:140
#define EXPAND16_REG_DEV_ID_AND_CTRL
Expand 16 description register.
Definition: expand16.h:59
#define EXPAND16_DEVICE_ID
Expand 16 device ID.
Definition: expand16.h:107
err_t expand16_read_reg(expand16_t *ctx, uint8_t reg, uint8_t *data_out)
Expand 16 register read function.
void application_init(void)
Definition: main.c:47

Application Task

Sets the state of the output pins and then reads the status of input pins

and displays the results on the USB UART approximately 2 seconds.

void application_task ( void )
{
uint8_t tmp_data = 0;
log_printf( &logger, "Output pins state: HIGH \r\n" );
log_printf( &logger, "- - - - - - - - - - - - -\r\n" );
expand16_read_reg( &expand16, EXPAND16_REG_INPUT_STATE, &tmp_data );
show_input_pin_state( tmp_data );
Delay_ms( 2000 );
log_printf( &logger, "Output pins state: LOW \r\n" );
log_printf( &logger, "- - - - - - - - - - - - -\r\n" );
expand16_read_reg( &expand16, EXPAND16_REG_INPUT_STATE, &tmp_data );
show_input_pin_state( tmp_data );
Delay_ms( 2000 );
}
#define EXPAND16_REG_INPUT_STATE
Definition: expand16.h:66
#define EXPAND16_PIN_MASK_NONE
Expand 16 description setting.
Definition: expand16.h:86
#define EXPAND16_PIN_MASK_GPIO_5
Definition: expand16.h:92
#define EXPAND16_PIN_MASK_GPIO_4
Definition: expand16.h:91
#define EXPAND16_PIN_MASK_GPIO_6
Definition: expand16.h:93
#define EXPAND16_PIN_MASK_GPIO_7
Definition: expand16.h:94
void application_task(void)
Definition: main.c:91

Note

In order for this example to work as intended it is necessary to connect the input and output pins

eg. GPIO0 and GPIO4, GPIO1 and GPIO5 etc. Floating input pins will be shown as a low state.

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

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.