Library Description

The library covers all the necessary functions to control Touchpad 3 Click board™. Library performs a standard I2C interface communication.

Key functions:

• uint16_t *x_axis, uint16_t *y_axis  - Get touch data function.
• uint8_t offset_loc, uint8_t tx_data, uint8_t *p_response  - Write register data function.
• uint8_t offset_loc, uint8_t *read_data, uint8_t *p_response  - Read register data function.

Examples description

The application is composed of three sections :

• System Initialization - Initializes I2C, set RST pin as an output, set INT pin as input and start to write log.
• Application Initialization - Initialization driver enables - I2C, perform a hardware reset, configuration (general, decoding, sensor mapping), get device ID and enable the touch, also write log.
• Application Task - (code snippet) This is an example that demonstrates the use of the Touchpad 3 Click board™. Touchpad 3 Click board™ uses USB UART log to display X and Y coordinates of the touch, depending on the selected Touch ID. All data logs write on USB UART for every change.

void application_task ( )
{
    if ( touchpad3_get_int( ) == TOUCHPAD3_INT_STATUS_HIGH )
    {
       touchpad3_get_touch( &touch_data, &x_axis, &y_axis );
       Delay_ms( 100 );

        if ( ( touch_data.tch_state == TOUCHPAD3_STATE_TCH ) &&
             ( touch_data.touch_id == touch_id_state ) )
        {
            WordToStr( x_axis, log_text );
            mikrobus_logWrite( "  X Coordinate : ", _LOG_TEXT );
            mikrobus_logWrite( log_text, _LOG_LINE );

            WordToStr( y_axis, log_text );
            mikrobus_logWrite( "  Y Coordinate : ", _LOG_TEXT );
            mikrobus_logWrite( log_text, _LOG_LINE );
            mikrobus_logWrite( "------------------------------", _LOG_LINE );
            
            Delay_ms( 100 );
        }
    }
}

Additional Functions :

• void display_status ( )- Display status.

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversions

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.