RTEMS 6.1-rc4
|
Data Structures | |
struct | _dcdc_detection_config |
Configuration for DCDC detection. More... | |
struct | _dcdc_loop_control_config |
Configuration for the loop control. More... | |
struct | _dcdc_low_power_config |
Configuration for DCDC low power. More... | |
struct | _dcdc_internal_regulator_config |
Configuration for DCDC internal regulator. More... | |
struct | _dcdc_min_power_config |
Configuration for min power setting. More... | |
Macros | |
#define | FSL_DCDC_DRIVER_VERSION (MAKE_VERSION(2, 3, 0)) |
DCDC driver version. | |
Typedefs | |
typedef enum _dcdc_comparator_current_bias | dcdc_comparator_current_bias_t |
The current bias of low power comparator. | |
typedef enum _dcdc_over_current_threshold | dcdc_over_current_threshold_t |
The threshold of over current detection. | |
typedef enum _dcdc_peak_current_threshold | dcdc_peak_current_threshold_t |
The threshold if peak current detection. | |
typedef enum _dcdc_count_charging_time_period | dcdc_count_charging_time_period_t |
The period of counting the charging times in power save mode. | |
typedef enum _dcdc_count_charging_time_threshold | dcdc_count_charging_time_threshold_t |
The threshold of the counting number of charging times. | |
typedef enum _dcdc_clock_source | dcdc_clock_source_t |
Oscillator clock option. | |
typedef struct _dcdc_detection_config | dcdc_detection_config_t |
Configuration for DCDC detection. | |
typedef struct _dcdc_loop_control_config | dcdc_loop_control_config_t |
Configuration for the loop control. | |
typedef struct _dcdc_low_power_config | dcdc_low_power_config_t |
Configuration for DCDC low power. | |
typedef struct _dcdc_internal_regulator_config | dcdc_internal_regulator_config_t |
Configuration for DCDC internal regulator. | |
typedef struct _dcdc_min_power_config | dcdc_min_power_config_t |
Configuration for min power setting. | |
Initialization and deinitialization | |
void | DCDC_Init (DCDC_Type *base) |
Enable the access to DCDC registers. | |
void | DCDC_Deinit (DCDC_Type *base) |
Disable the access to DCDC registers. | |
Status | |
uint32_t | DCDC_GetstatusFlags (DCDC_Type *base) |
Get DCDC status flags. | |
Misc control | |
void | DCDC_SetClockSource (DCDC_Type *base, dcdc_clock_source_t clockSource) |
Configure the DCDC clock source. | |
void | DCDC_GetDefaultDetectionConfig (dcdc_detection_config_t *config) |
Get the default setting for detection configuration. | |
void | DCDC_SetDetectionConfig (DCDC_Type *base, const dcdc_detection_config_t *config) |
Configure the DCDC detection. | |
void | DCDC_GetDefaultLowPowerConfig (dcdc_low_power_config_t *config) |
Get the default setting for low power configuration. | |
void | DCDC_SetLowPowerConfig (DCDC_Type *base, const dcdc_low_power_config_t *config) |
Configure the DCDC low power. | |
void | DCDC_ResetCurrentAlertSignal (DCDC_Type *base, bool enable) |
Reset current alert signal. Alert signal is generate by peak current detection. | |
void | DCDC_GetDefaultLoopControlConfig (dcdc_loop_control_config_t *config) |
Get the default setting for loop control configuration. | |
void | DCDC_SetLoopControlConfig (DCDC_Type *base, const dcdc_loop_control_config_t *config) |
Configure the DCDC loop control. | |
void | DCDC_SetMinPowerConfig (DCDC_Type *base, const dcdc_min_power_config_t *config) |
Configure for the min power. | |
void | DCDC_AdjustTargetVoltage (DCDC_Type *base, uint32_t VDDRun, uint32_t VDDStandby) |
Adjust the target voltage of VDD_SOC in run mode and low power mode. | |
void | DCDC_AdjustRunTargetVoltage (DCDC_Type *base, uint32_t VDDRun) |
Adjust the target voltage of VDD_SOC in run mode. | |
void | DCDC_AdjustLowPowerTargetVoltage (DCDC_Type *base, uint32_t VDDStandby) |
Adjust the target voltage of VDD_SOC in low power mode. | |
void | DCDC_SetInternalRegulatorConfig (DCDC_Type *base, const dcdc_internal_regulator_config_t *config) |
Configure the DCDC internal regulator. | |
Application guideline | |
void | DCDC_BootIntoDCM (DCDC_Type *base) |
Boot DCDC into DCM(discontinous conduction mode). | |
void | DCDC_BootIntoCCM (DCDC_Type *base) |
Boot DCDC into CCM(continous conduction mode). | |
#define FSL_DCDC_DRIVER_VERSION (MAKE_VERSION(2, 3, 0)) |
DCDC driver version.
Version 2.3.0.
enum _dcdc_clock_source |
Oscillator clock option.
The current bias of low power comparator.
The threshold of over current detection.
The threshold if peak current detection.
enum _dcdc_status_flags_t |
void DCDC_AdjustLowPowerTargetVoltage | ( | DCDC_Type * | base, |
uint32_t | VDDStandby | ||
) |
Adjust the target voltage of VDD_SOC in low power mode.
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
base | DCDC peripheral base address. |
VDDStandby | Target value in low power mode. 25 mV each step from 0x00 to 0x4. 00 is for 0.9V, 0x4 is for 1.0V. |
brief Adjust the target voltage of VDD_SOC in low power mode.
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
param base DCDC peripheral base address. param VDDStandby Target value in low power mode. 25 mV each step from 0x00 to 0x4. 00 is for 0.9V, 0x4 is for 1.0V.
void DCDC_AdjustRunTargetVoltage | ( | DCDC_Type * | base, |
uint32_t | VDDRun | ||
) |
Adjust the target voltage of VDD_SOC in run mode.
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
base | DCDC peripheral base address. |
VDDRun | Target value in run mode. 25 mV each step from 0x00 to 0x1F. 00 is for 0.8V, 0x1F is for 1.575V. |
brief Adjust the target voltage of VDD_SOC in run mode.
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
param base DCDC peripheral base address. param VDDRun Target value in run mode. 25 mV each step from 0x00 to 0x1F. 00 is for 0.8V, 0x1F is for 1.575V.
void DCDC_AdjustTargetVoltage | ( | DCDC_Type * | base, |
uint32_t | VDDRun, | ||
uint32_t | VDDStandby | ||
) |
Adjust the target voltage of VDD_SOC in run mode and low power mode.
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
base | DCDC peripheral base address. |
VDDRun | Target value in run mode. 25 mV each step from 0x00 to 0x1F. 00 is for 0.8V, 0x1F is for 1.575V. |
VDDStandby | Target value in low power mode. 25 mV each step from 0x00 to 0x4. 00 is for 0.9V, 0x4 is for 1.0V. |
brief Adjust the target voltage of VDD_SOC in run mode and low power mode. Do not use this function. It has been superceded by DCDC_AdjustRunTargetVoltage and DCDC_AdjustLowPowerTargetVoltage
This function is to adjust the target voltage of DCDC output. Change them and finally wait until the output is stabled. Set the target value of run mode the same as low power mode before entering power save mode, because DCDC will switch back to run mode if it detects the current loading is larger than about 50 mA(typical value).
param base DCDC peripheral base address. param VDDRun Target value in run mode. 25 mV each step from 0x00 to 0x1F. 00 is for 0.8V, 0x1F is for 1.575V. param VDDStandby Target value in low power mode. 25 mV each step from 0x00 to 0x4. 00 is for 0.9V, 0x4 is for 1.0V.
void DCDC_BootIntoCCM | ( | DCDC_Type * | base | ) |
Boot DCDC into CCM(continous conduction mode).
pwd_zcd=0x1; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale=0x3;
base | DCDC peripheral base address. |
Boot DCDC into CCM(continous conduction mode).
brief Boots DCDC into CCM(continous conduction mode).
pwd_zcd=0x1; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale=0x3;
param base DCDC peripheral base address.
Boot DCDC into CCM(continous conduction mode).
brief Boot DCDC into CCM(continous conduction mode).
pwd_zcd=0x1; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale=0x3;
param base DCDC peripheral base address.
void DCDC_BootIntoDCM | ( | DCDC_Type * | base | ) |
Boot DCDC into DCM(discontinous conduction mode).
pwd_zcd=0x0; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale= 0x5; DCM_set_ctrl=1'b1;
base | DCDC peripheral base address. |
Boot DCDC into DCM(discontinous conduction mode).
brief Boots DCDC into DCM(discontinous conduction mode).
pwd_zcd=0x0; DM_CTRL = 1'b1; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale=0x3 or 0x5; DCM_set_ctrl=1'b1;
param base DCDC peripheral base address.
Boot DCDC into DCM(discontinous conduction mode).
brief Boot DCDC into DCM(discontinous conduction mode).
pwd_zcd=0x0; pwd_cmp_offset=0x0; dcdc_loopctrl_en_rcscale= 0x5; DCM_set_ctrl=1'b1;
param base DCDC peripheral base address.
void DCDC_Deinit | ( | DCDC_Type * | base | ) |
Disable the access to DCDC registers.
base | DCDC peripheral base address. |
Disable the access to DCDC registers.
brief De-initializes the DCDC module.
param base DCDC peripheral base address.
Disable the access to DCDC registers.
brief Disable the access to DCDC registers.
param base DCDC peripheral base address.
void DCDC_GetDefaultDetectionConfig | ( | dcdc_detection_config_t * | config | ) |
Get the default setting for detection configuration.
The default configuration are set according to responding registers' setting when powered on. They are:
config | Pointer to configuration structure. See to "dcdc_detection_config_t" |
Get the default setting for detection configuration.
brief Gets the default setting for detection configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableXtalokDetection = false; config->powerDownOverVoltageVdd1P8Detection = true; config->powerDownOverVoltageVdd1P0Detection = true; config->powerDownLowVoltageDetection = false; config->powerDownOverCurrentDetection = true; config->powerDownPeakCurrentDetection = true; config->powerDownZeroCrossDetection = true; config->PeakCurrentThreshold = kDCDC_PeakCurrentRunMode250mALPMode1P5A; endcode
param config Pointer to configuration structure. See to "dcdc_detection_config_t"
Get the default setting for detection configuration.
brief Get the default setting for detection configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableXtalokDetection = false; config->powerDownOverVoltageDetection = true; config->powerDownLowVlotageDetection = false; config->powerDownOverCurrentDetection = true; config->powerDownPeakCurrentDetection = true; config->powerDownZeroCrossDetection = true; config->OverCurrentThreshold = kDCDC_OverCurrentThresholdAlt0; config->PeakCurrentThreshold = kDCDC_PeakCurrentThresholdAlt0; endcode
param config Pointer to configuration structure. See to "dcdc_detection_config_t"
void DCDC_GetDefaultLoopControlConfig | ( | dcdc_loop_control_config_t * | config | ) |
Get the default setting for loop control configuration.
The default configuration are set according to responding registers' setting when powered on. They are:
config | Pointer to configuration structure. See to "dcdc_loop_control_config_t" |
Get the default setting for loop control configuration.
brief Gets the default setting for loop control configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableCommonHysteresis = false; config->enableCommonThresholdDetection = false; config->enableInvertHysteresisSign = false; config->enableRCThresholdDetection = false; config->enableRCScaleCircuit = 0U; config->complementFeedForwardStep = 0U; config->controlParameterMagnitude = 2U; config->integralProportionalRatio = 2U; endcode
param config Pointer to configuration structure. See to "dcdc_loop_control_config_t"
Get the default setting for loop control configuration.
brief Get the default setting for loop control configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableCommonHysteresis = false; config->enableCommonThresholdDetection = false; config->enableInvertHysteresisSign = false; config->enableRCThresholdDetection = false; config->enableRCScaleCircuit = 0U; config->complementFeedForwardStep = 0U; endcode
param config Pointer to configuration structure. See to "dcdc_loop_control_config_t"
void DCDC_GetDefaultLowPowerConfig | ( | dcdc_low_power_config_t * | config | ) |
Get the default setting for low power configuration.
The default configuration are set according to responding registers' setting when powered on. They are:
config | Pointer to configuration structure. See to "dcdc_low_power_config_t" |
Get the default setting for low power configuration.
brief Gets the default setting for low power configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableAdjustHystereticValue = false; endcode
param config Pointer to configuration structure. See to "dcdc_low_power_config_t"
Get the default setting for low power configuration.
brief Get the default setting for low power configuration.
The default configuration are set according to responding registers' setting when powered on. They are: code config->enableOverloadDetection = true; config->enableAdjustHystereticValue = false; config->countChargingTimePeriod = kDCDC_CountChargingTimePeriod8Cycle; config->countChargingTimeThreshold = kDCDC_CountChargingTimeThreshold32; endcode
param config Pointer to configuration structure. See to "dcdc_low_power_config_t"
uint32_t DCDC_GetstatusFlags | ( | DCDC_Type * | base | ) |
Get DCDC status flags.
base | peripheral base address. |
brief Get DCDC status flags.
param base peripheral base address. return Mask of asserted status flags. See to "_dcdc_status_flags_t".
void DCDC_Init | ( | DCDC_Type * | base | ) |
Enable the access to DCDC registers.
base | DCDC peripheral base address. |
brief Enable the access to DCDC registers.
param base DCDC peripheral base address.
void DCDC_ResetCurrentAlertSignal | ( | DCDC_Type * | base, |
bool | enable | ||
) |
Reset current alert signal. Alert signal is generate by peak current detection.
base | DCDC peripheral base address. |
enable | Switcher to reset signal. True means reset signal. False means don't reset signal. |
brief Reset current alert signal. Alert signal is generate by peak current detection.
param base DCDC peripheral base address. param enable Switcher to reset signal. True means reset signal. False means don't reset signal.
void DCDC_SetClockSource | ( | DCDC_Type * | base, |
dcdc_clock_source_t | clockSource | ||
) |
Configure the DCDC clock source.
base | DCDC peripheral base address. |
clockSource | Clock source for DCDC. See to "dcdc_clock_source_t". |
Configure the DCDC clock source.
brief Configures the DCDC clock source.
param base DCDC peripheral base address. param clockSource Clock source for DCDC. See to "dcdc_clock_source_t".
Configure the DCDC clock source.
brief Configure the DCDC clock source.
param base DCDC peripheral base address. param clockSource Clock source for DCDC. See to "dcdc_clock_source_t".
void DCDC_SetDetectionConfig | ( | DCDC_Type * | base, |
const dcdc_detection_config_t * | config | ||
) |
Configure the DCDC detection.
base | DCDC peripheral base address. |
config | Pointer to configuration structure. See to "dcdc_detection_config_t" |
Configure the DCDC detection.
breif Configures the DCDC detection.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_detection_config_t"
Configure the DCDC detection.
breif Configure the DCDC detection.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_detection_config_t"
void DCDC_SetInternalRegulatorConfig | ( | DCDC_Type * | base, |
const dcdc_internal_regulator_config_t * | config | ||
) |
Configure the DCDC internal regulator.
base | DCDC peripheral base address. |
config | Pointer to configuration structure. See to "dcdc_internal_regulator_config_t". |
Configure the DCDC internal regulator.
brief Configures the DCDC internal regulator.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_internal_regulator_config_t".
Configure the DCDC internal regulator.
brief Configure the DCDC internal regulator.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_internal_regulator_config_t".
void DCDC_SetLoopControlConfig | ( | DCDC_Type * | base, |
const dcdc_loop_control_config_t * | config | ||
) |
Configure the DCDC loop control.
base | DCDC peripheral base address. |
config | Pointer to configuration structure. See to "dcdc_loop_control_config_t". |
Configure the DCDC loop control.
brief Configures the DCDC loop control.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_loop_control_config_t".
Configure the DCDC loop control.
brief Configure the DCDC loop control.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_loop_control_config_t".
void DCDC_SetLowPowerConfig | ( | DCDC_Type * | base, |
const dcdc_low_power_config_t * | config | ||
) |
Configure the DCDC low power.
base | DCDC peripheral base address. |
config | Pointer to configuration structure. See to "dcdc_low_power_config_t". |
Configure the DCDC low power.
brief Configures the DCDC low power.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_low_power_config_t".
Configure the DCDC low power.
brief Configure the DCDC low power.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_low_power_config_t".
void DCDC_SetMinPowerConfig | ( | DCDC_Type * | base, |
const dcdc_min_power_config_t * | config | ||
) |
Configure for the min power.
base | DCDC peripheral base address. |
config | Pointer to configuration structure. See to "dcdc_min_power_config_t". |
Configure for the min power.
brief Configures for the min power.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_min_power_config_t".
Configure for the min power.
brief Configure for the min power.
param base DCDC peripheral base address. param config Pointer to configuration structure. See to "dcdc_min_power_config_t".
uint32_t _dcdc_loop_control_config::complementFeedForwardStep |
Available range is 0~7. Two's complement feed forward step in duty cycle in the switching DC-DC converter. Each time this field makes a transition from 0x0, the loop filter of the DC-DC converter is stepped once by a value proportional to the change. This can be used to force a certain control loop behavior, such as improving response under known heavy load transients.
dcdc_count_charging_time_period_t _dcdc_low_power_config::countChargingTimePeriod |
The period of counting the charging times in power save mode.
dcdc_count_charging_time_threshold_t _dcdc_low_power_config::countChargingTimeThreshold |
the threshold of the counting number of charging times during the period that lp_overload_freq_sel sets in power save mode.
bool _dcdc_low_power_config::enableAdjustHystereticValue |
Adjust hysteretic value in low power from 12.5mV to 25mV.
bool _dcdc_loop_control_config::enableCommonHysteresis |
Enable hysteresis in switching converter common mode analog comparators. This feature will improve transient supply ripple and efficiency.
bool _dcdc_loop_control_config::enableCommonThresholdDetection |
Increase the threshold detection for common mode analog comparator.
bool _dcdc_loop_control_config::enableInvertHysteresisSign |
Invert the sign of the hysteresis in DC-DC analog comparators.
bool _dcdc_internal_regulator_config::enableLoadResistor |
control the load resistor of the internal regulator of DCDC, the load resistor is connected as default "true", and need set to "false" to disconnect the load resistor.
bool _dcdc_low_power_config::enableOverloadDetection |
Enable the overload detection in power save mode, if current is larger than the overloading threshold (typical value is 50 mA), DCDC will switch to the run mode automatically.
uint32_t _dcdc_loop_control_config::enableRCScaleCircuit |
Available range is 0~7. Enable analog circuit of DC-DC converter to respond faster under transient load conditions.
bool _dcdc_loop_control_config::enableRCThresholdDetection |
Increase the threshold detection for RC scale circuit.
bool _dcdc_min_power_config::enableUseHalfFreqForContinuous |
Set DCDC clock to half frequency for the continuous mode.
bool _dcdc_detection_config::enableXtalokDetection |
Enable xtalok detection circuit.
uint32_t _dcdc_internal_regulator_config::feedbackPoint |
Available range is 0~3. Select the feedback point of the internal regulator.
dcdc_over_current_threshold_t _dcdc_detection_config::OverCurrentThreshold |
The threshold of over current detection.
dcdc_peak_current_threshold_t _dcdc_detection_config::PeakCurrentThreshold |
The threshold of peak current detection.
bool _dcdc_detection_config::powerDownLowVlotageDetection |
Power down low-voltage detection comparator.
bool _dcdc_detection_config::powerDownOverCurrentDetection |
Power down over-current detection.
bool _dcdc_detection_config::powerDownOverVoltageDetection |
Power down over-voltage detection comparator.
bool _dcdc_detection_config::powerDownPeakCurrentDetection |
Power down peak-current detection.
bool _dcdc_detection_config::powerDownZeroCrossDetection |
Power down the zero cross detection function for discontinuous conductor mode.