2ec3781464
The current QDF timer multiplier factor is of type uint32 which takes whole number, so we cannot have multiplier factors like 0.5 or 1.5 To provide such timer multiplier, we define timer multiplier, as a macro, provided though build options and support values like 0.5 or 1.5 through 1/2 and 3/2 respectively and this is used to configure the timeout value. Change-Id: I3f5441e33cca71f4a399cbbf9c6f61e2f21ee828 CRs-Fixed: 2450710
131 lines
3.5 KiB
C
131 lines
3.5 KiB
C
/*
|
|
* Copyright (c) 2014-2016, 2018-2019 The Linux Foundation. All rights reserved.
|
|
*
|
|
* Permission to use, copy, modify, and/or distribute this software for
|
|
* any purpose with or without fee is hereby granted, provided that the
|
|
* above copyright notice and this permission notice appear in all
|
|
* copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
|
|
* WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
|
|
* AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
|
|
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
* PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
/**
|
|
* DOC: qdf_timer
|
|
* This file abstracts OS timers running in soft IRQ context.
|
|
*/
|
|
|
|
#ifndef _QDF_TIMER_H
|
|
#define _QDF_TIMER_H
|
|
|
|
#include <qdf_types.h>
|
|
#include <i_qdf_timer.h>
|
|
|
|
typedef struct __qdf_timer_t qdf_timer_t;
|
|
|
|
/**
|
|
* qdf_timer_init() - initialize a timer
|
|
* @hdl: OS handle
|
|
* @timer: Timer object pointer
|
|
* @func: Timer function
|
|
* @arg: Argument of timer function
|
|
* @type: deferrable or non deferrable timer type
|
|
*
|
|
* Timer type QDF_TIMER_TYPE_SW means its a deferrable sw timer which will
|
|
* not cause CPU wake upon expiry
|
|
* Timer type QDF_TIMER_TYPE_WAKE_APPS means its a non-deferrable timer which
|
|
* will cause CPU wake up on expiry
|
|
*
|
|
* Return: QDF_STATUS
|
|
*/
|
|
static inline QDF_STATUS
|
|
qdf_timer_init(qdf_handle_t hdl, qdf_timer_t *timer, qdf_timer_func_t func,
|
|
void *arg, QDF_TIMER_TYPE type)
|
|
{
|
|
return __qdf_timer_init(timer, func, arg, type);
|
|
}
|
|
|
|
#ifdef QDF_TIMER_MULTIPLIER_FRAC
|
|
#define qdf_msecs_to_jiffies(msec) \
|
|
(QDF_TIMER_MULTIPLIER_FRAC * __qdf_msecs_to_jiffies(msec))
|
|
#else
|
|
#define qdf_msecs_to_jiffies(msec) \
|
|
(qdf_timer_get_multiplier() * __qdf_msecs_to_jiffies(msec))
|
|
#endif
|
|
|
|
/**
|
|
* qdf_timer_start() - start a timer
|
|
* @timer: timer to start
|
|
* @msec: Expiration period in milliseconds
|
|
*
|
|
* Return: none
|
|
*/
|
|
static inline void qdf_timer_start(qdf_timer_t *timer, int msec)
|
|
{
|
|
__qdf_timer_start(timer, msec);
|
|
}
|
|
|
|
/**
|
|
* qdf_timer_mod() - modify the timeout on a timer
|
|
* @timer: timer to modify
|
|
* @msec: Expiration period in milliseconds
|
|
*
|
|
* If @timer is not active, it will be activated.
|
|
*
|
|
* Return: none
|
|
*/
|
|
static inline void qdf_timer_mod(qdf_timer_t *timer, int msec)
|
|
{
|
|
__qdf_timer_mod(timer, msec);
|
|
}
|
|
|
|
/**
|
|
* qdf_timer_stop() - cancel a timer
|
|
* @timer: timer to cancel
|
|
*
|
|
* Note! The timer callback may be executing when this function call returns.
|
|
* If you want to ensure that it is not, use qdf_timer_sync_cancel() instead.
|
|
*
|
|
* Return: true if @timer was deactivated, false if @timer was not active
|
|
*/
|
|
static inline bool qdf_timer_stop(qdf_timer_t *timer)
|
|
{
|
|
return __qdf_timer_stop(timer);
|
|
}
|
|
|
|
/**
|
|
* qdf_timer_sync_cancel - Cancel a timer synchronously
|
|
* @timer: timer to cancel
|
|
*
|
|
* If the timer callback is already running, this function blocks until it
|
|
* completes.
|
|
*
|
|
* Return: true if @timer was deactivated, false if @timer was not active
|
|
*/
|
|
static inline bool qdf_timer_sync_cancel(qdf_timer_t *timer)
|
|
{
|
|
return __qdf_timer_sync_cancel(timer);
|
|
}
|
|
|
|
/**
|
|
* qdf_timer_free() - free a timer
|
|
* @timer: timer to free
|
|
*
|
|
* If the timer callback is already running, this function blocks until it
|
|
* completes.
|
|
*
|
|
* Return: none
|
|
*/
|
|
static inline void qdf_timer_free(qdf_timer_t *timer)
|
|
{
|
|
__qdf_timer_free(timer);
|
|
}
|
|
|
|
#endif /* _QDF_TIMER_H */
|