diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/TARGET_MCU_NRF52840/sdk/sdk_config.h b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/TARGET_MCU_NRF52840/sdk/sdk_config.h index 25ecf907d9..e456c12d4c 100644 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/TARGET_MCU_NRF52840/sdk/sdk_config.h +++ b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/TARGET_MCU_NRF52840/sdk/sdk_config.h @@ -2883,7 +2883,7 @@ // APP_TIMER_ENABLED - app_timer - Application timer functionality //========================================================== #ifndef APP_TIMER_ENABLED -#define APP_TIMER_ENABLED 1 +#define APP_TIMER_ENABLED 0 #endif #if APP_TIMER_ENABLED // APP_TIMER_WITH_PROFILER - Enable app_timer profiling diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.c b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.c deleted file mode 100644 index 33487310f6..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.c +++ /dev/null @@ -1,1079 +0,0 @@ -/* - * Copyright (c) 2012 Nordic Semiconductor ASA - * All rights reserved. - * - * 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, except as embedded into a Nordic Semiconductor ASA - * integrated circuit in a product or a software update for such product, 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. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be - * used to endorse or promote products derived from this software without specific prior - * written permission. - * - * 4. This software, with or without modification, must only be used with a - * Nordic Semiconductor ASA integrated circuit. - * - * 5. Any software provided in binary or object form under this license must not be reverse - * engineered, decompiled, modified and/or disassembled. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND - * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ -#ifndef MBED_CONF_RTOS_PRESENT - -#include "sdk_common.h" -#if NRF_MODULE_ENABLED(APP_TIMER) -#include "app_timer.h" -#include -#include "nrf.h" -#include "nrf_soc.h" -#include "app_error.h" -#include "nrf_delay.h" -#include "app_util_platform.h" - -#define RTC1_IRQ_PRI APP_IRQ_PRIORITY_LOWEST /**< Priority of the RTC1 interrupt (used for checking for timeouts and executing timeout handlers). */ -#define SWI_IRQ_PRI APP_IRQ_PRIORITY_LOWEST /**< Priority of the SWI interrupt (used for updating the timer list). */ - -// The current design assumes that both interrupt handlers run at the same interrupt level. -// If this is to be changed, protection must be added to prevent them from interrupting each other -// (e.g. by using guard/trigger flags). -STATIC_ASSERT(RTC1_IRQ_PRI == SWI_IRQ_PRI); - -#define MAX_RTC_COUNTER_VAL 0x00FFFFFF /**< Maximum value of the RTC counter. */ - -#define RTC_COMPARE_OFFSET_MIN 3 /**< Minimum offset between the current RTC counter value and the Capture Compare register. Although the nRF51 Series User Specification recommends this value to be 2, we use 3 to be safer.*/ - -#define MAX_RTC_TASKS_DELAY 47 /**< Maximum delay until an RTC task is executed. */ - -#define SWI_IRQn SWI0_IRQn -#define SWI_IRQHandler SWI0_IRQHandler - -#define MODULE_INITIALIZED (m_op_queue.p_user_op_queue != NULL) /**< Macro designating whether the module has been initialized properly. */ - -/**@brief Timer node type. The nodes will be used form a linked list of running timers. */ -typedef struct -{ - uint32_t ticks_to_expire; /**< Number of ticks from previous timer interrupt to timer expiry. */ - uint32_t ticks_at_start; /**< Current RTC counter value when the timer was started. */ - uint32_t ticks_first_interval; /**< Number of ticks in the first timer interval. */ - uint32_t ticks_periodic_interval; /**< Timer period (for repeating timers). */ - bool is_running; /**< True if timer is running, False otherwise. */ - app_timer_mode_t mode; /**< Timer mode. */ - app_timer_timeout_handler_t p_timeout_handler; /**< Pointer to function to be executed when the timer expires. */ - void * p_context; /**< General purpose pointer. Will be passed to the timeout handler when the timer expires. */ - void * next; /**< Pointer to the next node. */ -} timer_node_t; - -STATIC_ASSERT(sizeof(timer_node_t) == APP_TIMER_NODE_SIZE); - -/**@brief Set of available timer operation types. */ -typedef enum -{ - TIMER_USER_OP_TYPE_NONE, /**< Invalid timer operation type. */ - TIMER_USER_OP_TYPE_START, /**< Timer operation type Start. */ - TIMER_USER_OP_TYPE_STOP, /**< Timer operation type Stop. */ - TIMER_USER_OP_TYPE_STOP_ALL /**< Timer operation type Stop All. */ -} timer_user_op_type_t; - -/**@brief Structure describing a timer start operation. */ -typedef struct -{ - uint32_t ticks_at_start; /**< Current RTC counter value when the timer was started. */ - uint32_t ticks_first_interval; /**< Number of ticks in the first timer interval. */ - uint32_t ticks_periodic_interval; /**< Timer period (for repeating timers). */ - void * p_context; /**< General purpose pointer. Will be passed to the timeout handler when the timer expires. */ -} timer_user_op_start_t; - -/**@brief Structure describing a timer operation. */ -typedef struct -{ - timer_user_op_type_t op_type; /**< Id of timer on which the operation is to be performed. */ - timer_node_t * p_node; - union - { - timer_user_op_start_t start; /**< Structure describing a timer start operation. */ - } params; -} timer_user_op_t; - -STATIC_ASSERT(sizeof(timer_user_op_t) <= APP_TIMER_USER_OP_SIZE); -STATIC_ASSERT(sizeof(timer_user_op_t) % 4 == 0); - -/**@brief Structure describing a timer operations queue. - * - * @details This queue will hold timer operations issued by the application - * until the timer interrupt handler processes these operations. - */ -typedef struct -{ - uint8_t first; /**< Index of first entry to have been inserted in the queue (i.e. the next entry to be executed). */ - uint8_t last; /**< Index of last entry to have been inserted in the queue. */ - uint8_t size; /**< Queue size. */ - timer_user_op_t * p_user_op_queue; /**< Queue buffer. */ -} timer_op_queue_t; - -STATIC_ASSERT(sizeof(timer_op_queue_t) % 4 == 0); - -#define CONTEXT_QUEUE_SIZE_MAX (2) - -static timer_op_queue_t m_op_queue; /**< Timer operations queue. */ -static timer_node_t * mp_timer_id_head; /**< First timer in list of running timers. */ -static uint32_t m_ticks_latest; /**< Last known RTC counter value. */ -static uint32_t m_ticks_elapsed[CONTEXT_QUEUE_SIZE_MAX]; /**< Timer internal elapsed ticks queue. */ -static uint8_t m_ticks_elapsed_q_read_ind; /**< Timer internal elapsed ticks queue read index. */ -static uint8_t m_ticks_elapsed_q_write_ind; /**< Timer internal elapsed ticks queue write index. */ -static app_timer_evt_schedule_func_t m_evt_schedule_func; /**< Pointer to function for propagating timeout events to the scheduler. */ -static bool m_rtc1_running; /**< Boolean indicating if RTC1 is running. */ -static bool m_rtc1_reset; /**< Boolean indicating if RTC1 counter has been reset due to last timer removed from timer list during the timer list handling. */ - -#if APP_TIMER_WITH_PROFILER -static uint8_t m_max_user_op_queue_utilization; /**< Maximum observed timer user operations queue utilization. */ -#endif - -/**@brief Function for initializing the RTC1 counter. - * - * @param[in] prescaler Value of the RTC1 PRESCALER register. Set to 0 for no prescaling. - */ -static void rtc1_init(uint32_t prescaler) -{ - NRF_RTC1->PRESCALER = prescaler; - NVIC_SetPriority(RTC1_IRQn, RTC1_IRQ_PRI); -} - - -/**@brief Function for starting the RTC1 timer. - */ -static void rtc1_start(void) -{ - NRF_RTC1->EVTENSET = RTC_EVTEN_COMPARE0_Msk; - NRF_RTC1->INTENSET = RTC_INTENSET_COMPARE0_Msk; - - NVIC_ClearPendingIRQ(RTC1_IRQn); - NVIC_EnableIRQ(RTC1_IRQn); - - NRF_RTC1->TASKS_START = 1; - nrf_delay_us(MAX_RTC_TASKS_DELAY); - - m_rtc1_running = true; -} - - -/**@brief Function for stopping the RTC1 timer. - */ -static void rtc1_stop(void) -{ - NVIC_DisableIRQ(RTC1_IRQn); - - NRF_RTC1->EVTENCLR = RTC_EVTEN_COMPARE0_Msk; - NRF_RTC1->INTENCLR = RTC_INTENSET_COMPARE0_Msk; - - NRF_RTC1->TASKS_STOP = 1; - nrf_delay_us(MAX_RTC_TASKS_DELAY); - - NRF_RTC1->TASKS_CLEAR = 1; - m_ticks_latest = 0; - nrf_delay_us(MAX_RTC_TASKS_DELAY); - - m_rtc1_running = false; -} - - -/**@brief Function for returning the current value of the RTC1 counter. - * - * @return Current value of the RTC1 counter. - */ -static __INLINE uint32_t rtc1_counter_get(void) -{ - return NRF_RTC1->COUNTER; -} - - -/**@brief Function for computing the difference between two RTC1 counter values. - * - * @return Number of ticks elapsed from ticks_old to ticks_now. - */ -static __INLINE uint32_t ticks_diff_get(uint32_t ticks_now, uint32_t ticks_old) -{ - return ((ticks_now - ticks_old) & MAX_RTC_COUNTER_VAL); -} - - -/**@brief Function for setting the RTC1 Capture Compare register 0, and enabling the corresponding - * event. - * - * @param[in] value New value of Capture Compare register 0. - */ -static __INLINE void rtc1_compare0_set(uint32_t value) -{ - NRF_RTC1->CC[0] = value; -} - - -/**@brief Function for inserting a timer in the timer list. - * - * @param[in] timer_id Id of timer to insert. - */ -static void timer_list_insert(timer_node_t * p_timer) -{ - if (mp_timer_id_head == NULL) - { - mp_timer_id_head = p_timer; - } - else - { - if (p_timer->ticks_to_expire <= mp_timer_id_head->ticks_to_expire) - { - mp_timer_id_head->ticks_to_expire -= p_timer->ticks_to_expire; - - p_timer->next = mp_timer_id_head; - mp_timer_id_head = p_timer; - } - else - { - timer_node_t * p_previous; - timer_node_t * p_current; - uint32_t ticks_to_expire; - - ticks_to_expire = p_timer->ticks_to_expire; - p_previous = mp_timer_id_head; - p_current = mp_timer_id_head; - - while ((p_current != NULL) && (ticks_to_expire > p_current->ticks_to_expire)) - { - ticks_to_expire -= p_current->ticks_to_expire; - p_previous = p_current; - p_current = p_current->next; - } - - if (p_current != NULL) - { - p_current->ticks_to_expire -= ticks_to_expire; - } - - p_timer->ticks_to_expire = ticks_to_expire; - p_timer->next = p_current; - p_previous->next = p_timer; - } - } -} - - -/**@brief Function for removing a timer from the timer queue. - * - * @param[in] timer_id Id of timer to remove. - */ -static void timer_list_remove(timer_node_t * p_timer) -{ - timer_node_t * p_previous; - timer_node_t * p_current; - uint32_t timeout; - - // Find the timer's position in timer list. - p_previous = mp_timer_id_head; - p_current = p_previous; - - while (p_current != NULL) - { - if (p_current == p_timer) - { - break; - } - p_previous = p_current; - p_current = p_current->next; - } - - // Timer not in active list. - if (p_current == NULL) - { - return; - } - - // Timer is the first in the list - if (p_previous == p_current) - { - mp_timer_id_head = mp_timer_id_head->next; - - // No more timers in the list. Reset RTC1 in case Start timer operations are present in the queue. - if (mp_timer_id_head == NULL) - { - NRF_RTC1->TASKS_CLEAR = 1; - m_ticks_latest = 0; - m_rtc1_reset = true; - } - } - - // Remaining timeout between next timeout. - timeout = p_current->ticks_to_expire; - - // Link previous timer with next of this timer, i.e. removing the timer from list. - p_previous->next = p_current->next; - - // If this is not the last timer, increment the next timer by this timer timeout. - p_current = p_previous->next; - if (p_current != NULL) - { - p_current->ticks_to_expire += timeout; - } -} - - -/**@brief Function for scheduling a check for timeouts by generating a RTC1 interrupt. - */ -static void timer_timeouts_check_sched(void) -{ - NVIC_SetPendingIRQ(RTC1_IRQn); -} - - -/**@brief Function for scheduling a timer list update by generating a SWI interrupt. - */ -static void timer_list_handler_sched(void) -{ - NVIC_SetPendingIRQ(SWI_IRQn); -} - - -/**@brief Function for executing an application timeout handler, either by calling it directly, or - * by passing an event to the @ref app_scheduler. - * - * @param[in] p_timer Pointer to expired timer. - */ -static void timeout_handler_exec(timer_node_t * p_timer) -{ - if (m_evt_schedule_func != NULL) - { - uint32_t err_code = m_evt_schedule_func(p_timer->p_timeout_handler, p_timer->p_context); - APP_ERROR_CHECK(err_code); - } - else - { - p_timer->p_timeout_handler(p_timer->p_context); - } -} - - -/**@brief Function for checking for expired timers. - */ -static void timer_timeouts_check(void) -{ - // Handle expired of timer - if (mp_timer_id_head != NULL) - { - timer_node_t * p_timer; - timer_node_t * p_previous_timer; - uint32_t ticks_elapsed; - uint32_t ticks_expired; - - // Initialize actual elapsed ticks being consumed to 0. - ticks_expired = 0; - - // ticks_elapsed is collected here, job will use it. - ticks_elapsed = ticks_diff_get(rtc1_counter_get(), m_ticks_latest); - - // Auto variable containing the head of timers expiring. - p_timer = mp_timer_id_head; - - // Expire all timers within ticks_elapsed and collect ticks_expired. - while (p_timer != NULL) - { - // Do nothing if timer did not expire. - if (ticks_elapsed < p_timer->ticks_to_expire) - { - break; - } - - // Decrement ticks_elapsed and collect expired ticks. - ticks_elapsed -= p_timer->ticks_to_expire; - ticks_expired += p_timer->ticks_to_expire; - - // Move to next timer. - p_previous_timer = p_timer; - p_timer = p_timer->next; - - // Execute Task. - if (p_previous_timer->is_running) - { - p_previous_timer->is_running = false; - timeout_handler_exec(p_previous_timer); - } - } - - // Prepare to queue the ticks expired in the m_ticks_elapsed queue. - if (m_ticks_elapsed_q_read_ind == m_ticks_elapsed_q_write_ind) - { - // The read index of the queue is equal to the write index. This means the new - // value of ticks_expired should be stored at a new location in the m_ticks_elapsed - // queue (which is implemented as a double buffer). - - // Check if there will be a queue overflow. - if (++m_ticks_elapsed_q_write_ind == CONTEXT_QUEUE_SIZE_MAX) - { - // There will be a queue overflow. Hence the write index should point to the start - // of the queue. - m_ticks_elapsed_q_write_ind = 0; - } - } - - // Queue the ticks expired. - m_ticks_elapsed[m_ticks_elapsed_q_write_ind] = ticks_expired; - - timer_list_handler_sched(); - } -} - - -/**@brief Function for acquiring the number of ticks elapsed. - * - * @param[out] p_ticks_elapsed Number of ticks elapsed. - * - * @return TRUE if elapsed ticks was read from queue, FALSE otherwise. - */ -static bool elapsed_ticks_acquire(uint32_t * p_ticks_elapsed) -{ - // Pick the elapsed value from queue. - if (m_ticks_elapsed_q_read_ind != m_ticks_elapsed_q_write_ind) - { - // Dequeue elapsed value. - m_ticks_elapsed_q_read_ind++; - if (m_ticks_elapsed_q_read_ind == CONTEXT_QUEUE_SIZE_MAX) - { - m_ticks_elapsed_q_read_ind = 0; - } - - *p_ticks_elapsed = m_ticks_elapsed[m_ticks_elapsed_q_read_ind]; - - m_ticks_latest += *p_ticks_elapsed; - m_ticks_latest &= MAX_RTC_COUNTER_VAL; - - return true; - } - else - { - // No elapsed value in queue. - *p_ticks_elapsed = 0; - return false; - } -} - - -/**@brief Function for handling the timer list deletions. - * - * @return TRUE if Capture Compare register must be updated, FALSE otherwise. - */ -static bool list_deletions_handler(void) -{ - timer_node_t * p_timer_old_head; - uint8_t user_ops_first = m_op_queue.first; - - // Remember the old head, so as to decide if new compare needs to be set. - p_timer_old_head = mp_timer_id_head; - - while (user_ops_first != m_op_queue.last) - { - timer_user_op_t * p_user_op = &m_op_queue.p_user_op_queue[user_ops_first]; - - // Traverse to next operation in queue. - user_ops_first++; - if (user_ops_first == m_op_queue.size) - { - user_ops_first = 0; - } - - switch (p_user_op->op_type) - { - case TIMER_USER_OP_TYPE_STOP: - // Delete node if timer is running. - timer_list_remove(p_user_op->p_node); - break; - - case TIMER_USER_OP_TYPE_STOP_ALL: - // Delete list of running timers, and mark all timers as not running. - while (mp_timer_id_head != NULL) - { - timer_node_t * p_head = mp_timer_id_head; - - p_head->is_running = false; - mp_timer_id_head = p_head->next; - } - break; - - default: - // No implementation needed. - break; - } - } - - // Detect change in head of the list. - return (mp_timer_id_head != p_timer_old_head); -} - - -/**@brief Function for updating the timer list for expired timers. - * - * @param[in] ticks_elapsed Number of elapsed ticks. - * @param[in] ticks_previous Previous known value of the RTC counter. - * @param[out] p_restart_list_head List of repeating timers to be restarted. - */ -static void expired_timers_handler(uint32_t ticks_elapsed, - uint32_t ticks_previous, - timer_node_t ** p_restart_list_head) -{ - uint32_t ticks_expired = 0; - - while (mp_timer_id_head != NULL) - { - timer_node_t * p_timer; - timer_node_t * p_timer_expired; - - // Auto variable for current timer node. - p_timer = mp_timer_id_head; - - // Do nothing if timer did not expire - if (ticks_elapsed < p_timer->ticks_to_expire) - { - p_timer->ticks_to_expire -= ticks_elapsed; - break; - } - - // Decrement ticks_elapsed and collect expired ticks. - ticks_elapsed -= p_timer->ticks_to_expire; - ticks_expired += p_timer->ticks_to_expire; - - // Timer expired, set ticks_to_expire zero. - p_timer->ticks_to_expire = 0; - - // Remove the expired timer from head. - p_timer_expired = mp_timer_id_head; - mp_timer_id_head = p_timer->next; - - // Timer will be restarted if periodic. - if (p_timer->ticks_periodic_interval != 0) - { - p_timer->ticks_at_start = (ticks_previous + ticks_expired) & MAX_RTC_COUNTER_VAL; - p_timer->ticks_first_interval = p_timer->ticks_periodic_interval; - p_timer->next = *p_restart_list_head; - *p_restart_list_head = p_timer_expired; - } - } -} - - -/**@brief Function for handling timer list insertions. - * - * @param[in] p_restart_list_head List of repeating timers to be restarted. - * - * @return TRUE if Capture Compare register must be updated, FALSE otherwise. - */ -static bool list_insertions_handler(timer_node_t * p_restart_list_head) -{ - timer_node_t * p_timer_id_old_head; - - // Remember the old head, so as to decide if new compare needs to be set. - p_timer_id_old_head = mp_timer_id_head; - - // Handle insertions of timers. - while ((p_restart_list_head != NULL) || (m_op_queue.first != m_op_queue.last)) - { - timer_node_t * p_timer; - - if (p_restart_list_head != NULL) - { - p_timer = p_restart_list_head; - p_restart_list_head = p_timer->next; - } - else - { - timer_user_op_t * p_user_op = &m_op_queue.p_user_op_queue[m_op_queue.first]; - - m_op_queue.first++; - if (m_op_queue.first == m_op_queue.size) - { - m_op_queue.first = 0; - } - - p_timer = p_user_op->p_node; - - if ((p_user_op->op_type != TIMER_USER_OP_TYPE_START) || p_timer->is_running) - { - continue; - } - - p_timer->ticks_at_start = p_user_op->params.start.ticks_at_start; - p_timer->ticks_first_interval = p_user_op->params.start.ticks_first_interval; - p_timer->ticks_periodic_interval = p_user_op->params.start.ticks_periodic_interval; - p_timer->p_context = p_user_op->params.start.p_context; - - if (m_rtc1_reset) - { - p_timer->ticks_at_start = 0; - } - } - - // Prepare the node to be inserted. - if ( - ((p_timer->ticks_at_start - m_ticks_latest) & MAX_RTC_COUNTER_VAL) - < - (MAX_RTC_COUNTER_VAL / 2) - ) - { - p_timer->ticks_to_expire = ticks_diff_get(p_timer->ticks_at_start, m_ticks_latest) + - p_timer->ticks_first_interval; - } - else - { - uint32_t delta_current_start; - - delta_current_start = ticks_diff_get(m_ticks_latest, p_timer->ticks_at_start); - if (p_timer->ticks_first_interval > delta_current_start) - { - p_timer->ticks_to_expire = p_timer->ticks_first_interval - delta_current_start; - } - else - { - p_timer->ticks_to_expire = 0; - } - } - - p_timer->ticks_at_start = 0; - p_timer->ticks_first_interval = 0; - p_timer->is_running = true; - p_timer->next = NULL; - - // Insert into list - timer_list_insert(p_timer); - } - - return (mp_timer_id_head != p_timer_id_old_head); -} - - -/**@brief Function for updating the Capture Compare register. - */ -static void compare_reg_update(timer_node_t * p_timer_id_head_old) -{ - // Setup the timeout for timers on the head of the list - if (mp_timer_id_head != NULL) - { - uint32_t ticks_to_expire = mp_timer_id_head->ticks_to_expire; - uint32_t pre_counter_val = rtc1_counter_get(); - uint32_t cc = m_ticks_latest; - uint32_t ticks_elapsed = ticks_diff_get(pre_counter_val, cc) + RTC_COMPARE_OFFSET_MIN; - - if (!m_rtc1_running) - { - // No timers were already running, start RTC - rtc1_start(); - } - - cc += (ticks_elapsed < ticks_to_expire) ? ticks_to_expire : ticks_elapsed; - cc &= MAX_RTC_COUNTER_VAL; - - rtc1_compare0_set(cc); - - uint32_t post_counter_val = rtc1_counter_get(); - - if ( - (ticks_diff_get(post_counter_val, pre_counter_val) + RTC_COMPARE_OFFSET_MIN) - > - ticks_diff_get(cc, pre_counter_val) - ) - { - // When this happens the COMPARE event may not be triggered by the RTC. - // The nRF51 Series User Specification states that if the COUNTER value is N - // (i.e post_counter_val = N), writing N or N + 1 to a CC register may not trigger a - // COMPARE event. Hence the RTC interrupt is forcefully pended by calling the following - // function. - rtc1_compare0_set(rtc1_counter_get()); // this should prevent CC to fire again in the background while the code is in RTC-ISR - nrf_delay_us(MAX_RTC_TASKS_DELAY); - timer_timeouts_check_sched(); - } - } - else - { -#if (APP_TIMER_KEEPS_RTC_ACTIVE == 0) - // No timers are running, stop RTC - rtc1_stop(); -#endif //(APP_TIMER_KEEPS_RTC_ACTIVE == 0) - } -} - - -/**@brief Function for handling changes to the timer list. - */ -static void timer_list_handler(void) -{ - timer_node_t * p_restart_list_head = NULL; - - uint32_t ticks_elapsed; - uint32_t ticks_previous; - bool ticks_have_elapsed; - bool compare_update; - timer_node_t * p_timer_id_head_old; - -#if APP_TIMER_WITH_PROFILER - { - uint8_t size = m_op_queue.size; - uint8_t first = m_op_queue.first; - uint8_t last = m_op_queue.last; - uint8_t utilization = (first <= last) ? (last - first) : (size + 1 - first + last); - - if (utilization > m_max_user_op_queue_utilization) - { - m_max_user_op_queue_utilization = utilization; - } - } -#endif - - // Back up the previous known tick and previous list head - ticks_previous = m_ticks_latest; - p_timer_id_head_old = mp_timer_id_head; - - // Get number of elapsed ticks - ticks_have_elapsed = elapsed_ticks_acquire(&ticks_elapsed); - - // Handle list deletions - compare_update = list_deletions_handler(); - - // Handle expired timers - if (ticks_have_elapsed) - { - expired_timers_handler(ticks_elapsed, ticks_previous, &p_restart_list_head); - compare_update = true; - } - - // Handle list insertions - if (list_insertions_handler(p_restart_list_head)) - { - compare_update = true; - } - - // Update compare register if necessary - if (compare_update) - { - compare_reg_update(p_timer_id_head_old); - } - m_rtc1_reset = false; -} - - -/**@brief Function for enqueueing a new operations queue entry. - * - * @param[in] last_index Index of the next last index to be enqueued. - */ -static void user_op_enque(uint8_t last_index) -{ - m_op_queue.last = last_index; -} - - -/**@brief Function for allocating a new operations queue entry. - * - * @param[out] p_last_index Index of the next last index to be enqueued. - * - * @return Pointer to allocated queue entry, or NULL if queue is full. - */ -static timer_user_op_t * user_op_alloc( uint8_t * p_last_index) -{ - uint8_t last; - timer_user_op_t * p_user_op; - - last = m_op_queue.last + 1; - if (last == m_op_queue.size) - { - // Overflow case. - last = 0; - } - if (last == m_op_queue.first) - { - // Queue is full. - return NULL; - } - - *p_last_index = last; - p_user_op = &m_op_queue.p_user_op_queue[m_op_queue.last]; - - return p_user_op; -} - - -/**@brief Function for scheduling a Timer Start operation. - * - * @param[in] timer_id Id of timer to start. - * @param[in] timeout_initial Time (in ticks) to first timer expiry. - * @param[in] timeout_periodic Time (in ticks) between periodic expiries. - * @param[in] p_context General purpose pointer. Will be passed to the timeout handler when - * the timer expires. - * @return NRF_SUCCESS on success, otherwise an error code. - */ - -static uint32_t timer_start_op_schedule(timer_node_t * p_node, - uint32_t timeout_initial, - uint32_t timeout_periodic, - void * p_context) -{ - uint8_t last_index; - uint32_t err_code = NRF_SUCCESS; - - CRITICAL_REGION_ENTER(); - timer_user_op_t * p_user_op = user_op_alloc(&last_index); - if (p_user_op == NULL) - { - err_code = NRF_ERROR_NO_MEM; - } - else - { - - p_user_op->op_type = TIMER_USER_OP_TYPE_START; - p_user_op->p_node = p_node; - p_user_op->params.start.ticks_at_start = rtc1_counter_get(); - p_user_op->params.start.ticks_first_interval = timeout_initial; - p_user_op->params.start.ticks_periodic_interval = timeout_periodic; - p_user_op->params.start.p_context = p_context; - - user_op_enque(last_index); - } - CRITICAL_REGION_EXIT(); - - if (err_code == NRF_SUCCESS) - { - timer_list_handler_sched(); - } - - return err_code; -} - - -/**@brief Function for scheduling a Timer Stop operation. - * - * @param[in] timer_id Id of timer to stop. - * @param[in] op_type Type of stop operation - * - * @return NRF_SUCCESS on successful scheduling a timer stop operation. NRF_ERROR_NO_MEM when there - * is no memory left to schedule the timer stop operation. - */ -static uint32_t timer_stop_op_schedule(timer_node_t * p_node, - timer_user_op_type_t op_type) -{ - uint8_t last_index; - uint32_t err_code = NRF_SUCCESS; - - CRITICAL_REGION_ENTER(); - timer_user_op_t * p_user_op = user_op_alloc(&last_index); - if (p_user_op == NULL) - { - err_code = NRF_ERROR_NO_MEM; - } - else - { - p_user_op->op_type = op_type; - p_user_op->p_node = p_node; - - user_op_enque(last_index); - } - CRITICAL_REGION_EXIT(); - - if (err_code == NRF_SUCCESS) - { - timer_list_handler_sched(); - } - - return err_code; -} - -/**@brief Function for handling the RTC1 interrupt. - * - * @details Checks for timeouts, and executes timeout handlers for expired timers. - */ -void RTC1_IRQHandler(void) -{ - // Clear all events (also unexpected ones) - NRF_RTC1->EVENTS_COMPARE[0] = 0; - NRF_RTC1->EVENTS_COMPARE[1] = 0; - NRF_RTC1->EVENTS_COMPARE[2] = 0; - NRF_RTC1->EVENTS_COMPARE[3] = 0; - NRF_RTC1->EVENTS_TICK = 0; - NRF_RTC1->EVENTS_OVRFLW = 0; - - // Check for expired timers - timer_timeouts_check(); -} - - -/**@brief Function for handling the SWI interrupt. - * - * @details Performs all updates to the timer list. - */ -void SWI_IRQHandler(void) -{ - timer_list_handler(); -} - - -uint32_t app_timer_init(uint32_t prescaler, - uint8_t op_queue_size, - void * p_buffer, - app_timer_evt_schedule_func_t evt_schedule_func) -{ - // Check that buffer is correctly aligned - if (!is_word_aligned(p_buffer)) - { - return NRF_ERROR_INVALID_PARAM; - } - // Check for NULL buffer - if (p_buffer == NULL) - { - return NRF_ERROR_INVALID_PARAM; - } - - // Stop RTC to prevent any running timers from expiring (in case of reinitialization) - rtc1_stop(); - - m_evt_schedule_func = evt_schedule_func; - - // Initialize operation queue - m_op_queue.first = 0; - m_op_queue.last = 0; - m_op_queue.size = op_queue_size; - m_op_queue.p_user_op_queue = p_buffer; - - mp_timer_id_head = NULL; - m_ticks_elapsed_q_read_ind = 0; - m_ticks_elapsed_q_write_ind = 0; - -#if APP_TIMER_WITH_PROFILER - m_max_user_op_queue_utilization = 0; -#endif - - NVIC_ClearPendingIRQ(SWI_IRQn); - NVIC_SetPriority(SWI_IRQn, SWI_IRQ_PRI); - NVIC_EnableIRQ(SWI_IRQn); - - rtc1_init(prescaler); - - m_ticks_latest = rtc1_counter_get(); - - return NRF_SUCCESS; -} - - -uint32_t app_timer_create(app_timer_id_t const * p_timer_id, - app_timer_mode_t mode, - app_timer_timeout_handler_t timeout_handler) -{ - // Check state and parameters - VERIFY_MODULE_INITIALIZED(); - - if (timeout_handler == NULL) - { - return NRF_ERROR_INVALID_PARAM; - } - if (p_timer_id == NULL) - { - return NRF_ERROR_INVALID_PARAM; - } - if (((timer_node_t*)*p_timer_id)->is_running) - { - return NRF_ERROR_INVALID_STATE; - } - - timer_node_t * p_node = (timer_node_t *)*p_timer_id; - p_node->is_running = false; - p_node->mode = mode; - p_node->p_timeout_handler = timeout_handler; - return NRF_SUCCESS; -} - -uint32_t app_timer_start(app_timer_id_t timer_id, uint32_t timeout_ticks, void * p_context) -{ - uint32_t timeout_periodic; - timer_node_t * p_node = (timer_node_t*)timer_id; - - // Check state and parameters - VERIFY_MODULE_INITIALIZED(); - - if (timer_id == 0) - { - return NRF_ERROR_INVALID_STATE; - } - if (timeout_ticks < APP_TIMER_MIN_TIMEOUT_TICKS) - { - return NRF_ERROR_INVALID_PARAM; - } - if (p_node->p_timeout_handler == NULL) - { - return NRF_ERROR_INVALID_STATE; - } - - // Schedule timer start operation - timeout_periodic = (p_node->mode == APP_TIMER_MODE_REPEATED) ? timeout_ticks : 0; - - return timer_start_op_schedule(p_node, - timeout_ticks, - timeout_periodic, - p_context); -} - - -uint32_t app_timer_stop(app_timer_id_t timer_id) -{ - timer_node_t * p_node = (timer_node_t*)timer_id; - // Check state and parameters - VERIFY_MODULE_INITIALIZED(); - - if ((timer_id == NULL) || (p_node->p_timeout_handler == NULL)) - { - return NRF_ERROR_INVALID_STATE; - } - - p_node->is_running = false; - // Schedule timer stop operation - return timer_stop_op_schedule(p_node, TIMER_USER_OP_TYPE_STOP); -} - - -uint32_t app_timer_stop_all(void) -{ - // Check state - VERIFY_MODULE_INITIALIZED(); - - return timer_stop_op_schedule(NULL, TIMER_USER_OP_TYPE_STOP_ALL); -} - - -uint32_t app_timer_cnt_get(void) -{ - return rtc1_counter_get(); -} - - -uint32_t app_timer_cnt_diff_compute(uint32_t ticks_to, - uint32_t ticks_from, - uint32_t * p_ticks_diff) -{ - *p_ticks_diff = ticks_diff_get(ticks_to, ticks_from); - return NRF_SUCCESS; -} - -#if APP_TIMER_WITH_PROFILER -uint8_t app_timer_op_queue_utilization_get(void) -{ - return m_max_user_op_queue_utilization; -} -#endif -#endif //NRF_MODULE_ENABLED(APP_TIMER) -#endif // MBED_CONF_RTOS_PRESENT diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.h b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.h deleted file mode 100644 index cc4e104bed..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer.h +++ /dev/null @@ -1,321 +0,0 @@ -/* - * Copyright (c) 2012 Nordic Semiconductor ASA - * All rights reserved. - * - * 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, except as embedded into a Nordic Semiconductor ASA - * integrated circuit in a product or a software update for such product, 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. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be - * used to endorse or promote products derived from this software without specific prior - * written permission. - * - * 4. This software, with or without modification, must only be used with a - * Nordic Semiconductor ASA integrated circuit. - * - * 5. Any software provided in binary or object form under this license must not be reverse - * engineered, decompiled, modified and/or disassembled. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND - * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ - -/** @file - * - * @defgroup app_timer Application Timer - * @{ - * @ingroup app_common - * - * @brief Application timer functionality. - * - * @details This module enables the application to create multiple timer instances based on the RTC1 - * peripheral. Checking for time-outs and invocation of user time-out handlers is performed - * in the RTC1 interrupt handler. List handling is done using a software interrupt (SWI0). - * Both interrupt handlers are running in APP_LOW priority level. - * - * @details When calling app_timer_start() or app_timer_stop(), the timer operation is just queued, - * and the software interrupt is triggered. The actual timer start/stop operation is - * executed by the SWI0 interrupt handler. Since the SWI0 interrupt is running in APP_LOW, - * if the application code calling the timer function is running in APP_LOW or APP_HIGH, - * the timer operation will not be performed until the application handler has returned. - * This will be the case, for example, when stopping a timer from a time-out handler when not using - * the scheduler. - * - * @details Use the USE_SCHEDULER parameter of the APP_TIMER_INIT() macro to select if the - * @ref app_scheduler should be used or not. Even if the scheduler is - * not used, app_timer.h will include app_scheduler.h, so when - * compiling, app_scheduler.h must be available in one of the compiler include paths. - */ - -#ifndef APP_TIMER_H__ -#define APP_TIMER_H__ -#include "sdk_config.h" -#include "app_error.h" -#include "app_util.h" -#include "compiler_abstraction.h" -#include -#include -#include - -#ifdef __cplusplus -extern "C" { -#endif - -#define APP_TIMER_CLOCK_FREQ 32768 /**< Clock frequency of the RTC timer used to implement the app timer module. */ -#define APP_TIMER_MIN_TIMEOUT_TICKS 5 /**< Minimum value of the timeout_ticks parameter of app_timer_start(). */ - -#ifdef RTX -#define APP_TIMER_NODE_SIZE 40 /**< Size of app_timer.timer_node_t (used to allocate data). */ -#else -#define APP_TIMER_NODE_SIZE 32 /**< Size of app_timer.timer_node_t (used to allocate data). */ -#endif // RTX -#define APP_TIMER_USER_OP_SIZE 24 /**< Size of app_timer.timer_user_op_t (only for use inside APP_TIMER_BUF_SIZE()). */ - -/**@brief Compute number of bytes required to hold the application timer data structures. - * - * @param[in] OP_QUEUE_SIZE Size of the queue holding timer operations that are pending execution. - * Note that due to the queue implementation, this size must be one more - * than the size that is actually needed. - * - * @return Required application timer buffer size (in bytes). - */ -#define APP_TIMER_BUF_SIZE(OP_QUEUE_SIZE) \ - ( \ - ( \ - (((OP_QUEUE_SIZE) + 1) * APP_TIMER_USER_OP_SIZE) \ - ) \ - ) - -/**@brief Convert milliseconds to timer ticks. - * - * This macro uses 64-bit integer arithmetic, but as long as the macro parameters are - * constants (i.e. defines), the computation will be done by the preprocessor. - * - * When using this macro, ensure that the - * values provided as input result in an output value that is supported by the - * @ref app_timer_start function. For example, when the ticks for 1 ms is needed, the - * maximum possible value of PRESCALER must be 6, when @ref APP_TIMER_CLOCK_FREQ is 32768. - * This will result in a ticks value as 5. Any higher value for PRESCALER will result in a - * ticks value that is not supported by this module. - * - * @param[in] MS Milliseconds. - * @param[in] PRESCALER Value of the RTC1 PRESCALER register (must be the same value that was - * passed to APP_TIMER_INIT()). - * - * @return Number of timer ticks. - */ -#define APP_TIMER_TICKS(MS, PRESCALER)\ - ((uint32_t)ROUNDED_DIV((MS) * (uint64_t)APP_TIMER_CLOCK_FREQ, ((PRESCALER) + 1) * 1000)) - -typedef struct app_timer_t { uint32_t data[CEIL_DIV(APP_TIMER_NODE_SIZE, sizeof(uint32_t))]; } app_timer_t; - -/**@brief Timer ID type. - * Never declare a variable of this type, but use the macro @ref APP_TIMER_DEF instead.*/ -typedef app_timer_t * app_timer_id_t; - -/** - * @brief Create a timer identifier and statically allocate memory for the timer. - * - * @param timer_id Name of the timer identifier variable that will be used to control the timer. - */ -#define APP_TIMER_DEF(timer_id) \ - static app_timer_t timer_id##_data = { {0} }; \ - static const app_timer_id_t timer_id = &timer_id##_data - - -/**@brief Application time-out handler type. */ -typedef void (*app_timer_timeout_handler_t)(void * p_context); - -/**@brief Type of function for passing events from the timer module to the scheduler. */ -typedef uint32_t (*app_timer_evt_schedule_func_t) (app_timer_timeout_handler_t timeout_handler, - void * p_context); - -/**@brief Timer modes. */ -typedef enum -{ - APP_TIMER_MODE_SINGLE_SHOT, /**< The timer will expire only once. */ - APP_TIMER_MODE_REPEATED /**< The timer will restart each time it expires. */ -} app_timer_mode_t; - -/**@brief Initialize the application timer module. - * - * @details This macro handles dimensioning and allocation of the memory buffer required by the timer, - * making sure that the buffer is correctly aligned. It will also connect the timer module - * to the scheduler (if specified). - * - * @note This module assumes that the LFCLK is already running. If it is not, the module will - * be non-functional, since the RTC will not run. If you do not use a SoftDevice, you - * must start the LFCLK manually. See the rtc_example's lfclk_config() function - * for an example of how to do this. If you use a SoftDevice, the LFCLK is started on - * SoftDevice init. - * - * - * @param[in] PRESCALER Value of the RTC1 PRESCALER register. This will decide the - * timer tick rate. Set to 0 for no prescaling. - * @param[in] OP_QUEUE_SIZE Size of the queue holding timer operations that are pending execution. - * @param[in] SCHEDULER_FUNC Pointer to scheduler event handler - * - * @note Since this macro allocates a buffer, it must only be called once (it is OK to call it - * several times as long as it is from the same location, for example, to do a re-initialization). - */ -/*lint -emacro(506, APP_TIMER_INIT) */ /* Suppress "Constant value Boolean */ -#define APP_TIMER_INIT(PRESCALER, OP_QUEUE_SIZE, SCHEDULER_FUNC) \ - do \ - { \ - static uint32_t APP_TIMER_BUF[CEIL_DIV(APP_TIMER_BUF_SIZE(OP_QUEUE_SIZE), \ - sizeof(uint32_t))]; \ - uint32_t ERR_CODE = app_timer_init((PRESCALER), \ - (OP_QUEUE_SIZE) + 1, \ - APP_TIMER_BUF, \ - SCHEDULER_FUNC); \ - APP_ERROR_CHECK(ERR_CODE); \ - } while (0) - - - -/**@brief Function for initializing the timer module. - * - * Normally, initialization should be done using the APP_TIMER_INIT() macro, because that macro will both - * allocate the buffers needed by the timer module (including aligning the buffers correctly) - * and take care of connecting the timer module to the scheduler (if specified). - * - * @param[in] prescaler Value of the RTC1 PRESCALER register. Set to 0 for no prescaling. - * @param[in] op_queue_size Size of the queue holding timer operations that are pending - * execution. Note that due to the queue implementation, this size must - * be one more than the size that is actually needed. - * @param[in] p_buffer Pointer to memory buffer for internal use in the app_timer - * module. The size of the buffer can be computed using the - * APP_TIMER_BUF_SIZE() macro. The buffer must be aligned to a - * 4 byte boundary. - * @param[in] evt_schedule_func Function for passing time-out events to the scheduler. Point to - * app_timer_evt_schedule() to connect to the scheduler. Set to NULL - * to make the timer module call the time-out handler directly from - * the timer interrupt handler. - * - * @retval NRF_SUCCESS If the module was initialized successfully. - * @retval NRF_ERROR_INVALID_PARAM If a parameter was invalid (buffer not aligned to a 4 byte - * boundary or NULL). - */ -uint32_t app_timer_init(uint32_t prescaler, - uint8_t op_queue_size, - void * p_buffer, - app_timer_evt_schedule_func_t evt_schedule_func); - -/**@brief Function for creating a timer instance. - * - * @param[in] p_timer_id Pointer to timer identifier. - * @param[in] mode Timer mode. - * @param[in] timeout_handler Function to be executed when the timer expires. - * - * @retval NRF_SUCCESS If the timer was successfully created. - * @retval NRF_ERROR_INVALID_PARAM If a parameter was invalid. - * @retval NRF_ERROR_INVALID_STATE If the application timer module has not been initialized or - * the timer is running. - * - * @note This function does the timer allocation in the caller's context. It is also not protected - * by a critical region. Therefore care must be taken not to call it from several interrupt - * levels simultaneously. - * @note The function can be called again on the timer instance and will re-initialize the instance if - * the timer is not running. - * @attention The FreeRTOS and RTX app_timer implementation does not allow app_timer_create to - * be called on the previously initialized instance. - */ -uint32_t app_timer_create(app_timer_id_t const * p_timer_id, - app_timer_mode_t mode, - app_timer_timeout_handler_t timeout_handler); - -/**@brief Function for starting a timer. - * - * @param[in] timer_id Timer identifier. - * @param[in] timeout_ticks Number of ticks (of RTC1, including prescaling) to time-out event - * (minimum 5 ticks). - * @param[in] p_context General purpose pointer. Will be passed to the time-out handler when - * the timer expires. - * - * @retval NRF_SUCCESS If the timer was successfully started. - * @retval NRF_ERROR_INVALID_PARAM If a parameter was invalid. - * @retval NRF_ERROR_INVALID_STATE If the application timer module has not been initialized or the timer - * has not been created. - * @retval NRF_ERROR_NO_MEM If the timer operations queue was full. - * - * @note The minimum timeout_ticks value is 5. - * @note For multiple active timers, time-outs occurring in close proximity to each other (in the - * range of 1 to 3 ticks) will have a positive jitter of maximum 3 ticks. - * @note When calling this method on a timer that is already running, the second start operation - * is ignored. - */ -uint32_t app_timer_start(app_timer_id_t timer_id, uint32_t timeout_ticks, void * p_context); - -/**@brief Function for stopping the specified timer. - * - * @param[in] timer_id Timer identifier. - * - * @retval NRF_SUCCESS If the timer was successfully stopped. - * @retval NRF_ERROR_INVALID_PARAM If a parameter was invalid. - * @retval NRF_ERROR_INVALID_STATE If the application timer module has not been initialized or the timer - * has not been created. - * @retval NRF_ERROR_NO_MEM If the timer operations queue was full. - */ -uint32_t app_timer_stop(app_timer_id_t timer_id); - -/**@brief Function for stopping all running timers. - * - * @retval NRF_SUCCESS If all timers were successfully stopped. - * @retval NRF_ERROR_INVALID_STATE If the application timer module has not been initialized. - * @retval NRF_ERROR_NO_MEM If the timer operations queue was full. - */ -uint32_t app_timer_stop_all(void); - -/**@brief Function for returning the current value of the RTC1 counter. - * - * @return Current value of the RTC1 counter. - */ -uint32_t app_timer_cnt_get(void); - -/**@brief Function for computing the difference between two RTC1 counter values. - * - * @param[in] ticks_to Value returned by app_timer_cnt_get(). - * @param[in] ticks_from Value returned by app_timer_cnt_get(). - * @param[out] p_ticks_diff Number of ticks from ticks_from to ticks_to. - * - * @retval NRF_SUCCESS If the counter difference was successfully computed. - */ -uint32_t app_timer_cnt_diff_compute(uint32_t ticks_to, - uint32_t ticks_from, - uint32_t * p_ticks_diff); - - -/**@brief Function for getting the maximum observed operation queue utilization. - * - * Function for tuning the module and determining OP_QUEUE_SIZE value and thus module RAM usage. - * - * @note APP_TIMER_WITH_PROFILER must be enabled to use this functionality. - * - * @return Maximum number of events in queue observed so far. - */ -uint8_t app_timer_op_queue_utilization_get(void); - - -#ifdef __cplusplus -} -#endif - -#endif // APP_TIMER_H__ - -/** @} */ diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.c b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.c deleted file mode 100644 index b3df7095b9..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.c +++ /dev/null @@ -1,60 +0,0 @@ -/* - * Copyright (c) 2014 Nordic Semiconductor ASA - * All rights reserved. - * - * 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, except as embedded into a Nordic Semiconductor ASA - * integrated circuit in a product or a software update for such product, 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. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be - * used to endorse or promote products derived from this software without specific prior - * written permission. - * - * 4. This software, with or without modification, must only be used with a - * Nordic Semiconductor ASA integrated circuit. - * - * 5. Any software provided in binary or object form under this license must not be reverse - * engineered, decompiled, modified and/or disassembled. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND - * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ - -#include "app_timer_appsh.h" -#include "app_scheduler.h" - -static void app_timer_evt_get(void * p_event_data, uint16_t event_size) -{ - app_timer_event_t * p_timer_event = (app_timer_event_t *)p_event_data; - - APP_ERROR_CHECK_BOOL(event_size == sizeof(app_timer_event_t)); - p_timer_event->timeout_handler(p_timer_event->p_context); -} - -uint32_t app_timer_evt_schedule(app_timer_timeout_handler_t timeout_handler, - void * p_context) -{ - app_timer_event_t timer_event; - - timer_event.timeout_handler = timeout_handler; - timer_event.p_context = p_context; - - return app_sched_event_put(&timer_event, sizeof(timer_event), app_timer_evt_get); -} - diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.h b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.h deleted file mode 100644 index bcefc13580..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_appsh.h +++ /dev/null @@ -1,79 +0,0 @@ -/* - * Copyright (c) 2014 Nordic Semiconductor ASA - * All rights reserved. - * - * 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, except as embedded into a Nordic Semiconductor ASA - * integrated circuit in a product or a software update for such product, 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. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be - * used to endorse or promote products derived from this software without specific prior - * written permission. - * - * 4. This software, with or without modification, must only be used with a - * Nordic Semiconductor ASA integrated circuit. - * - * 5. Any software provided in binary or object form under this license must not be reverse - * engineered, decompiled, modified and/or disassembled. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND - * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ - - #ifndef APP_TIMER_APPSH_H - #define APP_TIMER_APPSH_H - -#include "app_timer.h" - -#ifdef __cplusplus -extern "C" { -#endif - -#define APP_TIMER_SCHED_EVT_SIZE sizeof(app_timer_event_t) /**< Size of button events being passed through the scheduler (is to be used for computing the maximum size of scheduler events). */ - -/**@brief Macro for initializing the application timer module to use with app_scheduler. - * - * @param[in] PRESCALER Value of the RTC1 PRESCALER register. This will decide the - * timer tick rate. Set to 0 for no prescaling. - * @param[in] OP_QUEUES_SIZE Size of queues holding timer operations that are pending execution. - * @param[in] USE_SCHEDULER TRUE if the application is using the app_scheduler, - * FALSE otherwise. - * - * @note Since this macro allocates a buffer, it must only be called once (it is OK to call it - * several times as long as it is from the same location, e.g. to do a reinitialization). - */ -#define APP_TIMER_APPSH_INIT(PRESCALER, OP_QUEUES_SIZE, USE_SCHEDULER) \ - APP_TIMER_INIT(PRESCALER, OP_QUEUES_SIZE, \ - (USE_SCHEDULER) ? app_timer_evt_schedule : NULL) - -typedef struct -{ - app_timer_timeout_handler_t timeout_handler; - void * p_context; -} app_timer_event_t; - -uint32_t app_timer_evt_schedule(app_timer_timeout_handler_t timeout_handler, - void * p_context); - -#ifdef __cplusplus -} -#endif - -#endif // APP_TIMER_APPSH_H - diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_dox_config.h b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_dox_config.h deleted file mode 100644 index c142cfca40..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_dox_config.h +++ /dev/null @@ -1,37 +0,0 @@ -/** - * - * @defgroup app_timer_config Application timer functionality configuration - * @{ - * @ingroup app_timer - */ -/** @brief Enabling app_timer module - * - * Set to 1 to activate. - * - * @note This is an NRF_CONFIG macro. - */ -#define APP_TIMER_ENABLED - -/** @brief Enable app_timer profiling - * - * Set to 1 to activate. - * - * @note This is an NRF_CONFIG macro. - */ -#define APP_TIMER_WITH_PROFILER - - -/** @brief Enable RTC always on - * - * If option is enabled RTC is kept running even if there is no active timers. - * This option can be used when app_timer is used for timestamping. - * - * Set to 1 to activate. - * - * @note This is an NRF_CONFIG macro. - */ -#define APP_TIMER_KEEPS_RTC_ACTIVE - - - -/** @} */ diff --git a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_rtx.c b/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_rtx.c deleted file mode 100644 index acf9e566c5..0000000000 --- a/targets/TARGET_NORDIC/TARGET_NRF5_SDK13/sdk/libraries/timer/app_timer_rtx.c +++ /dev/null @@ -1,285 +0,0 @@ -/* - * Copyright (c) 2016 Nordic Semiconductor ASA - * All rights reserved. - * - * 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, except as embedded into a Nordic Semiconductor ASA - * integrated circuit in a product or a software update for such product, 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. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be - * used to endorse or promote products derived from this software without specific prior - * written permission. - * - * 4. This software, with or without modification, must only be used with a - * Nordic Semiconductor ASA integrated circuit. - * - * 5. Any software provided in binary or object form under this license must not be reverse - * engineered, decompiled, modified and/or disassembled. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND - * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS 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. - * - */ -#ifdef MBED_CONF_RTOS_PRESENT - -#include "sdk_common.h" -#if NRF_MODULE_ENABLED(APP_TIMER) -#include "app_timer.h" -#include -#include "nrf.h" -#include "nrf_soc.h" -#include "app_error.h" -#include "cmsis_os.h" -#include "app_util_platform.h" - -#define RTC1_IRQ_PRI APP_IRQ_PRIORITY_LOWEST /**< Priority of the RTC1 interrupt. */ - -#define MAX_RTC_COUNTER_VAL 0x00FFFFFF /**< Maximum value of the RTC counter. */ - -/**@brief This structure keeps information about osTimer.*/ -typedef struct -{ - osTimerDef_t timerDef; - uint32_t buffer[6]; - osTimerId id; -}app_timer_info_t; - -/**@brief Store an array of timers with configuration. */ -typedef struct -{ - uint8_t max_timers; /**< The maximum number of timers*/ - uint32_t prescaler; - app_timer_info_t * app_timers; /**< Pointer to table of timers*/ -}app_timer_control_t; -app_timer_control_t app_timer_control; - -/**@brief This structure is defined by RTX. It keeps information about created osTimers. It is used in app_timer_start(). */ -typedef struct os_timer_cb_ -{ - struct os_timer_cb_ * next; /**< Pointer to next active Timer */ - uint8_t state; /**< Timer State */ - uint8_t type; /**< Timer Type (Periodic/One-shot). */ - uint16_t reserved; /**< Reserved. */ - uint32_t tcnt; /**< Timer Delay Count. */ - uint32_t icnt; /**< Timer Initial Count. */ - void * arg; /**< Timer Function Argument. */ - const osTimerDef_t * timer; /**< Pointer to Timer definition. */ -} os_timer_cb; - -/**@brief This functions are defined by RTX.*/ -//lint --save -e10 -e19 -e526 -extern osStatus svcTimerStop(osTimerId timer_id); /**< Used in app_timer_stop(). */ -extern osStatus svcTimerStart(osTimerId timer_id, uint32_t millisec); /**< Used in app_timer_start(). */ -// lint --restore -static void * rt_id2obj (void *id) /**< Used in app_timer_start(). This function gives information if osTimerID is valid */ -{ - if ((uint32_t)id & 3U) - { - return NULL; - } - -#ifdef OS_SECTIONS_LINK_INFO - - if ((os_section_id$$Base != 0U) && (os_section_id$$Limit != 0U)) - { - if (id < (void *)os_section_id$$Base) - { - return NULL; - } - - if (id >= (void *)os_section_id$$Limit) - { - return NULL; - } - } -#endif - - return id; -} - - - -uint32_t app_timer_init(uint32_t prescaler, - uint8_t op_queues_size, - void * p_buffer, - app_timer_evt_schedule_func_t evt_schedule_func) -{ - if (p_buffer == NULL) - { - return NRF_ERROR_INVALID_PARAM; - } - - app_timer_control.prescaler = prescaler; - app_timer_control.app_timers = p_buffer; - NVIC_SetPriority(RTC1_IRQn, RTC1_IRQ_PRI); - - return NRF_SUCCESS; -} - - -uint32_t app_timer_create(app_timer_id_t const * p_timer_id, - app_timer_mode_t mode, - app_timer_timeout_handler_t timeout_handler) -{ - - if ((timeout_handler == NULL) || (p_timer_id == NULL)) - { - return NRF_ERROR_INVALID_PARAM; - } - - app_timer_info_t * p_timer_info = (app_timer_info_t *)*p_timer_id; - p_timer_info->timerDef.timer = p_timer_info->buffer; - p_timer_info->timerDef.ptimer = (os_ptimer)timeout_handler; - - p_timer_info->id = osTimerCreate(&(p_timer_info->timerDef), (os_timer_type)mode, NULL); - - if (p_timer_info->id) - return NRF_SUCCESS; - else - { - return NRF_ERROR_INVALID_PARAM; // This error is unspecified by rtx - } -} - -#define osTimerRunning 2 -uint32_t app_timer_start(app_timer_id_t timer_id, uint32_t timeout_ticks, void * p_context) -{ - if ((timeout_ticks < APP_TIMER_MIN_TIMEOUT_TICKS)) - { - return NRF_ERROR_INVALID_PARAM; - } - uint32_t timeout_ms = - ((uint32_t)ROUNDED_DIV(timeout_ticks * 1000 * (app_timer_control.prescaler + 1), - (uint32_t)APP_TIMER_CLOCK_FREQ)); - - app_timer_info_t * p_timer_info = (app_timer_info_t *)timer_id; - if (rt_id2obj((void *)p_timer_info->id) == NULL) - return NRF_ERROR_INVALID_PARAM; - - // Pass p_context to timer_timeout_handler - ((os_timer_cb *)(p_timer_info->id))->arg = p_context; - - if (((os_timer_cb *)(p_timer_info->id))->state == osTimerRunning) - { - return NRF_SUCCESS; - } - // osTimerStart() returns osErrorISR if it is called in interrupt routine. - switch (osTimerStart((osTimerId)p_timer_info->id, timeout_ms) ) - { - case osOK: - return NRF_SUCCESS; - - case osErrorISR: - break; - - case osErrorParameter: - return NRF_ERROR_INVALID_PARAM; - - default: - return NRF_ERROR_INVALID_PARAM; - } - - // Start timer without svcCall - switch (svcTimerStart((osTimerId)p_timer_info->id, timeout_ms)) - { - case osOK: - return NRF_SUCCESS; - - case osErrorISR: - return NRF_ERROR_INVALID_STATE; - - case osErrorParameter: - return NRF_ERROR_INVALID_PARAM; - - default: - return NRF_ERROR_INVALID_PARAM; - } -} - -uint32_t app_timer_stop(app_timer_id_t timer_id) -{ - app_timer_info_t * p_timer_info = (app_timer_info_t *)timer_id; - switch (osTimerStop((osTimerId)p_timer_info->id) ) - { - case osOK: - return NRF_SUCCESS; - - case osErrorISR: - break; - - case osErrorParameter: - return NRF_ERROR_INVALID_PARAM; - - case osErrorResource: - return NRF_SUCCESS; - - default: - return NRF_ERROR_INVALID_PARAM; - } - - // Stop timer without svcCall - switch (svcTimerStop((osTimerId)p_timer_info->id)) - { - case osOK: - return NRF_SUCCESS; - - case osErrorISR: - return NRF_ERROR_INVALID_STATE; - - case osErrorParameter: - return NRF_ERROR_INVALID_PARAM; - - case osErrorResource: - return NRF_SUCCESS; - - default: - return NRF_ERROR_INVALID_PARAM; - } -} - - -uint32_t app_timer_stop_all(void) -{ - for (int i = 0; i < app_timer_control.max_timers; i++) - { - if (app_timer_control.app_timers[i].id) - { - (void)app_timer_stop((app_timer_id_t)app_timer_control.app_timers[i].id); - } - } - return 0; -} - - -extern uint32_t os_tick_val(void); -uint32_t app_timer_cnt_get(void) -{ - return os_tick_val(); -} - - -uint32_t app_timer_cnt_diff_compute(uint32_t ticks_to, - uint32_t ticks_from, - uint32_t * p_ticks_diff) -{ - *p_ticks_diff = ((ticks_to - ticks_from) & MAX_RTC_COUNTER_VAL); - return NRF_SUCCESS; -} -#endif //NRF_MODULE_ENABLED(APP_TIMER) - -#endif // MBED_CONF_RTOS_PRESENT