| #ifndef __UAPI_LINUX_CAM_REQ_MGR_H |
| #define __UAPI_LINUX_CAM_REQ_MGR_H |
| |
| #include <linux/videodev2.h> |
| #include <linux/types.h> |
| #include <linux/ioctl.h> |
| #include <linux/media.h> |
| #include <media/cam_defs.h> |
| |
| #define CAM_REQ_MGR_VNODE_NAME "cam-req-mgr-devnode" |
| |
| #define CAM_DEVICE_TYPE_BASE (MEDIA_ENT_F_OLD_BASE) |
| #define CAM_VNODE_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE) |
| #define CAM_SENSOR_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 1) |
| #define CAM_IFE_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 2) |
| #define CAM_ICP_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 3) |
| #define CAM_LRME_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 4) |
| #define CAM_JPEG_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 5) |
| #define CAM_FD_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 6) |
| #define CAM_CPAS_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 7) |
| #define CAM_CSIPHY_DEVICE_TYPE (CAM_DEVICE_TYPE_BASE + 8) |
| |
| /* cam_req_mgr hdl info */ |
| #define CAM_REQ_MGR_HDL_IDX_POS 8 |
| #define CAM_REQ_MGR_HDL_IDX_MASK ((1 << CAM_REQ_MGR_HDL_IDX_POS) - 1) |
| #define CAM_REQ_MGR_GET_HDL_IDX(hdl) (hdl & CAM_REQ_MGR_HDL_IDX_MASK) |
| |
| /** |
| * Max handles supported by cam_req_mgr |
| * It includes both session and device handles |
| */ |
| #define CAM_REQ_MGR_MAX_HANDLES 64 |
| #define MAX_LINKS_PER_SESSION 2 |
| |
| /* V4L event type which user space will subscribe to */ |
| #define V4L_EVENT_CAM_REQ_MGR_EVENT (V4L2_EVENT_PRIVATE_START + 0) |
| |
| /* Specific event ids to get notified in user space */ |
| #define V4L_EVENT_CAM_REQ_MGR_SOF 0 |
| #define V4L_EVENT_CAM_REQ_MGR_ERROR 1 |
| #define V4L_EVENT_CAM_REQ_MGR_MAX 2 |
| |
| /** |
| * Request Manager : flush_type |
| * @CAM_REQ_MGR_FLUSH_TYPE_ALL: Req mgr will remove all the pending |
| * requests from input/processing queue. |
| * @CAM_REQ_MGR_FLUSH_TYPE_CANCEL_REQ: Req mgr will remove only particular |
| * request id from input/processing queue. |
| * @CAM_REQ_MGR_FLUSH_TYPE_MAX: Max number of the flush type |
| * @opcode: CAM_REQ_MGR_FLUSH_REQ |
| */ |
| #define CAM_REQ_MGR_FLUSH_TYPE_ALL 0 |
| #define CAM_REQ_MGR_FLUSH_TYPE_CANCEL_REQ 1 |
| #define CAM_REQ_MGR_FLUSH_TYPE_MAX 2 |
| |
| /** |
| * struct cam_req_mgr_event_data |
| * @session_hdl: session handle |
| * @link_hdl: link handle |
| * @frame_id: frame id |
| * @reserved: reserved for 64 bit aligngment |
| * @req_id: request id |
| * @tv_sec: timestamp in seconds |
| * @tv_usec: timestamp in micro seconds |
| */ |
| struct cam_req_mgr_event_data { |
| int32_t session_hdl; |
| int32_t link_hdl; |
| int32_t frame_id; |
| int32_t reserved; |
| int64_t req_id; |
| uint64_t tv_sec; |
| uint64_t tv_usec; |
| }; |
| |
| /** |
| * struct cam_req_mgr_session_info |
| * @session_hdl: In/Output param - session_handle |
| * @opcode1: CAM_REQ_MGR_CREATE_SESSION |
| * @opcode2: CAM_REQ_MGR_DESTROY_SESSION |
| */ |
| struct cam_req_mgr_session_info { |
| int32_t session_hdl; |
| int32_t reserved; |
| }; |
| |
| /** |
| * struct cam_req_mgr_link_info |
| * @session_hdl: Input param - Identifier for CSL session |
| * @num_devices: Input Param - Num of devices to be linked |
| * @dev_hdls: Input param - List of device handles to be linked |
| * @link_hdl: Output Param -Identifier for link |
| * @opcode: CAM_REQ_MGR_LINK |
| */ |
| struct cam_req_mgr_link_info { |
| int32_t session_hdl; |
| uint32_t num_devices; |
| int32_t dev_hdls[CAM_REQ_MGR_MAX_HANDLES]; |
| int32_t link_hdl; |
| }; |
| |
| /** |
| * struct cam_req_mgr_unlink_info |
| * @session_hdl: input param - session handle |
| * @link_hdl: input param - link handle |
| * @opcode: CAM_REQ_MGR_UNLINK |
| */ |
| struct cam_req_mgr_unlink_info { |
| int32_t session_hdl; |
| int32_t link_hdl; |
| }; |
| |
| /** |
| * struct cam_req_mgr_flush_info |
| * @brief: User can tell drivers to flush a particular request id or |
| * flush all requests from its pending processing queue. Flush is a |
| * blocking call and driver shall ensure all requests are flushed |
| * before returning. |
| * @session_hdl: Input param - Identifier for CSL session |
| * @link_hdl: Input Param -Identifier for link |
| * @flush_type: User can cancel a particular req id or can flush |
| * all requests in queue |
| * @reserved: reserved for 64 bit aligngment |
| * @req_id: field is valid only if flush type is cancel request |
| * for flush all this field value is not considered. |
| * @opcode: CAM_REQ_MGR_FLUSH_REQ |
| */ |
| struct cam_req_mgr_flush_info { |
| int32_t session_hdl; |
| int32_t link_hdl; |
| uint32_t flush_type; |
| uint32_t reserved; |
| int64_t req_id; |
| }; |
| |
| /** struct cam_req_mgr_sched_info |
| * @session_hdl: Input param - Identifier for CSL session |
| * @link_hdl: Input Param -Identifier for link |
| * inluding itself. |
| * @bubble_enable: Input Param - Cam req mgr will do bubble recovery if this |
| * flag is set. |
| * @reserved: reserved field for alignment |
| * @req_id: Input Param - Request Id from which all requests will be flushed |
| */ |
| struct cam_req_mgr_sched_request { |
| int32_t session_hdl; |
| int32_t link_hdl; |
| int32_t bubble_enable; |
| int32_t reserved; |
| int64_t req_id; |
| }; |
| |
| /** |
| * struct cam_req_mgr_sync_mode |
| * @session_hdl: Input param - Identifier for CSL session |
| * @sync_enable: Input Param -Enable sync mode or disable |
| * @num_links: Input Param - Num of links in sync mode (Valid only |
| * when sync_enable is TRUE) |
| * @link_hdls: Input Param - Array of link handles to be in sync mode |
| * (Valid only when sync_enable is TRUE) |
| * @master_link_hdl: Input Param - To dictate which link's SOF drives system |
| * (Valid only when sync_enable is TRUE) |
| * |
| * @opcode: CAM_REQ_MGR_SYNC_MODE |
| */ |
| struct cam_req_mgr_sync_mode { |
| int32_t session_hdl; |
| int32_t sync_enable; |
| int32_t num_links; |
| int32_t link_hdls[MAX_LINKS_PER_SESSION]; |
| int32_t master_link_hdl; |
| int32_t reserved; |
| }; |
| |
| /** |
| * cam_req_mgr specific opcode ids |
| */ |
| #define CAM_REQ_MGR_CREATE_DEV_NODES (CAM_COMMON_OPCODE_MAX + 1) |
| #define CAM_REQ_MGR_CREATE_SESSION (CAM_COMMON_OPCODE_MAX + 2) |
| #define CAM_REQ_MGR_DESTROY_SESSION (CAM_COMMON_OPCODE_MAX + 3) |
| #define CAM_REQ_MGR_LINK (CAM_COMMON_OPCODE_MAX + 4) |
| #define CAM_REQ_MGR_UNLINK (CAM_COMMON_OPCODE_MAX + 5) |
| #define CAM_REQ_MGR_SCHED_REQ (CAM_COMMON_OPCODE_MAX + 6) |
| #define CAM_REQ_MGR_FLUSH_REQ (CAM_COMMON_OPCODE_MAX + 7) |
| #define CAM_REQ_MGR_SYNC_MODE (CAM_COMMON_OPCODE_MAX + 8) |
| #define CAM_REQ_MGR_ALLOC_BUF (CAM_COMMON_OPCODE_MAX + 9) |
| #define CAM_REQ_MGR_MAP_BUF (CAM_COMMON_OPCODE_MAX + 10) |
| #define CAM_REQ_MGR_RELEASE_BUF (CAM_COMMON_OPCODE_MAX + 11) |
| #define CAM_REQ_MGR_CACHE_OPS (CAM_COMMON_OPCODE_MAX + 12) |
| #define CAM_REQ_MGR_GET_MMU_HDLS_DEBUG (CAM_COMMON_OPCODE_MAX + 13) |
| #define CAM_REQ_MGR_GET_IO_BUF_DEBUG (CAM_COMMON_OPCODE_MAX + 14) |
| #define CAM_REQ_MGR_GET_KMD_BUF_DEBUG (CAM_COMMON_OPCODE_MAX + 15) |
| /* end of cam_req_mgr opcodes */ |
| |
| #define CAM_MEM_FLAG_HW_READ_WRITE (1<<0) |
| #define CAM_MEM_FLAG_HW_READ_ONLY (1<<1) |
| #define CAM_MEM_FLAG_HW_WRITE_ONLY (1<<2) |
| #define CAM_MEM_FLAG_KMD_ACCESS (1<<3) |
| #define CAM_MEM_FLAG_UMD_ACCESS (1<<4) |
| #define CAM_MEM_FLAG_PROTECTED_MODE (1<<5) |
| #define CAM_MEM_FLAG_CMD_BUF_TYPE (1<<6) |
| #define CAM_MEM_FLAG_PIXEL_BUF_TYPE (1<<7) |
| #define CAM_MEM_FLAG_STATS_BUF_TYPE (1<<8) |
| #define CAM_MEM_FLAG_PACKET_BUF_TYPE (1<<9) |
| #define CAM_MEM_FLAG_CACHE (1<<10) |
| |
| #define CAM_MEM_MMU_MAX_HANDLE 16 |
| |
| /* Maximum allowed buffers in existence */ |
| #define CAM_MEM_BUFQ_MAX 1024 |
| |
| #define CAM_MEM_MGR_HDL_IDX_SIZE 16 |
| #define CAM_MEM_MGR_HDL_FD_SIZE 16 |
| #define CAM_MEM_MGR_HDL_IDX_END_POS 16 |
| #define CAM_MEM_MGR_HDL_FD_END_POS 32 |
| |
| #define CAM_MEM_MGR_HDL_IDX_MASK ((1 << CAM_MEM_MGR_HDL_IDX_SIZE) - 1) |
| |
| #define GET_MEM_HANDLE(idx, fd) \ |
| ((idx << (CAM_MEM_MGR_HDL_IDX_END_POS - CAM_MEM_MGR_HDL_IDX_SIZE)) | \ |
| (fd << (CAM_MEM_MGR_HDL_FD_END_POS - CAM_MEM_MGR_HDL_FD_SIZE))) \ |
| |
| #define CAM_MEM_MGR_GET_HDL_IDX(hdl) (hdl & CAM_MEM_MGR_HDL_IDX_MASK) |
| |
| /** |
| * memory allocation type |
| */ |
| #define CAM_MEM_DMA_NONE 0 |
| #define CAM_MEM_DMA_BIDIRECTIONAL 1 |
| #define CAM_MEM_DMA_TO_DEVICE 2 |
| #define CAM_MEM_DMA_FROM_DEVICE 3 |
| |
| |
| /** |
| * memory cache operation |
| */ |
| #define CAM_MEM_CLEAN_CACHE 1 |
| #define CAM_MEM_INV_CACHE 2 |
| #define CAM_MEM_CLEAN_INV_CACHE 3 |
| |
| |
| /** |
| * struct cam_mem_alloc_out_params |
| * @buf_handle: buffer handle |
| * @fd: output buffer file descriptor |
| * @vaddr: virtual address pointer |
| */ |
| struct cam_mem_alloc_out_params { |
| uint32_t buf_handle; |
| int32_t fd; |
| uint64_t vaddr; |
| }; |
| |
| /** |
| * struct cam_mem_map_out_params |
| * @buf_handle: buffer handle |
| * @reserved: reserved for future |
| * @vaddr: virtual address pointer |
| */ |
| struct cam_mem_map_out_params { |
| uint32_t buf_handle; |
| uint32_t reserved; |
| uint64_t vaddr; |
| }; |
| |
| /** |
| * struct cam_mem_mgr_alloc_cmd |
| * @len: size of buffer to allocate |
| * @align: alignment of the buffer |
| * @mmu_hdls: array of mmu handles |
| * @num_hdl: number of handles |
| * @flags: flags of the buffer |
| * @out: out params |
| */ |
| /* CAM_REQ_MGR_ALLOC_BUF */ |
| struct cam_mem_mgr_alloc_cmd { |
| uint64_t len; |
| uint64_t align; |
| int32_t mmu_hdls[CAM_MEM_MMU_MAX_HANDLE]; |
| uint32_t num_hdl; |
| uint32_t flags; |
| struct cam_mem_alloc_out_params out; |
| }; |
| |
| /** |
| * struct cam_mem_mgr_map_cmd |
| * @mmu_hdls: array of mmu handles |
| * @num_hdl: number of handles |
| * @flags: flags of the buffer |
| * @fd: output buffer file descriptor |
| * @reserved: reserved field |
| * @out: out params |
| */ |
| |
| /* CAM_REQ_MGR_MAP_BUF */ |
| struct cam_mem_mgr_map_cmd { |
| int32_t mmu_hdls[CAM_MEM_MMU_MAX_HANDLE]; |
| uint32_t num_hdl; |
| uint32_t flags; |
| int32_t fd; |
| uint32_t reserved; |
| struct cam_mem_map_out_params out; |
| }; |
| |
| /** |
| * struct cam_mem_mgr_map_cmd |
| * @buf_handle: buffer handle |
| * @reserved: reserved field |
| */ |
| /* CAM_REQ_MGR_RELEASE_BUF */ |
| struct cam_mem_mgr_release_cmd { |
| int32_t buf_handle; |
| uint32_t reserved; |
| }; |
| |
| /** |
| * struct cam_mem_mgr_map_cmd |
| * @buf_handle: buffer handle |
| * @ops: cache operations |
| */ |
| /* CAM_REQ_MGR_CACHE_OPS */ |
| struct cam_mem_cache_ops_cmd { |
| int32_t buf_handle; |
| uint32_t mem_cache_ops; |
| }; |
| |
| #endif /* __UAPI_LINUX_CAM_REQ_MGR_H */ |
