Edit online

MPP 对 GE 接口的封装

3 Mar 2025
Read time: 2 minute(s)

由于驱动支持非命令队列和命令队列两种模式，在提供的用户态 MPP 接口中，对调用驱动的接口进行了封装，保持了统一的调用 API， 建议用户统一使用 MPP 中间层 API。在命令队列模式下，task 会先缓存在用户态的 cmd buffer 中，当调用 mpp_ge_emit 后， 会通过 write 接口把命令写入内核的 ring buffer。


ge_call_mpp

图 1. 应用调用 MPP 框架
表 1. MPP 封装接口语法

接口名称

语法

mpp_ge_open

 
struct mpp_ge *mpp_ge_open();

mpp_ge_close

 
void mpp_ge_close(struct mpp_ge *ge);

mpp_ge_get_mode

 
enum ge_mode mpp_ge_get_mode(struct mpp_ge *ge);

mpp_ge_add_dmabuf

 
int mpp_ge_add_dmabuf(struct mpp_ge *ge, int dma_fd);

mpp_ge_rm_dmabuf

 
int mpp_ge_rm_dmabuf(struct mpp_ge *ge, int dma_fd);

mpp_ge_fillrect

 
int mpp_ge_fillrect(struct mpp_ge *ge, struct ge_fillrect *fillrect);

mpp_ge_bitblt

 
int mpp_ge_bitblt(struct mpp_ge *ge, struct ge_bitblt *blt);

mpp_ge_rotate

 
int mpp_ge_rotate(struct mpp_ge *ge, struct ge_rotation *rot);

mpp_ge_emit

 
nt mpp_ge_emit(struct mpp_ge *ge);

mpp_ge_sync

 
iint mpp_ge_sync(struct mpp_ge *ge);
表 2. MPP 封装接口功能描述

接口名称

功能说明

参数定义

返回值

注意事项

mpp_ge_open

打开 ge 设备

-

struct mpp_ge 结构体指针

NULL：失败

-

mpp_ge_close

关闭 ge 设备

ge: struct mpp_ge 结构体指针

-

-

mpp_ge_get_mode

获取 GE 模式

ge: struct mpp_ge 结构体指针

enum ge_mode 枚举类型

通过返回值可以获取 GE 是否工作在命令队列模式

-

mpp_ge_add_dmabuf

添加 DMA buffer

 ge：struct mpp_ge 结构体指针

dma_fd：dma buffer fd
  • 0：成功
  • <0：失败

-

mpp_ge_rm_dmabuf

删除 DMA buffer

 ge：struct mpp_ge 结构体指针

dma_fd：dma buffer fd
  • 0：成功
  • <0：失败

-

mpp_ge_fillrect

矩形填充

 ge: struct mpp_ge 结构体指针

fillrect:struct ge_fillrect 结构体指针
  • 0：成功
  • <0：失败
normal（非命令队列）模式此接口是同步的。命令队列模式此接口是异步的：
  • 当用户态的缓存 buffer 足够时候仅把命令缓存在用户态。
  • 当用户态的缓存空间不够的时候，先通过 write 接口，把缓存的命令全部写入驱动，然后再把当前命令缓存到用户态 buffer。

mpp_ge_bitblt

 位块搬移 ge: struct mpp_ge 结构体指针

blt:struct ge_bitblt 结构体指针
  • 0：成功
  • <0：失败
normal（非命令队列）模式此接口是同步的。命令队列模式此接口是异步的：
  • 当用户态的缓存 buffer 足够时候仅把命令缓存在用户态。
  • 当用户态的缓存空间不够的时候，先通过 write 接口，把缓存的命令全部写入驱动，然后再把当前命令缓存到用户态 buffer。

mpp_ge_rotate

 任意角度旋转 ge: struct mpp_ge 结构体指针

rot:struct ge_rotation 结构体指针
  • 0：成功
  • <0：失败
normal（非命令队列）模式此接口是同步的。命令队列模式此接口是异步的：
  • 当用户态的缓存 buffer 足够时候仅把命令缓存在用户态。
  • 当用户态的缓存空间不够的时候，先通过 write 接口，把缓存的命令全部写入驱动，然后再把当前命令缓存到用户态 buffer。

mpp_ge_emit

向驱动发送命令

ge: struct mpp_ge 结构体指针
  • 0：成功
  • <0：失败
 normal（非命令队列）模式此接口为空，不产生任何作用。

命令队列模式此接口通过 write 接口，把用户态 buffer 中缓存的命令都写入驱动。

mpp_ge_sync

阻塞等待所有任务执行完成

ge: struct mpp_ge 结构体指针
  • 0：成功
  • <0：失败
 normal（非命令队列）模式此接口为空，不产生任何作用。

命令队列模式此接口通过调用 SYNC 接口，等待所有任务都完成。