Merge tag 'drivers-5.10-2020-10-12' of git://git.kernel.dk/linux-block
[linux-2.6-block.git] / drivers / media / platform / mtk-vcodec / vdec_vpu_if.h
CommitLineData
9293e39c 1/* SPDX-License-Identifier: GPL-2.0 */
590577a4
TL
2/*
3 * Copyright (c) 2016 MediaTek Inc.
4 * Author: PC Chen <pc.chen@mediatek.com>
590577a4
TL
5 */
6
7#ifndef _VDEC_VPU_IF_H_
8#define _VDEC_VPU_IF_H_
9
bf1d556a
YD
10#include "mtk_vcodec_fw.h"
11
12struct mtk_vcodec_ctx;
590577a4
TL
13
14/**
15 * struct vdec_vpu_inst - VPU instance for video codec
bf1d556a 16 * @id : ipi msg id for each decoder
590577a4
TL
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
4a3fad70 23 * @dev : platform device of VPU
590577a4
TL
24 * @wq : wait queue to wait VPU message ack
25 * @handler : ipi handler for each decoder
26 */
27struct vdec_vpu_inst {
bf1d556a 28 int id;
590577a4
TL
29 void *vsi;
30 int32_t failure;
31 uint32_t inst_addr;
32 unsigned int signaled;
33 struct mtk_vcodec_ctx *ctx;
590577a4 34 wait_queue_head_t wq;
bf1d556a 35 mtk_vcodec_ipi_handler handler;
590577a4
TL
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 */
43int 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 */
53int 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
8b72c18d 58 * decoder in VPU will continue to do reference frame management
590577a4
TL
59 * and check if there is a new decoded frame available to display.
60 *
61 * @vpu : instance for vdec_vpu_inst
62 */
63int 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 */
70int 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 */
78int vpu_dec_reset(struct vdec_vpu_inst *vpu);
79
590577a4 80#endif