You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
398 lines
13 KiB
398 lines
13 KiB
/**
|
|
******************************************************************************
|
|
* @file stm8s_adc2.c
|
|
* @author MCD Application Team
|
|
* @version V2.2.0
|
|
* @date 30-September-2014
|
|
* @brief This file contains all the functions/macros for the ADC2 peripheral.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© COPYRIGHT 2014 STMicroelectronics</center></h2>
|
|
*
|
|
* Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
|
|
* You may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at:
|
|
*
|
|
* http://www.st.com/software_license_agreement_liberty_v2
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm8s_adc2.h"
|
|
|
|
/** @addtogroup STM8S_StdPeriph_Driver
|
|
* @{
|
|
*/
|
|
/* Private typedef -----------------------------------------------------------*/
|
|
/* Private define ------------------------------------------------------------*/
|
|
/* Private macro -------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
/* Private functions ---------------------------------------------------------*/
|
|
|
|
/* Public functions ----------------------------------------------------------*/
|
|
|
|
/**
|
|
* @addtogroup ADC2_Public_Functions
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Deinitializes the ADC2 peripheral registers to their default reset
|
|
* values.
|
|
* @param None
|
|
* @retval None
|
|
*/
|
|
void ADC2_DeInit(void)
|
|
{
|
|
ADC2->CSR = ADC2_CSR_RESET_VALUE;
|
|
ADC2->CR1 = ADC2_CR1_RESET_VALUE;
|
|
ADC2->CR2 = ADC2_CR2_RESET_VALUE;
|
|
ADC2->TDRH = ADC2_TDRH_RESET_VALUE;
|
|
ADC2->TDRL = ADC2_TDRL_RESET_VALUE;
|
|
}
|
|
|
|
/**
|
|
* @brief Initializes the ADC2 peripheral according to the specified parameters
|
|
* @param ADC2_ConversionMode: specifies the conversion mode
|
|
* can be one of the values of @ref ADC2_ConvMode_TypeDef.
|
|
* @param ADC2_Channel: specifies the channel to convert
|
|
* can be one of the values of @ref ADC2_Channel_TypeDef.
|
|
* @param ADC2_PrescalerSelection: specifies the ADC2 prescaler
|
|
* can be one of the values of @ref ADC2_PresSel_TypeDef.
|
|
* @param ADC2_ExtTrigger: specifies the external trigger
|
|
* can be one of the values of @ref ADC2_ExtTrig_TypeDef.
|
|
* @param ADC2_ExtTriggerState: specifies the external trigger new state
|
|
* can be one of the values of @ref FunctionalState.
|
|
* @param ADC2_Align: specifies the converted data alignment
|
|
* can be one of the values of @ref ADC2_Align_TypeDef.
|
|
* @param ADC2_SchmittTriggerChannel: specifies the schmitt trigger channel
|
|
* can be one of the values of @ref ADC2_SchmittTrigg_TypeDef.
|
|
* @param ADC2_SchmittTriggerState: specifies the schmitt trigger state
|
|
* can be one of the values of @ref FunctionalState.
|
|
* @retval None
|
|
*/
|
|
void ADC2_Init(ADC2_ConvMode_TypeDef ADC2_ConversionMode, ADC2_Channel_TypeDef ADC2_Channel, ADC2_PresSel_TypeDef ADC2_PrescalerSelection, ADC2_ExtTrig_TypeDef ADC2_ExtTrigger, FunctionalState ADC2_ExtTriggerState, ADC2_Align_TypeDef ADC2_Align, ADC2_SchmittTrigg_TypeDef ADC2_SchmittTriggerChannel, FunctionalState ADC2_SchmittTriggerState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_ADC2_CONVERSIONMODE_OK(ADC2_ConversionMode));
|
|
assert_param(IS_ADC2_CHANNEL_OK(ADC2_Channel));
|
|
assert_param(IS_ADC2_PRESSEL_OK(ADC2_PrescalerSelection));
|
|
assert_param(IS_ADC2_EXTTRIG_OK(ADC2_ExtTrigger));
|
|
assert_param(IS_FUNCTIONALSTATE_OK(((ADC2_ExtTriggerState))));
|
|
assert_param(IS_ADC2_ALIGN_OK(ADC2_Align));
|
|
assert_param(IS_ADC2_SCHMITTTRIG_OK(ADC2_SchmittTriggerChannel));
|
|
assert_param(IS_FUNCTIONALSTATE_OK(ADC2_SchmittTriggerState));
|
|
|
|
/*-----------------CR1 & CSR configuration --------------------*/
|
|
/* Configure the conversion mode and the channel to convert
|
|
respectively according to ADC2_ConversionMode & ADC2_Channel values & ADC2_Align values */
|
|
ADC2_ConversionConfig(ADC2_ConversionMode, ADC2_Channel, ADC2_Align);
|
|
/* Select the prescaler division factor according to ADC2_PrescalerSelection values */
|
|
ADC2_PrescalerConfig(ADC2_PrescalerSelection);
|
|
|
|
/*-----------------CR2 configuration --------------------*/
|
|
/* Configure the external trigger state and event respectively
|
|
according to ADC2_ExtTrigStatus, ADC2_ExtTrigger */
|
|
ADC2_ExternalTriggerConfig(ADC2_ExtTrigger, ADC2_ExtTriggerState);
|
|
|
|
/*------------------TDR configuration ---------------------------*/
|
|
/* Configure the schmitt trigger channel and state respectively
|
|
according to ADC2_SchmittTriggerChannel & ADC2_SchmittTriggerNewState values */
|
|
ADC2_SchmittTriggerConfig(ADC2_SchmittTriggerChannel, ADC2_SchmittTriggerState);
|
|
|
|
/* Enable the ADC2 peripheral */
|
|
ADC2->CR1 |= ADC2_CR1_ADON;
|
|
}
|
|
|
|
/**
|
|
* @brief Enables or Disables the ADC2 peripheral.
|
|
* @param NewState: specifies the peripheral enabled or disabled state.
|
|
* @retval None
|
|
*/
|
|
void ADC2_Cmd(FunctionalState NewState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_FUNCTIONALSTATE_OK(NewState));
|
|
|
|
if (NewState != DISABLE)
|
|
{
|
|
ADC2->CR1 |= ADC2_CR1_ADON;
|
|
}
|
|
else /* NewState == DISABLE */
|
|
{
|
|
ADC2->CR1 &= (uint8_t)(~ADC2_CR1_ADON);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Enables or disables the ADC2 interrupt.
|
|
* @param NewState specifies the state of ADC2 interrupt.
|
|
* @retval None
|
|
*/
|
|
void ADC2_ITConfig(FunctionalState NewState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_FUNCTIONALSTATE_OK(NewState));
|
|
|
|
if (NewState != DISABLE)
|
|
{
|
|
/* Enable the ADC2 interrupts */
|
|
ADC2->CSR |= (uint8_t)ADC2_CSR_EOCIE;
|
|
}
|
|
else /*NewState == DISABLE */
|
|
{
|
|
/* Disable the ADC2 interrupts */
|
|
ADC2->CSR &= (uint8_t)(~ADC2_CSR_EOCIE);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Configure the ADC2 prescaler division factor.
|
|
* @param ADC2_Prescaler: the selected prescaler.
|
|
* It can be one of the values of @ref ADC2_PresSel_TypeDef.
|
|
* @retval None
|
|
*/
|
|
void ADC2_PrescalerConfig(ADC2_PresSel_TypeDef ADC2_Prescaler)
|
|
{
|
|
/* Check the parameter */
|
|
assert_param(IS_ADC2_PRESSEL_OK(ADC2_Prescaler));
|
|
|
|
/* Clear the SPSEL bits */
|
|
ADC2->CR1 &= (uint8_t)(~ADC2_CR1_SPSEL);
|
|
/* Select the prescaler division factor according to ADC2_PrescalerSelection values */
|
|
ADC2->CR1 |= (uint8_t)(ADC2_Prescaler);
|
|
}
|
|
|
|
/**
|
|
* @brief Enables or disables the ADC2 Schmitt Trigger on a selected channel.
|
|
* @param ADC2_SchmittTriggerChannel specifies the desired Channel.
|
|
* It can be set of the values of @ref ADC2_SchmittTrigg_TypeDef.
|
|
* @param NewState specifies the Channel ADC2 Schmitt Trigger new status.
|
|
* can have one of the values of @ref FunctionalState.
|
|
* @retval None
|
|
*/
|
|
void ADC2_SchmittTriggerConfig(ADC2_SchmittTrigg_TypeDef ADC2_SchmittTriggerChannel, FunctionalState NewState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_ADC2_SCHMITTTRIG_OK(ADC2_SchmittTriggerChannel));
|
|
assert_param(IS_FUNCTIONALSTATE_OK(NewState));
|
|
|
|
if (ADC2_SchmittTriggerChannel == ADC2_SCHMITTTRIG_ALL)
|
|
{
|
|
if (NewState != DISABLE)
|
|
{
|
|
ADC2->TDRL &= (uint8_t)0x0;
|
|
ADC2->TDRH &= (uint8_t)0x0;
|
|
}
|
|
else /* NewState == DISABLE */
|
|
{
|
|
ADC2->TDRL |= (uint8_t)0xFF;
|
|
ADC2->TDRH |= (uint8_t)0xFF;
|
|
}
|
|
}
|
|
else if (ADC2_SchmittTriggerChannel < ADC2_SCHMITTTRIG_CHANNEL8)
|
|
{
|
|
if (NewState != DISABLE)
|
|
{
|
|
ADC2->TDRL &= (uint8_t)(~(uint8_t)((uint8_t)0x01 << (uint8_t)ADC2_SchmittTriggerChannel));
|
|
}
|
|
else /* NewState == DISABLE */
|
|
{
|
|
ADC2->TDRL |= (uint8_t)((uint8_t)0x01 << (uint8_t)ADC2_SchmittTriggerChannel);
|
|
}
|
|
}
|
|
else /* ADC2_SchmittTriggerChannel >= ADC2_SCHMITTTRIG_CHANNEL8 */
|
|
{
|
|
if (NewState != DISABLE)
|
|
{
|
|
ADC2->TDRH &= (uint8_t)(~(uint8_t)((uint8_t)0x01 << ((uint8_t)ADC2_SchmittTriggerChannel - (uint8_t)8)));
|
|
}
|
|
else /* NewState == DISABLE */
|
|
{
|
|
ADC2->TDRH |= (uint8_t)((uint8_t)0x01 << ((uint8_t)ADC2_SchmittTriggerChannel - (uint8_t)8));
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Configure the ADC2 conversion on selected channel.
|
|
* @param ADC2_ConversionMode Specifies the conversion type.
|
|
* It can be set of the values of @ref ADC2_ConvMode_TypeDef
|
|
* @param ADC2_Channel specifies the ADC2 Channel.
|
|
* It can be set of the values of @ref ADC2_Channel_TypeDef
|
|
* @param ADC2_Align specifies the converted data alignment.
|
|
* It can be set of the values of @ref ADC2_Align_TypeDef
|
|
* @retval None
|
|
*/
|
|
void ADC2_ConversionConfig(ADC2_ConvMode_TypeDef ADC2_ConversionMode, ADC2_Channel_TypeDef ADC2_Channel, ADC2_Align_TypeDef ADC2_Align)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_ADC2_CONVERSIONMODE_OK(ADC2_ConversionMode));
|
|
assert_param(IS_ADC2_CHANNEL_OK(ADC2_Channel));
|
|
assert_param(IS_ADC2_ALIGN_OK(ADC2_Align));
|
|
|
|
/* Clear the align bit */
|
|
ADC2->CR2 &= (uint8_t)(~ADC2_CR2_ALIGN);
|
|
/* Configure the data alignment */
|
|
ADC2->CR2 |= (uint8_t)(ADC2_Align);
|
|
|
|
if (ADC2_ConversionMode == ADC2_CONVERSIONMODE_CONTINUOUS)
|
|
{
|
|
/* Set the continuous conversion mode */
|
|
ADC2->CR1 |= ADC2_CR1_CONT;
|
|
}
|
|
else /* ADC2_ConversionMode == ADC2_CONVERSIONMODE_SINGLE */
|
|
{
|
|
/* Set the single conversion mode */
|
|
ADC2->CR1 &= (uint8_t)(~ADC2_CR1_CONT);
|
|
}
|
|
|
|
/* Clear the ADC2 channels */
|
|
ADC2->CSR &= (uint8_t)(~ADC2_CSR_CH);
|
|
/* Select the ADC2 channel */
|
|
ADC2->CSR |= (uint8_t)(ADC2_Channel);
|
|
}
|
|
|
|
/**
|
|
* @brief Configure the ADC2 conversion on external trigger event.
|
|
* @par Full description:
|
|
* The selected external trigger event can be enabled or disabled.
|
|
* @param ADC2_ExtTrigger to select the External trigger event.
|
|
* can have one of the values of @ref ADC2_ExtTrig_TypeDef.
|
|
* @param NewState to enable/disable the selected external trigger
|
|
* can have one of the values of @ref FunctionalState.
|
|
* @retval None
|
|
*/
|
|
void ADC2_ExternalTriggerConfig(ADC2_ExtTrig_TypeDef ADC2_ExtTrigger, FunctionalState NewState)
|
|
{
|
|
/* Check the parameters */
|
|
assert_param(IS_ADC2_EXTTRIG_OK(ADC2_ExtTrigger));
|
|
assert_param(IS_FUNCTIONALSTATE_OK(NewState));
|
|
|
|
/* Clear the external trigger selection bits */
|
|
ADC2->CR2 &= (uint8_t)(~ADC2_CR2_EXTSEL);
|
|
|
|
if (NewState != DISABLE)
|
|
{
|
|
/* Enable the selected external Trigger */
|
|
ADC2->CR2 |= (uint8_t)(ADC2_CR2_EXTTRIG);
|
|
}
|
|
else /* NewState == DISABLE */
|
|
{
|
|
/* Disable the selected external trigger */
|
|
ADC2->CR2 &= (uint8_t)(~ADC2_CR2_EXTTRIG);
|
|
}
|
|
|
|
/* Set the selected external trigger */
|
|
ADC2->CR2 |= (uint8_t)(ADC2_ExtTrigger);
|
|
}
|
|
|
|
/**
|
|
* @brief Start ADC2 conversion
|
|
* @par Full description:
|
|
* This function triggers the start of conversion, after ADC2 configuration.
|
|
* @param None
|
|
* @retval None
|
|
* @par Required preconditions:
|
|
* Enable the ADC2 peripheral before calling this function
|
|
*/
|
|
void ADC2_StartConversion(void)
|
|
{
|
|
ADC2->CR1 |= ADC2_CR1_ADON;
|
|
}
|
|
|
|
/**
|
|
* @brief Get one sample of measured signal.
|
|
* @param None
|
|
* @retval ConversionValue: value of the measured signal.
|
|
* @par Required preconditions:
|
|
* ADC2 conversion finished.
|
|
*/
|
|
uint16_t ADC2_GetConversionValue(void)
|
|
{
|
|
uint16_t temph = 0;
|
|
uint8_t templ = 0;
|
|
|
|
if ((ADC2->CR2 & ADC2_CR2_ALIGN) != 0) /* Right alignment */
|
|
{
|
|
/* Read LSB first */
|
|
templ = ADC2->DRL;
|
|
/* Then read MSB */
|
|
temph = ADC2->DRH;
|
|
|
|
temph = (uint16_t)(templ | (uint16_t)(temph << (uint8_t)8));
|
|
}
|
|
else /* Left alignment */
|
|
{
|
|
/* Read MSB first*/
|
|
temph = ADC2->DRH;
|
|
/* Then read LSB */
|
|
templ = ADC2->DRL;
|
|
|
|
temph = (uint16_t)((uint16_t)((uint16_t)templ << 6) | (uint16_t)((uint16_t)temph << 8));
|
|
}
|
|
|
|
return ((uint16_t)temph);
|
|
}
|
|
|
|
/**
|
|
* @brief Checks the ADC2 EOC flag status.
|
|
* @param None
|
|
* @retval FlagStatus Status of the ADC2 EOC flag.
|
|
*/
|
|
FlagStatus ADC2_GetFlagStatus(void)
|
|
{
|
|
/* Get EOC flag status */
|
|
return (FlagStatus)(ADC2->CSR & ADC2_CSR_EOC);
|
|
}
|
|
|
|
/**
|
|
* @brief Clear the ADC2 EOC Flag.
|
|
* @param None
|
|
* @retval None
|
|
*/
|
|
void ADC2_ClearFlag(void)
|
|
{
|
|
ADC2->CSR &= (uint8_t)(~ADC2_CSR_EOC);
|
|
}
|
|
|
|
/**
|
|
* @brief Returns the EOC pending bit status
|
|
* @par Parameters:
|
|
* None
|
|
* @retval FlagStatus: status of the EOC pending bit.
|
|
*/
|
|
ITStatus ADC2_GetITStatus(void)
|
|
{
|
|
return (ITStatus)(ADC2->CSR & ADC2_CSR_EOC);
|
|
}
|
|
|
|
/**
|
|
* @brief Clear the ADC2 End of Conversion pending bit.
|
|
* @param None
|
|
* @retval None
|
|
*/
|
|
void ADC2_ClearITPendingBit(void)
|
|
{
|
|
ADC2->CSR &= (uint8_t)(~ADC2_CSR_EOC);
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
|
|