| /* SPDX-License-Identifier: GPL-2.0 */ | 
| /* | 
|  * Copyright (c) 2016 MediaTek Inc. | 
|  * Author: PC Chen <pc.chen@mediatek.com> | 
|  */ | 
|   | 
| #ifndef _VDEC_VPU_IF_H_ | 
| #define _VDEC_VPU_IF_H_ | 
|   | 
| #include "mtk_vcodec_fw.h" | 
|   | 
| struct mtk_vcodec_ctx; | 
|   | 
| /** | 
|  * struct vdec_vpu_inst - VPU instance for video codec | 
|  * @id          : ipi msg id for each decoder | 
|  * @vsi         : driver structure allocated by VPU side and shared to AP side | 
|  *                for control and info share | 
|  * @failure     : VPU execution result status, 0: success, others: fail | 
|  * @inst_addr    : VPU decoder instance address | 
|  * @signaled    : 1 - Host has received ack message from VPU, 0 - not received | 
|  * @ctx         : context for v4l2 layer integration | 
|  * @dev        : platform device of VPU | 
|  * @wq          : wait queue to wait VPU message ack | 
|  * @handler     : ipi handler for each decoder | 
|  */ | 
| struct vdec_vpu_inst { | 
|     int id; | 
|     void *vsi; | 
|     int32_t failure; | 
|     uint32_t inst_addr; | 
|     unsigned int signaled; | 
|     struct mtk_vcodec_ctx *ctx; | 
|     wait_queue_head_t wq; | 
|     mtk_vcodec_ipi_handler handler; | 
| }; | 
|   | 
| /** | 
|  * vpu_dec_init - init decoder instance and allocate required resource in VPU. | 
|  * | 
|  * @vpu: instance for vdec_vpu_inst | 
|  */ | 
| int vpu_dec_init(struct vdec_vpu_inst *vpu); | 
|   | 
| /** | 
|  * vpu_dec_start - start decoding, basically the function will be invoked once | 
|  *                 every frame. | 
|  * | 
|  * @vpu : instance for vdec_vpu_inst | 
|  * @data: meta data to pass bitstream info to VPU decoder | 
|  * @len : meta data length | 
|  */ | 
| int vpu_dec_start(struct vdec_vpu_inst *vpu, uint32_t *data, unsigned int len); | 
|   | 
| /** | 
|  * vpu_dec_end - end decoding, basically the function will be invoked once | 
|  *               when HW decoding done interrupt received successfully. The | 
|  *               decoder in VPU will continue to do reference frame management | 
|  *               and check if there is a new decoded frame available to display. | 
|  * | 
|  * @vpu : instance for vdec_vpu_inst | 
|  */ | 
| int vpu_dec_end(struct vdec_vpu_inst *vpu); | 
|   | 
| /** | 
|  * vpu_dec_deinit - deinit decoder instance and resource freed in VPU. | 
|  * | 
|  * @vpu: instance for vdec_vpu_inst | 
|  */ | 
| int vpu_dec_deinit(struct vdec_vpu_inst *vpu); | 
|   | 
| /** | 
|  * vpu_dec_reset - reset decoder, use for flush decoder when end of stream or | 
|  *                 seek. Remainig non displayed frame will be pushed to display. | 
|  * | 
|  * @vpu: instance for vdec_vpu_inst | 
|  */ | 
| int vpu_dec_reset(struct vdec_vpu_inst *vpu); | 
|   | 
| #endif |