swipeswitch  2.0.0.0
Main Page

SwipeSwitch click

SwipeSwitch click is capacitive touch, gesture, and proximity sensing Click board™, which is equipped with the IQS266, an integrated trackpad controller circuit which features ProxSense® and IQ Switch® technologies. This IC consists of a 2x3-channel capacitive trackpad controller, and a single self-capacitive proximity sensor, which can be used to wake up the device. This ensures very low power consumption, as the device is able to stay in the Sleep mode when not used. The IQS266 can detect a number of various configurable swipe and tap gestures. An Automatic Tuning Implementation (ATI) feature ensures an optimized performance in various conditions.

click Product page


Click library

  • Author : MikroE Team
  • Date : Dec 2019.
  • Type : I2C type

Software Support

We provide a library for the SwipeSwitch 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 form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.

Library Description

This library contains API for SwipeSwitch Click driver.

Standard key functions :

Example key functions :

  • This function reads Gestures

    uint8_t swipeswitch_read_gestures ( swipeswitch_t *ctx );

  • This function reads X coordinate.

    uint8_t swipeswitch_read_x_coordinate ( swipeswitch_t *ctx );

  • This function reads Y coordinate.

    uint8_t swipeswitch_read_y_coordinate ( swipeswitch_t *ctx );

Examples Description

Click board is able to sense several different swipe gestures.

The demo application is composed of two sections :

Application Init

Initialization and configuration of the chip for measurement.

void application_init ( void )
{
log_cfg_t log_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
SWIPESWITCH_MAP_MIKROBUS( cfg, MIKROBUS_1 );
swipeswitch_init( &swipeswitch, &cfg );
Delay_ms( 300 );
display_mode = SWIPESWITCH_GESTURE_MODE;
if ( display_mode == SWIPESWITCH_GESTURE_MODE)
{
log_printf( &logger, "<<< GESTURE MODE >>> \r\n" );
}
else if ( display_mode == SWIPESWITCH_POSITION_MODE)
{
log_printf( &logger, "<<< POSITION MODE >>> \r\n" );
}
}

Application Task

Display message on a terminal when new event occurs ( TAP or SWIPE ) along with the X and Y coordinates depending on the display_mode value.

void application_task ( void )
{
if ( display_mode == SWIPESWITCH_GESTURE_MODE)
{
events = swipeswitch_read_events( &swipeswitch );
gestures = swipeswitch_read_gestures( &swipeswitch );
if ( ( events & ( SWIPESWITCH_EVENT_SWIPE ) ) != 0 )
{
if ( ( gestures & SWIPESWITCH_GESTURE_SWIPE_UP ) != 0 )
{
log_printf( &logger, "SWIPE UP \r\n" );
}
if ( ( gestures & SWIPESWITCH_GESTURE_SWIPE_DOWN ) != 0 )
{
log_printf( &logger, "SWIPE DOWN \r\n" );
}
if ( ( gestures & SWIPESWITCH_GESTURE_SWIPE_LEFT ) != 0 )
{
log_printf( &logger, "SWIPE LEFT \r\n" );
}
if ( ( gestures & SWIPESWITCH_GESTURE_SWIPE_RIGHT ) != 0 )
{
log_printf( &logger, "SWIPE RIGHT \r\n" );
}
}
else if ( ( events & ( SWIPESWITCH_EVENT_TAP ) ) != 0 )
{
log_printf( &logger,"TAP \r\n" );
}
}
else if ( display_mode == SWIPESWITCH_POSITION_MODE)
{
x_coordinate = swipeswitch_read_x_coordinate( &swipeswitch );
y_coordinate = swipeswitch_read_y_coordinate( &swipeswitch );
if ( ( x_coordinate != old_x_coordinate) || ( y_coordinate != old_y_coordinate ) )
{
log_printf( &logger,"Coordinate : (%u , %u)\r\n", (uint16_t) x_coordinate, (uint16_t) y_coordinate );
old_x_coordinate = x_coordinate;
old_y_coordinate = y_coordinate;
}
}
Delay_ms( 300 );
}

The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.SwipeSwitch

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.


SWIPESWITCH_GESTURE_SWIPE_LEFT
#define SWIPESWITCH_GESTURE_SWIPE_LEFT
Definition: swipeswitch.h:135
SWIPESWITCH_GESTURE_SWIPE_RIGHT
#define SWIPESWITCH_GESTURE_SWIPE_RIGHT
Definition: swipeswitch.h:136
swipeswitch_read_x_coordinate
uint8_t swipeswitch_read_x_coordinate(swipeswitch_t *ctx)
Function for reading X coordinate.
SWIPESWITCH_POSITION_MODE
#define SWIPESWITCH_POSITION_MODE
Definition: main.c:30
application_task
void application_task(void)
Definition: main.c:84
swipeswitch_read_events
uint8_t swipeswitch_read_events(swipeswitch_t *ctx)
Function for reading event.
swipeswitch_read_y_coordinate
uint8_t swipeswitch_read_y_coordinate(swipeswitch_t *ctx)
Function for reading Y coordinate.
swipeswitch_init
SWIPESWITCH_RETVAL swipeswitch_init(swipeswitch_t *ctx, swipeswitch_cfg_t *cfg)
Initialization function.
SWIPESWITCH_EVENT_TAP
#define SWIPESWITCH_EVENT_TAP
Definition: swipeswitch.h:121
swipeswitch_cfg_setup
void swipeswitch_cfg_setup(swipeswitch_cfg_t *cfg)
Config Object Initialization function.
SWIPESWITCH_MAP_MIKROBUS
#define SWIPESWITCH_MAP_MIKROBUS(cfg, mikrobus)
Definition: swipeswitch.h:52
SWIPESWITCH_EVENT_SWIPE
#define SWIPESWITCH_EVENT_SWIPE
Definition: swipeswitch.h:122
swipeswitch_read_gestures
uint8_t swipeswitch_read_gestures(swipeswitch_t *ctx)
Function for reading Gestures.
application_init
void application_init(void)
Definition: main.c:47
SWIPESWITCH_GESTURE_MODE
#define SWIPESWITCH_GESTURE_MODE
Definition: main.c:29
SWIPESWITCH_GESTURE_SWIPE_DOWN
#define SWIPESWITCH_GESTURE_SWIPE_DOWN
Definition: swipeswitch.h:134
swipeswitch_cfg_t
Click configuration structure definition.
Definition: swipeswitch.h:294
SWIPESWITCH_GESTURE_SWIPE_UP
#define SWIPESWITCH_GESTURE_SWIPE_UP
Definition: swipeswitch.h:133