Files
android_kernel_samsung_sm86…/drivers/cam_utils/cam_packet_util.h
Shivakumar Malke 6d99262523 msm: camera: mem_mgr: Add refcount to track in use buffers
The function cam_mem_mgr_release can unmap the buffers when in use.

This change prevents unmapping the buffers when in use.

CRs-Fixed: 3489559
Change-Id: I2e72e795d39ac15abfa56c19043c419a03686966
Signed-off-by: Shivakumar Malke <quic_smalke@quicinc.com>
2023-06-21 15:06:26 -07:00

209 lines
6.8 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
/*
* Copyright (c) 2017-2021, The Linux Foundation. All rights reserved.
* Copyright (c) 2022-2023, Qualcomm Innovation Center, Inc. All rights reserved.
*/
#ifndef _CAM_PACKET_UTIL_H_
#define _CAM_PACKET_UTIL_H_
#include <media/cam_defs.h>
#include "cam_hw_mgr_intf.h"
/**
* @brief KMD scratch buffer information
*
* @handle: Memory handle
* @cpu_addr: Cpu address
* @offset: Offset from the start of the buffer
* @size: Size of the buffer in bytes
* @used_bytes: Used memory in bytes
*
*/
struct cam_kmd_buf_info {
int handle;
uint32_t *cpu_addr;
uint32_t offset;
uint32_t size;
uint32_t used_bytes;
};
/* Generic Cmd Buffer blob callback function type */
typedef int (*cam_packet_generic_blob_handler)(void *user_data,
uint32_t blob_type, uint32_t blob_size, uint8_t *blob_data);
/**
* @brief Get packet buffer address
*
* @packet: Pointer to packet to be retrieved
* @packet_handle: Buffer handle of the packet
* @offset: offset to packet start address
*
* @return: 0 for success
*/
int cam_packet_util_get_packet_addr(struct cam_packet **packet,
uint64_t packet_handle, uint32_t offset);
/**
* @brief Put packet buffer address
*
* @packet_handle: Buffer handle of the packet
*/
void cam_packet_util_put_packet_addr(uint64_t packet_handle);
/**
* cam_packet_util_get_cmd_mem_addr()
*
* @brief Get command buffer address
*
* @handle: Command buffer memory handle
* @buf_addr: Command buffer cpu mapped address
* @len: Command buffer length
*
* @return: 0 for success
* -EINVAL for Fail
*/
int cam_packet_util_get_cmd_mem_addr(int handle, uint32_t **buf_addr,
size_t *len);
/**
* cam_packet_util_validate_packet()
*
* @brief Validate the packet
*
* @packet: Packet to be validated
*
* @remain_len: CPU buff length after config offset
*
* @return: 0 for success
* -EINVAL for Fail
*/
int cam_packet_util_validate_packet(struct cam_packet *packet,
size_t remain_len);
/**
* cam_packet_util_validate_cmd_desc()
*
* @brief Validate the packet
*
* @cmd_desc: Command descriptor to be validated
*
* @return: 0 for success
* -EINVAL for Fail
*/
int cam_packet_util_validate_cmd_desc(struct cam_cmd_buf_desc *cmd_desc);
/**
* cam_packet_util_get_kmd_buffer()
*
* @brief Get the kmd buffer from the packet command descriptor
*
* @packet: Packet data
* @kmd_buf: Extracted the KMD buffer information
*
* @return: 0 for success
* -EINVAL for Fail
*/
int cam_packet_util_get_kmd_buffer(struct cam_packet *packet,
struct cam_kmd_buf_info *kmd_buf_info);
/**
* cam_packet_util_dump_patch_info()
*
* @brief: Dump patch info in case of page fault
*
* @packet: Input packet containing Command Buffers and Patches
* @iommu_hdl: IOMMU handle of the HW Device that received the packet
* @sec_iommu_hdl: Secure IOMMU handle of the HW Device that
* received the packet
* @pf_args: Page fault arguments
*
*/
void cam_packet_util_dump_patch_info(struct cam_packet *packet,
int32_t iommu_hdl, int32_t sec_iommu_hdl, struct cam_hw_dump_pf_args *pf_args);
/**
* cam_packet_util_process_patches()
*
* @brief: Replace the handle in Packet to Address using the
* information from patches.
*
* @packet: Input packet containing Command Buffers and Patches
* @mapped_io_list: List in to add patches/buffers to for reference counting
* @iommu_hdl: IOMMU handle of the HW Device that received the packet
* @sec_iommu_hdl: Secure IOMMU handle of the HW Device that
* received the packet
* @exp_mem: Boolean to know if patched address is in expanded memory range
* or within default 32-bit address space.
*
* @return: 0: Success
* Negative: Failure
*/
int cam_packet_util_process_patches(struct cam_packet *packet,
struct list_head *mapped_io_list, int32_t iommu_hdl, int32_t sec_mmu_hdl,
bool exp_mem);
/**
* cam_packet_util_dump_io_bufs()
*
* @brief: Search for faulted io buffer in packet and print io buffers info
*
* @packet: Input packet containing io buffers
* @iommu_hdl: IOMMU handle of the HW Device that received the packet
* @sec_iommu_hdl: Secure IOMMU handle of the HW Device that
* received the packet
* @pf_args: Pault Fault related info
* @res_id_support: if the specific device has knowledge of the resource id for hw
*/
void cam_packet_util_dump_io_bufs(struct cam_packet *packet,
int32_t iommu_hdl, int32_t sec_mmu_hdl,
struct cam_hw_dump_pf_args *pf_args, bool res_id_support);
/**
* cam_packet_util_process_generic_cmd_buffer()
*
* @brief: Process Generic Blob command buffer. This utility
* function process the command buffer and calls the
* blob_handle_cb callback for each blob that exists
* in the command buffer.
*
* @cmd_buf: Generic Blob Cmd Buffer handle
* @blob_handler_cb: Callback pointer to call for each blob exists in the
* command buffer
* @user_data: User data to be passed while callback
*
* @return: 0: Success
* Negative: Failure
*/
int cam_packet_util_process_generic_cmd_buffer(
struct cam_cmd_buf_desc *cmd_buf,
cam_packet_generic_blob_handler blob_handler_cb, void *user_data);
/**
* @brief : API to retrieve image buffers from presil after processing is
* done,using packet from request
*
* @packet: Packet pointer for current request
* @iommu_hdl: IOMMU hdl for Image buffers
* @out_res_id: Resource ID corresponding to the output buffer
*
* @return: Success or Failure
*/
int cam_presil_retrieve_buffers_from_packet(struct cam_packet *packet, int iommu_hdl,
int out_res_id);
/**
* @brief : API to send relevant buffers to presil
*
* @packet : Packet pointer for current request
* @img_iommu_hdl: IOMMU hdl for Image buffers
* @cdm_iommu_hdl: IOMMU hdl for cdm buffers
*
*/
int cam_presil_send_buffers_from_packet(struct cam_packet *packet, int img_iommu_hdl,
int cdm_iommu_hdl);
#endif /* _CAM_PACKET_UTIL_H_ */