/**
* \file
*
* \brief SAM Watchdog Driver
*
* Copyright (C) 2012-2016 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 Atmel Support
*/
#include "wdt.h"
#include
/**
* \brief Sets up the WDT hardware module based on the configuration.
*
* Writes a given configuration of a WDT configuration to the
* hardware module, and initializes the internal device struct.
*
* \param[in] config Pointer to the configuration struct
*
* \return Status of the configuration procedure.
*
* \retval STATUS_OK If the module was configured correctly
* \retval STATUS_ERR_INVALID_ARG If invalid argument(s) were supplied
* \retval STATUS_ERR_IO If the Watchdog module is locked to be always on
*/
#if (SAML21) || (SAML22) || (SAMC20) || (SAMC21) || (SAMR30)
enum status_code wdt_set_config(
const struct wdt_conf *const config)
{
/* Sanity check arguments */
Assert(config);
Wdt *const WDT_module = WDT;
/* Turn on the digital interface clock */
system_apb_clock_set_mask(SYSTEM_CLOCK_APB_APBA, MCLK_APBAMASK_WDT);
/* Check of the Watchdog has been locked to be always on, if so, abort */
if (wdt_is_locked()) {
return STATUS_ERR_IO;
}
/* Check for an invalid timeout period, abort if found */
if (config->timeout_period == WDT_PERIOD_NONE) {
return STATUS_ERR_INVALID_ARG;
}
/* Make sure the Window and Early Warning periods are not more than the
* reset period, abort if either is invalid */
if ((config->timeout_period < config->window_period) ||
(config->timeout_period < config->early_warning_period)) {
return STATUS_ERR_INVALID_ARG;
}
/* Disable the Watchdog module */
WDT_module->CTRLA.reg &= ~WDT_CTRLA_ENABLE;
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
if(config->enable == false) {
return STATUS_OK;
}
uint32_t new_config = 0;
/* Update the timeout period value with the requested period */
new_config |= (config->timeout_period - 1) << WDT_CONFIG_PER_Pos;
/* Check if the user has requested a reset window period */
if (config->window_period != WDT_PERIOD_NONE) {
WDT_module->CTRLA.reg |= WDT_CTRLA_WEN;
/* Update and enable the timeout period value */
new_config |= (config->window_period - 1) << WDT_CONFIG_WINDOW_Pos;
} else {
/* Ensure the window enable control flag is cleared */
WDT_module->CTRLA.reg &= ~WDT_CTRLA_WEN;
}
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
/* Write the new Watchdog configuration */
WDT_module->CONFIG.reg = new_config;
/* Check if the user has requested an early warning period */
if (config->early_warning_period != WDT_PERIOD_NONE) {
/* Set the Early Warning period */
WDT_module->EWCTRL.reg
= (config->early_warning_period - 1) << WDT_EWCTRL_EWOFFSET_Pos;
}
/* Either enable or lock-enable the Watchdog timer depending on the user
* settings */
if (config->always_on) {
WDT_module->CTRLA.reg |= WDT_CTRLA_ALWAYSON;
} else {
WDT_module->CTRLA.reg |= WDT_CTRLA_ENABLE;
}
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
return STATUS_OK;
}
#else
enum status_code wdt_set_config(
const struct wdt_conf *const config)
{
/* Sanity check arguments */
Assert(config);
Wdt *const WDT_module = WDT;
/* Turn on the digital interface clock */
system_apb_clock_set_mask(SYSTEM_CLOCK_APB_APBA, PM_APBAMASK_WDT);
/* Check of the Watchdog has been locked to be always on, if so, abort */
if (wdt_is_locked()) {
return STATUS_ERR_IO;
}
/* Check for an invalid timeout period, abort if found */
if (config->timeout_period == WDT_PERIOD_NONE) {
return STATUS_ERR_INVALID_ARG;
}
/* Make sure the Window and Early Warning periods are not more than the
* reset period, abort if either is invalid */
if ((config->timeout_period < config->window_period) ||
(config->timeout_period < config->early_warning_period)) {
return STATUS_ERR_INVALID_ARG;
}
/* Disable the Watchdog module */
WDT_module->CTRL.reg &= ~WDT_CTRL_ENABLE;
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
if(config->enable == false) {
return STATUS_OK;
}
/* Configure GCLK channel and enable clock */
struct system_gclk_chan_config gclk_chan_conf;
gclk_chan_conf.source_generator = config->clock_source;
system_gclk_chan_set_config(WDT_GCLK_ID, &gclk_chan_conf);
system_gclk_chan_enable(WDT_GCLK_ID);
if (config->always_on) {
system_gclk_chan_lock(WDT_GCLK_ID);
}
uint32_t new_config = 0;
/* Update the timeout period value with the requested period */
new_config |= (config->timeout_period - 1) << WDT_CONFIG_PER_Pos;
/* Check if the user has requested a reset window period */
if (config->window_period != WDT_PERIOD_NONE) {
WDT_module->CTRL.reg |= WDT_CTRL_WEN;
/* Update and enable the timeout period value */
new_config |= (config->window_period - 1) << WDT_CONFIG_WINDOW_Pos;
} else {
/* Ensure the window enable control flag is cleared */
WDT_module->CTRL.reg &= ~WDT_CTRL_WEN;
}
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
/* Write the new Watchdog configuration */
WDT_module->CONFIG.reg = new_config;
/* Check if the user has requested an early warning period */
if (config->early_warning_period != WDT_PERIOD_NONE) {
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
/* Set the Early Warning period */
WDT_module->EWCTRL.reg
= (config->early_warning_period - 1) << WDT_EWCTRL_EWOFFSET_Pos;
}
/* Either enable or lock-enable the Watchdog timer depending on the user
* settings */
if (config->always_on) {
WDT_module->CTRL.reg |= WDT_CTRL_ALWAYSON;
} else {
WDT_module->CTRL.reg |= WDT_CTRL_ENABLE;
}
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
return STATUS_OK;
}
#endif
/**
* \brief Resets the count of the running Watchdog Timer that was previously enabled.
*
* Resets the current count of the Watchdog Timer, restarting the timeout
* period count elapsed. This function should be called after the window
* period (if one was set in the module configuration) but before the timeout
* period to prevent a reset of the system.
*/
void wdt_reset_count(void)
{
Wdt *const WDT_module = WDT;
/* Disable the Watchdog module */
WDT_module->CLEAR.reg = WDT_CLEAR_CLEAR_KEY;
while (wdt_is_syncing()) {
/* Wait for all hardware modules to complete synchronization */
}
}