Library Description

This library allows user to perform a control of the Charger 9 Click board. Also user can check the indication status from the charger to get charging state. Fault condition also can be checked. For more details check documentation.

Key functions:

• void charger9_gpioDriverInit(T_CHARGER9_P gpioObj) - Convert ADC value to Pressure data in mBar.
• T_CHARGER9_RETVAL charger9_enable( T_CHARGER9_STATE pwr_state ) - Convert ADC value to Voltage in mV.
• T_CHARGER9_RETVAL charger9_faultInd( void ) - Sets max output voltage on the AN pin.

Examples description

The application is composed of three sections :

• System Initialization - Initializes peripherals and pins.
• Application Initialization - Initializes GPIO driver and turns OFF the charger as initial state.
• Application Task - (code snippet) - Checks which command was sent by user and performs the selected command. Also checks the fault condition, and when fault condition is detected sends a report message to the uart terminal and turns OFF the charger. Note: When user sends a desired command to the charger, a report message will be sent to the uart terminal as indication to the user. The possible commands, for Charger 9 control, will be written to the uart terminal. The alarm sound will be generated on the determined commands: enable, disable and fault condition detecting.

void applicationTask()
{
	rx_dat = UART_Rdy_Ptr();
	
	if (rx_dat != 0)
	{
		rx_dat = UART_Rd_Ptr();
		
		switch (rx_dat)
		{
			case 'e' :
			{
				if (en_flag == _CHARGER9_DISABLE)
				{
					charger9_enable( _CHARGER9_ENABLE );
					en_flag = _CHARGER9_ENABLE;
					
					mikrobus_logWrite( "** Charger 9 is enabled **", _LOG_LINE );
					alarmOn();
				}
				else
				{
					mikrobus_logWrite( "** Charger 9 is already enabled **", _LOG_LINE );
				}
			break;
			}
			case 'd' :
			{
				if (en_flag == _CHARGER9_ENABLE)
				{
					charger9_enable( _CHARGER9_DISABLE );
					en_flag = _CHARGER9_DISABLE;

					mikrobus_logWrite( "** Charger 9 is disabled **", _LOG_LINE );
					alarmOff();
				}
				else
				{
					mikrobus_logWrite( "** Charger 9 is already disabled **", _LOG_LINE );
				}
			break;
			}
			case 's' :
			{
				charge_state = charger9_fullChargeInd();
				
				if (charge_state == _CHARGER9_IND_ACTIVE)
				{
					mikrobus_logWrite( "** Full-Charge state **", _LOG_LINE );
				}
				
				charge_state = charger9_fastChargeInd();

				if (charge_state == _CHARGER9_IND_ACTIVE)
				{
					mikrobus_logWrite( "** Fast-Charge state **", _LOG_LINE );
				}
			break;
			}
			case 'l' :
			{
				writeLegend();
			break;
			}
			default :
			{
				mikrobus_logWrite( "** Invalid command **", _LOG_LINE );
				writeLegend();
			break;
			}
		}
	}
	
	charge_state = charger9_faultInd();
	
	if (charge_state == _CHARGER9_IND_ACTIVE)
	{
		charger9_enable( _CHARGER9_DISABLE );
		en_flag = _CHARGER9_DISABLE;
		
		mikrobus_logWrite( "** Fault condition! **", _LOG_LINE );
		mikrobus_logWrite( "** Charger 9 is disabled **", _LOG_LINE );
		alarmFault();
	}
}
			

Additional Functions :

• alarmOn - Generates an alarm sound for charger power ON.
• alarmOff - Generates an alarm sound for charger power OFF.
• alarmFault - Generates an alarm sound for fault condition.
• writeLegend - Writes possible valid commands to the uart terminal.

Other mikroE Libraries used in the example:

• Sound
• 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.