/* * Copyright (c) 2016, Freescale Semiconductor, Inc. * Copyright 2016-2021 NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #ifndef _FSL_LPADC_H_ #define _FSL_LPADC_H_ #include "fsl_common.h" /*! * @addtogroup lpadc * @{ */ /*! @file */ /******************************************************************************* * Definitions ******************************************************************************/ /*! @name Driver version */ /*@{*/ /*! @brief LPADC driver version 2.5.1. */ #define FSL_LPADC_DRIVER_VERSION (MAKE_VERSION(2, 5, 1)) /*@}*/ /*! * @brief Define the MACRO function to get command status from status value. * * The statusVal is the return value from LPADC_GetStatusFlags(). */ #define LPADC_GET_ACTIVE_COMMAND_STATUS(statusVal) ((statusVal & ADC_STAT_CMDACT_MASK) >> ADC_STAT_CMDACT_SHIFT) /*! * @brief Define the MACRO function to get trigger status from status value. * * The statusVal is the return value from LPADC_GetStatusFlags(). */ #define LPADC_GET_ACTIVE_TRIGGER_STATUE(statusVal) ((statusVal & ADC_STAT_TRGACT_MASK) >> ADC_STAT_TRGACT_SHIFT) #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) /*! * @brief Define hardware flags of the module. */ enum _lpadc_status_flags { kLPADC_ResultFIFO0OverflowFlag = ADC_STAT_FOF0_MASK, /*!< Indicates that more data has been written to the Result FIFO 0 than it can hold. */ kLPADC_ResultFIFO0ReadyFlag = ADC_STAT_RDY0_MASK, /*!< Indicates when the number of valid datawords in the result FIFO 0 is greater than the setting watermark level. */ kLPADC_ResultFIFO1OverflowFlag = ADC_STAT_FOF1_MASK, /*!< Indicates that more data has been written to the Result FIFO 1 than it can hold. */ kLPADC_ResultFIFO1ReadyFlag = ADC_STAT_RDY1_MASK, /*!< Indicates when the number of valid datawords in the result FIFO 1 is greater than the setting watermark level. */ }; /*! * @brief Define interrupt switchers of the module. */ enum _lpadc_interrupt_enable { kLPADC_ResultFIFO0OverflowInterruptEnable = ADC_IE_FOFIE0_MASK, /*!< Configures ADC to generate overflow interrupt requests when FOF0 flag is asserted. */ kLPADC_FIFO0WatermarkInterruptEnable = ADC_IE_FWMIE0_MASK, /*!< Configures ADC to generate watermark interrupt requests when RDY0 flag is asserted. */ kLPADC_ResultFIFO1OverflowInterruptEnable = ADC_IE_FOFIE1_MASK, /*!< Configures ADC to generate overflow interrupt requests when FOF1 flag is asserted. */ kLPADC_FIFO1WatermarkInterruptEnable = ADC_IE_FWMIE1_MASK, /*!< Configures ADC to generate watermark interrupt requests when RDY1 flag is asserted. */ #if (defined(FSL_FEATURE_LPADC_HAS_TSTAT) && FSL_FEATURE_LPADC_HAS_TSTAT) kLPADC_TriggerExceptionInterruptEnable = ADC_IE_TEXC_IE_MASK, /*!< Configures ADC to generate trigger exception interrupt. */ kLPADC_Trigger0CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 0UL), /*!< Configures ADC to generate interrupt when trigger 0 completion. */ kLPADC_Trigger1CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 1UL), /*!< Configures ADC to generate interrupt when trigger 1 completion. */ kLPADC_Trigger2CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 2UL), /*!< Configures ADC to generate interrupt when trigger 2 completion. */ kLPADC_Trigger3CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 3UL), /*!< Configures ADC to generate interrupt when trigger 3 completion. */ kLPADC_Trigger4CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 4UL), /*!< Configures ADC to generate interrupt when trigger 4 completion. */ kLPADC_Trigger5CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 5UL), /*!< Configures ADC to generate interrupt when trigger 5 completion. */ kLPADC_Trigger6CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 6UL), /*!< Configures ADC to generate interrupt when trigger 6 completion. */ kLPADC_Trigger7CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 7UL), /*!< Configures ADC to generate interrupt when trigger 7 completion. */ kLPADC_Trigger8CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 8UL), /*!< Configures ADC to generate interrupt when trigger 8 completion. */ kLPADC_Trigger9CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 9UL), /*!< Configures ADC to generate interrupt when trigger 9 completion. */ kLPADC_Trigger10CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 10UL), /*!< Configures ADC to generate interrupt when trigger 10 completion. */ kLPADC_Trigger11CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 11UL), /*!< Configures ADC to generate interrupt when trigger 11 completion. */ kLPADC_Trigger12CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 12UL), /*!< Configures ADC to generate interrupt when trigger 12 completion. */ kLPADC_Trigger13CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 13UL), /*!< Configures ADC to generate interrupt when trigger 13 completion. */ kLPADC_Trigger14CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 14UL), /*!< Configures ADC to generate interrupt when trigger 14 completion. */ kLPADC_Trigger15CompletionInterruptEnable = ADC_IE_TCOMP_IE(1UL << 15UL), /*!< Configures ADC to generate interrupt when trigger 15 completion. */ #endif /* FSL_FEATURE_LPADC_HAS_TSTAT */ }; #else /*! * @brief Define hardware flags of the module. */ enum _lpadc_status_flags { kLPADC_ResultFIFOOverflowFlag = ADC_STAT_FOF_MASK, /*!< Indicates that more data has been written to the Result FIFO than it can hold. */ kLPADC_ResultFIFOReadyFlag = ADC_STAT_RDY_MASK, /*!< Indicates when the number of valid datawords in the result FIFO is greater than the setting watermark level. */ }; /*! * @brief Define interrupt switchers of the module. */ enum _lpadc_interrupt_enable { kLPADC_ResultFIFOOverflowInterruptEnable = ADC_IE_FOFIE_MASK, /*!< Configures ADC to generate overflow interrupt requests when FOF flag is asserted. */ kLPADC_FIFOWatermarkInterruptEnable = ADC_IE_FWMIE_MASK, /*!< Configures ADC to generate watermark interrupt requests when RDY flag is asserted. */ }; #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ #if (defined(FSL_FEATURE_LPADC_HAS_TSTAT) && FSL_FEATURE_LPADC_HAS_TSTAT) /*! * @brief The enumerator of lpadc trigger status flags, including interrupted flags and completed flags. */ enum _lpadc_trigger_status_flags { kLPADC_Trigger0InterruptedFlag = 1UL << 0UL, /*!< Trigger 0 is interrupted by a high priority exception. */ kLPADC_Trigger1InterruptedFlag = 1UL << 1UL, /*!< Trigger 1 is interrupted by a high priority exception. */ kLPADC_Trigger2InterruptedFlag = 1UL << 2UL, /*!< Trigger 2 is interrupted by a high priority exception. */ kLPADC_Trigger3InterruptedFlag = 1UL << 3UL, /*!< Trigger 3 is interrupted by a high priority exception. */ kLPADC_Trigger4InterruptedFlag = 1UL << 4UL, /*!< Trigger 4 is interrupted by a high priority exception. */ kLPADC_Trigger5InterruptedFlag = 1UL << 5UL, /*!< Trigger 5 is interrupted by a high priority exception. */ kLPADC_Trigger6InterruptedFlag = 1UL << 6UL, /*!< Trigger 6 is interrupted by a high priority exception. */ kLPADC_Trigger7InterruptedFlag = 1UL << 7UL, /*!< Trigger 7 is interrupted by a high priority exception. */ kLPADC_Trigger8InterruptedFlag = 1UL << 8UL, /*!< Trigger 8 is interrupted by a high priority exception. */ kLPADC_Trigger9InterruptedFlag = 1UL << 9UL, /*!< Trigger 9 is interrupted by a high priority exception. */ kLPADC_Trigger10InterruptedFlag = 1UL << 10UL, /*!< Trigger 10 is interrupted by a high priority exception. */ kLPADC_Trigger11InterruptedFlag = 1UL << 11UL, /*!< Trigger 11 is interrupted by a high priority exception. */ kLPADC_Trigger12InterruptedFlag = 1UL << 12UL, /*!< Trigger 12 is interrupted by a high priority exception. */ kLPADC_Trigger13InterruptedFlag = 1UL << 13UL, /*!< Trigger 13 is interrupted by a high priority exception. */ kLPADC_Trigger14InterruptedFlag = 1UL << 14UL, /*!< Trigger 14 is interrupted by a high priority exception. */ kLPADC_Trigger15InterruptedFlag = 1UL << 15UL, /*!< Trigger 15 is interrupted by a high priority exception. */ kLPADC_Trigger0CompletedFlag = 1UL << 16UL, /*!< Trigger 0 is completed and trigger 0 has enabled completion interrupts. */ kLPADC_Trigger1CompletedFlag = 1UL << 17UL, /*!< Trigger 1 is completed and trigger 1 has enabled completion interrupts. */ kLPADC_Trigger2CompletedFlag = 1UL << 18UL, /*!< Trigger 2 is completed and trigger 2 has enabled completion interrupts. */ kLPADC_Trigger3CompletedFlag = 1UL << 19UL, /*!< Trigger 3 is completed and trigger 3 has enabled completion interrupts. */ kLPADC_Trigger4CompletedFlag = 1UL << 20UL, /*!< Trigger 4 is completed and trigger 4 has enabled completion interrupts. */ kLPADC_Trigger5CompletedFlag = 1UL << 21UL, /*!< Trigger 5 is completed and trigger 5 has enabled completion interrupts. */ kLPADC_Trigger6CompletedFlag = 1UL << 22UL, /*!< Trigger 6 is completed and trigger 6 has enabled completion interrupts. */ kLPADC_Trigger7CompletedFlag = 1UL << 23UL, /*!< Trigger 7 is completed and trigger 7 has enabled completion interrupts. */ kLPADC_Trigger8CompletedFlag = 1UL << 24UL, /*!< Trigger 8 is completed and trigger 8 has enabled completion interrupts. */ kLPADC_Trigger9CompletedFlag = 1UL << 25UL, /*!< Trigger 9 is completed and trigger 9 has enabled completion interrupts. */ kLPADC_Trigger10CompletedFlag = 1UL << 26UL, /*!< Trigger 10 is completed and trigger 10 has enabled completion interrupts. */ kLPADC_Trigger11CompletedFlag = 1UL << 27UL, /*!< Trigger 11 is completed and trigger 11 has enabled completion interrupts. */ kLPADC_Trigger12CompletedFlag = 1UL << 28UL, /*!< Trigger 12 is completed and trigger 12 has enabled completion interrupts. */ kLPADC_Trigger13CompletedFlag = 1UL << 29UL, /*!< Trigger 13 is completed and trigger 13 has enabled completion interrupts. */ kLPADC_Trigger14CompletedFlag = 1UL << 30UL, /*!< Trigger 14 is completed and trigger 14 has enabled completion interrupts. */ kLPADC_Trigger15CompletedFlag = 1UL << 31UL, /*!< Trigger 15 is completed and trigger 15 has enabled completion interrupts. */ }; #endif /* FSL_FEATURE_LPADC_HAS_TSTAT */ /*! * @brief Define enumeration of sample scale mode. * * The sample scale mode is used to reduce the selected ADC analog channel input voltage level by a factor. The maximum * possible voltage on the ADC channel input should be considered when selecting a scale mode to ensure that the * reducing factor always results voltage level at or below the VREFH reference. This reducing capability allows * conversion of analog inputs higher than VREFH. A-side and B-side channel inputs are both scaled using the scale mode. */ typedef enum _lpadc_sample_scale_mode { kLPADC_SamplePartScale = 0U, /*!< Use divided input voltage signal. (Factor of 30/64). */ kLPADC_SampleFullScale = 1U, /*!< Full scale (Factor of 1). */ } lpadc_sample_scale_mode_t; /*! * @brief Define enumeration of channel sample mode. * * The channel sample mode configures the channel with single-end/differential/dual-single-end, side A/B. */ typedef enum _lpadc_sample_channel_mode { kLPADC_SampleChannelSingleEndSideA = 0U, /*!< Single end mode, using side A. */ kLPADC_SampleChannelSingleEndSideB = 1U, /*!< Single end mode, using side B. */ #if defined(FSL_FEATURE_LPADC_HAS_CMDL_DIFF) && FSL_FEATURE_LPADC_HAS_CMDL_DIFF kLPADC_SampleChannelDiffBothSideAB = 2U, /*!< Differential mode, using A as plus side and B as minus side. */ kLPADC_SampleChannelDiffBothSideBA = 3U, /*!< Differential mode, using B as plus side and A as minus side. */ #elif defined(FSL_FEATURE_LPADC_HAS_CMDL_CTYPE) && FSL_FEATURE_LPADC_HAS_CMDL_CTYPE kLPADC_SampleChannelDiffBothSide = 2U, /*!< Differential mode, using A and B. */ kLPADC_SampleChannelDualSingleEndBothSide = 3U, /*!< Dual-Single-Ended Mode. Both A side and B side channels are converted independently. */ #endif } lpadc_sample_channel_mode_t; /*! * @brief Define enumeration of hardware average selection. * * It Selects how many ADC conversions are averaged to create the ADC result. An internal storage buffer is used to * capture temporary results while the averaging iterations are executed. */ typedef enum _lpadc_hardware_average_mode { kLPADC_HardwareAverageCount1 = 0U, /*!< Single conversion. */ kLPADC_HardwareAverageCount2 = 1U, /*!< 2 conversions averaged. */ kLPADC_HardwareAverageCount4 = 2U, /*!< 4 conversions averaged. */ kLPADC_HardwareAverageCount8 = 3U, /*!< 8 conversions averaged. */ kLPADC_HardwareAverageCount16 = 4U, /*!< 16 conversions averaged. */ kLPADC_HardwareAverageCount32 = 5U, /*!< 32 conversions averaged. */ kLPADC_HardwareAverageCount64 = 6U, /*!< 64 conversions averaged. */ kLPADC_HardwareAverageCount128 = 7U, /*!< 128 conversions averaged. */ } lpadc_hardware_average_mode_t; /*! * @brief Define enumeration of sample time selection. * * The shortest sample time maximizes conversion speed for lower impedance inputs. Extending sample time allows higher * impedance inputs to be accurately sampled. Longer sample times can also be used to lower overall power consumption * when command looping and sequencing is configured and high conversion rates are not required. */ typedef enum _lpadc_sample_time_mode { kLPADC_SampleTimeADCK3 = 0U, /*!< 3 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK5 = 1U, /*!< 5 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK7 = 2U, /*!< 7 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK11 = 3U, /*!< 11 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK19 = 4U, /*!< 19 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK35 = 5U, /*!< 35 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK67 = 6U, /*!< 69 ADCK cycles total sample time. */ kLPADC_SampleTimeADCK131 = 7U, /*!< 131 ADCK cycles total sample time. */ } lpadc_sample_time_mode_t; /*! * @brief Define enumeration of hardware compare mode. * * After an ADC channel input is sampled and converted and any averaging iterations are performed, this mode setting * guides operation of the automatic compare function to optionally only store when the compare operation is true. * When compare is enabled, the conversion result is compared to the compare values. */ typedef enum _lpadc_hardware_compare_mode { kLPADC_HardwareCompareDisabled = 0U, /*!< Compare disabled. */ kLPADC_HardwareCompareStoreOnTrue = 2U, /*!< Compare enabled. Store on true. */ kLPADC_HardwareCompareRepeatUntilTrue = 3U, /*!< Compare enabled. Repeat channel acquisition until true. */ } lpadc_hardware_compare_mode_t; #if defined(FSL_FEATURE_LPADC_HAS_CMDL_MODE) && FSL_FEATURE_LPADC_HAS_CMDL_MODE /*! * @brief Define enumeration of conversion resolution mode. * * Configure the resolution bit in specific conversion type. For detailed resolution accuracy, see to * #lpadc_sample_channel_mode_t */ typedef enum _lpadc_conversion_resolution_mode { kLPADC_ConversionResolutionStandard = 0U, /*!< Standard resolution. Single-ended 12-bit conversion, Differential 13-bit conversion with 2’s complement output. */ kLPADC_ConversionResolutionHigh = 1U, /*!< High resolution. Single-ended 16-bit conversion; Differential 16-bit conversion with 2’s complement output. */ } lpadc_conversion_resolution_mode_t; #endif /* FSL_FEATURE_LPADC_HAS_CMDL_MODE */ #if defined(FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS) && FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS /*! * @brief Define enumeration of conversion averages mode. * * Configure the converion average number for auto-calibration. */ typedef enum _lpadc_conversion_average_mode { kLPADC_ConversionAverage1 = 0U, /*!< Single conversion. */ kLPADC_ConversionAverage2 = 1U, /*!< 2 conversions averaged. */ kLPADC_ConversionAverage4 = 2U, /*!< 4 conversions averaged. */ kLPADC_ConversionAverage8 = 3U, /*!< 8 conversions averaged. */ kLPADC_ConversionAverage16 = 4U, /*!< 16 conversions averaged. */ kLPADC_ConversionAverage32 = 5U, /*!< 32 conversions averaged. */ kLPADC_ConversionAverage64 = 6U, /*!< 64 conversions averaged. */ kLPADC_ConversionAverage128 = 7U, /*!< 128 conversions averaged. */ } lpadc_conversion_average_mode_t; #endif /* FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS */ /*! * @brief Define enumeration of reference voltage source. * * For detail information, need to check the SoC's specification. */ typedef enum _lpadc_reference_voltage_mode { kLPADC_ReferenceVoltageAlt1 = 0U, /*!< Option 1 setting. */ kLPADC_ReferenceVoltageAlt2 = 1U, /*!< Option 2 setting. */ kLPADC_ReferenceVoltageAlt3 = 2U, /*!< Option 3 setting. */ } lpadc_reference_voltage_source_t; /*! * @brief Define enumeration of power configuration. * * Configures the ADC for power and performance. In the highest power setting the highest conversion rates will be * possible. Refer to the device data sheet for power and performance capabilities for each setting. */ typedef enum _lpadc_power_level_mode { kLPADC_PowerLevelAlt1 = 0U, /*!< Lowest power setting. */ kLPADC_PowerLevelAlt2 = 1U, /*!< Next lowest power setting. */ kLPADC_PowerLevelAlt3 = 2U, /*!< ... */ kLPADC_PowerLevelAlt4 = 3U, /*!< Highest power setting. */ } lpadc_power_level_mode_t; /*! * @brief Define enumeration of trigger priority policy. * * This selection controls how higher priority triggers are handled. */ typedef enum _lpadc_trigger_priority_policy { kLPADC_TriggerPriorityPreemptImmediately = 0U, /*!< If a higher priority trigger is detected during command processing, the current conversion is aborted and the new command specified by the trigger is started. */ kLPADC_TriggerPriorityPreemptSoftly = 1U, /*!< If a higher priority trigger is received during command processing, the current conversion is completed (including averaging iterations and compare function if enabled) and stored to the result FIFO before the higher priority trigger/command is initiated. */ #if defined(FSL_FEATURE_LPADC_HAS_CFG_SUBSEQUENT_PRIORITY) && FSL_FEATURE_LPADC_HAS_CFG_SUBSEQUENT_PRIORITY kLPADC_TriggerPriorityPreemptSubsequently = 2U, /*!< If a higher priority trigger is received during command processing, the current command will be completed (averaging, looping, compare) before servicing the higher priority trigger. */ #endif /* FSL_FEATURE_LPADC_HAS_CFG_SUBSEQUENT_PRIORITY */ } lpadc_trigger_priority_policy_t; /*! * @brief LPADC global configuration. * * This structure would used to keep the settings for initialization. */ typedef struct { #if defined(FSL_FEATURE_LPADC_HAS_CFG_ADCKEN) && FSL_FEATURE_LPADC_HAS_CFG_ADCKEN bool enableInternalClock; /*!< Enables the internally generated clock source. The clock source is used in clock selection logic at the chip level and is optionally used for the ADC clock source. */ #endif /* FSL_FEATURE_LPADC_HAS_CFG_ADCKEN */ #if defined(FSL_FEATURE_LPADC_HAS_CFG_VREF1RNG) && FSL_FEATURE_LPADC_HAS_CFG_VREF1RNG bool enableVref1LowVoltage; /*!< If voltage reference option1 input is below 1.8V, it should be "true". If voltage reference option1 input is above 1.8V, it should be "false". */ #endif /* FSL_FEATURE_LPADC_HAS_CFG_VREF1RNG */ bool enableInDozeMode; /*!< Control system transition to Stop and Wait power modes while ADC is converting. When enabled in Doze mode, immediate entries to Wait or Stop are allowed. When disabled, the ADC will wait for the current averaging iteration/FIFO storage to complete before acknowledging stop or wait mode entry. */ #if defined(FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS) && FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS lpadc_conversion_average_mode_t conversionAverageMode; /*!< Auto-Calibration Averages. */ #endif /* FSL_FEATURE_LPADC_HAS_CTRL_CAL_AVGS */ bool enableAnalogPreliminary; /*!< ADC analog circuits are pre-enabled and ready to execute conversions without startup delays(at the cost of higher DC current consumption). */ uint32_t powerUpDelay; /*!< When the analog circuits are not pre-enabled, the ADC analog circuits are only powered while the ADC is active and there is a counted delay defined by this field after an initial trigger transitions the ADC from its Idle state to allow time for the analog circuits to stabilize. The startup delay count of (powerUpDelay * 4) ADCK cycles must result in a longer delay than the analog startup time. */ lpadc_reference_voltage_source_t referenceVoltageSource; /*!< Selects the voltage reference high used for conversions.*/ lpadc_power_level_mode_t powerLevelMode; /*!< Power Configuration Selection. */ lpadc_trigger_priority_policy_t triggerPriorityPolicy; /*!< Control how higher priority triggers are handled, see to lpadc_trigger_priority_policy_t. */ bool enableConvPause; /*!< Enables the ADC pausing function. When enabled, a programmable delay is inserted during command execution sequencing between LOOP iterations, between commands in a sequence, and between conversions when command is executing in "Compare Until True" configuration. */ uint32_t convPauseDelay; /*!< Controls the duration of pausing during command execution sequencing. The pause delay is a count of (convPauseDelay*4) ADCK cycles. Only available when ADC pausing function is enabled. The available value range is in 9-bit. */ #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) /* for FIFO0. */ uint32_t FIFO0Watermark; /*!< FIFO0Watermark is a programmable threshold setting. When the number of datawords stored in the ADC Result FIFO0 is greater than the value in this field, the ready flag would be asserted to indicate stored data has reached the programmable threshold. */ /* for FIFO1. */ uint32_t FIFO1Watermark; /*!< FIFO1Watermark is a programmable threshold setting. When the number of datawords stored in the ADC Result FIFO1 is greater than the value in this field, the ready flag would be asserted to indicate stored data has reached the programmable threshold. */ #else /* for FIFO. */ uint32_t FIFOWatermark; /*!< FIFOWatermark is a programmable threshold setting. When the number of datawords stored in the ADC Result FIFO is greater than the value in this field, the ready flag would be asserted to indicate stored data has reached the programmable threshold. */ #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ } lpadc_config_t; /*! * @brief Define structure to keep the configuration for conversion command. */ typedef struct { #if defined(FSL_FEATURE_LPADC_HAS_CMDL_CSCALE) && FSL_FEATURE_LPADC_HAS_CMDL_CSCALE lpadc_sample_scale_mode_t sampleScaleMode; /*!< Sample scale mode. */ #endif /* FSL_FEATURE_LPADC_HAS_CMDL_CSCALE */ lpadc_sample_channel_mode_t sampleChannelMode; /*!< Channel sample mode. */ uint32_t channelNumber; /*!< Channel number, select the channel or channel pair. */ uint32_t chainedNextCommandNumber; /*!< Selects the next command to be executed after this command completes. 1-15 is available, 0 is to terminate the chain after this command. */ bool enableAutoChannelIncrement; /*!< Loop with increment: when disabled, the "loopCount" field selects the number of times the selected channel is converted consecutively; when enabled, the "loopCount" field defines how many consecutive channels are converted as part of the command execution. */ uint32_t loopCount; /*!< Selects how many times this command executes before finish and transition to the next command or Idle state. Command executes LOOP+1 times. 0-15 is available. */ lpadc_hardware_average_mode_t hardwareAverageMode; /*!< Hardware average selection. */ lpadc_sample_time_mode_t sampleTimeMode; /*!< Sample time selection. */ lpadc_hardware_compare_mode_t hardwareCompareMode; /*!< Hardware compare selection. */ uint32_t hardwareCompareValueHigh; /*!< Compare Value High. The available value range is in 16-bit. */ uint32_t hardwareCompareValueLow; /*!< Compare Value Low. The available value range is in 16-bit. */ #if defined(FSL_FEATURE_LPADC_HAS_CMDL_MODE) && FSL_FEATURE_LPADC_HAS_CMDL_MODE lpadc_conversion_resolution_mode_t conversionResolutionMode; /*!< Conversion resolution mode. */ #endif /* FSL_FEATURE_LPADC_HAS_CMDL_MODE */ #if defined(FSL_FEATURE_LPADC_HAS_CMDH_WAIT_TRIG) && FSL_FEATURE_LPADC_HAS_CMDH_WAIT_TRIG bool enableWaitTrigger; /*!< Wait for trigger assertion before execution: when disabled, this command will be automatically executed; when enabled, the active trigger must be asserted again before executing this command. */ #endif /* FSL_FEATURE_LPADC_HAS_CMDH_WAIT_TRIG */ } lpadc_conv_command_config_t; /*! * @brief Define structure to keep the configuration for conversion trigger. */ typedef struct { uint32_t targetCommandId; /*!< Select the command from command buffer to execute upon detect of the associated trigger event. */ uint32_t delayPower; /*!< Select the trigger delay duration to wait at the start of servicing a trigger event. When this field is clear, then no delay is incurred. When this field is set to a non-zero value, the duration for the delay is 2^delayPower ADCK cycles. The available value range is 4-bit. */ uint32_t priority; /*!< Sets the priority of the associated trigger source. If two or more triggers have the same priority level setting, the lower order trigger event has the higher priority. The lower value for this field is for the higher priority, the available value range is 1-bit. */ #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) uint8_t channelAFIFOSelect; /* SAR Result Destination For Channel A. */ uint8_t channelBFIFOSelect; /* SAR Result Destination For Channel B. */ #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ bool enableHardwareTrigger; /*!< Enable hardware trigger source to initiate conversion on the rising edge of the input trigger source or not. THe software trigger is always available. */ } lpadc_conv_trigger_config_t; /*! * @brief Define the structure to keep the conversion result. */ typedef struct { uint32_t commandIdSource; /*!< Indicate the command buffer being executed that generated this result. */ uint32_t loopCountIndex; /*!< Indicate the loop count value during command execution that generated this result. */ uint32_t triggerIdSource; /*!< Indicate the trigger source that initiated a conversion and generated this result. */ uint16_t convValue; /*!< Data result. */ } lpadc_conv_result_t; #if defined(__cplusplus) extern "C" { #endif /******************************************************************************* * API ******************************************************************************/ /*! * @name Initialization & de-initialization. * @{ */ /*! * @brief Initializes the LPADC module. * * @param base LPADC peripheral base address. * @param config Pointer to configuration structure. See "lpadc_config_t". */ void LPADC_Init(ADC_Type *base, const lpadc_config_t *config); /*! * @brief Gets an available pre-defined settings for initial configuration. * * This function initializes the converter configuration structure with an available settings. The default values are: * @code * config->enableInDozeMode = true; * config->enableAnalogPreliminary = false; * config->powerUpDelay = 0x80; * config->referenceVoltageSource = kLPADC_ReferenceVoltageAlt1; * config->powerLevelMode = kLPADC_PowerLevelAlt1; * config->triggerPriorityPolicy = kLPADC_TriggerPriorityPreemptImmediately; * config->enableConvPause = false; * config->convPauseDelay = 0U; * config->FIFOWatermark = 0U; * @endcode * @param config Pointer to configuration structure. */ void LPADC_GetDefaultConfig(lpadc_config_t *config); /*! * @brief De-initializes the LPADC module. * * @param base LPADC peripheral base address. */ void LPADC_Deinit(ADC_Type *base); /*! * @brief Switch on/off the LPADC module. * * @param base LPADC peripheral base address. * @param enable switcher to the module. */ static inline void LPADC_Enable(ADC_Type *base, bool enable) { if (enable) { base->CTRL |= ADC_CTRL_ADCEN_MASK; } else { base->CTRL &= ~ADC_CTRL_ADCEN_MASK; } } #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) /*! * @brief Do reset the conversion FIFO0. * * @param base LPADC peripheral base address. */ static inline void LPADC_DoResetFIFO0(ADC_Type *base) { base->CTRL |= ADC_CTRL_RSTFIFO0_MASK; } /*! * @brief Do reset the conversion FIFO1. * * @param base LPADC peripheral base address. */ static inline void LPADC_DoResetFIFO1(ADC_Type *base) { base->CTRL |= ADC_CTRL_RSTFIFO1_MASK; } #else /*! * @brief Do reset the conversion FIFO. * * @param base LPADC peripheral base address. */ static inline void LPADC_DoResetFIFO(ADC_Type *base) { base->CTRL |= ADC_CTRL_RSTFIFO_MASK; } #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ /*! * @brief Do reset the module's configuration. * * Reset all ADC internal logic and registers, except the Control Register (ADCx_CTRL). * * @param base LPADC peripheral base address. */ static inline void LPADC_DoResetConfig(ADC_Type *base) { base->CTRL |= ADC_CTRL_RST_MASK; base->CTRL &= ~ADC_CTRL_RST_MASK; } /* @} */ /*! * @name Status * @{ */ /*! * @brief Get status flags. * * @param base LPADC peripheral base address. * @return status flags' mask. See to #_lpadc_status_flags. */ static inline uint32_t LPADC_GetStatusFlags(ADC_Type *base) { return base->STAT; } /*! * @brief Clear status flags. * * Only the flags can be cleared by writing ADCx_STATUS register would be cleared by this API. * * @param base LPADC peripheral base address. * @param mask Mask value for flags to be cleared. See to #_lpadc_status_flags. */ static inline void LPADC_ClearStatusFlags(ADC_Type *base, uint32_t mask) { base->STAT = mask; } #if (defined(FSL_FEATURE_LPADC_HAS_TSTAT) && FSL_FEATURE_LPADC_HAS_TSTAT) /*! * @brief Get trigger status flags to indicate which trigger sequences have been completed or interrupted by a high * priority trigger exception. * * @param base LPADC peripheral base address. * @return The OR'ed value of @ref _lpadc_trigger_status_flags. */ static inline uint32_t LPADC_GetTriggerStatusFlags(ADC_Type *base) { return base->TSTAT; } /*! * @brief Clear trigger status flags. * * @param base LPADC peripheral base address. * @param mask The mask of trigger status flags to be cleared, should be the * OR'ed value of @ref _lpadc_trigger_status_flags. */ static inline void LPADC_ClearTriggerStatusFlags(ADC_Type *base, uint32_t mask) { base->TSTAT = mask; } #endif /* FSL_FEATURE_LPADC_HAS_TSTAT */ /* @} */ /*! * @name Interrupts * @{ */ /*! * @brief Enable interrupts. * * @param base LPADC peripheral base address. * @param mask Mask value for interrupt events. See to #_lpadc_interrupt_enable. */ static inline void LPADC_EnableInterrupts(ADC_Type *base, uint32_t mask) { base->IE |= mask; } /*! * @brief Disable interrupts. * * @param base LPADC peripheral base address. * @param mask Mask value for interrupt events. See to #_lpadc_interrupt_enable. */ static inline void LPADC_DisableInterrupts(ADC_Type *base, uint32_t mask) { base->IE &= ~mask; } /*! * @name DMA Control * @{ */ #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) /*! * @brief Switch on/off the DMA trigger for FIFO0 watermark event. * * @param base LPADC peripheral base address. * @param enable Switcher to the event. */ static inline void LPADC_EnableFIFO0WatermarkDMA(ADC_Type *base, bool enable) { if (enable) { base->DE |= ADC_DE_FWMDE0_MASK; } else { base->DE &= ~ADC_DE_FWMDE0_MASK; } } /*! * @brief Switch on/off the DMA trigger for FIFO1 watermark event. * * @param base LPADC peripheral base address. * @param enable Switcher to the event. */ static inline void LPADC_EnableFIFO1WatermarkDMA(ADC_Type *base, bool enable) { if (enable) { base->DE |= ADC_DE_FWMDE1_MASK; } else { base->DE &= ~ADC_DE_FWMDE1_MASK; } } #else /*! * @brief Switch on/off the DMA trigger for FIFO watermark event. * * @param base LPADC peripheral base address. * @param enable Switcher to the event. */ static inline void LPADC_EnableFIFOWatermarkDMA(ADC_Type *base, bool enable) { if (enable) { base->DE |= ADC_DE_FWMDE_MASK; } else { base->DE &= ~ADC_DE_FWMDE_MASK; } } #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ /* @} */ /*! * @name Trigger and conversion with FIFO. * @{ */ #if (defined(FSL_FEATURE_LPADC_FIFO_COUNT) && (FSL_FEATURE_LPADC_FIFO_COUNT == 2)) /*! * @brief Get the count of result kept in conversion FIFOn. * * @param base LPADC peripheral base address. * @param index Result FIFO index. * @return The count of result kept in conversion FIFOn. */ static inline uint32_t LPADC_GetConvResultCount(ADC_Type *base, uint8_t index) { return (ADC_FCTRL_FCOUNT_MASK & base->FCTRL[index]) >> ADC_FCTRL_FCOUNT_SHIFT; } /*! * brief Get the result in conversion FIFOn. * * param base LPADC peripheral base address. * param result Pointer to structure variable that keeps the conversion result in conversion FIFOn. * param index Result FIFO index. * * return Status whether FIFOn entry is valid. */ bool LPADC_GetConvResult(ADC_Type *base, lpadc_conv_result_t *result, uint8_t index); #else /*! * @brief Get the count of result kept in conversion FIFO. * * @param base LPADC peripheral base address. * @return The count of result kept in conversion FIFO. */ static inline uint32_t LPADC_GetConvResultCount(ADC_Type *base) { return (ADC_FCTRL_FCOUNT_MASK & base->FCTRL) >> ADC_FCTRL_FCOUNT_SHIFT; } /*! * @brief Get the result in conversion FIFO. * * @param base LPADC peripheral base address. * @param result Pointer to structure variable that keeps the conversion result in conversion FIFO. * * @return Status whether FIFO entry is valid. */ bool LPADC_GetConvResult(ADC_Type *base, lpadc_conv_result_t *result); #endif /* FSL_FEATURE_LPADC_FIFO_COUNT */ /*! * @brief Configure the conversion trigger source. * * Each programmable trigger can launch the conversion command in command buffer. * * @param base LPADC peripheral base address. * @param triggerId ID for each trigger. Typically, the available value range is from 0. * @param config Pointer to configuration structure. See to #lpadc_conv_trigger_config_t. */ void LPADC_SetConvTriggerConfig(ADC_Type *base, uint32_t triggerId, const lpadc_conv_trigger_config_t *config); /*! * @brief Gets an available pre-defined settings for trigger's configuration. * * This function initializes the trigger's configuration structure with an available settings. The default values are: * @code * config->commandIdSource = 0U; * config->loopCountIndex = 0U; * config->triggerIdSource = 0U; * config->enableHardwareTrigger = false; * @endcode * @param config Pointer to configuration structure. */ void LPADC_GetDefaultConvTriggerConfig(lpadc_conv_trigger_config_t *config); /*! * @brief Do software trigger to conversion command. * * @param base LPADC peripheral base address. * @param triggerIdMask Mask value for software trigger indexes, which count from zero. */ static inline void LPADC_DoSoftwareTrigger(ADC_Type *base, uint32_t triggerIdMask) { /* Writes to ADCx_SWTRIG register are ignored while ADCx_CTRL[ADCEN] is clear. */ base->SWTRIG = triggerIdMask; } /*! * @brief Configure conversion command. * * @param base LPADC peripheral base address. * @param commandId ID for command in command buffer. Typically, the available value range is 1 - 15. * @param config Pointer to configuration structure. See to #lpadc_conv_command_config_t. */ void LPADC_SetConvCommandConfig(ADC_Type *base, uint32_t commandId, const lpadc_conv_command_config_t *config); /*! * @brief Gets an available pre-defined settings for conversion command's configuration. * * This function initializes the conversion command's configuration structure with an available settings. The default * values are: * @code * config->sampleScaleMode = kLPADC_SampleFullScale; * config->channelSampleMode = kLPADC_SampleChannelSingleEndSideA; * config->channelNumber = 0U; * config->chainedNextCmdNumber = 0U; * config->enableAutoChannelIncrement = false; * config->loopCount = 0U; * config->hardwareAverageMode = kLPADC_HardwareAverageCount1; * config->sampleTimeMode = kLPADC_SampleTimeADCK3; * config->hardwareCompareMode = kLPADC_HardwareCompareDisabled; * config->hardwareCompareValueHigh = 0U; * config->hardwareCompareValueLow = 0U; * config->conversionResolutionMode = kLPADC_ConversionResolutionStandard; * config->enableWaitTrigger = false; * @endcode * @param config Pointer to configuration structure. */ void LPADC_GetDefaultConvCommandConfig(lpadc_conv_command_config_t *config); #if defined(FSL_FEATURE_LPADC_HAS_CFG_CALOFS) && FSL_FEATURE_LPADC_HAS_CFG_CALOFS /*! * @brief Enable the calibration function. * * When CALOFS is set, the ADC is configured to perform a calibration function anytime the ADC executes * a conversion. Any channel selected is ignored and the value returned in the RESFIFO is a signed value * between -31 and 31. -32 is not a valid and is never a returned value. Software should copy the lower 6- * bits of the conversion result stored in the RESFIFO after a completed calibration conversion to the * OFSTRIM field. The OFSTRIM field is used in normal operation for offset correction. * * @param base LPADC peripheral base address. * @param enable switcher to the calibration function. */ void LPADC_EnableCalibration(ADC_Type *base, bool enable); #if defined(FSL_FEATURE_LPADC_HAS_OFSTRIM) && FSL_FEATURE_LPADC_HAS_OFSTRIM /*! * @brief Set proper offset value to trim ADC. * * To minimize the offset during normal operation, software should read the conversion result from * the RESFIFO calibration operation and write the lower 6 bits to the OFSTRIM register. * * @param base LPADC peripheral base address. * @param value Setting offset value. */ static inline void LPADC_SetOffsetValue(ADC_Type *base, uint32_t value) { base->OFSTRIM = (value & ADC_OFSTRIM_OFSTRIM_MASK) >> ADC_OFSTRIM_OFSTRIM_SHIFT; } /*! * @brief Do auto calibration. * * Calibration function should be executed before using converter in application. It used the software trigger and a * dummy conversion, get the offset and write them into the OFSTRIM register. It called some of functional API * including: -LPADC_EnableCalibration(...) -LPADC_LPADC_SetOffsetValue(...) -LPADC_SetConvCommandConfig(...) * -LPADC_SetConvTriggerConfig(...) * * @param base LPADC peripheral base address. */ void LPADC_DoAutoCalibration(ADC_Type *base); #endif /* FSL_FEATURE_LPADC_HAS_OFSTRIM */ #endif /* FSL_FEATURE_LPADC_HAS_CFG_CALOFS */ #if defined(FSL_FEATURE_LPADC_HAS_CTRL_CALOFS) && FSL_FEATURE_LPADC_HAS_CTRL_CALOFS #if defined(FSL_FEATURE_LPADC_HAS_OFSTRIM) && FSL_FEATURE_LPADC_HAS_OFSTRIM /*! * @brief Set proper offset value to trim ADC. * * Set the offset trim value for offset calibration manually. * * @param base LPADC peripheral base address. * @param valueA Setting offset value A. * @param valueB Setting offset value B. * @note In normal adc sequence, the values are automatically calculated by LPADC_EnableOffsetCalibration. */ static inline void LPADC_SetOffsetValue(ADC_Type *base, uint32_t valueA, uint32_t valueB) { base->OFSTRIM = ADC_OFSTRIM_OFSTRIM_A(valueA) | ADC_OFSTRIM_OFSTRIM_B(valueB); } #endif /* FSL_FEATURE_LPADC_HAS_OFSTRIM */ /*! * @brief Enable the offset calibration function. * * @param base LPADC peripheral base address. * @param enable switcher to the calibration function. */ static inline void LPADC_EnableOffsetCalibration(ADC_Type *base, bool enable) { if (enable) { base->CTRL |= ADC_CTRL_CALOFS_MASK; } else { base->CTRL &= ~ADC_CTRL_CALOFS_MASK; } } /*! * @brief Do offset calibration. * * @param base LPADC peripheral base address. */ void LPADC_DoOffsetCalibration(ADC_Type *base); #if defined(FSL_FEATURE_LPADC_HAS_CTRL_CAL_REQ) && FSL_FEATURE_LPADC_HAS_CTRL_CAL_REQ /*! * brief Do auto calibration. * * param base LPADC peripheral base address. */ void LPADC_DoAutoCalibration(ADC_Type *base); #endif /* FSL_FEATURE_LPADC_HAS_CTRL_CAL_REQ */ #endif /* FSL_FEATURE_LPADC_HAS_CTRL_CALOFS */ /* @} */ #if defined(__cplusplus) } #endif /*! * @} */ #endif /* _FSL_LPADC_H_ */