mpp/inc/mpp_task.h

8  *      http://www.apache.org/licenses/LICENSE-2.0
27  * Port has two type: input port and output port which are all for data transaction.
29  * On input side user will dequeue task from input port, setup task and enqueue task
31  * On output side user will dequeue task from output port, get the information from
35  * Task has two working mode: async mode and sync mode
45  * One mpp task queue has two ports: input and output
48  * Top layer mpp has two ports: mpp_input_port and mpp_output_port
49  * But internally these two ports belongs to two task queue.
69  * a - poll(input)
70  * b - dequeue(input, *task)
71  * c - task_set_item(packet/frame)
72  * d - enqueue(input, task)     // when enqueue return the task is not done yet
75  * a - poll(output)
76  * b - dequeue(output, *task)
77  * c - task_get_item(frame/packet)
78  * d - enqueue(output, task)
84  * a - poll(input)
85  * b - dequeue(input, *task)
86  * c - task_set_item(packet/frame)
87  * d - enqueue(task)            // when enqueue return the task is finished
99  * MPP_POLL_BLOCK           - for block poll
100  * MPP_POLL_NON_BLOCK       - for non-block poll
101  * small than MPP_POLL_MAX  - for poll with timeout in ms
105     MPP_POLL_BUTT       = -2,
106     MPP_POLL_BLOCK      = -1,
113  * MPP_TIMEOUT_BLOCK            - for block poll
114  * MPP_TIMEOUT_NON_BLOCK        - for non-block poll
115  * small than MPP_TIMEOUT_MAX   - for poll with timeout in ms
118 #define MPP_TIMEOUT_BUTT        (-2L)
119 #define MPP_TIMEOUT_BLOCK       (-1L)
130  * input    - MppPacket     (normal cpu buffer, need cpu copy)
131  * output   - MppFrame      (ion/drm buffer in external/internal mode)
133  * input    - MppPacket     (externel ion/drm buffer, cpu can not access)
134  * output   - MppFrame      (ion/drm buffer in external/internal mode, cpu can not access)
162  * input    - MppFrame      (ion/drm buffer in external mode)
163  * output   - MppPacket     (normal cpu buffer, need cpu copy)
164  * 2. user input encoder mode:
165  * input    - MppFrame      (normal cpu buffer, need to build hardware table for this buffer)
166  * output   - MppPacket     (normal cpu buffer, need cpu copy)
168  * input    - MppFrame      (ion/drm buffer in external mode, cpu can not access)
169  * output   - MppPacket     (externel ion/drm buffer, cpu can not access)
171  * typical / user input flow
193  * NOTE: this flow can specify the output frame. User will setup both intput frame and output packet
194 …* buffer at the input side. Then at output side when user gets a finished task user can get the ou…
200  * input    - MppFrame      (ion/drm buffer in external mode)
201  * output   - MppFrame      (ion/drm buffer in external mode)
203  * typical / user input flow