android_kernel_samsung_sm8650-modules/components/son/dispatcher/inc/son_ucfg_api.h

/*
 * Copyright (c) 2021, The Linux Foundation. All rights reserved.
 * Copyright (c) 2021-2022 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 : contains interface prototypes for OS_IF layer
 */
#ifndef _SON_UCFG_API_H_
#define _SON_UCFG_API_H_

#include <qdf_trace.h>
#include <wlan_objmgr_pdev_obj.h>
#include <wlan_mlme_ucfg_api.h>
#include <son_api.h>

/**
 * ucfg_son_get_operation_chan_freq_vdev_id() - get operating chan freq of
 *                                              given vdev id
 * @pdev: Pointer to pdev
 * @vdev_id: vdev id
 *
 * Return: chan freq of given vdev id
 */
qdf_freq_t
ucfg_son_get_operation_chan_freq_vdev_id(struct wlan_objmgr_pdev *pdev,
					 uint8_t vdev_id);

/**
 * ucfg_son_get_min_and_max_power() - get min and max power
 * @psoc: pointer to psoc
 * @max_tx_power: max tx power(dBm units) to get.
 * @min_tx_power: min tx power(dBm units) to get.
 *
 * Return: Void
 */
void ucfg_son_get_min_and_max_power(struct wlan_objmgr_psoc *psoc,
				    int8_t *max_tx_power,
				    int8_t *min_tx_power);

/**
 * ucfg_son_is_cac_in_progress() - whether cac in progress or not
 * @vdev: Pointer to vdev
 *
 * Return: whether vdev in cac or not
 */
bool ucfg_son_is_cac_in_progress(struct wlan_objmgr_vdev *vdev);

/**
 * ucfg_son_get_sta_count() - get sta count
 * @vdev: Pointer to vdev
 *
 * Return: sta count
 */
uint32_t ucfg_son_get_sta_count(struct wlan_objmgr_vdev *vdev);

/**
 * ucfg_son_get_chan_flag() - get chan flag
 * @pdev: pointer to pdev
 * @freq: qdf_freq_t
 * @flag_160: whether 160 band width is enabled or not
 * @chan_params: chan parameters
 *
 * Return: chan flag
 */
uint32_t ucfg_son_get_chan_flag(struct wlan_objmgr_pdev *pdev,
				qdf_freq_t freq, bool flag_160,
				struct ch_params *chan_params);

/**
 * ucfg_son_get_he_supported() - get he supported
 * @psoc: pointer to psoc
 * @he_supported: he supported or not
 *
 * Return: void
 */
#ifdef WLAN_FEATURE_11AX
void ucfg_son_get_he_supported(struct wlan_objmgr_psoc *psoc,
			       bool *he_supported);
#else
static inline void ucfg_son_get_he_supported(struct wlan_objmgr_psoc *psoc,
					     bool *he_supported)
{
	*he_supported = false;
}
#endif /*WLAN_FEATURE_11AX*/

/**
 * ucfg_son_set_peer_kickout_allow() - set the peer is allowed to kickout
 * @vdev: pointer to vdev
 * @peer: pointer to peer
 * @kickout_allow: kickout_allow to set
 *
 * Return: QDF_STATUS_SUCCESS on Success else failure.
 */
QDF_STATUS ucfg_son_set_peer_kickout_allow(struct wlan_objmgr_vdev *vdev,
					   struct wlan_objmgr_peer *peer,
					   bool kickout_allow);

/**
 * ucfg_son_register_deliver_opmode_cb() - register deliver opmode cb
 * psoc: pointer to psoc
 * cb: deliver opmode callback
 *
 * Return: QDF_STATUS_SUCCESS on Success else failure.
 */
QDF_STATUS ucfg_son_register_deliver_opmode_cb(struct wlan_objmgr_psoc *psoc,
					       mlme_deliver_cb cb);

/**
 * ucfg_son_register_deliver_smps_cb() - register deliver smps cb
 * psoc: pointer to psoc
 * cb: deliver smps callback
 *
 * Return: QDF_STATUS_SUCCESS on Success else failure.
 */

QDF_STATUS ucfg_son_register_deliver_smps_cb(struct wlan_objmgr_psoc *psoc,
					     mlme_deliver_cb cb);

/**
 * ucfg_son_cbs_init() - son cbs init
 *
 * Return: 0 if succeed
 */
int ucfg_son_cbs_init(void);

/* ucfg_son_cbs_deinit - son cbs deinit
 *
 * Return: 0 if succeed
 */
int ucfg_son_cbs_deinit(void);

/* ucfg_son_set_cbs() - son cbs set
 * @vdev: pointer to vdev
 * @enable: enable or disable son cbs
 *
 * Return: 0 if succeed
 */
int ucfg_son_set_cbs(struct wlan_objmgr_vdev *vdev,
		     bool enable);

/* ucfg_son_set_cbs_wait_time() - cbs wait time configure
 * @vdev: pointer to vdev
 * @val: wait time value
 *
 * Return: 0 if succeed
 */
int ucfg_son_set_cbs_wait_time(struct wlan_objmgr_vdev *vdev,
			       uint32_t val);

/* ucfg_son_set_cbs_dwell_split_time() - cbs dwell spilt time configure
 * @vdev: pointer to vdev
 * @val: dwell spilt time value
 *
 * Return: 0 if succeed
 */
int ucfg_son_set_cbs_dwell_split_time(struct wlan_objmgr_vdev *vdev,
				      uint32_t val);

/**
 * ucfg_son_get_max_tx_power() - Gets the max transmit power for peer
 * @assoc_req_ies: assoc req ies
 *
 * Return: Returns the max tx power
 */
uint8_t ucfg_son_get_tx_power(struct element_info assoc_req_ies);

/**
 * ucfg_get_max_mcs() - calculate the max mcs supported by the node
 * @mode: current phy mode
 * @supp_idx: max supported idx
 * @ext_idx: max extended idx
 * @ht_mcs_idx: max mcs index for HT
 * @vht_mcs_map: mcs map for VHT
 *
 * Return: max_mcs for the node
 */
uint8_t ucfg_son_get_max_mcs(uint8_t mode, uint8_t supp_idx, uint8_t ext_idx,
			     uint8_t ht_mcs_idx, uint8_t vht_mcs_map);

/**
 * ucfg_son_get_peer_rrm_info() - Get RRM info for peer
 * @assoc_req_ies: assoc req ies
 * @rrmcaps: rrm capabiities
 * @is_beacon_meas_supported: if beacon meas is supported
 *
 * Return: Returns QDF_STATUS_SUCCESS if succeed
 */
QDF_STATUS ucfg_son_get_peer_rrm_info(struct element_info assoc_req_ies,
				      uint8_t *rrmcaps,
				      bool *is_beacon_meas_supported);

/**
 * ucfg_son_vdev_get_supported_txrx_streams() - get supported spatial streams
 * @vdev: pointer to vdev
 * @num_tx_streams: pointer to number of tx streams
 * @num_rx_streams: pointer to number of rx streams
 *
 * Return: QDF_STATUS_SUCCESS on Success else failure.
 */
QDF_STATUS
ucfg_son_vdev_get_supported_txrx_streams(struct wlan_objmgr_vdev *vdev,
					 uint32_t *num_tx_streams,
					 uint32_t *num_rx_streams);
/**
 * ucfg_son_get_vht_cap() - get the vht capability ie
 * @psoc: psoc object
 * @vht_caps: VHT caps bit fields
 *
 * Return: QDF_STATUS_SUCCESS on Success else failure.
 */
QDF_STATUS ucfg_son_get_vht_cap(struct wlan_objmgr_psoc *psoc,
				int32_t *vht_caps);

#ifdef WLAN_FEATURE_SON
/* ucfg_son_disable_cbs() - son cbs disable
 * @vdev: vdev pointer
 *
 * Return: 0 if succeed
 */
int ucfg_son_disable_cbs(struct wlan_objmgr_vdev *vdev);
#else
static inline int ucfg_son_disable_cbs(struct wlan_objmgr_vdev *vdev)
{
	return -EINVAL;
}
#endif
#endif