Files
android_kernel_samsung_sm86…/os_if/qmi/inc/os_if_qmi.h
Ananya Gupta 605019d3b1 qcacld-3.0: API to send UT commands to LPASS using QMI
Add API to send unit test commands using QMI messages
to generate direct link traffic from LPASS.

Change-Id: I68b69303ef715677f6056c1f6c4d336466720f45
CRs-Fixed: 3362513
2023-01-11 03:46:43 -08:00

274 baris
7.2 KiB
C

/*
* 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: os_if_qmi.h
*
* This file contains declarations for wrapper APIs for QMI HLOS APIs
*/
#ifndef _OS_IF_QMI_H_
#define _OS_IF_QMI_H_
#include "wlan_qmi_public_struct.h"
#include <qdf_types.h>
#include <linux/soc/qcom/qmi.h>
#include <linux/net.h>
#include <linux/types.h>
#include "wlan_cfg80211.h"
#include "wlan_objmgr_psoc_obj.h"
#include <qdf_time.h>
#define QMI_WFDS_MAX_RECV_BUF_SIZE 4096
#define QMI_WFDS_SERVICE_INS_ID_V01 0x0
#define QMI_WFDS_TIMEOUT_MS 10000
#define QMI_WFDS_TIMEOUT_JF \
qdf_system_msecs_to_ticks(QMI_WFDS_TIMEOUT_MS)
/**
* enum os_if_qmi_wfds_ut_cmd_type - WFDS unit test command type
* @WFDS_STOP_TRAFFIC: Stop WFDS traffic
* @WFDS_START_TRAFFIC: Start WFDS Traffic
* @WFDS_GET_STATS: Get WFDS traffic stats
*/
enum os_if_qmi_wfds_ut_cmd_type {
WFDS_STOP_TRAFFIC,
WFDS_START_TRAFFIC,
WFDS_GET_STATS
};
/**
* struct os_if_qmi_wfds_ut_cmd_info - WFDS UT cmd info structure
* @cmd: Command type
* @duration: Traffic duration
* @num_pkts: Buffers per flush
* @flush_period: Buffer flushing periodicity
* @buf_size: Buffer size
* @ether_type: ether_type of packet
* @dest_mac: Destination MAC address
* @src_mac: Source MAC address
*/
struct os_if_qmi_wfds_ut_cmd_info {
enum os_if_qmi_wfds_ut_cmd_type cmd;
uint32_t duration;
uint32_t flush_period;
uint32_t num_pkts;
uint32_t buf_size;
uint16_t ether_type;
struct qdf_mac_addr src_mac;
struct qdf_mac_addr dest_mac;
};
#ifdef QMI_COMPONENT_ENABLE
/**
* os_if_qmi_handle_init() - Initialize QMI handle
* @qmi_hdl: QMI handle to initialize
* @recv_buf_size: maximum size of incoming message
* @ops: reference to callbacks for QRTR notifications
* @qmi_msg_handlers: NULL-terminated list of QMI message handlers
*
* Returns: QDF status
*/
QDF_STATUS
os_if_qmi_handle_init(struct qmi_handle *qmi_hdl, qdf_size_t recv_buf_size,
const struct qmi_ops *ops,
const struct qmi_msg_handler *qmi_msg_handlers);
/**
* os_if_qmi_handle_release() - Release QMI handle
* @qmi_hdl: QMI handle to release
*
* Returns: None
*/
void os_if_qmi_handle_release(struct qmi_handle *qmi_hdl);
/**
* os_if_qmi_add_lookup() - Register a new lookup with the name service
* @qmi_hdl: QMI handle
* @service: service id of the request
* @instance: instance id of the request
* @version: version number of the request
*
* Return: QDF status
*/
QDF_STATUS os_if_qmi_add_lookup(struct qmi_handle *qmi_hdl,
unsigned int service, unsigned int version,
unsigned int instance);
/**
* os_if_qmi_connect_to_svc() - Connect to QMI service
* @qmi_hdl: QMI handle
* @qmi_svc: QMI service handle
*
* Return: QDF status
*/
QDF_STATUS os_if_qmi_connect_to_svc(struct qmi_handle *qmi_hdl,
struct qmi_service *qmi_svc);
/**
* os_if_qmi_txn_init() - Initialize QMI transaction
* @qmi_hdl: QMI handle
* @qmi_txn: QMI transaction handle
* @qmi_ei: description of how to decode a matching response (optional)
* @resp: pointer to the object to decode the response into (optional)
*
* Return: QDF status
*/
QDF_STATUS os_if_qmi_txn_init(struct qmi_handle *qmi_hdl,
struct qmi_txn *qmi_txn,
struct qmi_elem_info *qmi_ei, void *resp);
/**
* os_if_qmi_send_request() - Connect to QMI service
* @qmi_hdl: QMI handle
* @sq: destination sockaddr
* @qmi_txn: QMI transaction handle
* @msg_id: message id
* @len: max length of the QMI message
* @ei: QMI message description
* @req: message to be encoded
*
* Return: QDF status
*/
QDF_STATUS os_if_qmi_send_request(struct qmi_handle *qmi_hdl,
struct sockaddr_qrtr *sq,
struct qmi_txn *qmi_txn, int msg_id,
uint32_t len, struct qmi_elem_info *ei,
const void *req);
/**
* os_if_qmi_txn_wait() - Wait for transaction response
* @qmi_txn: QMI transaction handle
* @timeout: Timeout value in jiffies
*
* Return: QDF status
*/
QDF_STATUS os_if_qmi_txn_wait(struct qmi_txn *qmi_txn, unsigned long timeout);
/**
* os_if_qmi_txn_cancel() - Cancel the QMI transaction
* @qmi_txn: QMI transaction handle
*
* Return: None
*/
void os_if_qmi_txn_cancel(struct qmi_txn *qmi_txn);
/**
* os_if_qmi_register_callbacks() - Register callback handlers
* @psoc: Pointer to psoc context
* @cb_obj: Callback object pointer
*
* Return: None
*/
void os_if_qmi_register_callbacks(struct wlan_objmgr_psoc *psoc,
struct wlan_qmi_psoc_callbacks *cb_obj);
#ifdef QMI_WFDS
/**
* os_if_qmi_wfds_register_callbacks() - Register WFDS callback handlers
* @cb_obj: Callback object pointer
*
* Return: None
*/
void os_if_qmi_wfds_register_callbacks(struct wlan_qmi_psoc_callbacks *cb_obj);
/**
* os_if_qmi_wfds_send_ut_cmd_req_msg() - Send WFDS unit test command
* @cmd_info: Unit test command info
*
* Return: QDF_STATUS
*/
QDF_STATUS
os_if_qmi_wfds_send_ut_cmd_req_msg(struct os_if_qmi_wfds_ut_cmd_info *cmd_info);
#else
static inline
void os_if_qmi_wfds_register_callbacks(struct wlan_qmi_psoc_callbacks *cb_obj)
{
}
static inline QDF_STATUS
os_if_qmi_wfds_send_ut_cmd_req_msg(struct os_if_qmi_wfds_ut_cmd_info *cmd_info)
{
}
#endif
#else
static inline
QDF_STATUS os_if_qmi_handle_init(struct qmi_handle *qmi_hdl,
qdf_size_t recv_buf_size,
const struct qmi_ops *ops,
const struct qmi_msg_handler *qmi_msg_handlers)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
void os_if_qmi_handle_release(struct qmi_handle *qmi_hdl)
{
}
static inline
QDF_STATUS os_if_qmi_add_lookup(struct qmi_handle *qmi_hdl,
unsigned int service, unsigned int version,
unsigned int instance)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
QDF_STATUS os_if_qmi_connect_to_svc(struct qmi_handle *qmi_hdl,
struct qmi_service *qmi_svc)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
QDF_STATUS os_if_qmi_txn_init(struct qmi_handle *qmi_hdl,
struct qmi_txn *qmi_txn,
struct qmi_elem_info *qmi_ei, void *resp)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
QDF_STATUS os_if_qmi_send_request(struct qmi_handle *qmi_hdl,
struct sockaddr_qrtr *sq,
struct qmi_txn *qmi_txn, int msg_id,
uint32_t len, struct qmi_elem_info *ei,
const void *req)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
QDF_STATUS os_if_qmi_txn_wait(struct qmi_txn *qmi_txn, unsigned long timeout)
{
return QDF_STATUS_E_NOSUPPORT;
}
static inline
void os_if_qmi_txn_cancel(struct qmi_txn *qmi_txn)
{
}
static inline
void os_if_qmi_register_callbacks(struct wlan_objmgr_psoc *psoc,
struct wlan_qmi_psoc_callbacks *cb_obj)
{
}
#endif
#endif