Library Description

The library covers all the necessary functions to control DC Motor 5 Click board.
DC Motor 5 Click communicates with the target board via the PWM module.
This library contains drivers to enable or disable the engine, 
for rotation in the clockwise or counterclockwise direction, for the brake and stop the motor and
for PWM function: initialization, for sets duty ratio, starts and stops PWM module.

Key functions:

• void dcmotor5_enable() - Enable the motor function.
• void dcmotor5_counterClockwise()- Set the direction of rotation in the counter clockwise direction function.
• void dcmotor5_clockwise() - Set the direction of rotation in the clockwise direction function.

Examples description

The application is composed of three sections:

• System Initialization - Initializes GPIO and LOG structures, sets AN and CS pins as input, sets RST, PWM, and INT pins as output.
• Application Initialization -  Initialization driver enables - GPIO, PWM initialization set PWM duty cycle and PWM frequency, start PWM, enable the engine, and start to write log.
• Application Task - (code snippet) This is an example which demonstrates the use of DC Motor 5 Click board. DC Motor 5 Click communicates with register via PWM interface.
  Its shows moving in the clockwise direction of rotation from slow to fast speed and moving in the counterclockwise direction of rotation from fast to slow speed.
  Results are being sent to the Usart Terminal where you can track their changes.

void applicationTask() 
{
    mikrobus_logWrite( "   Brake the engine  ", _LOG_LINE );
    dcmotor5_shortBrake();
    Delay_1sec();
    
    mikrobus_logWrite( "---------------------", _LOG_LINE );
    mikrobus_logWrite( "      Clockwise      ", _LOG_LINE );
    dcmotor5_clockwise();
    Delay_1sec();
 
    for ( dutyCycle = 500; dutyCycle < 3000; dutyCycle += 250 )
    {
        dcmotor5_pwmSetDuty( dutyCycle );
        mikrobus_logWrite( " >", _LOG_TEXT );
        Delay_1sec();
    }
 
    mikrobus_logWrite( "", _LOG_LINE );
    mikrobus_logWrite( "---------------------", _LOG_LINE );
    mikrobus_logWrite( "   Brake the engine  ", _LOG_LINE );
    dcmotor5_shortBrake();
    Delay_1sec();

    mikrobus_logWrite( "---------------------", _LOG_LINE );  
    mikrobus_logWrite( "  Counter Clockwise  ", _LOG_LINE );
    dcmotor5_counterClockwise();
    Delay_1sec();
 
    for ( dutyCycle = 3000; dutyCycle > 500; dutyCycle -= 250 )
    {
        dcmotor5_pwmSetDuty( dutyCycle );
        mikrobus_logWrite( " <", _LOG_TEXT );
        Delay_1sec();
    }
  
    mikrobus_logWrite( "", _LOG_LINE );
    mikrobus_logWrite( "---------------------", _LOG_LINE );
    Delay_1sec();
}  

Additional Functions :

• uint32_t dcmotor5_pwmInit( uint16_t freq ) - Initializes the Timer module in PWM mode.
• void dcmotor5_pwmSetDuty( uint16_t duty ) - The function changes PWM duty ratio.
• void dcmotor5_pwmStart() - Starts appropriate PWM module.
• void dcmotor5_pwmStop() - Stops appropriate PWM module.

Other mikroE Libraries used in the example:

• PWM
• UART

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