Brushless 8 click
Brushless 8 Click is a compact add-on board suitable for controlling BLDC motors with any MCU. This board features the TC78B042FTG, a sine-wave PWM drive three-phase full-wave brushless motor controller from Toshiba Semiconductor.
click Product page
Click library
- Author : Luka Filipovic
- Date : Dec 2020.
- Type : I2C type
Software Support
We provide a library for the Brushless8 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 Brushless8 Click driver.
Standard key functions :
- Config Object Initialization function.
void brushless8_cfg_setup ( brushless8_cfg_t *cfg );
- Initialization function.
BRUSHLESS8_RETVAL brushless8_init ( brushless8_t *ctx, brushless8_cfg_t *cfg );
- Click Default Configuration function.
void brushless8_default_cfg ( brushless8_t *ctx );
Example key functions :
brushless8_cfg_setup
function initializes click configuration structure to initial values.
void brushless8_cfg_setup(brushless8_cfg_t *cfg)
Brushless 8 configuration object setup function.
brushless8_init
function initializes all necessary pins and peripherals used for this click board.
#define BRUSHLESS8_RETVAL
Brushless 8 function status.
Definition: brushless8.h:109
BRUSHLESS8_RETVAL brushless8_init(brushless8_t *ctx, brushless8_cfg_t *cfg)
Brushless 8 initialization function.
brushless8_default_cfg
function executes a default configuration of Brushless 8 click board.
BRUSHLESS8_RETVAL brushless8_default_cfg(brushless8_t *ctx)
Brushless 8 default configuration function.
Examples Description
This application is a schowcase of controlling speed and direction of brushless motor with hall sesnor.
The demo application is composed of two sections :
Application Init
Initializes the click board to appropriate settings based on selected mode. Initialization settings are sent through I2C bus and the motor itself is controlled via PWM or DAC over I2C.
- Modes:
- BRUSHLESS8_PWM
- BRUSHLESS8_DAC
{
log_cfg_t log_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "Application Init" );
{
log_error( &logger, "Application Init Error" );
log_info( &logger, "Please, run program again..." );
for ( ; ; );
}
{
Delay_ms( 3000 );
}
{
Delay_ms( 3000 );
}
log_info( &logger, "Application Task" );
log_printf( &logger, "------------------------------\r\n" );
}
#define BRUSHLESS8_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: brushless8.h:300
#define BRUSHLESS8_DAC_REG_CHN_A_DVSP
Definition: brushless8.h:64
#define BRUSHLESS8_OK
Definition: brushless8.h:110
#define BRUSHLESS8_DAC
Brushless 8 motor control settings.
Definition: brushless8.h:281
#define BRUSHLESS8_PWM
Definition: brushless8.h:282
void brushless8_pwm_start(brushless8_t *ctx)
Starts PWM module.
int8_t brushless8_set_dac_vout(brushless8_t *ctx, uint8_t dac_chn, uint16_t vout)
Brushless 8 I2C function for setting vout.
void brushless8_set_duty_cycle(brushless8_t *ctx, float duty_cycle)
Sets PWM duty cycle.
void brushless8_pwm_stop(brushless8_t *ctx)
Stops PWM module.
void application_init(void)
Definition: main.c:50
#define BRUSHLESS8_MODE
Definition: main.c:38
Brushless 8 Click configuration object.
Definition: brushless8.h:341
uint8_t ctrl_mod
Definition: brushless8.h:358
Application Task
This example demonstrates the use of Brushless 8 click board. Brushless 8 click communicates with the device via I2C driver in order to set adequate voltage level for connected motor. Current PWM/DAC settings being output are sent via logger.
{
{
for ( float duty = 0.1; duty < 1; duty += 0.1 )
{
log_info( &logger, "Duty: %u%%", ( uint16_t )ceil( duty * 100 ) );
float adc_vout;
log_info( &logger, "ADC [ V ]: %.2f", adc_vout );
log_printf( &logger, "------------------------------\r\n" );
}
for ( float duty = 0.9; duty >= 0; duty -= 0.1 )
{
log_info( &logger, "Duty: %u%%", ( uint16_t )ceil( duty * 100 ) );
float adc_vout;
log_info( &logger, "ADC [ V ]: %.2f", adc_vout );
log_printf( &logger, "------------------------------\r\n" );
}
for ( int16_t dsvp = 200; dsvp <= 5000; dsvp += ( ( 5000 - 200 ) / 10 ) )
{
log_info( &logger, "DSVP [ mV ]: %d", dsvp );
float adc_vout;
log_info( &logger, "ADC [ V ]: %.2f", adc_vout );
log_printf( &logger, "------------------------------\r\n" );
}
for ( int16_t dsvp = 5000; dsvp >= 200; dsvp -= ( ( 5000 - 200 ) / 10 ) )
{
log_info( &logger, "DSVP [ mV ]: %d", dsvp );
float adc_vout;
log_info( &logger, "ADC [ V ]: %.2f", adc_vout );
log_printf( &logger, "------------------------------\r\n" );
}
} else {
log_error( &logger, "Application Task Error" );
log_info( &logger, "Please, run program again..." );
for ( ; ; );
}
}
#define BRUSHLESS8_RESET_DIS
Definition: brushless8.h:96
#define BRUSHLESS8_RESET_EN
Brushless 8 motor reset pin state setting.
Definition: brushless8.h:95
BRUSHLESS8_RETVAL brushless8_read_an_voltage(brushless8_t *ctx, float *data_out)
AN voltage read function.
void brushless8_set_reset(brushless8_t *ctx, uint8_t status)
Brushless 8 rst pin setting.
void application_task(void)
Definition: main.c:106
#define COMM_DELAY
Definition: main.c:41
Note
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.Brushless8
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.