t
Fork of mbed-dev by
Diff: targets/TARGET_Atmel/TARGET_SAM_CortexM4/drivers/rtt/rtt.c
- Revision:
- 149:156823d33999
- Parent:
- 107:414e9c822e99
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/targets/TARGET_Atmel/TARGET_SAM_CortexM4/drivers/rtt/rtt.c Fri Oct 28 11:17:30 2016 +0100 @@ -0,0 +1,260 @@ +/** + * \file + * + * \brief Real-time Timer (RTT) driver for SAM. + * + * Copyright (c) 2011-2015 Atmel Corporation. All rights reserved. + * + * \asf_license_start + * + * \page License + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * 1. Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright notice, + * this list of conditions and the following disclaimer in the documentation + * and/or other materials provided with the distribution. + * + * 3. The name of Atmel may not be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * 4. This software may only be redistributed and used in connection with an + * Atmel microcontroller product. + * + * THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR IMPLIED + * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * EXPRESSLY AND SPECIFICALLY DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR + * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN + * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + * + * \asf_license_stop + * + */ +/* + * Support and FAQ: visit <a href="http://www.atmel.com/design-support/">Atmel Support</a> + */ + +#include "rtt.h" + +/// @cond 0 +/**INDENT-OFF**/ +#ifdef __cplusplus +extern "C" { +#endif +/**INDENT-ON**/ +/// @endcond + + /** + * \defgroup sam_drivers_rtt_group Real-time Timer (RTT) + * + * The Real-time Timer is built around a 32-bit counter used to count + * roll-over events of the programmable 16-bit prescaler, which enables + * counting elapsed seconds from a 32 kHz slow clock source. + * This is a driver for configuration and use of the RTT peripheral. + * + * @{ + */ + + /* + * In follow series chip, the bit RTC1HZ and RTTDIS in RTT_MR are write only. + * So we use a variable to record status of these bits. + */ +#if (SAM4N || SAM4S || SAM4E || SAM4C || SAMG51 || SAM4CP || SAM4CM || SAMV71 || SAMV70 || SAME70 || SAMS70) + static uint32_t g_wobits_in_rtt_mr = 0; +#endif + + /** + * \brief Initialize the given RTT. + * + * \note This function restarts the real-time timer. If w_prescaler is equal to zero, + * the prescaler period is equal to 2^16 * SCLK period. If not, the prescaler period + * is equal to us_prescaler * SCLK period. + * + * \param p_rtt Pointer to an RTT instance. + * \param us_prescaler Prescaler value for the RTT. + * + * \return 0 if successful. + */ + uint32_t rtt_init(Rtt *p_rtt, uint16_t us_prescaler) +{ +#if (SAM4N || SAM4S || SAM4E || SAM4C || SAMG51 || SAM4CP || SAM4CM || SAMV71 || SAMV70 || SAME70 || SAMS70) + p_rtt->RTT_MR = (us_prescaler | RTT_MR_RTTRST | g_wobits_in_rtt_mr); +#else + p_rtt->RTT_MR = (us_prescaler | RTT_MR_RTTRST); +#endif + return 0; +} + +#if (SAM4N || SAM4S || SAM4E || SAM4C || SAMG51 || SAM4CP || SAM4CM || SAMV71 || SAMV70 || SAME70 || SAMS70) +/** + * \brief Select RTT counter source. + * + * \param p_rtt Pointer to an RTT instance. + * \param is_rtc_sel RTC 1Hz Clock Selection. + */ +void rtt_sel_source(Rtt *p_rtt, bool is_rtc_sel) +{ + if(is_rtc_sel) { + g_wobits_in_rtt_mr |= RTT_MR_RTC1HZ; + p_rtt->RTT_MR |= g_wobits_in_rtt_mr; + } else { + g_wobits_in_rtt_mr &= ~RTT_MR_RTC1HZ; + p_rtt->RTT_MR |= g_wobits_in_rtt_mr; + } +} + +/** + * \brief Enable RTT. + * + * \param p_rtt Pointer to an RTT instance. + */ +void rtt_enable(Rtt *p_rtt) +{ + g_wobits_in_rtt_mr &= ~RTT_MR_RTTDIS; + p_rtt->RTT_MR |= g_wobits_in_rtt_mr; +} +/** + * \brief Disable RTT. + * + * \param p_rtt Pointer to an RTT instance. + */ +void rtt_disable(Rtt *p_rtt) +{ + g_wobits_in_rtt_mr |= RTT_MR_RTTDIS; + p_rtt->RTT_MR |= g_wobits_in_rtt_mr; +} +#elif (SAMG53 || SAMG54 || SAMG55) +void rtt_sel_source(Rtt *p_rtt, bool is_rtc_sel) +{ + if(is_rtc_sel) { + p_rtt->RTT_MR |= RTT_MR_RTC1HZ; + } else { + p_rtt->RTT_MR &= ~RTT_MR_RTC1HZ; + } +} + +void rtt_enable(Rtt *p_rtt) +{ + p_rtt->RTT_MR &= ~RTT_MR_RTTDIS; +} +/** + * \brief Disable RTT. + * + * \param p_rtt Pointer to an RTT instance. + */ +void rtt_disable(Rtt *p_rtt) +{ + p_rtt->RTT_MR |= RTT_MR_RTTDIS; +} +#endif + +/** + * \brief Enable RTT interrupts. + * + * \param p_rtt Pointer to an RTT instance. + * \param ul_sources Interrupts to be enabled. + */ +void rtt_enable_interrupt(Rtt *p_rtt, uint32_t ul_sources) +{ + uint32_t temp; + + temp = p_rtt->RTT_MR; + temp |= ul_sources; +#if (SAM4N || SAM4S || SAM4E || SAM4C || SAMG51 || SAM4CP || SAM4CM || SAMV71 || SAMV70 || SAME70 || SAMS70) + temp |= g_wobits_in_rtt_mr; +#endif + p_rtt->RTT_MR = temp; +} + +/** + * \brief Disable RTT interrupts. + * + * \param p_rtt Pointer to an RTT instance. + * \param ul_sources Interrupts to be disabled. + */ +void rtt_disable_interrupt(Rtt *p_rtt, uint32_t ul_sources) +{ + uint32_t temp = 0; + + temp = p_rtt->RTT_MR; + temp &= (~ul_sources); +#if (SAM4N || SAM4S || SAM4E || SAM4C || SAMG51 || SAM4CP || SAM4CM || SAMV71 || SAMV70 || SAME70 || SAMS70) + temp |= g_wobits_in_rtt_mr; +#endif + p_rtt->RTT_MR = temp; +} + +/** + * \brief Read the current value of the RTT timer value. + * + * \param p_rtt Pointer to an RTT instance. + * + * \return The current Real-time Timer value. + */ +uint32_t rtt_read_timer_value(Rtt *p_rtt) +{ + return p_rtt->RTT_VR; +} + +/** + * \brief Get the status register value of the given RTT. + * + * \param p_rtt Pointer to an RTT instance. + * + * \return The Real-time Timer status. + */ +uint32_t rtt_get_status(Rtt *p_rtt) +{ + return p_rtt->RTT_SR; +} + +/** + * \brief Configure the RTT to generate an alarm at the given time. + * + * \param p_rtt Pointer to an RTT instance. + * \param ul_alarm_time Alarm time. + * + * \retval 0 Configuration is done. + * \retval 1 Parameter error. + */ +uint32_t rtt_write_alarm_time(Rtt *p_rtt, uint32_t ul_alarm_time) +{ + uint32_t flag; + + if (ul_alarm_time == 0) { + return 1; + } + + flag = p_rtt->RTT_MR & RTT_MR_ALMIEN; + + rtt_disable_interrupt(RTT, RTT_MR_ALMIEN); + + /* Alarm time = ALMV + 1 */ + p_rtt->RTT_AR = ul_alarm_time - 1; + + if (flag) { + rtt_enable_interrupt(RTT, RTT_MR_ALMIEN); + } + + return 0; +} + +//@} + +/// @cond 0 +/**INDENT-OFF**/ +#ifdef __cplusplus +} +#endif +/**INDENT-ON**/ +/// @endcond