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

Conversion macros for user-declarations of output voltage feedback parameters of the boost converter. More...

+ Collaboration diagram for Boost Converter:
#define BOOST_VOUT_FEEDBACK_GAIN   (float)((BOOST_VOUT_DIV_R2) / (BOOST_VOUT_DIV_R1 + BOOST_VOUT_DIV_R2))
 Conversion macros of output voltage feedback parameters. More...
 
#define BOOST_VOUT_REF   (uint16_t)(BOOST_VOUT_NOMINAL * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)
 Macro calculating the integer number equivalent of the output voltage reference given above in [V]. More...
 
#define BOOST_VOUT_NOM   BOOST_VOUT_REF
 Alias macro of the integer number equivalent of the nominal output voltage given above in [V]. More...
 
#define BOOST_VOUT_DEV_TRIP   (uint16_t)(BOOST_VOUT_TOLERANCE_MAX * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)
 Macro calculating the integer number equivalent of the maximum allowed output voltage deviation given above in [V], which will lead to a converter shut down when exceeded. More...
 
#define BOOST_VOUT_DEV_RELEASE   (uint16_t)(BOOST_VOUT_TOLERANCE_MIN * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)
 Macro calculating the integer number equivalent of the maximum allowed output voltage deviation given above in [V], which needs to be underrun before a shut-down converter can recover. More...
 
#define BOOST_VOUT_OVP_TRIP   (uint16_t)((BOOST_VOUT_MAXIMUM * BOOST_VOUT_FEEDBACK_GAIN) / ADC_GRANULARITY)
 Over Voltage Protection voltage trip signal level. More...
 
#define BOOST_VOUT_OVP_RELEASE   (uint16_t)((BOOST_VOUT_MAXIMUM - BOOST_VOUT_HYSTERESIS) * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)
 Over Voltage Protection voltage recovery signal level. More...
 
#define BOOST_VOUT_OFFSET   (uint16_t)(BOOST_VOUT_FEEDBACK_OFFSET / ADC_GRANULARITY)
 Macro calculating the integer number equivalent of the physical, static signal offset of this feedback channel. More...
 
#define BOOST_VOUT_ADC_TRGDLY   (uint16_t)(BOOST_VOUT_ADC_TRG_DELAY / PWM_CLOCK_PERIOD)
 Macro calculating the integer number equivalent of the signal chain time delay between internal PWM timebase and effective switching edge of the leading FET. More...
 
#define BOOST_VOUT_VFWD_DROP   (uint16_t)(BOOST_VOUT_VFWD_DROP_MAX / ADC_GRANULARITY)
 Macro calculating the integer number equivalent of the maximum forward voltage drop across teh rectifier diode. More...
 
#define BOOST_VOUT_NORM_INV_G   (float)(1.0/BOOST_VOUT_FEEDBACK_GAIN)
 Inverted feedback gain required for value normalization. More...
 
#define BOOST_VOUT_NORM_SCALER   (int16_t)(ceil(log(BOOST_VOUT_NORM_INV_G)/log(2)))
 VOUT normalization. More...
 
#define BOOST_VOUT_NORM_FACTOR   (int16_t)((BOOST_VOUT_NORM_INV_G / pow(2.0, BOOST_VOUT_NORM_SCALER)) * (pow(2.0, 15)-1))
 VOUT normalization factor scaled in Q15. More...
 
#define BOOST_VOUT_RANGE_MAX   (float)(ADC_REFERENCE * BOOST_VOUT_NORM_INV_G)
 Macro calculating the integer number equivalent of the total output voltage range defined by the settings given above in [V]]. More...
 

Detailed Description

Conversion macros for user-declarations of output voltage feedback parameters of the boost converter.

Macro Definition Documentation

◆ BOOST_VOUT_ADC_TRGDLY

#define BOOST_VOUT_ADC_TRGDLY   (uint16_t)(BOOST_VOUT_ADC_TRG_DELAY / PWM_CLOCK_PERIOD)

Macro calculating the integer number equivalent of the signal chain time delay between internal PWM timebase and effective switching edge of the leading FET.

Definition at line 1152 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_DEV_RELEASE

#define BOOST_VOUT_DEV_RELEASE   (uint16_t)(BOOST_VOUT_TOLERANCE_MIN * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)

Macro calculating the integer number equivalent of the maximum allowed output voltage deviation given above in [V], which needs to be underrun before a shut-down converter can recover.

Definition at line 1148 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_DEV_TRIP

#define BOOST_VOUT_DEV_TRIP   (uint16_t)(BOOST_VOUT_TOLERANCE_MAX * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)

Macro calculating the integer number equivalent of the maximum allowed output voltage deviation given above in [V], which will lead to a converter shut down when exceeded.

Definition at line 1147 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_FEEDBACK_GAIN

#define BOOST_VOUT_FEEDBACK_GAIN   (float)((BOOST_VOUT_DIV_R2) / (BOOST_VOUT_DIV_R1 + BOOST_VOUT_DIV_R2))

Conversion macros of output voltage feedback parameters.

These conversion macros are used to convert user settings defined as physical quantities into binary (integer) numbers, which will be written to registers and variables and used in calculations throughout the firmware.

Definition at line 1143 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_NOM

#define BOOST_VOUT_NOM   BOOST_VOUT_REF

Alias macro of the integer number equivalent of the nominal output voltage given above in [V].

Definition at line 1146 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_NORM_FACTOR

#define BOOST_VOUT_NORM_FACTOR   (int16_t)((BOOST_VOUT_NORM_INV_G / pow(2.0, BOOST_VOUT_NORM_SCALER)) * (pow(2.0, 15)-1))

VOUT normalization factor scaled in Q15.

Definition at line 1157 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_NORM_INV_G

#define BOOST_VOUT_NORM_INV_G   (float)(1.0/BOOST_VOUT_FEEDBACK_GAIN)

Inverted feedback gain required for value normalization.

Definition at line 1155 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_NORM_SCALER

#define BOOST_VOUT_NORM_SCALER   (int16_t)(ceil(log(BOOST_VOUT_NORM_INV_G)/log(2)))

VOUT normalization.

Definition at line 1156 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_OFFSET

#define BOOST_VOUT_OFFSET   (uint16_t)(BOOST_VOUT_FEEDBACK_OFFSET / ADC_GRANULARITY)

Macro calculating the integer number equivalent of the physical, static signal offset of this feedback channel.

Definition at line 1151 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_OVP_RELEASE

#define BOOST_VOUT_OVP_RELEASE   (uint16_t)((BOOST_VOUT_MAXIMUM - BOOST_VOUT_HYSTERESIS) * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)

Over Voltage Protection voltage recovery signal level.

Definition at line 1150 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_OVP_TRIP

#define BOOST_VOUT_OVP_TRIP   (uint16_t)((BOOST_VOUT_MAXIMUM * BOOST_VOUT_FEEDBACK_GAIN) / ADC_GRANULARITY)

Over Voltage Protection voltage trip signal level.

Definition at line 1149 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_RANGE_MAX

#define BOOST_VOUT_RANGE_MAX   (float)(ADC_REFERENCE * BOOST_VOUT_NORM_INV_G)

Macro calculating the integer number equivalent of the total output voltage range defined by the settings given above in [V]].

Definition at line 1159 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_REF

#define BOOST_VOUT_REF   (uint16_t)(BOOST_VOUT_NOMINAL * BOOST_VOUT_FEEDBACK_GAIN / ADC_GRANULARITY)

Macro calculating the integer number equivalent of the output voltage reference given above in [V].

Definition at line 1145 of file dpsk3_hwdescr.h.

◆ BOOST_VOUT_VFWD_DROP

#define BOOST_VOUT_VFWD_DROP   (uint16_t)(BOOST_VOUT_VFWD_DROP_MAX / ADC_GRANULARITY)

Macro calculating the integer number equivalent of the maximum forward voltage drop across teh rectifier diode.

Definition at line 1153 of file dpsk3_hwdescr.h.