/** * \file * * \brief RTC Driver * * Copyright (c) 2014-2018 Microchip Technology Inc. and its subsidiaries. * * \asf_license_start * * \page License * * Subject to your compliance with these terms, you may use Microchip * software and any derivatives exclusively with Microchip products. * It is your responsibility to comply with third party license terms applicable * to your use of third party software (including open source software) that * may accompany Microchip software. * * THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, * WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, * INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, * AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL MICROCHIP BE * LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL * LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE * SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE * POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT * ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY * RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, * THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE. * * \asf_license_stop * */ #include #include #include /*!< Pointer to hpl device */ static struct calendar_dev *_rtc_dev = NULL; /** * \brief Initializes the RTC module with given configurations. */ int32_t _calendar_init(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); _rtc_dev = dev; if (hri_rtcmode0_get_CTRLA_ENABLE_bit(dev->hw)) { #if !CONF_RTC_INIT_RESET return ERR_DENIED; #else hri_rtcmode0_clear_CTRLA_ENABLE_bit(dev->hw); hri_rtcmode0_wait_for_sync(dev->hw, RTC_MODE0_SYNCBUSY_ENABLE); #endif } hri_rtcmode0_set_CTRLA_SWRST_bit(dev->hw); hri_rtcmode0_wait_for_sync(dev->hw, RTC_MODE0_SYNCBUSY_SWRST); #if CONF_RTC_EVENT_CONTROL_ENABLE == 1 hri_rtcmode0_write_EVCTRL_reg( dev->hw, (CONF_RTC_PEREO0 << RTC_MODE0_EVCTRL_PEREO0_Pos) | (CONF_RTC_PEREO1 << RTC_MODE0_EVCTRL_PEREO1_Pos) | (CONF_RTC_PEREO2 << RTC_MODE0_EVCTRL_PEREO2_Pos) | (CONF_RTC_PEREO3 << RTC_MODE0_EVCTRL_PEREO3_Pos) | (CONF_RTC_PEREO4 << RTC_MODE0_EVCTRL_PEREO4_Pos) | (CONF_RTC_PEREO5 << RTC_MODE0_EVCTRL_PEREO5_Pos) | (CONF_RTC_PEREO6 << RTC_MODE0_EVCTRL_PEREO6_Pos) | (CONF_RTC_PEREO7 << RTC_MODE0_EVCTRL_PEREO7_Pos) | (CONF_RTC_COMPE0 << RTC_MODE0_EVCTRL_CMPEO_Pos) | (CONF_RTC_OVFEO << RTC_MODE0_EVCTRL_OVFEO_Pos)); #endif hri_rtcmode0_write_CTRLA_reg(dev->hw, RTC_MODE0_CTRLA_PRESCALER(CONF_RTC_PRESCALER) | RTC_MODE0_CTRLA_COUNTSYNC); hri_rtc_write_TAMPCTRL_reg( dev->hw, (CONF_RTC_TAMPER_INACT_0 << RTC_TAMPCTRL_IN0ACT_Pos) | (CONF_RTC_TAMPER_INACT_1 << RTC_TAMPCTRL_IN1ACT_Pos) | (CONF_RTC_TAMPER_INACT_2 << RTC_TAMPCTRL_IN2ACT_Pos) | (CONF_RTC_TAMPER_INACT_3 << RTC_TAMPCTRL_IN3ACT_Pos) | (CONF_RTC_TAMPER_INACT_4 << RTC_TAMPCTRL_IN4ACT_Pos) | (CONF_RTC_TAMP_LVL_0 << RTC_TAMPCTRL_TAMLVL0_Pos) | (CONF_RTC_TAMP_LVL_1 << RTC_TAMPCTRL_TAMLVL1_Pos) | (CONF_RTC_TAMP_LVL_2 << RTC_TAMPCTRL_TAMLVL2_Pos) | (CONF_RTC_TAMP_LVL_3 << RTC_TAMPCTRL_TAMLVL3_Pos) | (CONF_RTC_TAMP_LVL_4 << RTC_TAMPCTRL_TAMLVL4_Pos) | (CONF_RTC_TAMP_DEBNC_0 << RTC_TAMPCTRL_DEBNC0_Pos) | (CONF_RTC_TAMP_DEBNC_1 << RTC_TAMPCTRL_DEBNC1_Pos) | (CONF_RTC_TAMP_DEBNC_2 << RTC_TAMPCTRL_DEBNC2_Pos) | (CONF_RTC_TAMP_DEBNC_3 << RTC_TAMPCTRL_DEBNC3_Pos) | (CONF_RTC_TAMP_DEBNC_4 << RTC_TAMPCTRL_DEBNC4_Pos)); if ((CONF_RTC_TAMPER_INACT_0 == TAMPER_MODE_ACTL) | (CONF_RTC_TAMPER_INACT_1 == TAMPER_MODE_ACTL) | (CONF_RTC_TAMPER_INACT_2 == TAMPER_MODE_ACTL) | (CONF_RTC_TAMPER_INACT_3 == TAMPER_MODE_ACTL) | (CONF_RTC_TAMPER_INACT_4 == TAMPER_MODE_ACTL)) { hri_rtcmode0_set_CTRLB_RTCOUT_bit(dev->hw); } return ERR_NONE; } /** * \brief Deinit the RTC module */ int32_t _calendar_deinit(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); NVIC_DisableIRQ(RTC_IRQn); dev->callback_alarm = NULL; dev->callback_tick = NULL; dev->callback_tamper = NULL; hri_rtcmode0_clear_CTRLA_ENABLE_bit(dev->hw); hri_rtcmode0_set_CTRLA_SWRST_bit(dev->hw); return ERR_NONE; } /** * \brief Enable the RTC module */ int32_t _calendar_enable(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); hri_rtcmode0_set_CTRLA_ENABLE_bit(dev->hw); return ERR_NONE; } /** * \brief Disable the RTC module */ int32_t _calendar_disable(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); hri_rtcmode0_clear_CTRLA_ENABLE_bit(dev->hw); return ERR_NONE; } /** * \brief Set the current calendar time to desired time. */ int32_t _calendar_set_counter(struct calendar_dev *const dev, const uint32_t counter) { ASSERT(dev && dev->hw); hri_rtcmode0_write_COUNT_reg(dev->hw, counter); return ERR_NONE; } /** * \brief Get current counter */ uint32_t _calendar_get_counter(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); return hri_rtcmode0_read_COUNT_reg(dev->hw); } /** * \brief Set the compare for the specified value. */ int32_t _calendar_set_comp(struct calendar_dev *const dev, const uint32_t comp) { ASSERT(dev && dev->hw); hri_rtcmode0_write_COMP_reg(dev->hw, 0, comp); return ERR_NONE; } /** * \brief Get the compare value */ uint32_t _calendar_get_comp(struct calendar_dev *const dev) { ASSERT(dev && dev->hw); return hri_rtcmode0_read_COMP_reg(dev->hw, 0); } /** * \brief Find tamper is detected on specified pin */ bool _is_tamper_detected(struct calendar_dev *const dev, enum tamper_id tamper_id_pin) { bool value; ASSERT(dev && dev->hw); value = ((hri_rtc_read_TAMPID_reg(dev->hw) >> tamper_id_pin) & 0x01); return value; } /** * \brief Clear the Tamper ID flag */ int32_t _tamper_clear_tampid_flag(struct calendar_dev *const dev, enum tamper_id tamper_id_pin) { ASSERT(dev && dev->hw); hri_rtc_write_TAMPID_reg(dev->hw, (true << tamper_id_pin)); return ERR_NONE; } /** * \brief Enable Tamper Debounce Asynchronous Feature */ int32_t _tamper_enable_debounce_asynchronous(struct calendar_dev *const dev) { int32_t return_value; hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, false); while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } if (hri_rtcmode0_read_CTRLA_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { return_value = ERR_FAILURE; } else { hri_rtcmode0_write_CTRLB_DEBASYNC_bit(dev->hw, true); return_value = ERR_NONE; while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, true); } return return_value; } /** * \brief Disable Tamper Debounce Asynchronous Feature */ int32_t _tamper_disable_debounce_asynchronous(struct calendar_dev *const dev) { int32_t return_value; hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, false); while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } if (hri_rtcmode0_read_CTRLA_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { return_value = ERR_FAILURE; } else { hri_rtcmode0_write_CTRLB_DEBASYNC_bit(dev->hw, false); return_value = ERR_NONE; while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, true); } return return_value; } /** * \brief Enable Tamper Debounce Majority Feature */ int32_t _tamper_enable_debounce_majority(struct calendar_dev *const dev) { int32_t return_value; hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, false); while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } if (hri_rtcmode0_read_CTRLA_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { return_value = ERR_FAILURE; } else { hri_rtcmode0_write_CTRLB_DEBMAJ_bit(dev->hw, true); return_value = ERR_NONE; while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, true); } return return_value; } /** * \brief Disable Tamper Debounce Majority Feature */ int32_t _tamper_disable_debounce_majority(struct calendar_dev *const dev) { int32_t return_value; hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, false); while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } if (hri_rtcmode0_read_CTRLA_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { return_value = ERR_FAILURE; } else { hri_rtcmode0_write_CTRLB_DEBMAJ_bit(dev->hw, false); return_value = ERR_NONE; while (hri_rtcmode0_read_SYNCBUSY_reg(dev->hw) & RTC_MODE2_CTRLA_ENABLE) { } hri_rtcmode0_write_CTRLA_ENABLE_bit(dev->hw, true); } return return_value; } int32_t _prescaler_register_callback(struct calendar_dev *const dev, calendar_drv_cb_t callback) { ASSERT(dev && dev->hw); /* Check callback */ if (callback != NULL) { /* register the callback */ dev->callback_tick = callback; /* enable RTC_IRQn */ NVIC_ClearPendingIRQ(RTC_IRQn); NVIC_EnableIRQ(RTC_IRQn); /* enable periodic interrupt */ hri_rtcmode0_set_INTEN_PER7_bit(dev->hw); } else { /* disable periodic interrupt */ hri_rtcmode0_clear_INTEN_PER7_bit(dev->hw); } return ERR_NONE; } // TODO: refactor this so it doesn't take a callback (it will never get called anyway) int32_t _extwake_register_callback(struct calendar_dev *const dev, calendar_drv_cb_t callback) { ASSERT(dev && dev->hw); /* Check callback */ if (callback != NULL) { /* register the callback */ dev->callback_tamper = callback; /* enable RTC_IRQn */ NVIC_ClearPendingIRQ(RTC_IRQn); NVIC_EnableIRQ(RTC_IRQn); hri_rtcmode0_clear_interrupt_TAMPER_bit(dev->hw); /* enable tamper interrupt */ hri_rtcmode0_set_INTEN_TAMPER_bit(dev->hw); } else { /* disable tamper interrupt */ hri_rtcmode0_clear_INTEN_TAMPER_bit(dev->hw); } return ERR_NONE; } /** * \brief Registers callback for the specified callback type */ int32_t _calendar_register_callback(struct calendar_dev *const dev, calendar_drv_cb_t callback) { ASSERT(dev && dev->hw); /* Check callback */ if (callback != NULL) { /* register the callback */ dev->callback_alarm = callback; /* enable RTC_IRQn */ NVIC_ClearPendingIRQ(RTC_IRQn); NVIC_EnableIRQ(RTC_IRQn); /* enable cmp */ hri_rtcmode0_set_INTEN_CMP0_bit(dev->hw); } else { /* disable cmp */ hri_rtcmode0_clear_INTEN_CMP0_bit(dev->hw); } return ERR_NONE; } /** * \brief RTC interrupt handler * * \param[in] dev The pointer to calendar device struct */ static void _rtc_interrupt_handler(struct calendar_dev *dev) { /* Read and mask interrupt flag register */ uint16_t interrupt_status = hri_rtcmode0_read_INTFLAG_reg(dev->hw); uint16_t interrupt_enabled = hri_rtcmode0_read_INTEN_reg(dev->hw); if ((interrupt_status & interrupt_enabled) & RTC_MODE2_INTFLAG_ALARM0) { dev->callback_alarm(dev); /* Clear interrupt flag */ hri_rtcmode0_clear_interrupt_CMP0_bit(dev->hw); } else if ((interrupt_status & interrupt_enabled) & RTC_MODE2_INTFLAG_PER7) { dev->callback_tick(dev); /* Clear interrupt flag */ hri_rtcmode0_clear_interrupt_PER7_bit(dev->hw); } else if ((interrupt_status & interrupt_enabled) & RTC_MODE2_INTFLAG_TAMPER) { /* Clear interrupt flag */ hri_rtcmode0_clear_interrupt_TAMPER_bit(dev->hw); } } /** * \brief Set calendar IRQ */ void _calendar_set_irq(struct calendar_dev *const dev) { (void)dev; NVIC_SetPendingIRQ(RTC_IRQn); } /** * \brief Rtc interrupt handler */ void RTC_Handler(void) { _rtc_interrupt_handler(_rtc_dev); }