mirror of
https://github.com/nyanmisaka/mpp.git
synced 2025-10-18 15:10:39 +08:00
63135dea1c
1. rename set/clr ref to set/clr dpb_ref 2. rename set/clr decoding to set/clr hw_dst 3. add inc/dec hw_ref for hal task done git-svn-id: https://10.10.10.66:8443/svn/MediaProcessPlatform/trunk/mpp@243 6e48237b-75ef-9749-8fc9-41990f28c85a
200 lines
8.4 KiB
C
200 lines
8.4 KiB
C
/*
|
|
* Copyright 2010 Rockchip Electronics S.LSI Co. LTD
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef __MPP_BUF_SLOT_H__
|
|
#define __MPP_BUF_SLOT_H__
|
|
|
|
#include "rk_type.h"
|
|
#include "mpp_frame.h"
|
|
|
|
/*
|
|
* mpp_dec will alloc 18 decoded picture buffer slot
|
|
* buffer slot is for transferring information between parser / mpp/ hal
|
|
* it represent the dpb routine in logical
|
|
*
|
|
* basic working flow:
|
|
*
|
|
* buf_slot parser hal
|
|
*
|
|
* + + +
|
|
* | | |
|
|
* | +--------+--------+ |
|
|
* | | | |
|
|
* | | do parsing here | |
|
|
* | | | |
|
|
* | +--------+--------+ |
|
|
* | | |
|
|
* | get_slot | |
|
|
* | <--------------------------+ |
|
|
* | get unused dpb slot for | |
|
|
* | current decoder output | |
|
|
* | | |
|
|
* | update dpb refer status | |
|
|
* | <--------------------------+ |
|
|
* | parser will send marking | |
|
|
* | operation to dpb slot | |
|
|
* | including: | |
|
|
* | ref/unref/output/display | |
|
|
* | | |
|
|
* | | |
|
|
* | | set buffer status to hal |
|
|
* +-------------------------------------------------------> |
|
|
* | | |
|
|
* | | +--------+--------+
|
|
* | | | |
|
|
* | | | reg generation |
|
|
* | | | |
|
|
* | | +--------+--------+
|
|
* | | |
|
|
* | | get buffer address info |
|
|
* | <-------------------------------------------------------+
|
|
* | | used buffer index to get |
|
|
* | | physical address or iommu |
|
|
* | | address for hardware |
|
|
* | | |
|
|
* | | +--------+--------+
|
|
* | | | |
|
|
* | | | set/wait hw |
|
|
* | | | |
|
|
* | | +--------+--------+
|
|
* | | |
|
|
* | | update the output status |
|
|
* | <-------------------------------------------------------+
|
|
* | | mark picture is available |
|
|
* | | for output and generate |
|
|
* | | output frame information |
|
|
* + + +
|
|
*
|
|
* typical buffer status transfer
|
|
*
|
|
* -> unused initial
|
|
* -> set_hw_dst by parser
|
|
* -> set_buffer by mpp - do alloc buffer here / info change here
|
|
* -> clr_hw_dst by hal()
|
|
*
|
|
* next four step can be different order
|
|
* -> set_dpb_ref by parser
|
|
* -> set_display by parser - slot ready to display, can be output
|
|
* -> clr_display by mpp - output buffer struct
|
|
* -> clr_dpb_ref by parser
|
|
*
|
|
* -> set_unused automatic clear and dec buffer ref
|
|
*
|
|
*/
|
|
|
|
typedef void* MppBufSlots;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* called by mpp context
|
|
*
|
|
* init / deinit - normal initialize and de-initialize function
|
|
* setup - called by parser when slot information changed
|
|
* is_changed - called by mpp to detect whether info change flow is needed
|
|
* ready - called by mpp when info changed is done
|
|
*
|
|
* typical info change flow:
|
|
*
|
|
* mpp_buf_slot_setup called in parser with changed equal to 1
|
|
* mpp_buf_slot_is_changed called in mpp and found info change
|
|
*
|
|
* do info change outside
|
|
*
|
|
* mpp_buf_slot_ready called in mpp when info change is done
|
|
*
|
|
*/
|
|
MPP_RET mpp_buf_slot_init(MppBufSlots *slots);
|
|
MPP_RET mpp_buf_slot_deinit(MppBufSlots slots);
|
|
MPP_RET mpp_buf_slot_setup(MppBufSlots slots, RK_U32 count, RK_U32 size, RK_U32 changed);
|
|
RK_U32 mpp_buf_slot_is_changed(MppBufSlots slots);
|
|
MPP_RET mpp_buf_slot_ready(MppBufSlots slots);
|
|
RK_U32 mpp_buf_slot_get_size(MppBufSlots slots);
|
|
|
|
/*
|
|
* called by parser
|
|
*
|
|
* mpp_buf_slot_get_unused
|
|
* - parser need a new slot ffor output, on field mode alloc one buffer for two field
|
|
*
|
|
* mpp_buf_slot_set_dpb_ref
|
|
* - mark a slot to be used as reference frame in dpb
|
|
*
|
|
* mpp_buf_slot_clr_dpb_ref
|
|
* - mark a slot to be unused as reference frame and remove from dpb
|
|
*
|
|
* mpp_buf_slot_set_hw_dst
|
|
* - mark a slot to be output destination buffer
|
|
* - NOTE: the frame information MUST be set here
|
|
*
|
|
* mpp_buf_slot_set_display
|
|
* - mark a slot to be can be display
|
|
*
|
|
* mpp_buf_slot_inc_hw_ref
|
|
* - MUST be called once when one slot is used in hardware decoding as reference frame
|
|
*
|
|
* called by mpp
|
|
*
|
|
* mpp_buf_slot_get_hw_dst
|
|
* - mpp_dec need to get the output slot index to check buffer status
|
|
*
|
|
* mpp_buf_slot_clr_display
|
|
* - mark a slot has been send out to display
|
|
* - NOTE: will be called inside mpp_buf_slot_get_display
|
|
*
|
|
* called by hal
|
|
*
|
|
* mpp_buf_slot_clr_hw_dst
|
|
* - mark a slot's buffer is already decoded by hardware
|
|
* NOTE: this call will clear used as output flag
|
|
*
|
|
* mpp_buf_slot_dec_hw_ref
|
|
* - when hal finished on hardware decoding it MUST be called once for each used slot
|
|
*/
|
|
MPP_RET mpp_buf_slot_get_unused(MppBufSlots slots, RK_U32 *index);
|
|
MPP_RET mpp_buf_slot_set_dpb_ref(MppBufSlots slots, RK_U32 index);
|
|
MPP_RET mpp_buf_slot_clr_dpb_ref(MppBufSlots slots, RK_U32 index);
|
|
MPP_RET mpp_buf_slot_set_display(MppBufSlots slots, RK_U32 index);
|
|
|
|
MPP_RET mpp_buf_slot_set_hw_dst(MppBufSlots slots, RK_U32 index, MppFrame frame);
|
|
MPP_RET mpp_buf_slot_clr_hw_dst(MppBufSlots slots, RK_U32 index);
|
|
MPP_RET mpp_buf_slot_get_hw_dst(MppBufSlots slots, RK_U32 *index);
|
|
|
|
MPP_RET mpp_buf_slot_inc_hw_ref(MppBufSlots slots, RK_U32 index);
|
|
MPP_RET mpp_buf_slot_dec_hw_ref(MppBufSlots slots, RK_U32 index);
|
|
|
|
/*
|
|
* mpp_buf_slot_set_buffer
|
|
* - called by dec thread when find a output index has not buffer
|
|
*
|
|
* mpp_buf_slot_get_buffer
|
|
* - called by hal module on register generation
|
|
*
|
|
* mpp_buf_slot_get_display
|
|
* - called by hal thread to output a display slot's frame info
|
|
*/
|
|
MPP_RET mpp_buf_slot_set_buffer(MppBufSlots slots, RK_U32 index, MppBuffer buffer);
|
|
MppBuffer mpp_buf_slot_get_buffer(MppBufSlots slots, RK_U32 index);
|
|
MPP_RET mpp_buf_slot_get_display(MppBufSlots slots, MppFrame *frame);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /*__MPP_BUF_SLOT_H__*/
|