Files
android_kernel_samsung_sm86…/spectral/dispatcher/inc/wlan_spectral_ucfg_api.h
Wu Gao 80df191a1a qcacmn: Add API to get spectral version
Since struct spectral_samp_msg may be modified, so provide API to get
version information, then spectraltool can compatible with different
host based on version information.

Change-Id: If68dbd0d85b28f46056208d849fe2db4faea493a
CRs-Fixed: 2575818
2020-07-27 09:03:49 -07:00

102 lines
3.4 KiB
C

/*
* Copyright (c) 2017-2020 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.
*/
#ifndef _WLAN_SPECTRAL_UCFG_API_H_
#define _WLAN_SPECTRAL_UCFG_API_H_
#include <wlan_objmgr_cmn.h>
#include <wlan_spectral_public_structs.h>
/* Spectral specific UCFG set operations */
/**
* ucfg_spectral_control() - Carry out Spectral control operations
* @pdev: Pointer to pdev
* @sscan_req: spectral related control request
*
* Carry out Spectral specific UCFG control get/set operations
*
* Return: 0 on success, negative value on failure
*/
QDF_STATUS ucfg_spectral_control(struct wlan_objmgr_pdev *pdev,
struct spectral_cp_request *sscan_req);
/**
* ucfg_spectral_scan_set_ppid() - configure pid of spectral tool
* @pdev: Pointer to pdev
* @ppid: Spectral tool pid
*
* Configure pid of spectral tool
*
* Return: None
*/
void ucfg_spectral_scan_set_ppid(struct wlan_objmgr_pdev *pdev,
uint32_t ppid);
/**
* ucfg_spectral_create_cp_req() - Create Spectral control path request
* @sscan_req: Pointer to Spectral scan request
* @indata: pointer input data
* @insize: Size of input data
*
* Create Spectral control path request structure
*
* Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_FAILURE on failure
*/
QDF_STATUS ucfg_spectral_create_cp_req(struct spectral_cp_request *sscan_req,
void *indata, u_int32_t insize);
/**
* ucfg_spectral_create_cp_req() - Extract response from Spectral CP request
* @sscan_req: Pointer to Spectral scan request
* @outdata: pointer output data
* @outsize: Size of output data
*
* Extract response from Spectral control path request
*
* Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_FAILURE on failure
*/
QDF_STATUS ucfg_spectral_extract_response(struct spectral_cp_request *sscan_req,
void *outdata, u_int32_t *outsize);
/**
* ucfg_spectral_register_to_dbr() - Register spectral to DBR
* @pdev: Pointer to pdev object
*
* Register spectral to Direct Buffer RX component
*
* Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_FAILURE on failure
*/
QDF_STATUS ucfg_spectral_register_to_dbr(struct wlan_objmgr_pdev *pdev);
/**
* ucfg_spectral_get_version() - ucfg API to get spectral version
* @pdev: Pointer to pdev object
* @version: Pointer to return version
* @sub_version: Pointer to return sub version
*
* Since struct spectral_samp_msg may be modified, so provide API to get
* version information and make sure spectraltool compatible with host.
*
* Return: QDF_STATUS_SUCCESS on success, QDF_STATUS_E_FAILURE on failure
*/
QDF_STATUS ucfg_spectral_get_version(struct wlan_objmgr_pdev *pdev,
uint32_t *version, uint32_t *sub_version);
#endif /* _WLAN_SPECTRAL_UCFG_API_H_ */