1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Copyright (c) 2016 MediaTek Inc. 4 * Author: PC Chen <pc.chen@mediatek.com> 5 */ 6 7 #ifndef _VDEC_VPU_IF_H_ 8 #define _VDEC_VPU_IF_H_ 9 10 #include "mtk_vcodec_fw.h" 11 12 struct mtk_vcodec_ctx; 13 14 /** 15 * struct vdec_vpu_inst - VPU instance for video codec 16 * @id : ipi msg id for each decoder 17 * @vsi : driver structure allocated by VPU side and shared to AP side 18 * for control and info share 19 * @failure : VPU execution result status, 0: success, others: fail 20 * @inst_addr : VPU decoder instance address 21 * @signaled : 1 - Host has received ack message from VPU, 0 - not received 22 * @ctx : context for v4l2 layer integration 23 * @dev : platform device of VPU 24 * @wq : wait queue to wait VPU message ack 25 * @handler : ipi handler for each decoder 26 */ 27 struct vdec_vpu_inst { 28 int id; 29 void *vsi; 30 int32_t failure; 31 uint32_t inst_addr; 32 unsigned int signaled; 33 struct mtk_vcodec_ctx *ctx; 34 wait_queue_head_t wq; 35 mtk_vcodec_ipi_handler handler; 36 }; 37 38 /** 39 * vpu_dec_init - init decoder instance and allocate required resource in VPU. 40 * 41 * @vpu: instance for vdec_vpu_inst 42 */ 43 int vpu_dec_init(struct vdec_vpu_inst *vpu); 44 45 /** 46 * vpu_dec_start - start decoding, basically the function will be invoked once 47 * every frame. 48 * 49 * @vpu : instance for vdec_vpu_inst 50 * @data: meta data to pass bitstream info to VPU decoder 51 * @len : meta data length 52 */ 53 int vpu_dec_start(struct vdec_vpu_inst *vpu, uint32_t *data, unsigned int len); 54 55 /** 56 * vpu_dec_end - end decoding, basically the function will be invoked once 57 * when HW decoding done interrupt received successfully. The 58 * decoder in VPU will continue to do reference frame management 59 * and check if there is a new decoded frame available to display. 60 * 61 * @vpu : instance for vdec_vpu_inst 62 */ 63 int vpu_dec_end(struct vdec_vpu_inst *vpu); 64 65 /** 66 * vpu_dec_deinit - deinit decoder instance and resource freed in VPU. 67 * 68 * @vpu: instance for vdec_vpu_inst 69 */ 70 int vpu_dec_deinit(struct vdec_vpu_inst *vpu); 71 72 /** 73 * vpu_dec_reset - reset decoder, use for flush decoder when end of stream or 74 * seek. Remainig non displayed frame will be pushed to display. 75 * 76 * @vpu: instance for vdec_vpu_inst 77 */ 78 int vpu_dec_reset(struct vdec_vpu_inst *vpu); 79 80 #endif 81