dspic33ck-power-dcdc-dual-active-bridge-development-platform-main/docs/a00287_source.html

#ifndef CONFIG_H

#define CONFIG_H


#include <xc.h> // include processor files - each processor file is guarded.

#include <stdint.h> // include standard integer data types

#include <stdbool.h> // include standard boolean data types

#include <stddef.h> // include standard definition data types


#define PERIOD_MODULATION_DEMO    false

#define DCDC400V_SYSTEM           true

#define DCDC800V_SYSTEM           false

#define ENABLE_VLOOP_AGC          false

 // end of group ~~~~~~~~~~~~~~~~~~~~


#define MAXIMUM_SWITCHING_FREQUENCY     (float)170.0e+3//230.0e+3 ///< Maximum Switching frequency in [Hz]

#define MINIMUM_SWITCHING_FREQUENCY     (float) 65.0e+3


#define MINIMUM_DEADTIME                (float)150e-9

#define MAXIMUM_DEADTIME                (float)500e-9

#define MINIMUM_PHASESHIFTED_PULSE      (float) 80e-9


#define PRI_TO_SEC_PHASE_DEGREES_LIMIT  90u


#if defined(PERIOD_MODULATION_DEMO) && (PERIOD_MODULATION_DEMO == true)

#define PRI_TO_SEC_PHASE_TARGET         830u

#define PERIODSTEP                      (2<<3)

#define PHASETIMESTEP                   (1<<3)

#endif

 // end of group pwm-fundamentals ~~~~~~~~~~~~~~~~~~~~


#define VPLOOP_ILOOP_EXE_RATIO           (uint16_t)(10 / 2)

#define AGC_MINIMUM_VIN_THRESHOLD       160u

#define AGC_MINIMUM_ISEC_THRESHOLD      7

 // end of group ~~~~~~~~~~~~~~~~~~~~

//------------------------------------------------------------------------------

// fault related parameters

//------------------------------------------------------------------------------

// #defines for fault thresholds in human readable form (SI or derived SI units)


// all fault parameters follow the same convention

// for example, for ISEC_CT over current protection

// if fault clear:

// if ISEC_CT > ISEC_OC_THRES_TRIG_AMPS for longer than ISEC_OC_T_BLANK_TRIG_SEC

//      then set fault

// if fault set:

// if ISEC_CT <= ISEC_OC_THRES_CLEAR_AMPS for longer than ISEC_OC_T_BLANK_CLEAR_SEC

//      then clear fault

// ISEC_OC_TICK_SEC is the rate at which the fault handler is invoked

// it is required for the firmware to measure trigger and clear blanking times


#define T_ADC_SAMPLE_SECS                   (float) (10.0e-6)


#define IPRI_OC_THRES_TRIG_AMPS             (float) (39.0)

#define IPRI_OC_THRES_CLEAR_AMPS            (float) (2.0)

#define IPRI_OC_T_BLANK_TRIG_SEC            (float) (50.0e-6)

#define IPRI_OC_T_BLANK_CLEAR_SEC           (float) (0.0)

#define IPRI_OC_TICK_SEC                    (T_ADC_SAMPLE_SECS)


#define IPRI_SC_THRES_TRIG_AMPS             (float) (39.0)

 // end of group ~~~~~~~~~~~~~~~~~~~~


#define ISEC_OC_THRES_TRIG_AMPS             (float) (49.0)

#define ISEC_OC_THRES_CLEAR_AMPS            (float)  (2.0)

#define ISEC_OC_T_BLANK_TRIG_SEC            (float) (50.0e-6)

#define ISEC_OC_T_BLANK_CLEAR_SEC           (float)  (0.0)

#define ISEC_OC_TICK_SEC                    (T_ADC_SAMPLE_SECS)


#define ISEC_SC_THRES_TRIG_AMPS             (float) (49.0)

#define ISEC_LOAD_STEP_CLAMPING_AMPS        (float) (1.5)

 // end of group ~~~~~~~~~~~~~~~~~~~~


#if(DCDC400V_SYSTEM)

    #define VPRI_OV_THRES_TRIG_VOLTS            (float)(700.0)

    #define VPRI_OV_THRES_CLEAR_VOLTS           (float)(600.0)

#elif(DCDC800V_SYSTEM)

    #define VPRI_OV_THRES_TRIG_VOLTS            (float)900.0

    #define VPRI_OV_THRES_CLEAR_VOLTS           (float)800.0

#endif

#define VPRI_OV_T_BLANK_TRIG_SEC            (float)  (0.0)

#define VPRI_OV_T_BLANK_CLEAR_SEC           (float)  (0.0)

#define VPRI_OV_TICK_SEC                    (T_ADC_SAMPLE_SECS)


#if(DCDC400V_SYSTEM)

    #define VPRI_UV_THRES_TRIG_VOLTS            (float)(300.0)

    #define VPRI_UV_THRES_CLEAR_VOLTS           (float)(200.0)

#elif(DCDC800V_SYSTEM)

    #define VPRI_UV_THRES_TRIG_VOLTS            (float)450.0

    #define VPRI_UV_THRES_CLEAR_VOLTS           (float)300.0

#endif

#define VPRI_UV_T_BLANK_TRIG_SEC            (float)  (0.0)

#define VPRI_UV_T_BLANK_CLEAR_SEC           (float)  (0.0)

#define VPRI_UV_TICK_SEC                    (T_ADC_SAMPLE_SECS)

 // end of group ~~~~~~~~~~~~~~~~~~~~


#if(DCDC400V_SYSTEM)

#define VSEC_OV_THRES_TRIG_VOLTS            (float)(500.0)

#define VSEC_OV_THRES_CLEAR_VOLTS           (float) (20.0)

#elif(DCDC800V_SYSTEM)

#define VSEC_OV_THRES_TRIG_VOLTS            (float)950.0

#define VSEC_OV_THRES_CLEAR_VOLTS           (float) 20.0

#endif

#define VSEC_OV_T_BLANK_TRIG_SEC            (float)  (1.0e-3)

#define VSEC_OV_T_BLANK_CLEAR_SEC           (float) (10.0e-3)

#define VSEC_OV_TICK_SEC                    (T_ADC_SAMPLE_SECS)


#if(DCDC400V_SYSTEM)

#define VSEC_UV_THRES_TRIG_VOLTS            (float)(100.0)

#define VSEC_UV_THRES_CLEAR_VOLTS           (float) (50.0)

#elif(DCDC800V_SYSTEM)

#define VSEC_UV_THRES_TRIG_VOLTS            (float)550.0

#define VSEC_UV_THRES_CLEAR_VOLTS           (float) 50.0

#endif

#define VSEC_UV_T_BLANK_TRIG_SEC            (float)  (0.0)

#define VSEC_UV_T_BLANK_CLEAR_SEC           (float)  (0.0)

#define VSEC_UV_TICK_SEC                    (T_ADC_SAMPLE_SECS)


#define VSEC_LOAD_STEP_CLAMPING_VOLTS       (float) (16)

#define VPRIM_LOAD_STEP_CLAMPING_VOLTS       (float) (16)

 // end of group ~~~~~~~~~~~~~~~~~~~~


#define VRAIL_5V_UV_THRES_TRIG_VOLTS        (float) (3.5)

#define VRAIL_5V_UV_THRES_CLEAR_VOLTS       (float) (3.8)

#define VRAIL_5V_UV_T_BLANK_TRIG_SEC        (float) (50.0e-6)

#define VRAIL_5V_UV_T_BLANK_CLEAR_SEC       (float) (0.0)

#define VRAIL_5V_UV_TICK_SEC                (T_ADC_SAMPLE_SECS)

 // end of group ~~~~~~~~~~~~~~~~~~~~


#define TEMPERATURE_PBV_OFFSET_CELSIUS         (40u)

#define OTP_THRES_TRIG_CELCIUS                 (80u)

#define OTP_THRES_CLEAR_CELCIUS                (70u)

#define FAULT_PERSISTENCE_COUNT_TEMP           (4u)


// Stabilize the temperature around 40 degrees C by varying

// the fan speed

#define NOMINAL_TEMPERATURE_THRESHOLD       (float) (40.0) //< Degrees Celcius

#define TEMPERATURE_HYSTERESIS               (float) (1.0)


 // end of group ~~~~~~~~~~~~~~~~~~~~


//------------------------------------------------------------------------------

// control (for debug only)

//------------------------------------------------------------------------------


#define DAC_DEBUG           false

#define OPEN_LOOP_POTI      false

#define OPEN_LOOP_PBV       false


#if((OPEN_LOOP_POTI == true) || (OPEN_LOOP_PBV == true))

#define CURRENT_CALIBRATION             false

#else

#define CURRENT_CALIBRATION             true

#endif

#define VPRI_OPTOCOUPLER_POLARITY       false


 // end of group ~~~~~~~~~~~~~~~~~~~~

//------------------------------------------------------------------------------

// fault disables (for debug only)

// during debug mode, Current calibration needs to be set to false

//------------------------------------------------------------------------------

#define FAULT_VPRI_OV   true

#define FAULT_VPRI_UV   false

#define FAULT_ISEC_OC   true

#define FAULT_IPRI_OC   true

#define FAULT_VSEC_OV   true

#define FAULT_PS_OTP    true

#define FAULT_SHORT_CCT true

#define FAULT_VRAIL_5V  true

#define LOAD_DISCONNECT true

//------------------------------------------------------------------------------


#endif  /* CONFIG_H */