diff options
Diffstat (limited to 'bsps/arm/imxrt/mcux-sdk/devices/MIMXRT1166/drivers/fsl_pmu.h')
-rw-r--r-- | bsps/arm/imxrt/mcux-sdk/devices/MIMXRT1166/drivers/fsl_pmu.h | 855 |
1 files changed, 855 insertions, 0 deletions
diff --git a/bsps/arm/imxrt/mcux-sdk/devices/MIMXRT1166/drivers/fsl_pmu.h b/bsps/arm/imxrt/mcux-sdk/devices/MIMXRT1166/drivers/fsl_pmu.h new file mode 100644 index 0000000000..cd22e42d4f --- /dev/null +++ b/bsps/arm/imxrt/mcux-sdk/devices/MIMXRT1166/drivers/fsl_pmu.h @@ -0,0 +1,855 @@ +/* + * Copyright 2020-2021 NXP + * All rights reserved. + * + * SPDX-License-Identifier: BSD-3-Clause + */ + +#ifndef _FSL_PMU_H_ +#define _FSL_PMU_H_ + +#include "fsl_common.h" + +/*! + * @addtogroup pmu + * @{ + */ + +/******************************************************************************* + * Definitions + ******************************************************************************/ + +/*! @name Driver version + * @{ + */ + +/*! @brief PMU driver version */ +#define FSL_PMU_DRIVER_VERSION (MAKE_VERSION(2, 1, 0)) /*!< Version 2.1.0. */ + +/*! + * @} + */ + +#if defined(ANADIG_PMU_PMU_BIAS_CTRL2_FBB_M7_CONTROL_MODE_MASK) +#define PMU_HAS_FBB (1U) +#else +#define PMU_HAS_FBB (0U) +#endif /* ANADIG_PMU_PMU_BIAS_CTRL2_FBB_M7_CONTROL_MODE_MASK */ + +/*! + * @brief System setpoints enumeration. + */ +enum _pmu_setpoint_map +{ + kPMU_SetPoint0 = 1UL << 0UL, /*!< Set point 0. */ + kPMU_SetPoint1 = 1UL << 1UL, /*!< Set point 1. */ + kPMU_SetPoint2 = 1UL << 2UL, /*!< Set point 2. */ + kPMU_SetPoint3 = 1UL << 3UL, /*!< Set point 3. */ + kPMU_SetPoint4 = 1UL << 4UL, /*!< Set point 4. */ + kPMU_SetPoint5 = 1UL << 5UL, /*!< Set point 5. */ + kPMU_SetPoint6 = 1UL << 6UL, /*!< Set point 6. */ + kPMU_SetPoint7 = 1UL << 7UL, /*!< Set point 7. */ + kPMU_SetPoint8 = 1UL << 8UL, /*!< Set point 8. */ + kPMU_SetPoint9 = 1UL << 9UL, /*!< Set point 9. */ + kPMU_SetPoint10 = 1UL << 10UL, /*!< Set point 10. */ + kPMU_SetPoint11 = 1UL << 11UL, /*!< Set point 11. */ + kPMU_SetPoint12 = 1UL << 12UL, /*!< Set point 12. */ + kPMU_SetPoint13 = 1UL << 13UL, /*!< Set point 13. */ + kPMU_SetPoint14 = 1UL << 14UL, /*!< Set point 14. */ + kPMU_SetPoint15 = 1UL << 15UL /*!< Set point 15. */ +}; + +/*! + * @brief The name of LDOs + */ +typedef enum _pmu_ldo_name +{ + kPMU_PllLdo = 0U, /*!< The PLL LDO in SOC domain. */ + kPMU_LpsrAnaLdo = 1U, /*!< The LPSR ANA LDO in LPSR domain. */ + kPMU_LpsrDigLdo = 2U, /*!< The LPSR DIG LDO in LPSR domain. */ + kPMU_SnvsDigLdo = 3U /*!< The SNVS DIG LDO in SNVS domain. */ +} pmu_ldo_name_t; + +/*! + * @brief The name of body bias. + */ +typedef enum _pmu_body_bias_name +{ +#if (defined(PMU_HAS_FBB) && PMU_HAS_FBB) + kPMU_FBB_CM7 = 0x0U, /*!< The FBB implemented in Cortex-M7 Platform. */ + kPMU_RBB_SOC = 0x1U, /*!< The RBB implemented in SOC. */ + kPMU_RBB_LPSR = 0x2U, /*!< The RBB implemented in LPSRMIX. */ +#else + kPMU_RBB_SOC = 0x0U, /*!< The RBB implemented in SOC. */ + kPMU_RBB_LPSR = 0x1U, /*!< The RBB implemented in LPSRMIX. */ +#endif /* PMU_HAS_FBB */ +} pmu_body_bias_name_t; + +/*! + * @brief The control mode of LDOs/Bandgaps/Body Bias. + */ +typedef enum _pmu_control_mode +{ + kPMU_StaticMode = 0U, /*!< Static/Software Control mode. */ + kPMU_GPCMode = 1U, /*!< GPC/Hardware Control mode. */ +} pmu_control_mode_t; + +/*! + * @brief The operation mode for the LDOs. + */ +typedef enum _pmu_ldo_operate_mode +{ + kPMU_LowPowerMode = 0x0U, /*!< LDOs operate in Low power mode. */ + kPMU_HighPowerMode = 0x1U, /*!< LDOs operate in High power mode. */ +} pmu_ldo_operate_mode_t; + +/*! + * @brief The enumeration of LPSR ANA LDO's charge pump current. + */ +typedef enum _pmu_lpsr_ana_ldo_charge_pump_current +{ + kPMU_LpsrAnaChargePump300nA = 0U, /*!< The current of the charge pump is selected as 300nA. */ + kPMU_LpsrAnaChargePump400nA = 1U, /*!< The current of the charge pump is selected as 400nA. */ + kPMU_LpsrAnaChargePump500nA = 2U, /*!< The current of the charge pump is selected as 500nA. */ + kPMU_LpsrAnaChargePump600nA = 3U, /*!< The current of the charge pump is selected as 600nA. */ +} pmu_lpsr_ana_ldo_charge_pump_current_t; + +/*! + * @brief The enumeration of LPSR ANA LDO's output range. + */ +typedef enum _pmu_lpsr_ana_ldo_output_range +{ + kPMU_LpsrAnaLdoOutputFrom1P77To1P83 = 0U, /*!< The output voltage varies from 1.77V to 1.83V. */ + kPMU_LpsrAnaLdoOutputFrom1P72To1P77 = 1U, /*!< The output voltage varies from 1.72V to 1.77V. */ + kPMU_LpsrAnaLdoOutputFrom1P82To1P88 = 2U, /*!< The output voltage varies from 1.82V to 1.88V. */ +} pmu_lpsr_ana_ldo_output_range_t; + +/*! + * @brief The enumeration of voltage step time for LPSR DIG LDO. + */ +typedef enum _pmu_lpsr_dig_voltage_step_time +{ + kPMU_LpsrDigVoltageStepInc15us = 0x0U, /*!< LPSR DIG LDO voltage step time selected as 15us. */ + kPMU_LpsrDigVoltageStepInc25us = 0x1U, /*!< LPSR DIG LDO voltage step time selected as 25us. */ + kPMU_LpsrDigVoltageStepInc50us = 0x2U, /*!< LPSR DIG LDO voltage step time selected as 50us. */ + kPMU_LpsrDigVoltageStepInc100us = 0x3U, /*!< LPSR DIG LDO voltage step time selected as 100us. */ +} pmu_lpsr_dig_voltage_step_time_t; + +/*! + * @brief The target output voltage of LPSR DIG LDO. + */ +typedef enum _pmu_lpsr_dig_target_output_voltage +{ + kPMU_LpsrDigTargetStableVoltage0P631V = 0x0U, /*!< The target voltage selected as 0.631V */ + kPMU_LpsrDigTargetStableVoltage0P65V = 0x1U, /*!< The target voltage selected as 0.65V */ + kPMU_LpsrDigTargetStableVoltage0P67V = 0x2U, /*!< The target voltage selected as 0.67V */ + kPMU_LpsrDigTargetStableVoltage0P689V = 0x3U, /*!< The target voltage selected as 0.689V */ + kPMU_LpsrDigTargetStableVoltage0P709V = 0x4U, /*!< The target voltage selected as 0.709V */ + kPMU_LpsrDigTargetStableVoltage0P728V = 0x5U, /*!< The target voltage selected as 0.728V */ + kPMU_LpsrDigTargetStableVoltage0P748V = 0x6U, /*!< The target voltage selected as 0.748V */ + kPMU_LpsrDigTargetStableVoltage0P767V = 0x7U, /*!< The target voltage selected as 0.767V */ + kPMU_LpsrDigTargetStableVoltage0P786V = 0x8U, /*!< The target voltage selected as 0.786V */ + kPMU_LpsrDigTargetStableVoltage0P806V = 0x9U, /*!< The target voltage selected as 0.806V */ + kPMU_LpsrDigTargetStableVoltage0P825V = 0xAU, /*!< The target voltage selected as 0.825V */ + kPMU_LpsrDigTargetStableVoltage0P845V = 0xBU, /*!< The target voltage selected as 0.845V */ + kPMU_LpsrDigTargetStableVoltage0P864V = 0xCU, /*!< The target voltage selected as 0.864V */ + kPMU_LpsrDigTargetStableVoltage0P883V = 0xDU, /*!< The target voltage selected as 0.883V */ + kPMU_LpsrDigTargetStableVoltage0P903V = 0xEU, /*!< The target voltage selected as 0.903V */ + kPMU_LpsrDigTargetStableVoltage0P922V = 0xFU, /*!< The target voltage selected as 0.922V */ + kPMU_LpsrDigTargetStableVoltage0P942V = 0x10U, /*!< The target voltage selected as 0.942V */ + kPMU_LpsrDigTargetStableVoltage0P961V = 0x11U, /*!< The target voltage selected as 0.961V */ + kPMU_LpsrDigTargetStableVoltage0P981V = 0x12U, /*!< The target voltage selected as 0.981V */ + kPMU_LpsrDigTargetStableVoltage1P0V = 0x13U, /*!< The target voltage selected as 1.0V */ + kPMU_LpsrDigTargetStableVoltage1P019V = 0x14U, /*!< The target voltage selected as 1.019V */ + kPMU_LpsrDigTargetStableVoltage1P039V = 0x15U, /*!< The target voltage selected as 1.039V */ + kPMU_LpsrDigTargetStableVoltage1P058V = 0x16U, /*!< The target voltage selected as 1.058V */ + kPMU_LpsrDigTargetStableVoltage1P078V = 0x17U, /*!< The target voltage selected as 1.078V */ + kPMU_LpsrDigTargetStableVoltage1P097V = 0x18U, /*!< The target voltage selected as 1.097V */ + kPMU_LpsrDigTargetStableVoltage1P117V = 0x19U, /*!< The target voltage selected as 1.117V */ + kPMU_LpsrDigTargetStableVoltage1P136V = 0x1AU, /*!< The target voltage selected as 1.136V */ + kPMU_LpsrDigTargetStableVoltage1P155V = 0x1BU, /*!< The target voltage selected as 1.155V */ + kPMU_LpsrDigTargetStableVoltage1P175V = 0x1CU, /*!< The target voltage selected as 1.175V */ + kPMU_LpsrDigTargetStableVoltage1P194V = 0x1DU, /*!< The target voltage selected as 1.194V */ + kPMU_LpsrDigTargetStableVoltage1P214V = 0x1EU, /*!< The target voltage selected as 1.214V */ + kPMU_LpsrDigTargetStableVoltage1P233V = 0x1FU, /*!< The target voltage selected as 1.233V */ +} pmu_lpsr_dig_target_output_voltage_t; + +/*! + * @brief The enumeration of the SNVS DIG LDO's charge pump current. + */ +typedef enum _pmu_snvs_dig_charge_pump_current +{ + kPMU_SnvsDigChargePump12P5nA = 0U, /*!< The current of SNVS DIG LDO's charge pump is selected as 12.5nA. */ + kPMU_SnvsDigChargePump6P25nA = 1U, /*!< The current of SNVS DIG LDO's charge pump is selected as 6.25nA. */ + kPMU_SnvsDigChargePump18P75nA = 2U, /*!< The current of SNVS DIG LDO's charge pump is selected as 18.75nA. */ +} pmu_snvs_dig_charge_pump_current_t; + +/*! + * @brief The enumeration of the SNVS DIG LDO's discharge resistor. + */ +typedef enum _pmu_snvs_dig_discharge_resistor_value +{ + kPMU_SnvsDigDischargeResistor15K = 0U, /*!< The Discharge Resistor is selected as 15K ohm */ + kPMU_SnvsDigDischargeResistor30K = 1U, /*!< The Discharge Resistor is selected as 30K ohm */ + kPMU_SnvsDigDischargeResistor9K = 2U, /*!< The Discharge Resistor is selected as 9K ohm */ +} pmu_snvs_dig_discharge_resistor_value_t; + +/*! + * @brief The enumeration of bandgap power down option. + */ +enum _pmu_static_bandgap_power_down_option +{ + kPMU_PowerDownBandgapFully = 1U << 0U, /*!< Fully power down the bandgap module. */ + kPMU_PowerDownVoltageReferenceOutputOnly = 1U << 1U, /*!< Power down only the reference output + section of the bandgap */ + kPMU_PowerDownBandgapVBGUPDetector = 1U << 2U, /*!< Power down the VBGUP detector of the bandgap without + affecting any additional functionality. */ +}; + +/*! + * @brief The enumeration of output VBG voltage. + */ +typedef enum _pmu_bandgap_output_VBG_voltage_value +{ + kPMU_BandgapOutputVBGVoltageNominal = 0x0U, /*!< Output nominal voltage. */ + kPMU_BandgapOutputVBGVoltagePlus10mV = 0x1U, /*!< Output VBG voltage Plus 10mV. */ + kPMU_BandgapOutputVBGVoltagePlus20mV = 0x2U, /*!< Output VBG voltage Plus 20mV. */ + kPMU_BandgapOutputVBGVoltagePlus30mV = 0x3U, /*!< Output VBG voltage Plus 30mV. */ + kPMU_BandgapOutputVBGVoltageMinus10mV = 0x4U, /*!< Output VBG voltage Minus 10mV. */ + kPMU_BandgapOutputVBGVoltageMinus20mV = 0x5U, /*!< Output VBG voltage Minus 20mV. */ + kPMU_BandgapOutputVBGVoltageMinus30mV = 0x6U, /*!< Output VBG voltage Minus 30mV. */ + kPMU_BandgapOutputVBGVoltageMinus40mV = 0x7U, /*!< Output VBG voltage Minus 40mV. */ +} pmu_bandgap_output_VBG_voltage_value_t; + +/*! + * @brief The enumeration of output current. + */ +typedef enum _pmu_bandgap_output_current_value +{ + kPMU_OutputCurrent11P5uA = 0x0U, /*!< Output 11.5uA current from the bandgap. */ + kPMU_OutputCurrent11P8uA = 0x1U, /*!< Output 11.8uA current from the bandgap. */ + kPMU_OutputCurrent12P1uA = 0x2U, /*!< Output 12.1uA current from the bandgap. */ + kPMU_OutputCurrent12P4uA = 0x4U, /*!< Output 12.4uA current from the bandgap. */ + kPMU_OutputCurrent12P7uA = 0x5U, /*!< Output 12.7uA current from the bandgap. */ + kPMU_OutputCurrent13P0uA = 0x6U, /*!< Output 13.0uA current from the bandgap. */ + kPMU_OutputCurrent13P3uA = 0x7U, /*!< Output 13.3uA current from the bandgap. */ +} pmu_bandgap_output_current_value_t; + +/*! + * @brief The enumerator of well bias power source. + */ +typedef enum _pmu_well_bias_power_source +{ + kPMU_WellBiasPowerFromLpsrDigLdo = 0U, /*!< LPSR Dig LDO supplies the power stage and NWELL sampler. */ + kPMU_WellBiasPowerFromDCDC, /*!< DCDC supplies the power stage and NWELL sampler. */ +} pmu_well_bias_power_source_t; + +/*! + * @brief The enumerator of bias area size. + */ +typedef enum _pmu_bias_area_size +{ + kPMU_180uA_6mm2At125C = 0U, /*!< Imax = 180uA; Areamax-RVT = 6.00mm2 at 125C */ + kPMU_150uA_5mm2At125C, /*!< Imax = 150uA; Areamax-RVT = 5.00mm2 at 125C */ + kPMU_120uA_4mm2At125C, /*!< Imax = 120uA; Areamax-RVT = 4.00mm2 at 125C */ + kPMU_90uA_3mm2At125C, /*!< Imax = 90uA; Areamax-RVT = 3.00mm2 at 125C */ + kPMU_60uA_2mm2At125C, /*!< Imax = 60uA; Areamax-RVT = 2.00mm2 at 125C */ + kPMU_45uA_1P5mm2At125C, /*!< Imax = 45uA; Areamax-RVT = 1P5mm2 at 125C */ + kPMU_30uA_1mm2At125C, /*!< Imax = 30uA; Areamax-RVT = 1.00mm2 at 125C */ + kPMU_15uA_0P5mm2At125C, /*!< Imax = 15uA; Areamax-RVT = 0.50mm2 at 125C */ +} pmu_bias_area_size_t; + +/*! + * @brief The enumerator of well bias typical frequency. + */ +typedef enum _pmu_well_bias_typical_freq +{ + kPMU_OscFreqDiv128 = 0U, /*!< Typical frequency = osc_freq / 128. */ + kPMU_OscFreqDiv64 = 1U, /*!< Typical frequency = osc_freq / 64. */ + kPMU_OscFreqDiv32 = 2U, /*!< Typical frequency = osc_freq / 32. */ + kPMU_OscFreqDiv16 = 3U, /*!< Typical frequency = osc_freq / 16. */ + kPMU_OscFreqDiv8 = 4U, /*!< Typical frequency = osc_freq / 8. */ + kPMU_OscFreqDiv2 = 6U, /*!< Typical frequency = osc_freq / 2. */ + kPMU_OscFreq = 7U, /*!< Typical frequency = oscillator frequency. */ +} pmu_well_bias_typical_freq_t; + +/*! + * @brief The enumerator of well bias adaptive clock source. + */ +typedef enum _pmu_adaptive_clock_source +{ + kPMU_AdaptiveClkSourceOscClk = 0U, /*!< The adaptive clock source is oscillator clock. */ + kPMU_AdaptiveClkSourceChargePumpClk, /*!< The adaptive clock source is charge pump clock. */ +} pmu_adaptive_clock_source_t; + +/*! + * @brief The enumerator of frequency reduction due to cap increment. + */ +typedef enum _pmu_freq_reduction +{ + kPMU_FreqReductionNone = 0U, /*!< No frequency reduction. */ + kPMU_FreqReduction30PCT, /*!< 30% frequency reduction due to cap increment. */ + kPMU_FreqReduction40PCT, /*!< 40% frequency reduction due to cap increment. */ + kPMU_FreqReduction50PCT, /*!< 50% frequency reduction due to cap increment. */ +} pmu_freq_reduction_t; + +/*! + * @brief The enumerator of well bias 1P8 adjustment. + */ +typedef enum _pmu_well_bias_1P8_adjustment +{ + kPMU_Cref0fFCspl0fFDeltaC0fF = 0U, /*!< Cref = 0fF, Cspl = 0fF, DeltaC = 0fF. */ + kPMU_Cref0fFCspl30fFDeltaCN30fF, /*!< Cref = 0fF, Cspl = 30fF, DeltaC = -30fF. */ + kPMU_Cref0fFCspl43fFDeltaCN43fF, /*!< Cref = 0fF, Cspl = 43fF, DeltaC = -43fF. */ + kPMU_Cref0fFCspl62fFDeltaCN62fF, /*!< Cref = 0fF, Cspl = 62fF, DeltaC = -62fF. */ + kPMU_Cref0fFCspl105fFDeltaCN105fF, /*!< Cref = 0fF, Cspl = 105fF, DeltaC = -105fF. */ + kPMU_Cref30fFCspl0fFDeltaC30fF, /*!< Cref = 30fF, Cspl = 0fF, DeltaC = 30fF. */ + kPMU_Cref30fFCspl43fFDeltaCN12fF, /*!< Cref = 30fF, Cspl = 43fF, DeltaC = -12fF. */ + kPMU_Cref30fFCspl105fFDeltaCN75fF, /*!< Cref = 30fF, Cspl = 105fF, DeltaC = -75fF. */ + kPMU_Cref43fFCspl0fFDeltaC43fF, /*!< Cref = 43fF, Cspl = 0fF, DeltaC = 43fF. */ + kPMU_Cref43fFCspl30fFDeltaC13fF, /*!< Cref = 43fF, Cspl = 30fF, DeltaC = 13fF. */ + kPMU_Cref43fFCspl62fFDeltaCN19fF, /*!< Cref = 43fF, Cspl = 62fF, DeltaC = -19fF. */ + kPMU_Cref62fFCspl0fFDeltaC62fF, /*!< Cref = 62fF, Cspl = 0fF, DeltaC = 62fF. */ + kPMU_Cref62fFCspl43fFDeltaC19fF, /*!< Cref = 62fF, Cspl = 43fF, DeltaC = 19fF. */ + kPMU_Cref105fFCspl0fFDeltaC105fF, /*!< Cref = 105fF, Cspl = 0fF, DeltaC = 105fF. */ + kPMU_Cref105fFCspl30fFDeltaC75fF, /*!< Cref = 105fF, Cspl = 30fF, DeltaC = 75fF. */ +} pmu_well_bias_1P8_adjustment_t; + +/*! + * @brief LPSR ANA LDO config. + */ +typedef struct _pmu_static_lpsr_ana_ldo_config +{ + pmu_ldo_operate_mode_t mode; /*!< The operate mode of LPSR ANA LDO. */ + bool enable2mALoad; /*!< Enable/Disable 2mA load. + - \b true Enables 2mA loading to prevent overshoot; + - \b false Disables 2mA loading.*/ + bool enable4mALoad; /*!< Enable/Disable 4mA load. + - \b true Enables 4mA loading to prevent dramatic voltage drop; + - \b false Disables 4mA load. */ + bool enable20uALoad; /*!< Enable/Disable 20uA load. + - \b true Enables 20uA loading to prevent overshoot; + - \b false Disables 20uA load. */ + bool enableStandbyMode; /*!< Enable/Disable Standby Mode. + - \b true Enables Standby mode, if the STBY assert, the LPSR ANA LDO enter LP mode + - \b false Disables Standby mode. */ +} pmu_static_lpsr_ana_ldo_config_t; + +/*! + * @brief LPSR DIG LDO Config in Static/Software Mode. + */ +typedef struct _pmu_static_lpsr_dig_config +{ + bool enableStableDetect; /*!< Enable/Disable Stable Detect. + - \b true Enables Stable Detect. + - \b false Disables Stable Detect. */ + pmu_lpsr_dig_voltage_step_time_t voltageStepTime; /*!< Step time. */ + pmu_lpsr_dig_target_output_voltage_t targetVoltage; /*!< The target output voltage. */ +} pmu_static_lpsr_dig_config_t; + +/*! + * @brief SNVS DIG LDO config. + */ +typedef struct _pmu_snvs_dig_config +{ + pmu_ldo_operate_mode_t mode; /*!< The operate mode the SNVS DIG LDO. */ + pmu_snvs_dig_charge_pump_current_t chargePumpCurrent; /*!< The current of SNVS DIG LDO's charge pump current. */ + pmu_snvs_dig_discharge_resistor_value_t dischargeResistorValue; /*!< The value of SNVS DIG LDO's + Discharge Resistor. */ + uint8_t trimValue; /*!< The trim value. */ + bool enablePullDown; /*!< Enable/Disable Pull down. + - \b true Enables the feature of using 1M ohm resistor to discharge the LDO output. + - \b false Disables the feature of using 1M ohm resistor to discharge the LDO output. */ + bool enableLdoStable; /*!< Enable/Disable SNVS DIG LDO Stable. */ +} pmu_snvs_dig_config_t; + +/*! + * @brief Bandgap config in static mode. + */ +typedef struct _pmu_static_bandgap_config +{ + uint8_t powerDownOption; /*!< The OR'ed value of @ref _pmu_static_bandgap_power_down_option. Please refer to @ref + _pmu_static_bandgap_power_down_option. */ + bool enableLowPowerMode; /*!< Turn on/off the Low power mode. + - \b true Turns on the low power operation of the bandgap. + - \b false Turns off the low power operation of the bandgap. */ + pmu_bandgap_output_VBG_voltage_value_t outputVoltage; /*!< The output VBG voltage of Bandgap. */ + pmu_bandgap_output_current_value_t outputCurrent; /*!< The output current from the bandgap to + the temperature sensors. */ +} pmu_static_bandgap_config_t; + +/*! + * @brief The union of well bias basic options, such as clock source, power source and so on. + */ +typedef union _pmu_well_bias_option +{ + uint16_t wellBiasData; /*!< well bias configuration data. */ + struct + { + uint16_t enablePWellOnly : 1U; /*!< Turn on both PWELL and NWELL, or only trun on PWELL. + - \b 1b0 PWELL and NEWLL are both turned on. + - \b 1b1 PWELL is turned on only. */ + uint16_t reserved1 : 1U; /*!< Reserved. */ + uint16_t biasAreaSize : 3U; /*!< Select size of bias area, please refer to @ref pmu_bias_area_size_t */ + uint16_t disableAdaptiveFreq : 1U; /*!< Enable/Disable adaptive frequency. + - \b 1b0 Frequency change after each half cycle minimum frequency + determined by typical frequency. + - \b 1b1 Adaptive frequency disabled. Frequency determined by typical + frequency. */ + uint16_t wellBiasFreq : 3U; /*!< Set well bias typical frequency, please refer to @ref + pmu_well_bias_typical_freq_t. */ + uint16_t clkSource : 1U; /*!< Config the adaptive clock source, please @ref pmu_adaptive_clock_source_t. */ + uint16_t freqReduction : 2U; /*!< Config the percent of frequency reduction due to cap increment, + please refer to @ref pmu_freq_reduction_t. */ + uint16_t enablePowerDownOption : 1U; /*!< Enable/Disable pull down option. + - \b false Pull down option is disabled. + - \b true Pull down option is enabled. */ + uint16_t reserved2 : 1U; /*!< Reserved. */ + uint16_t powerSource : 1U; /*!< Set power source, please refer to @ref pmu_well_bias_power_source_t. */ + uint16_t reserved3 : 1U; /*!< Reserved. */ + } wellBiasStruct; +} pmu_well_bias_option_t; + +/*! + * @brief The structure of well bias configuration. + */ +typedef struct _pmu_well_bias_config +{ + pmu_well_bias_option_t wellBiasOption; /*!< Well bias basic function, please + refer to @ref pmu_well_bias_option_t. */ + pmu_well_bias_1P8_adjustment_t adjustment; /*!< Well bias adjustment 1P8, please + refer to @ref pmu_well_bias_1P8_adjustment_t. */ +} pmu_well_bias_config_t; + +/*! + * @brief The stucture of body bias config in GPC mode. + */ +typedef struct _pmu_gpc_body_bias_config +{ + uint8_t PWELLRegulatorSize; /*!< The size of the PWELL Regulator. */ + uint8_t NWELLRegulatorSize; /*!< The size of the NWELL Regulator. */ + uint8_t oscillatorSize; /*!< The size of the oscillator bits. */ + uint8_t regulatorStrength; /*!< The strength of the selected regulator. */ +} pmu_gpc_body_bias_config_t; + +/******************************************************************************* + * API + ******************************************************************************/ +#if defined(__cplusplus) +extern "C" { +#endif + +/*! + * @name LDOs Control APIs + * @{ + */ + +/*! + * @brief Selects the control mode of the PLL LDO. + * + * @param base PMU peripheral base address. + * @param mode The control mode of the PLL LDO. Please refer to @ref pmu_control_mode_t. + */ +void PMU_SetPllLdoControlMode(ANADIG_PMU_Type *base, pmu_control_mode_t mode); + +/*! + * @brief Switches the PLL LDO from Static/Software Mode to GPC/Hardware Mode. + * + * @param base PMU peripheral base address. + */ +void PMU_SwitchPllLdoToGPCMode(ANADIG_PMU_Type *base); + +/*! + * @brief Enables PLL LDO via AI interface in Static/Software mode. + * + * @param base PMU peripheral base address. + */ +void PMU_StaticEnablePllLdo(ANADIG_PMU_Type *base); + +/*! + * @brief Disables PLL LDO via AI interface in Static/Software mode. + */ +void PMU_StaticDisablePllLdo(void); + +/*! + * @brief Selects the control mode of the LPSR ANA LDO. + * + * @param base PMU peripheral base address. + * @param mode The control mode of the LPSR ANA LDO. Please refer to @ref pmu_control_mode_t. + */ +void PMU_SetLpsrAnaLdoControlMode(ANADIG_LDO_SNVS_Type *base, pmu_control_mode_t mode); + +/*! + * @brief Sets the Bypass mode of the LPSR ANA LDO. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + * @param enable Enable/Disable bypass mode. + * - \b true Enable LPSR ANA Bypass mode. + * - \b false Disable LPSR ANA Bypass mode. + */ +void PMU_StaticEnableLpsrAnaLdoBypassMode(ANADIG_LDO_SNVS_Type *base, bool enable); + +/*! + * @brief Checks whether the LPSR ANA LDO is in bypass mode. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + * @return The result used to indicates whether the LPSR ANA LDO is in bypass mode. + * - \b true The LPSR ANA LDO is in bypass mode. + * - \b false The LPSR ANA LDO not in bypass mode. + */ +static inline bool PMU_StaticCheckLpsrAnaLdoBypassMode(ANADIG_LDO_SNVS_Type *base) +{ + return ((ANADIG_LDO_SNVS->PMU_LDO_LPSR_ANA & ANADIG_LDO_SNVS_PMU_LDO_LPSR_ANA_BYPASS_MODE_EN_MASK) != 0UL); +} + +/*! + * @brief Fill the LPSR ANA LDO configuration structure with default settings. + * + * The default values are: + * @code + * config->mode = kPMU_HighPowerMode; + config->enable2mALoad = true; + config->enable20uALoad = false; + config->enable4mALoad = true; + config->enableStandbyMode = false; + config->driverStrength = kPMU_LpsrAnaLdoDriverStrength0; + config->brownOutDetectorConfig = kPMU_LpsrAnaLdoBrownOutDetectorDisable; + config->chargePumpCurrent = kPMU_LpsrAnaChargePump300nA; + config->outputRange = kPMU_LpsrAnaLdoOutputFrom1P77To1P83; + * @endcode + * + * @param config Pointer to the structure @ref pmu_static_lpsr_ana_ldo_config_t. + */ +void PMU_StaticGetLpsrAnaLdoDefaultConfig(pmu_static_lpsr_ana_ldo_config_t *config); + +/*! + * @brief Initialize the LPSR ANA LDO in Static/Sofware Mode. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + * @param config Pointer to the structure @ref pmu_static_lpsr_ana_ldo_config_t. + */ +void PMU_StaticLpsrAnaLdoInit(ANADIG_LDO_SNVS_Type *base, const pmu_static_lpsr_ana_ldo_config_t *config); + +/*! + * @brief Disable the output of LPSR ANA LDO. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + */ +void PMU_StaticLpsrAnaLdoDeinit(ANADIG_LDO_SNVS_Type *base); + +/*! + * @brief Selects the control mode of the LPSR DIG LDO. + * + * @param base PMU peripheral base address. + * @param mode The control mode of the LPSR DIG LDO. Please refer to @ref pmu_control_mode_t. + */ +void PMU_SetLpsrDigLdoControlMode(ANADIG_LDO_SNVS_Type *base, pmu_control_mode_t mode); + +/*! + * @brief Turn on/off Bypass mode of the LPSR DIG LDO in Static/Software mode. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + * @param enable + * - \b true Turns on Bypass mode of the LPSR DIG LDO. + * - \b false Turns off Bypass mode of the LPSR DIG LDO. + */ +void PMU_StaticEnableLpsrDigLdoBypassMode(ANADIG_LDO_SNVS_Type *base, bool enable); + +/*! + * @brief Checks whether the LPSR DIG LDO is in bypass mode. + * + * @param base PMU peripheral base address. + * @return The result used to indicates whether the LPSR DIG LDO is in bypass mode. + * - \b true The LPSR DIG LDO is in bypass mode. + * - \b false The LPSR DIG LDO not in bypass mode. + */ +static inline bool PMU_StaticCheckLpsrDigLdoBypassMode(ANADIG_LDO_SNVS_Type *base) +{ + return ((ANADIG_LDO_SNVS->PMU_LDO_LPSR_DIG & ANADIG_LDO_SNVS_PMU_LDO_LPSR_DIG_BYPASS_MODE_MASK) != 0UL); +} + +/*! + * @brief Gets the default configuration of LPSR DIG LDO. + * + * The default values are: + * @code + * config->enableStableDetect = false; + * config->voltageStepTime = kPMU_LpsrDigVoltageStepInc50us; + * config->brownOutConfig = kPMU_LpsrDigBrownOutDisable; + * config->targetVoltage = kPMU_LpsrDigTargetStableVoltage1P0V; + * config->mode = kPMU_HighPowerMode; + * @endcode + * @param config Pointer to the structure @ref pmu_static_lpsr_dig_config_t. + */ +void PMU_StaticGetLpsrDigLdoDefaultConfig(pmu_static_lpsr_dig_config_t *config); + +/*! + * @brief Initialize the LPSR DIG LDO in static mode. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + * @param config Pointer to the structure @ref pmu_static_lpsr_dig_config_t. + */ +void PMU_StaticLpsrDigLdoInit(ANADIG_LDO_SNVS_Type *base, const pmu_static_lpsr_dig_config_t *config); + +/*! + * @brief Disable the LPSR DIG LDO. + * + * @param base ANADIG_LDO_SNVS peripheral base address. + */ +void PMU_StaticLpsrDigLdoDeinit(ANADIG_LDO_SNVS_Type *base); + +/*! + * @brief Sets the voltage step of LPSR DIG LDO in certain setpoint during GPC mode. + * + * @note The function provides the feature to set the voltage step to different setpoints. + * + * @param setpointMap The map of setpoints should be the OR'ed Value of @ref _pmu_setpoint_map. + * @param voltageValue The voltage step to be set. See enumeration @ref pmu_lpsr_dig_target_output_voltage_t. + */ +void PMU_GPCSetLpsrDigLdoTargetVoltage(uint32_t setpointMap, pmu_lpsr_dig_target_output_voltage_t voltageValue); + +/*! + * @brief Gets the default config of the SNVS DIG LDO. + * + * The default values are: + * @code + * config->mode = kPMU_LowPowerMode; + * config->chargePumpCurrent = kPMU_SnvsDigChargePump12P5nA; + * config->dischargeResistorValue = kPMU_SnvsDigDischargeResistor15K; + * config->trimValue = 0U; + * config->enablePullDown = true; + * config->enableLdoStable = false; + * @endcode + * + * @param config Pointer to @ref pmu_snvs_dig_config_t. + */ +void PMU_GetSnvsDigLdoDefaultConfig(pmu_snvs_dig_config_t *config); + +/*! + * @brief Initialize the SNVS DIG LDO. + * + * @param base LDO SNVS DIG peripheral base address. + * @param mode Used to control LDO power mode, please refer to @ref pmu_ldo_operate_mode_t. + */ +void PMU_SnvsDigLdoInit(ANADIG_LDO_SNVS_DIG_Type *base, pmu_ldo_operate_mode_t mode); + +/*! + * @brief Disable SNVS DIG LDO. + */ +static inline void PMU_SnvsDigLdoDeinit(ANADIG_LDO_SNVS_DIG_Type *base) +{ + base->PMU_LDO_SNVS_DIG &= ~ANADIG_LDO_SNVS_DIG_PMU_LDO_SNVS_DIG_REG_EN_MASK; +} + +/*! + * @brief Controls the ON/OFF of the selected LDO in certain setpoints with GPC mode. + * + * @param name The name of the selected ldo. Please see enumeration @ref pmu_ldo_name_t for details. + * @param setpointMap The map of setpoints should be the OR'ed Value of @ref _pmu_setpoint_map, 1b'1 + * means enable specific ldo in that setpoint. + * For example, the code PMU_GPCEnableLdo(kPMU_PllLdo, 0x1U) means to enable PLL LDO in setpoint 0 and disable + * PLL LDO in other setpoint. + */ +void PMU_GPCEnableLdo(pmu_ldo_name_t name, uint32_t setpointMap); + +/*! + * @brief Sets the operating mode of the selected LDO in certain setpoints with GPC mode. + * + * @param name The name of the selected ldo. Please see enumeration @ref pmu_ldo_name_t for details. + * @param setpointMap The map of setpoints should be the OR'ed Value of @ref _pmu_setpoint_map. + * @param mode The operating mode of the selected ldo. Please refer to enumeration @ref pmu_ldo_operate_mode_t for + * details. + */ +void PMU_GPCSetLdoOperateMode(pmu_ldo_name_t name, uint32_t setpointMap, pmu_ldo_operate_mode_t mode); + +/*! + * @brief Controls the ON/OFF of the selected LDOs' Tracking mode in certain setpoints with GPC mode. + * + * @param name The name of the selected ldo. Please see enumeration @ref pmu_ldo_name_t for details. + * @param setpointMap The map of setpoints that the LDO tracking mode will be enabled in those setpoints, this value + * should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +void PMU_GPCEnableLdoTrackingMode(pmu_ldo_name_t name, uint32_t setpointMap); + +/*! + * @brief Controls the ON/OFF of the selected LDOs' Bypass mode in certain setpoints with GPC mode. + * + * @param name The name of the selected ldo. Please see enumeration @ref pmu_ldo_name_t for details. + * @param setpointMap The map of setpoints that the LDO bypass mode will be enabled in those setpoints, this value + * should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +void PMU_GPCEnableLdoBypassMode(pmu_ldo_name_t name, uint32_t setpointMap); + +/*! + * @brief When STBY assert, enable/disable the selected LDO enter it's Low power mode. + * + * @param name The name of the selected ldo. Please see enumeration @ref pmu_ldo_name_t for details. + * @param setpointMap The map of setpoints that the LDO low power mode will be enabled in those setpoints if STBY + * assert, this value should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +void PMU_GPCEnableLdoStandbyMode(pmu_ldo_name_t name, uint32_t setpointMap); + +/*! + * @} + */ + +/*! + * @name Bandgap Control APIs + * @{ + */ + +/*! + * @brief Selects the control mode of the Bandgap Reference. + * + * @param base PMU peripheral base address. + * @param mode The control mode of the Bandgap Reference. Please refer to @ref pmu_control_mode_t. + */ +void PMU_SetBandgapControlMode(ANADIG_PMU_Type *base, pmu_control_mode_t mode); + +/*! + * @brief Switches the Bandgap from Static/Software Mode to GPC/Hardware Mode. + * + * @param base PMU peripheral base address. + */ +void PMU_SwitchBandgapToGPCMode(ANADIG_PMU_Type *base); + +/*! + * @brief Disables Bandgap self bias for best noise performance. + * + * This function should be invoked after powering up. This function will wait for the bandgap stable and disable the + * bandgap self bias. After powering up, it need to wait for the bandgap to get stable and then disable Bandgap Self + * bias for best noise performance. + */ +void PMU_DisableBandgapSelfBiasAfterPowerUp(void); + +/*! + * @brief Enables Bandgap self bias before power down. + * + * This function will enable Bandgap self bias feature before powering down or there + * will be risk of Bandgap not starting properly. + */ +void PMU_EnableBandgapSelfBiasBeforePowerDown(void); + +/*! + * @brief Initialize Bandgap. + * + * @param config Pointer to the structure @ref pmu_static_bandgap_config_t. + */ +void PMU_StaticBandgapInit(const pmu_static_bandgap_config_t *config); + +/*! + * @brief Controls the ON/OFF of the Bandgap in certain setpoints with GPC mode. + * + * For example, the code PMU_GPCEnableBandgap(PMU, kPMU_SetPoint0 | kPMU_SetPoint1); means enable bandgap in + * setpoint0 and setpoint1 and disable bandgap in other setpoints. + * + * @param base PMU peripheral base address. + * @param setpointMap The map of setpoints that the bandgap will be enabled in those setpoints, this parameter + * should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +static inline void PMU_GPCEnableBandgap(ANADIG_PMU_Type *base, uint32_t setpointMap) +{ + base->BANDGAP_ENABLE_SP = ~setpointMap; +} + +/*! + * @brief Controls the ON/OFF of the Bandgap's Standby mode in certain setpoints with GPC mode. + * + * @param base PMU peripheral base address. + * @param setpointMap The map of setpoints that the bandgap standby mode will be enabled in those setpoints, this value + * should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +static inline void PMU_GPCEnableBandgapStandbyMode(ANADIG_PMU_Type *base, uint32_t setpointMap) +{ + base->BANDGAP_STBY_EN_SP = setpointMap; +} + +/*! + * @} + */ + +/*! + * @name Body Bias Control APIs + * @{ + */ + +/*! + * @brief Configures Well bias, such as power source, clock source and so on. + * + * @param base PMU peripheral base address. + * @param config Pointer to the @ref pmu_well_bias_config_t structure. + */ +void PMU_WellBiasInit(ANADIG_PMU_Type *base, const pmu_well_bias_config_t *config); + +/*! + * @brief Gets the default configuration of well bias. + * + * @param config The pointer to the @ref pmu_well_bias_config_t structure. + */ +void PMU_GetWellBiasDefaultConfig(pmu_well_bias_config_t *config); + +/*! + * @brief Selects the control mode of the Body Bias. + * + * @param base PMU peripheral base address. + * @param name The name of the body bias. Please refer to @ref pmu_body_bias_name_t. + * @param mode The control mode of the Body Bias. Please refer to @ref pmu_control_mode_t. + */ +void PMU_SetBodyBiasControlMode(ANADIG_PMU_Type *base, pmu_body_bias_name_t name, pmu_control_mode_t mode); + +/*! + * @brief Enables/disables the selected body bias. + * + * @param base PMU peripheral base address. + * @param name The name of the body bias to be turned on/off, please refer to @ref pmu_body_bias_name_t. + * @param enable Used to turn on/off the specific body bias. + * - \b true Enable the selected body bias. + * - \b false Disable the selected body bias. + */ +void PMU_EnableBodyBias(ANADIG_PMU_Type *base, pmu_body_bias_name_t name, bool enable); + +/*! + * @brief Controls the ON/OFF of the selected body bias in certain setpoints with GPC mode. + * + * @param name The name of the selected body bias. Please see enumeration @ref pmu_body_bias_name_t for details. + * @param setpointMap The map of setpoints that the specific body bias will be enabled in those setpoints, this value + * should be the OR'ed Value of _pmu_setpoint_map. + */ +void PMU_GPCEnableBodyBias(pmu_body_bias_name_t name, uint32_t setpointMap); + +/*! + * @brief Controls the ON/OFF of the selected Body Bias' Wbias power switch in certain setpoints with GPC mode. + * + * @param name The name of the selected body bias. Please see the enumeration @ref pmu_body_bias_name_t for details. + * @param setpointMap The map of setpoints that the specific body bias's wbias power switch will be turn on in those + * setpoints, this value should be the OR'ed Value of @ref _pmu_setpoint_map. + */ +void PMU_GPCEnableBodyBiasStandbyMode(pmu_body_bias_name_t name, uint32_t setpointMap); + +/*! + * @brief Gets the default config of body bias in GPC mode. + * + * @param config Pointer to structure @ref pmu_gpc_body_bias_config_t. + */ +void PMU_GPCGetBodyBiasDefaultConfig(pmu_gpc_body_bias_config_t *config); + +/*! + * @brief Sets the config of the selected Body Bias in GPC mode. + * + * @param name The name of the selected body bias. Please see enumeration @ref pmu_body_bias_name_t for details. + * @param config Pointer to structure @ref pmu_gpc_body_bias_config_t. + */ +void PMU_GPCSetBodyBiasConfig(pmu_body_bias_name_t name, const pmu_gpc_body_bias_config_t *config); + +/*! + * @} + */ + +#if defined(__cplusplus) +} +#endif +/*! + * @} + */ + +#endif /* _FSL_PMU_H_ */ |