stm8s_adc1.c

STM8s

    /* Set the slected external trigger */
    ADC1->CR2 |= (u8)(ADC1_ExtTrigger);

}


/**
  * @brief Start ADC1 conversion
  * @par Full description:
  * This function  triggers the start of conversion, after ADC1 configuration.
  * @par Parameters:
  * None
  * @retval None
  * @par Required preconditions:
  * Enable the ADC1 peripheral before calling this fuction
  */
void ADC1_StartConversion(void)
{
    ADC1->CR1 |= ADC1_CR1_ADON;
}

/**
  * @brief Get one sample of measured signal.
  * @par Parameters:
  * None
  * @retval ConversionValue:  value of the measured signal.
  * @par Required preconditions:
  * ADC1 conversion finished.
  */
u16 ADC1_GetConversionValue(void)
{

    u16 temph = 0;
    u8 templ = 0;

    if (ADC1->CR2 & ADC1_CR2_ALIGN) /* Right alignment */
    {
        /* Read LSB first */
        templ = ADC1->DRL;
        /* Then read MSB */
        temph = ADC1->DRH;

        temph = (u16)(templ | (u16)(temph << (u8)8));
    }
    else /* Left alignment */
    {
        /* Read MSB firts*/
        temph = ADC1->DRH;
        /* Then read LSB */
        templ = ADC1->DRL;

        temph = (u16)((u16)(templ << (u8)6) | (u16)(temph << (u8)8));
    }

    return ((u16)temph);

}

/**
  * @brief Enables or disables the analog watchdog for the given channel.
  * @param[in] Channel specifies the desired Channel.
  * It can be set of the values of @ref ADC1_Channel_TypeDef.
  * @param[in] NewState specifies the analog watchdog new state.
  * can have one of the values of @ref FunctionalState.
  * @retval None
  */
void ADC1_AWDChannelConfig(ADC1_Channel_TypeDef Channel, FunctionalState NewState)
{
    /* Check the parameters */
    assert_param(IS_FUNCTIONALSTATE_OK(NewState));
    assert_param(IS_ADC1_CHANNEL_OK(Channel));

    if (Channel < (u8)8)
    {
        if (NewState != DISABLE)
        {
            ADC1->AWCRL |= (u8)((u8)1 << Channel);
        }
        else /* NewState == DISABLE */
        {
            ADC1->AWCRL &= (u8)(~((u8)1 << Channel));
        }
    }
    else
    {
        if (NewState != DISABLE)
        {
            ADC1->AWCRH |= (u8)((u8)1 << (Channel - (u8)8));
        }
        else /* NewState == DISABLE */
        {
            ADC1->AWCRH &= (u8)(~((u8)1 << (Channel - (u8)8)));
        }
    }
}

/**
  * @brief Sets the high threshold of the analog watchdog.
  * @param[in] Threshold specifies the high threshold value.
  * this value depends on the reference voltage range.
  * @retval None
  */
void ADC1_SetHighThreshold(u16 Threshold)
{
    ADC1->HTRH = (u8)(Threshold >> (u8)8);
    ADC1->HTRL = (u8)Threshold;
}

/**
  * @brief Sets the low threshold of the analog watchdog.
  * @param[in] Threshold specifies thelow threshold value.
  * this value depends on the reference voltage range.
  * @retval None
  */
void ADC1_SetLowThreshold(u16 Threshold)
{
    ADC1->LTRL = (u8)Threshold;
    ADC1->LTRH = (u8)(Threshold >> (u8)8);
}

/**
  * @brief Get one sample of measured signal.
  * @param[in] Buffer specifies the buffer to read.
  * @retval BufferValue:  value read from the given buffer.
  * @par Required preconditions:
  * ADC1 conversion finished.
  */
u16 ADC1_GetBufferValue(u8 Buffer)
{

    u16 temph = 0;
    u8 templ = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_BUFFER_OK(Buffer));

    if (ADC1->CR2 & ADC1_CR2_ALIGN) /* Right alignment */
    {
        /* Read LSB first */
        templ = *(u8*)(ADC1_BaseAddress + (Buffer << 1) + 1);
        /* Then read MSB */
        temph = *(u8*)(ADC1_BaseAddress + (Buffer << 1));

        temph = (u16)(templ | (u16)(temph << (u8)8));
    }
    else /* Left alignment */
    {
        /* Read MSB firts*/
        temph = *(u8*)(ADC1_BaseAddress + (Buffer << 1));
        /* Then read LSB */
        templ = *(u8*)(ADC1_BaseAddress + (Buffer << 1) + 1);

        temph = (u16)((u16)(templ << (u8)6) | (u16)(temph << (u8)8));
    }

    return ((u16)temph);

}

/**
  * @brief Checks the specified analog watchdog channel status.
  * @param[in] Channel: specify the channel of which to check the analog watchdog
  * can be one of the values of @ref ADC1_Channel_TypeDef.
  * @retval FlagStatus Status of the analog watchdog.
  */
FlagStatus ADC1_GetAWDChannelStatus(ADC1_Channel_TypeDef Channel)
{
    u8 status = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_CHANNEL_OK(Channel));

    if (Channel < (u8)8)
    {
        status = (u8)(ADC1->AWSRL & ((u8)1 << Channel));
    }
    else /* Channel = 8 | 9 */
    {
        status = (u8)(ADC1->AWSRH & ((u8)1 << (Channel - (u8)8)));
    }

    return ((FlagStatus)status);
}

/**
  * @brief Checks the specified ADC1 flag status.
  * @param[in] Flag: ADC1 flag.
  * can be one of the values of @ref ADC1_Flag_TypeDef.
  * @retval FlagStatus Status of the ADC1 flag.
  */
FlagStatus ADC1_GetFlagStatus(ADC1_Flag_TypeDef Flag)
{
    u8 flagstatus = 0;
    u8 temp = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_FLAG_OK(Flag));

    if ((Flag & 0x0F) == 0x01)
    {
        /* Get OVR flag status */
        flagstatus = (u8)(ADC1->CR3 & ADC1_CR3_OVR);
    }
    else if ((Flag & 0xF0) == 0x10)
    {
        /* Get analog watchdog channel status */
        temp = (u8)(Flag & 0x0F);
        if (temp < 8)
        {
            flagstatus = (u8)(ADC1->AWSRL & (1 << temp));
        }
        else
        {
            flagstatus = (u8)(ADC1->AWSRH & (1 << (temp - 8)));
        }
    }
    else  /* Get EOC | AWD flag status */
    {
        flagstatus = (u8)(ADC1->CSR & Flag);
    }
    return ((FlagStatus)flagstatus);

}

/**
  * @brief Clear the specified ADC1 Flag.
  * @param[in] Flag: ADC1 flag.
  * can be one of the values of @ref ADC1_Flag_TypeDef.
  * @retval None
  */
void ADC1_ClearFlag(ADC1_Flag_TypeDef Flag)
{
    u8 temp = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_FLAG_OK(Flag));

    if ((Flag & 0x0F) == 0x01)
    {
        /* Clear OVR flag status */
        ADC1->CR3 &= (u8)(~ADC1_CR3_OVR);
    }
    else if ((Flag & 0xF0) == 0x10)
    {
        /* Clear analog watchdog channel status */
        temp = (u8)(Flag & 0x0F);
        if (temp < 8)
        {
            ADC1->AWSRL &= (u8)(~((u8)1 << temp));
        }
        else
        {
            ADC1->AWSRH &= (u8)(~((u8)1 << (temp - 8)));
        }
    }
    else  /* Clear EOC | AWD flag status */
    {
        ADC1->CSR &= (u8) (~Flag);
    }
}

/**
  * @brief Returns the specified pending bit status
  * @param[in] ITPendingBit : the IT pending bit to check.
  * This parameter can be one of the following values:
  *    - ADC1_IT_AWD   : Analog WDG IT status
  *    - ADC1_IT_AWS0 : Analog channel 0 IT status
  *    - ADC1_IT_AWS1 : Analog channel 1 IT status
  *    - ADC1_IT_AWS2 : Analog channel 2 IT status
  *    - ADC1_IT_AWS3 : Analog channel 3 IT status
  *    - ADC1_IT_AWS4 : Analog channel 4 IT status
  *    - ADC1_IT_AWS5 : Analog channel 5 IT status
  *    - ADC1_IT_AWS6 : Analog channel 6 IT status
  *    - ADC1_IT_AWS7 : Analog channel 7 IT status
  *    - ADC1_IT_AWS8 : Analog channel 8 IT status
  *    - ADC1_IT_AWS9 : Analog channel 9 IT status
  *    - ADC1_IT_EOC    : EOC pending bit
  * @retval ITStatus: status of the specified pending bit.
  */
ITStatus ADC1_GetITStatus(ADC1_IT_TypeDef ITPendingBit)
{
    ITStatus itstatus = RESET;
    u8 temp = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_ITPENDINGBIT_OK(ITPendingBit));

    if ((ITPendingBit & 0xF0) == 0x10)
    {
        /* Get analog watchdog channel status */
        temp = (u8)(ITPendingBit & 0x0F);
        if (temp < 8)
        {
            itstatus = (u8)(ADC1->AWSRL & (u8)((u8)1 << temp));
        }
        else
        {
            itstatus = (u8)(ADC1->AWSRH & (u8)((u8)1 << (temp - 8)));
        }
    }
    else  /* Get EOC | AWD flag status */
    {
        itstatus = (u8)(ADC1->CSR & ITPendingBit);
    }
    return ((ITStatus)itstatus);

}

/**
  * @brief Clear the ADC1 End of Conversion pending bit.
  * @param[in] ITPendingBit : the IT pending bit to clear.
  * This parameter can be one of the following values:
  *    - ADC1_IT_AWD   : Analog WDG IT status
  *    - ADC1_IT_AWS0 : Analog channel 0 IT status
  *    - ADC1_IT_AWS1 : Analog channel 1 IT status
  *    - ADC1_IT_AWS2 : Analog channel 2 IT status
  *    - ADC1_IT_AWS3 : Analog channel 3 IT status
  *    - ADC1_IT_AWS4 : Analog channel 4 IT status
  *    - ADC1_IT_AWS5 : Analog channel 5 IT status
  *    - ADC1_IT_AWS6 : Analog channel 6 IT status
  *    - ADC1_IT_AWS7 : Analog channel 7 IT status
  *    - ADC1_IT_AWS8 : Analog channel 8 IT status
  *    - ADC1_IT_AWS9 : Analog channel 9 IT status
  *    - ADC1_IT_EOC  : EOC pending bit
  * @retval None
  */
void ADC1_ClearITPendingBit(ADC1_IT_TypeDef ITPendingBit)
{
    u8 temp = 0;

    /* Check the parameters */
    assert_param(IS_ADC1_ITPENDINGBIT_OK(ITPendingBit));

    if ((ITPendingBit& 0xF0) == 0x10)
    {
        /* Clear analog watchdog channel status */
        temp = (u8)(ITPendingBit & 0x0F);
        if (temp < 8)
        {
            ADC1->AWSRL &= (u8)(~((u8)1 << temp));
        }
        else
        {
            ADC1->AWSRH &= (u8)(~((u8)1 << (temp - 8)));
        }
    }
    else  /* Clear EOC | AWD flag status */
    {
        ADC1->CSR &= (u8) (~ITPendingBit);
    }
}

/**
  * @}
  */

/******************* (C) COPYRIGHT 2009 STMicroelectronics *****END OF FILE****/