|
|
@@ -1,6 +1,6 @@
|
|
|
/*
|
|
|
* Copyright (c) 2012-2021 The Linux Foundation. All rights reserved.
|
|
|
- * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
|
|
|
+ * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. 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
|
|
|
@@ -20,17 +20,11 @@
|
|
|
#ifndef __CDS_SCHED_H
|
|
|
#define __CDS_SCHED_H
|
|
|
|
|
|
-/**=========================================================================
|
|
|
-
|
|
|
- \file cds_sched.h
|
|
|
-
|
|
|
- \brief Connectivity driver services scheduler
|
|
|
-
|
|
|
- ========================================================================*/
|
|
|
+/**
|
|
|
+ * DOC: cds_sched.h
|
|
|
+ * Connectivity driver services scheduler
|
|
|
+ */
|
|
|
|
|
|
-/*--------------------------------------------------------------------------
|
|
|
- Include Files
|
|
|
- ------------------------------------------------------------------------*/
|
|
|
#include <qdf_event.h>
|
|
|
#include <i_qdf_types.h>
|
|
|
#include <linux/wait.h>
|
|
|
@@ -231,12 +225,33 @@ struct cds_context {
|
|
|
Function declarations and documentation
|
|
|
---------------------------------------------------------------------------*/
|
|
|
#ifdef QCA_CONFIG_SMP
|
|
|
+
|
|
|
+/**
|
|
|
+ * cds_sched_handle_cpu_hot_plug() - cpu hotplug event handler
|
|
|
+ *
|
|
|
+ * cpu hotplug indication handler
|
|
|
+ * will find online cores and will assign proper core based on perf requirement
|
|
|
+ *
|
|
|
+ * Return: 0 success
|
|
|
+ * 1 fail
|
|
|
+ */
|
|
|
int cds_sched_handle_cpu_hot_plug(void);
|
|
|
+
|
|
|
+/**
|
|
|
+ * cds_sched_handle_throughput_req() - cpu throughput requirement handler
|
|
|
+ * @high_tput_required: high throughput is required or not
|
|
|
+ *
|
|
|
+ * high or low throughput indication handler
|
|
|
+ * will find online cores and will assign proper core based on perf requirement
|
|
|
+ *
|
|
|
+ * Return: 0 success
|
|
|
+ * 1 fail
|
|
|
+ */
|
|
|
int cds_sched_handle_throughput_req(bool high_tput_required);
|
|
|
|
|
|
/**
|
|
|
- * cds_sched_handle_rx_thread_affinity_req - rx thread affinity req handler
|
|
|
- * @high_tput_required: high throughput is required or not
|
|
|
+ * cds_sched_handle_rx_thread_affinity_req() - rx thread affinity req handler
|
|
|
+ * @high_throughput: high throughput is required or not
|
|
|
*
|
|
|
* rx thread affinity handler will find online cores and
|
|
|
* will assign proper core based on perf requirement
|
|
|
@@ -261,28 +276,28 @@ void cds_set_rx_thread_ul_cpu_mask(uint8_t cpu_affinity_mask);
|
|
|
*/
|
|
|
void cds_set_rx_thread_cpu_mask(uint8_t cpu_affinity_mask);
|
|
|
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
- \brief cds_drop_rxpkt_by_staid() - API to drop pending Rx packets for a sta
|
|
|
- The \a cds_drop_rxpkt_by_staid() drops queued packets for a station, to drop
|
|
|
- all the pending packets the caller has to send WLAN_MAX_STA_COUNT as staId.
|
|
|
- \param pSchedContext - pointer to the global CDS Sched Context
|
|
|
- \param staId - Station Id
|
|
|
-
|
|
|
- \return Nothing
|
|
|
- \sa cds_drop_rxpkt_by_staid()
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
+/**
|
|
|
+ * cds_drop_rxpkt_by_staid() - api to drop pending rx packets for a sta
|
|
|
+ * @pSchedContext: Pointer to the global CDS Sched Context
|
|
|
+ * @staId: Station Id
|
|
|
+ *
|
|
|
+ * This api drops queued packets for a station, to drop all the pending
|
|
|
+ * packets the caller has to send WLAN_MAX_STA_COUNT as staId.
|
|
|
+ *
|
|
|
+ * Return: none
|
|
|
+ */
|
|
|
void cds_drop_rxpkt_by_staid(p_cds_sched_context pSchedContext, uint16_t staId);
|
|
|
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
- \brief cds_indicate_rxpkt() - API to Indicate rx data packet
|
|
|
- The \a cds_indicate_rxpkt() enqueues the rx packet onto ol_rx_thread_queue
|
|
|
- and notifies cds_ol_rx_thread().
|
|
|
- \param Arg - pointer to the global CDS Sched Context
|
|
|
- \param pkt - Vos data message buffer
|
|
|
-
|
|
|
- \return Nothing
|
|
|
- \sa cds_indicate_rxpkt()
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
+/**
|
|
|
+ * cds_indicate_rxpkt() - indicate rx data packet
|
|
|
+ * @pSchedContext: Pointer to the global CDS Sched Context
|
|
|
+ * @pkt: CDS data message buffer
|
|
|
+ *
|
|
|
+ * This api enqueues the rx packet into ol_rx_thread_queue and notifies
|
|
|
+ * cds_ol_rx_thread()
|
|
|
+ *
|
|
|
+ * Return: none
|
|
|
+ */
|
|
|
void cds_indicate_rxpkt(p_cds_sched_context pSchedContext,
|
|
|
struct cds_ol_rx_pkt *pkt);
|
|
|
|
|
|
@@ -295,142 +310,76 @@ void cds_indicate_rxpkt(p_cds_sched_context pSchedContext,
|
|
|
*/
|
|
|
QDF_STATUS cds_close_rx_thread(void);
|
|
|
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
- \brief cds_alloc_ol_rx_pkt() - API to return next available cds message
|
|
|
- The \a cds_alloc_ol_rx_pkt() returns next available cds message buffer
|
|
|
- used for Rx Data processing.
|
|
|
- \param pSchedContext - pointer to the global CDS Sched Context
|
|
|
-
|
|
|
- \return pointer to cds message buffer
|
|
|
- \sa cds_alloc_ol_rx_pkt()
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
-struct cds_ol_rx_pkt *cds_alloc_ol_rx_pkt(p_cds_sched_context pSchedContext);
|
|
|
-
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
- \brief cds_free_ol_rx_pkt() - API to release cds message to the freeq
|
|
|
- The \a cds_free_ol_rx_pkt() returns the cds message used for Rx data
|
|
|
- to the free queue.
|
|
|
- \param pSchedContext - pointer to the global CDS Sched Context
|
|
|
- \param pkt - Vos message buffer to be returned to free queue.
|
|
|
-
|
|
|
- \return Nothing
|
|
|
- \sa cds_free_ol_rx_pkt()
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
-void cds_free_ol_rx_pkt(p_cds_sched_context pSchedContext,
|
|
|
- struct cds_ol_rx_pkt *pkt);
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
- \brief cds_free_ol_rx_pkt_freeq() - Free cdss buffer free queue
|
|
|
- The \a cds_free_ol_rx_pkt_freeq() does mem free of the buffers
|
|
|
- available in free cds buffer queue which is used for Data rx processing
|
|
|
- from Tlshim.
|
|
|
- \param pSchedContext - pointer to the global CDS Sched Context
|
|
|
-
|
|
|
- \return Nothing
|
|
|
- \sa cds_free_ol_rx_pkt_freeq()
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
-void cds_free_ol_rx_pkt_freeq(p_cds_sched_context pSchedContext);
|
|
|
-#else
|
|
|
/**
|
|
|
- * cds_sched_handle_rx_thread_affinity_req - rx thread affinity req handler
|
|
|
- * @high_tput_required: high throughput is required or not
|
|
|
+ * cds_alloc_ol_rx_pkt() - API to return next available cds message
|
|
|
+ * @pSchedContext: Pointer to the global CDS Sched Context
|
|
|
*
|
|
|
- * rx thread affinity handler will find online cores and
|
|
|
- * will assign proper core based on perf requirement
|
|
|
+ * This api returns next available cds message buffer used for rx data
|
|
|
+ * processing
|
|
|
*
|
|
|
- * Return: None
|
|
|
+ * Return: Pointer to cds message buffer
|
|
|
*/
|
|
|
-static inline void cds_sched_handle_rx_thread_affinity_req(
|
|
|
- bool high_throughput) {}
|
|
|
+struct cds_ol_rx_pkt *cds_alloc_ol_rx_pkt(p_cds_sched_context pSchedContext);
|
|
|
|
|
|
/**
|
|
|
- * cds_set_rx_thread_ul_cpu_mask() - Rx_thread affinity for UL from INI
|
|
|
- * @cpu_affinity_mask: CPU affinity bitmap
|
|
|
+ * cds_free_ol_rx_pkt() - api to release cds message to the freeq
|
|
|
+ * @pSchedContext: Pointer to the global CDS Sched Context
|
|
|
+ * @pkt: CDS message buffer to be returned to free queue.
|
|
|
*
|
|
|
- * Return:None
|
|
|
- */
|
|
|
-static inline void cds_set_rx_thread_ul_cpu_mask(uint8_t cpu_affinity_mask) {}
|
|
|
-
|
|
|
-/**
|
|
|
- * cds_set_rx_thread_cpu_mask() - Rx_thread affinity from INI
|
|
|
- * @cpu_affinity_mask: CPU affinity bitmap
|
|
|
+ * This api returns the cds message used for Rx data to the free queue
|
|
|
*
|
|
|
- * Return:None
|
|
|
+ * Return: none
|
|
|
*/
|
|
|
-static inline void cds_set_rx_thread_cpu_mask(uint8_t cpu_affinity_mask) {}
|
|
|
+void cds_free_ol_rx_pkt(p_cds_sched_context pSchedContext,
|
|
|
+ struct cds_ol_rx_pkt *pkt);
|
|
|
|
|
|
/**
|
|
|
- * cds_drop_rxpkt_by_staid() - api to drop pending rx packets for a sta
|
|
|
- * @pSchedContext: Pointer to the global CDS Sched Context
|
|
|
- * @staId: Station Id
|
|
|
+ * cds_free_ol_rx_pkt_freeq() - free cds buffer free queue
|
|
|
+ * @pSchedContext: pointer to the global CDS Sched Context
|
|
|
*
|
|
|
- * This api drops queued packets for a station, to drop all the pending
|
|
|
- * packets the caller has to send WLAN_MAX_STA_COUNT as staId.
|
|
|
+ * This API does mem free of the buffers available in free cds buffer
|
|
|
+ * queue which is used for Data rx processing.
|
|
|
*
|
|
|
* Return: none
|
|
|
*/
|
|
|
+void cds_free_ol_rx_pkt_freeq(p_cds_sched_context pSchedContext);
|
|
|
+#else
|
|
|
+static inline void cds_sched_handle_rx_thread_affinity_req(
|
|
|
+ bool high_throughput) {}
|
|
|
+
|
|
|
+static inline void cds_set_rx_thread_ul_cpu_mask(uint8_t cpu_affinity_mask) {}
|
|
|
+
|
|
|
+static inline void cds_set_rx_thread_cpu_mask(uint8_t cpu_affinity_mask) {}
|
|
|
+
|
|
|
static inline
|
|
|
void cds_drop_rxpkt_by_staid(p_cds_sched_context pSchedContext, uint16_t staId)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
-/**
|
|
|
- * cds_indicate_rxpkt() - API to Indicate rx data packet
|
|
|
- * @pSchedContext: pointer to CDS Sched Context
|
|
|
- * @pkt: CDS OL RX pkt pointer containing to RX data message buffer
|
|
|
- *
|
|
|
- * Return: none
|
|
|
- */
|
|
|
static inline
|
|
|
void cds_indicate_rxpkt(p_cds_sched_context pSchedContext,
|
|
|
struct cds_ol_rx_pkt *pkt)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
-/**
|
|
|
- * cds_close_rx_thread() - close the Rx thread
|
|
|
- *
|
|
|
- * This api closes the Rx thread:
|
|
|
- *
|
|
|
- * Return: qdf status
|
|
|
- */
|
|
|
static inline
|
|
|
QDF_STATUS cds_close_rx_thread(void)
|
|
|
{
|
|
|
return QDF_STATUS_SUCCESS;
|
|
|
}
|
|
|
|
|
|
-/**
|
|
|
- * cds_alloc_ol_rx_pkt() - API to return next available cds message
|
|
|
- * @pSchedContext: pointer to CDS Sched Context
|
|
|
- *
|
|
|
- * Return: none
|
|
|
- */
|
|
|
static inline
|
|
|
struct cds_ol_rx_pkt *cds_alloc_ol_rx_pkt(p_cds_sched_context pSchedContext)
|
|
|
{
|
|
|
return NULL;
|
|
|
}
|
|
|
|
|
|
-/**
|
|
|
- * cds_free_ol_rx_pkt() - API to release cds message to the freeq
|
|
|
- * @pSchedContext: pointer to CDS Sched Context
|
|
|
- * @pkt: CDS message buffer to be returned to free queue
|
|
|
- *
|
|
|
- * Return: none
|
|
|
- */
|
|
|
static inline
|
|
|
void cds_free_ol_rx_pkt(p_cds_sched_context pSchedContext,
|
|
|
struct cds_ol_rx_pkt *pkt)
|
|
|
{
|
|
|
}
|
|
|
|
|
|
-/**
|
|
|
- * cds_free_ol_rx_pkt_freeq() - Free cds buffer free queue
|
|
|
- * @pSchedContext: pointer to CDS Sched Context
|
|
|
- * @pkt: CDS message buffer to be returned to free queue
|
|
|
- *
|
|
|
- * Return: none
|
|
|
- */
|
|
|
static inline
|
|
|
void cds_free_ol_rx_pkt_freeq(p_cds_sched_context pSchedContext)
|
|
|
{
|
|
|
@@ -444,82 +393,69 @@ static inline int cds_sched_handle_throughput_req(
|
|
|
|
|
|
#endif
|
|
|
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
-
|
|
|
- \brief cds_sched_open() - initialize the CDS Scheduler
|
|
|
-
|
|
|
- The \a cds_sched_open() function initializes the CDS Scheduler
|
|
|
- Upon successful initialization:
|
|
|
-
|
|
|
- - All the message queues are initialized
|
|
|
-
|
|
|
- - The Main Controller thread is created and ready to receive and
|
|
|
- dispatch messages.
|
|
|
-
|
|
|
- - The Tx thread is created and ready to receive and dispatch messages
|
|
|
-
|
|
|
- \param p_cds_context - pointer to the global QDF Context
|
|
|
-
|
|
|
- \param p_cds_sched_context - pointer to a previously allocated buffer big
|
|
|
- enough to hold a scheduler context.
|
|
|
-
|
|
|
- \return QDF_STATUS_SUCCESS - Scheduler was successfully initialized and
|
|
|
- is ready to be used.
|
|
|
-
|
|
|
- QDF_STATUS_E_RESOURCES - System resources (other than memory)
|
|
|
- are unavailable to initialize the scheduler
|
|
|
-
|
|
|
- QDF_STATUS_E_NOMEM - insufficient memory exists to initialize
|
|
|
- the scheduler
|
|
|
-
|
|
|
- QDF_STATUS_E_INVAL - Invalid parameter passed to the scheduler Open
|
|
|
- function
|
|
|
-
|
|
|
- QDF_STATUS_E_FAILURE - Failure to initialize the scheduler/
|
|
|
-
|
|
|
- \sa cds_sched_open()
|
|
|
-
|
|
|
- -------------------------------------------------------------------------*/
|
|
|
+/**
|
|
|
+ * cds_sched_open() - initialize the CDS Scheduler
|
|
|
+ * @p_cds_context: Pointer to the global CDS Context
|
|
|
+ * @pSchedContext: Pointer to a previously allocated buffer big
|
|
|
+ * enough to hold a scheduler context.
|
|
|
+ * @SchedCtxSize: CDS scheduler context size
|
|
|
+ *
|
|
|
+ * This function initializes the CDS Scheduler
|
|
|
+ * Upon successful initialization:
|
|
|
+ * - All the message queues are initialized
|
|
|
+ * - The Main Controller thread is created and ready to receive and
|
|
|
+ * dispatch messages.
|
|
|
+ *
|
|
|
+ *
|
|
|
+ * Return: QDF status
|
|
|
+ */
|
|
|
QDF_STATUS cds_sched_open(void *p_cds_context,
|
|
|
- p_cds_sched_context pSchedCxt, uint32_t SchedCtxSize);
|
|
|
-
|
|
|
-/*---------------------------------------------------------------------------
|
|
|
-
|
|
|
- \brief cds_sched_close() - Close the CDS Scheduler
|
|
|
-
|
|
|
- The \a cds_sched_closes() function closes the CDS Scheduler
|
|
|
- Upon successful closing:
|
|
|
-
|
|
|
- - All the message queues are flushed
|
|
|
-
|
|
|
- - The Main Controller thread is closed
|
|
|
-
|
|
|
- - The Tx thread is closed
|
|
|
-
|
|
|
- \return QDF_STATUS_SUCCESS - Scheduler was successfully initialized and
|
|
|
- is ready to be used.
|
|
|
-
|
|
|
- QDF_STATUS_E_INVAL - Invalid parameter passed to the scheduler Open
|
|
|
- function
|
|
|
-
|
|
|
- QDF_STATUS_E_FAILURE - Failure to initialize the scheduler/
|
|
|
+ p_cds_sched_context pSchedContext,
|
|
|
+ uint32_t SchedCtxSize);
|
|
|
|
|
|
- \sa cds_sched_close()
|
|
|
-
|
|
|
- ---------------------------------------------------------------------------*/
|
|
|
+/**
|
|
|
+ * cds_sched_close() - close the cds scheduler
|
|
|
+ *
|
|
|
+ * This api closes the CDS Scheduler upon successful closing:
|
|
|
+ * - All the message queues are flushed
|
|
|
+ * - The Main Controller thread is closed
|
|
|
+ * - The Tx thread is closed
|
|
|
+ *
|
|
|
+ *
|
|
|
+ * Return: qdf status
|
|
|
+ */
|
|
|
QDF_STATUS cds_sched_close(void);
|
|
|
|
|
|
+/**
|
|
|
+ * get_cds_sched_ctxt() - get cds scheduler context
|
|
|
+ *
|
|
|
+ * Return: cds scheduler context
|
|
|
+ */
|
|
|
p_cds_sched_context get_cds_sched_ctxt(void);
|
|
|
|
|
|
void qdf_timer_module_init(void);
|
|
|
void qdf_timer_module_deinit(void);
|
|
|
+
|
|
|
+/**
|
|
|
+ * cds_ssr_protect_init() - initialize ssr protection debug functionality
|
|
|
+ *
|
|
|
+ * Return:
|
|
|
+ * void
|
|
|
+ */
|
|
|
void cds_ssr_protect_init(void);
|
|
|
+
|
|
|
+/**
|
|
|
+ * cds_get_gfp_flags(): get GFP flags
|
|
|
+ *
|
|
|
+ * Based on the scheduled context, return GFP flags
|
|
|
+ * Return: gfp flags
|
|
|
+ */
|
|
|
int cds_get_gfp_flags(void);
|
|
|
|
|
|
/**
|
|
|
* cds_shutdown_notifier_register() - Register for shutdown notification
|
|
|
- * @cb : Call back to be called
|
|
|
- * @priv : Private pointer to be passed back to call back
|
|
|
+ * @cb: Call back to be called
|
|
|
+ * @priv: Private pointer to be passed back to call back
|
|
|
*
|
|
|
* During driver remove or shutdown (recovery), external threads might be stuck
|
|
|
* waiting on some event from firmware at lower layers. Remove or shutdown can't
|
|
|
@@ -529,7 +465,7 @@ int cds_get_gfp_flags(void);
|
|
|
* further as waiting there may not make sense when FW may already have been
|
|
|
* down.
|
|
|
*
|
|
|
- * Return: CDS status
|
|
|
+ * Return: QDF status
|
|
|
*/
|
|
|
QDF_STATUS cds_shutdown_notifier_register(void (*cb)(void *priv), void *priv);
|
|
|
|
Jeff Johnson