Diff: targets/hal/TARGET_Atmel/TARGET_SAM_CortexM4/drivers/rtt/rtt.c

Revision:

107:414e9c822e99

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/targets/hal/TARGET_Atmel/TARGET_SAM_CortexM4/drivers/rtt/rtt.c	Tue Apr 05 18:15:12 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