hbridge  2.1.0.0
Main Page

H-Bridge click

H-Bridge click is a high-efficiency dual H-bridge driver Click boardâ„¢, capable of providing reasonably high current while driving the connected load with up to 7V. Since the used driver IC has two full H-bridge channels, this Click boardâ„¢ is an ideal solution for driving smaller bipolar stepper motors. H-Bridge click provides driving in both directions, with an addition of the brake mode, and the high impedance mode (Hi-Z). Overshoot current suppression algorithm protects the output stages from being damaged if both high-side and low-side MOSFETs on a single H-bridge channel become conductive.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Feb 2024.
  • Type : GPIO type

Software Support

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

Standard key functions :

Example key functions :

  • hbridge_set_step_mode This function sets the step mode resolution settings in ctx->step_mode.
    void hbridge_set_step_mode ( hbridge_t *ctx, uint8_t mode );
  • hbridge_set_direction This function sets the motor direction to clockwise or counter-clockwise in ctx->direction.
    void hbridge_set_direction ( hbridge_t *ctx, uint8_t dir );
  • hbridge_drive_motor This function drives the motor for the specific number of steps at the selected speed.
    void hbridge_drive_motor ( hbridge_t *ctx, uint32_t steps, uint8_t speed );

Example Description

This example demonstrates the use of the H-Bridge click board by driving the motor in both directions for a desired number of steps.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger.

void application_init ( void )
{
log_cfg_t log_cfg;
hbridge_cfg_t hbridge_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
hbridge_cfg_setup( &hbridge_cfg );
HBRIDGE_MAP_MIKROBUS( hbridge_cfg, MIKROBUS_1 );
if ( DIGITAL_OUT_UNSUPPORTED_PIN == hbridge_init( &hbridge, &hbridge_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Drives the motor clockwise for 200 full steps and then counter-clockiwse for 400 half

steps with a 2 seconds delay before changing the direction. All data is being logged on the USB UART where you can track the program flow.

void application_task ( void )
{
log_printf ( &logger, " Move 200 full steps clockwise\r\n\n" );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
log_printf ( &logger, " Move 400 half steps counter-clockwise\r\n\n" );
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.HBridge

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.


HBRIDGE_MODE_HALF_STEP
#define HBRIDGE_MODE_HALF_STEP
Definition: hbridge.h:87
HBRIDGE_DIR_CCW
#define HBRIDGE_DIR_CCW
Definition: hbridge.h:73
application_task
void application_task(void)
Definition: main.c:60
hbridge_cfg_t
H-Bridge Click configuration object.
Definition: hbridge.h:145
hbridge_drive_motor
void hbridge_drive_motor(hbridge_t *ctx, uint32_t steps, uint8_t speed)
H-Bridge driver motor function.
HBRIDGE_MODE_FULL_STEP
#define HBRIDGE_MODE_FULL_STEP
H-Bridge step resolution setting.
Definition: hbridge.h:86
hbridge_t
H-Bridge Click context object.
Definition: hbridge.h:129
HBRIDGE_SPEED_FAST
#define HBRIDGE_SPEED_FAST
Definition: hbridge.h:96
hbridge_init
err_t hbridge_init(hbridge_t *ctx, hbridge_cfg_t *cfg)
H-Bridge initialization function.
HBRIDGE_MAP_MIKROBUS
#define HBRIDGE_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: hbridge.h:115
hbridge_set_step_mode
void hbridge_set_step_mode(hbridge_t *ctx, uint8_t mode)
H-Bridge set step mode function.
hbridge_set_direction
void hbridge_set_direction(hbridge_t *ctx, uint8_t dir)
H-Bridge set direction function.
application_init
void application_init(void)
Definition: main.c:30
HBRIDGE_SPEED_MEDIUM
#define HBRIDGE_SPEED_MEDIUM
Definition: hbridge.h:95
hbridge_cfg_setup
void hbridge_cfg_setup(hbridge_cfg_t *cfg)
H-Bridge configuration object setup function.
HBRIDGE_DIR_CW
#define HBRIDGE_DIR_CW
H-Bridge direction setting.
Definition: hbridge.h:72