haptic3  2.0.0.0
Main Page

HAPTIC 3 Click

Haptic 3 Click is a compact add-on board that uses advanced vibration patterns and waveforms to convey information to a user. This board features the DA7282, a linear resonant actuator (LRA), and an eccentric rotating mass (ERM) haptic driver from Dialog Semiconductor. The DA7282 features LRA or ERM drive capability with automatic closed-loop LRA resonant frequency tracking, guaranteeing consistency across LRA production tolerances. It also offers wideband operation that fully utilizes the capabilities of newer wideband and multi-directional LRAs, alongside three external general-purpose inputs for triggering up to six independent haptic sequences.

Click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Feb 2022.
  • Type : I2C type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of HAPTIC 3 Click board by controlling the attached motor vibration level.

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;
haptic3_cfg_t haptic3_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
haptic3_cfg_setup( &haptic3_cfg );
HAPTIC3_MAP_MIKROBUS( haptic3_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == haptic3_init( &haptic3, &haptic3_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( HAPTIC3_ERROR == haptic3_default_cfg ( &haptic3 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Changes the motor vibration level every 2 seconds from MAX to MIN, and displays the currently set level on the USB UART.

void application_task ( void )
{
float vibration_level;
{
if ( HAPTIC3_OK == haptic3_get_vibration_level ( &haptic3, &vibration_level ) )
{
log_printf( &logger, " Vibration level: %.3f \r\n\n", vibration_level );
}
}
Delay_ms ( 1000 );
Delay_ms ( 1000 );
{
if ( HAPTIC3_OK == haptic3_get_vibration_level ( &haptic3, &vibration_level ) )
{
log_printf( &logger, " Vibration level: %.3f \r\n\n", vibration_level );
}
}
Delay_ms ( 1000 );
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.HAPTIC3

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.


haptic3_write_register
err_t haptic3_write_register(haptic3_t *ctx, uint8_t reg, uint8_t data_in)
HAPTIC 3 write register function.
haptic3_get_vibration_level
err_t haptic3_get_vibration_level(haptic3_t *ctx, float *level)
HAPTIC 3 get vibration level function.
haptic3_cfg_t
HAPTIC 3 Click configuration object.
Definition: haptic3.h:282
haptic3_init
err_t haptic3_init(haptic3_t *ctx, haptic3_cfg_t *cfg)
HAPTIC 3 initialization function.
HAPTIC3_VIBRATION_LEVEL_MAX
#define HAPTIC3_VIBRATION_LEVEL_MAX
Definition: haptic3.h:209
application_task
void application_task(void)
Definition: main.c:65
haptic3_default_cfg
err_t haptic3_default_cfg(haptic3_t *ctx)
HAPTIC 3 default configuration function.
haptic3_t
HAPTIC 3 Click context object.
Definition: haptic3.h:262
HAPTIC3_MAP_MIKROBUS
#define HAPTIC3_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: haptic3.h:248
HAPTIC3_OK
@ HAPTIC3_OK
Definition: haptic3.h:300
HAPTIC3_ERROR
@ HAPTIC3_ERROR
Definition: haptic3.h:301
HAPTIC3_VIBRATION_LEVEL_MIN
#define HAPTIC3_VIBRATION_LEVEL_MIN
Definition: haptic3.h:208
haptic3_set_vibration_level
err_t haptic3_set_vibration_level(haptic3_t *ctx, float level)
HAPTIC 3 set vibration level function.
application_init
void application_init(void)
Definition: main.c:29
haptic3_cfg_setup
void haptic3_cfg_setup(haptic3_cfg_t *cfg)
HAPTIC 3 configuration object setup function.