xref: /wlan-driver/qca-wifi-host-cmn/dp/inc/cdp_txrx_mon.h (revision 5113495b16420b49004c444715d2daae2066e7dc)

/*
 * Copyright (c) 2016-2021 The Linux Foundation. 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
 * 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: cdp_txrx_mon.h
 * Define the monitor mode API functions
 * called by the host control SW and the OS interface module
 */

#ifndef _CDP_TXRX_MON_H_
#define _CDP_TXRX_MON_H_
#include "cdp_txrx_handle.h"
#include <cdp_txrx_cmn.h>

static inline QDF_STATUS cdp_reset_monitor_mode(ol_txrx_soc_handle soc,
						uint8_t pdev_id,
						u_int8_t smart_monitor)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		QDF_BUG(0);
		return 0;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_reset_monitor_mode)
		return 0;

	return soc->ops->mon_ops->txrx_reset_monitor_mode(soc, pdev_id,
							  smart_monitor);
}

/**
 * cdp_deliver_tx_mgmt() - Deliver mgmt frame for tx capture
 * @soc: Datapath SOC handle
 * @pdev_id: id of datapath PDEV handle
 * @nbuf: Management frame buffer
 */
static inline QDF_STATUS
cdp_deliver_tx_mgmt(ol_txrx_soc_handle soc, uint8_t pdev_id,
		    qdf_nbuf_t nbuf)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		QDF_BUG(0);
		return QDF_STATUS_E_FAILURE;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_deliver_tx_mgmt)
		return QDF_STATUS_E_FAILURE;

	return soc->ops->mon_ops->txrx_deliver_tx_mgmt(soc, pdev_id, nbuf);
}

#ifdef QCA_SUPPORT_LITE_MONITOR
/**
 * cdp_set_lite_mon_config() - Set lite monitor config/filter
 *
 * @soc: dp soc handle
 * @config: lite monitor config
 * @pdev_id: pdev id
 *
 * This API is used to enable/disable lite monitor feature
 *
 * Return: QDF_STATUS_SUCCESS if value set successfully
 *         QDF_STATUS_E_INVAL false if error
 */
static inline QDF_STATUS
cdp_set_lite_mon_config(ol_txrx_soc_handle soc,
			struct cdp_lite_mon_filter_config *config,
			uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_INVAL;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_set_lite_mon_config)
		return QDF_STATUS_E_INVAL;

	return soc->ops->mon_ops->txrx_set_lite_mon_config(soc, config,
							   pdev_id);
}

/**
 * cdp_get_lite_mon_config() - Get lite monitor config
 *
 * @soc: dp soc handle
 * @config: lite monitor config
 * @pdev_id: pdev id
 *
 * This API is used to get lite monitor feature config
 *
 * Return: QDF_STATUS_SUCCESS if get is successfully
 *         QDF_STATUS_E_INVAL false if error
 */
static inline QDF_STATUS
cdp_get_lite_mon_config(ol_txrx_soc_handle soc,
			struct cdp_lite_mon_filter_config *config,
			uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_INVAL;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_get_lite_mon_config)
		return QDF_STATUS_E_INVAL;

	return soc->ops->mon_ops->txrx_get_lite_mon_config(soc, config,
							   pdev_id);
}

/**
 * cdp_set_lite_mon_peer_config() - Set lite monitor peer config
 *
 * @soc: dp soc handle
 * @config: lite monitor peer config
 * @pdev_id: pdev id
 *
 * This API is used to add/del lite monitor peers
 *
 * Return: QDF_STATUS_SUCCESS if value set successfully
 *         QDF_STATUS_E_INVAL false if error
 */
static inline QDF_STATUS
cdp_set_lite_mon_peer_config(ol_txrx_soc_handle soc,
			     struct cdp_lite_mon_peer_config *config,
			     uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_INVAL;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_set_lite_mon_peer_config)
		return QDF_STATUS_E_INVAL;

	return soc->ops->mon_ops->txrx_set_lite_mon_peer_config(soc, config,
								pdev_id);
}

/**
 * cdp_get_lite_mon_peer_config() - Get lite monitor peer list
 *
 * @soc: dp soc handle
 * @info: lite monitor peer info
 * @pdev_id: pdev id
 *
 * This API is used to get lite monitor peers
 *
 * Return: QDF_STATUS_SUCCESS if value set successfully
 *         QDF_STATUS_E_INVAL false if error
 */
static inline QDF_STATUS
cdp_get_lite_mon_peer_config(ol_txrx_soc_handle soc,
			     struct cdp_lite_mon_peer_info *info,
			     uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_INVAL;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_get_lite_mon_peer_config)
		return QDF_STATUS_E_INVAL;

	return soc->ops->mon_ops->txrx_get_lite_mon_peer_config(soc, info,
								pdev_id);
}

/**
 * cdp_is_lite_mon_enabled() - Get lite monitor enable status
 *
 * @soc: dp soc handle
 * @pdev_id: pdev id
 * @dir: direction tx/rx
 *
 * This API is used to get lite monitor enable status
 *
 * Return: 0 if disabled
 *         1 if enabled
 */
static inline int
cdp_is_lite_mon_enabled(ol_txrx_soc_handle soc,
			uint8_t pdev_id, uint8_t dir)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return 0;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_is_lite_mon_enabled)
		return 0;

	return soc->ops->mon_ops->txrx_is_lite_mon_enabled(soc, pdev_id, dir);
}

/*
 * cdp_get_lite_mon_legacy_feature_enabled() - Get the legacy feature enabled
 *
 * @soc: dp soc handle
 * @pdev_id: pdev id
 * @dir: direction tx/rx
 *
 *  This API is used to get the legacy feature enabled using lite_mon
 *
 * Return: legacy feature enabled
 */
static inline int
cdp_get_lite_mon_legacy_feature_enabled(ol_txrx_soc_handle soc,
					uint8_t pdev_id, uint8_t dir)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return 0;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_get_lite_mon_legacy_feature_enabled)
		return 0;

	return soc->ops->mon_ops->txrx_get_lite_mon_legacy_feature_enabled(soc,
									   pdev_id,
									   dir);
}
#endif

#ifdef QCA_RSSI_DB2DBM
/**
 * cdp_set_params_rssi_dbm_conversion - Set the rssi dbm conversion params
 *					into dp_pdev structure
 * @soc: soc txrx handler
 * @params: cdp_rssi_db2dbm_param_dp pointer
 *
 */
static inline QDF_STATUS
cdp_set_params_rssi_dbm_conversion(ol_txrx_soc_handle soc,
				   struct cdp_rssi_db2dbm_param_dp *params)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance:");
		QDF_BUG(0);
		return QDF_STATUS_E_FAILURE;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_set_mon_pdev_params_rssi_dbm_conv)
		return QDF_STATUS_E_FAILURE;

	return soc->ops->mon_ops->txrx_set_mon_pdev_params_rssi_dbm_conv
							    (soc, params);
}
#endif

#ifdef WLAN_CONFIG_TELEMETRY_AGENT
/*
 * cdp_update_pdev_mon_telemetry_airtime_stats() - update telemetry airtime
 * stats in monitor pdev
 *
 *@soc: dp soc handle
 *@pdev_id: pdev id
 *
 * This API is used to update telemetry airtime stats in monitor pdev
 *
 * Return: Success if stats are updated, else failure
 */
static inline QDF_STATUS
cdp_update_pdev_mon_telemetry_airtime_stats(ol_txrx_soc_handle soc,
					    uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_FAILURE;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->txrx_update_pdev_mon_telemetry_airtime_stats)
		return QDF_STATUS_E_FAILURE;

	return soc->ops->mon_ops->txrx_update_pdev_mon_telemetry_airtime_stats(
						soc, pdev_id);
}
#endif

#ifdef WLAN_FEATURE_LOCAL_PKT_CAPTURE
/**
 * cdp_start_local_pkt_capture() - start local pkt capture
 * @soc: opaque soc handle
 * @pdev_id: pdev id
 * @filter: monitor filter config
 *
 * Return: QDF_STATUS_SUCCESS if success
 *         QDF_STATUS_E_FAILURE if error
 */
static inline
QDF_STATUS cdp_start_local_pkt_capture(ol_txrx_soc_handle soc,
				       uint8_t pdev_id,
				       struct cdp_monitor_filter *filter)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		return QDF_STATUS_E_FAILURE;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->start_local_pkt_capture)
		return QDF_STATUS_E_FAILURE;

	return soc->ops->mon_ops->start_local_pkt_capture(soc, pdev_id, filter);
}

/**
 * cdp_stop_local_pkt_capture() - stop local pkt capture
 * @soc: opaque soc handle
 * @pdev_id: pdev_id
 *
 * Return: QDF_STATUS_SUCCESS if success
 *         QDF_STATUS_E_FAILURE if error
 */
static inline
QDF_STATUS cdp_stop_local_pkt_capture(ol_txrx_soc_handle soc, uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		QDF_BUG(0);
		return QDF_STATUS_E_FAILURE;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->stop_local_pkt_capture)
		return QDF_STATUS_E_FAILURE;

	return soc->ops->mon_ops->stop_local_pkt_capture(soc, pdev_id);
}

/**
 * cdp_is_local_pkt_capture_running() - get is local packet capture running
 * @soc: opaque soc handle
 * @pdev_id: pdev id
 *
 * Return: true if running
 *         false if not running
 */
static inline
bool cdp_is_local_pkt_capture_running(ol_txrx_soc_handle soc, uint8_t pdev_id)
{
	if (!soc || !soc->ops) {
		dp_cdp_debug("Invalid Instance");
		QDF_BUG(0);
		return false;
	}

	if (!soc->ops->mon_ops ||
	    !soc->ops->mon_ops->is_local_pkt_capture_running)
		return false;

	return soc->ops->mon_ops->is_local_pkt_capture_running(soc, pdev_id);
}
#else
static inline
QDF_STATUS cdp_start_local_pkt_capture(ol_txrx_soc_handle soc,
				       uint8_t pdev_id,
				       struct cdp_monitor_filter *filter)
{
	return QDF_STATUS_E_NOSUPPORT;
}

static inline
QDF_STATUS cdp_stop_local_pkt_capture(ol_txrx_soc_handle soc, uint8_t pdev_id)
{
	return QDF_STATUS_E_NOSUPPORT;
}

static inline
bool cdp_is_local_pkt_capture_running(ol_txrx_soc_handle soc, uint8_t pdev_id)
{
	return false;
}
#endif /* WLAN_FEATURE_LOCAL_PKT_CAPTURE */

#endif