Digital Power Starter Kit 3 Firmware
dsPIC33C Buck Converter Voltage Mode Control Example

Public functions of the application layer of the power control task. More...

+ Collaboration diagram for Public Functions:

Functions

volatile uint16_t appPowerSupply_Execute (void)
 This is the top-level function call triggering the most recent state machine of all associated power supply controllers. More...
 
volatile uint16_t appPowerSupply_Initialize (void)
 Calls the application layer power controller initialization. More...
 
volatile uint16_t appPowerSupply_Start (void)
 This function calls the buck converter device driver function starting the power supply. More...
 
volatile uint16_t appPowerSupply_Stop (void)
 This function calls the buck converter device driver function stopping the power supply. More...
 
volatile uint16_t appPowerSupply_Suspend (void)
 This function stops the power supply operation. More...
 
volatile uint16_t appPowerSupply_Resume (void)
 This function resumes the power supply operation. More...
 

Detailed Description

Public functions of the application layer of the power control task.

The power control application layer is the proprietary user code used to configure the generic power controller device driver defined in dev_buck_typedef.h. This application layer further provides a subset of function calls allowing external software functions to control and monitor the processes of the power control device driver, such as the system-wide fault monitor or communication drivers.

Function Documentation

◆ appPowerSupply_Execute()

volatile uint16_t appPowerSupply_Execute ( void  )

This is the top-level function call triggering the most recent state machine of all associated power supply controllers.

Returns
0=failure
1=success

After initialization, the proprietary user code has to call this function on a deterministic, constant time base. In each execution step this function will call the power control state machines of each supported/included power supply unit.

Definition at line 63 of file app_power_control.c.

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ appPowerSupply_Initialize()

volatile uint16_t appPowerSupply_Initialize ( void  )

Calls the application layer power controller initialization.

Returns
0=failure
1=success

The power control application layer is the proprietary user code layer used to tailor the generic power converter device driver to the specific hardware of this design. The initialization routine covers three levels

  • Converter Object Configuration
  • Controller Configuration
  • Peripheral Set Configuration
  • Interrupt Vector Configuration

Once all modules have been configured successfully, the power converter object is started with control loops and PWM outputs disabled. However, the PWM module will start triggering the ADC to allow the standby monitoring of system conditions to allow the firmware to decide if it is safe to start up the power converter.

Definition at line 133 of file app_power_control.c.

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ appPowerSupply_Resume()

volatile uint16_t appPowerSupply_Resume ( void  )

This function resumes the power supply operation.

Returns
unsigned integer (0=failure, 1=success)

This function calls the buck converter device driver function recovering the power supply operation from a previously initiated shut-down.

Definition at line 233 of file app_power_control.c.

+ Here is the call graph for this function:

◆ appPowerSupply_Start()

volatile uint16_t appPowerSupply_Start ( void  )

This function calls the buck converter device driver function starting the power supply.

Returns
0=failure
1=success

This function exposes the Power Converter Start function of the device driver.

Definition at line 164 of file app_power_control.c.

+ Here is the call graph for this function:

◆ appPowerSupply_Stop()

volatile uint16_t appPowerSupply_Stop ( void  )

This function calls the buck converter device driver function stopping the power supply.

Returns
0=failure
1=success

This function exposes the Power Converter Stop function of the device driver.

Note
The STOP function terminates the state machine and all peripherals used by the power controller. This includes the PWM and ADC peripheral modules and will therefore also stop all data acquisition. If you are trying to stop the power supply but keep its state machine and data acquisition running, use the SUSPEND function instead

Definition at line 192 of file app_power_control.c.

+ Here is the call graph for this function:

◆ appPowerSupply_Suspend()

volatile uint16_t appPowerSupply_Suspend ( void  )

This function stops the power supply operation.

Returns
0=failure
1=success

The SUSPEND function stops the power supply operation but keep its state machine and data acquisition running.

Definition at line 212 of file app_power_control.c.

+ Here is the call graph for this function:
+ Here is the caller graph for this function: