Display

简介
目录
- 接口说明
- 使用说明
相关仓

简介

该仓下主要包含Display模块HDI（Hardware Driver Interface）接口定义及其实现，对上层图形服务提供显示驱动能力接口，HDI接口主要包括如下三大类：

DisplayLayer：负责显示图层的管理，包括图层创建、显示属性设置、图层填充及刷新等操作；
DisplayGralloc：负责显示模块内存的管理，包括内存的申请和释放、内存映射等操作；
DisplayGfx：提供硬件加速接口，包括硬件加速模块的初始化、位图搬移、规则图形的画线及填充等操作。

图 1 DISPLAY模块HDI接口层框架图

/drivers/peripheral/display
├── hal                # display模块的hal层代码
│   └── default       # display模块hdi的默认实现
├── interfaces         # display模块对上层服务提供的驱动能力接口
│   └── include       # display模块对外提供的接口定义
├── test               # display模块的测试代码
│   └── unittest      # display模块的单元测试代码

接口说明

Display驱动提供给系统服务WMS可直接调用的驱动能力接口，按照功能分类三大类：显示图层子模块、显示内存子模块、硬件加速子模块，可以提供图层的创建和销毁、图层属性的设置，内存的申请和释放、映射和缓冲，矩形填充和位图搬移等能力。

提供的部分接口说明如表1 Display HDI接口列表所示：

表 1 Display HDI接口列表

头文件	接口名称	功能描述
display_layer.h	int32_t (*InitDisplay)(uint32_t devId);	显示屏初始化
	int32_t (*DeinitDisplay)(uint32_t devId);	显示屏反初始化
	int32_t (GetDisplayInfo)(uint32_t devId, DisplayInfo dispInfo);	获取显示信息
	int32_t (OpenLayer)(uint32_t devId, const LayerInfo layerInfo, uint32_t *layerId);	创建layer图层
	int32_t (*CloseLayer)(uint32_t devId, uint32_t layerId);	销毁layer图层
	int32_t (*SetLayerVisible)(uint32_t devId, uint32_t layerId, bool visible);	设置layer是否可见
	int32_t (SetLayerDirtyRegion)(uint32_t devId, uint32_t layerId, IRect region);	设置layer刷新区域
	int32_t (Flush)(uint32_t devId, uint32_t layerId, LayerBuffer buffer);	刷新图层
	int32_t (GetLayerBuffer)(uint32_t devId, uint32_t layerId, LayerBuffer buffer);	获取图层buffer
display_gralloc.h	int32_t AllocMem(GrallocBuffer *buffer);	显示内存分配
	void FreeMem(GrallocBuffer *buffer);	显示内存释放
	void Mmap(GrallocBuffer buffer);	内存映射
	void MmapCache(GrallocBuffer buffer);	内存映射为cache
	int32_t Unmap(GrallocBuffer *buffer);	取消内存映射
	int32_t FlushCache(GrallocBuffer *buffer);	刷新cache里的内容到内存并且使cache里的内容无效
	int32_t FlushMCache(GrallocBuffer *buffer);	刷新Mmap映射的cache里的内容到内存并且使cache里的内容无效
display_gfx.h	int32_t InitGfx(void);	初始化硬件加速
	int32_t DeinitGfx(void);	反初始化硬件加速
	int32_t Blit(ISurface srcSurface, IRect srcRect, ISurface dstSurface, IRect dstRect);	位图搬移
	int32_t FillRect(ISurface surface, IRect rect, uint32_t color, GfxOpt *opt);	绘制矩形框

使用说明

该仓核心功能是提供显示驱动能力接口供上层图形系统服务调用，提供的驱动能力接口统一归属为HDI接口层。

通过如下简要示例代码说明Display HDI接口的使用：

#include "display_gfx.h"
#include "display_gralloc.h"
#include "display_layer.h"
#include "display_type.h"

#define DEVID 0
DisplayTest g_displayTest;
static GrallocBuffer g_buffer;

static int32_t GetDisplayInterfaces(void)
{
    int32_t ret;
    ret = LayerInitialize(&g_displayTest.layerFuncs);
    if (ret != DISPLAY_SUCCESS || g_displayTest.layerFuncs == NULL) {
        HDF_LOGE("initialize layer failed");
        return DISPLAY_FAILURE;
    }
    ret = GrallocInitialize(&g_displayTest.grallocFuncs);
    if (ret != DISPLAY_SUCCESS || g_displayTest.layerFuncs == NULL) {
        HDF_LOGE("initialize gralloc failed");
        return DISPLAY_FAILURE;
    }
    ret = GfxInitialize(&g_displayTest.gfxFuncs);
    if (ret != DISPLAY_SUCCESS || g_displayTest.gfxFuncs == NULL) {
        HDF_LOGE("initialize gralloc failed");
        return DISPLAY_FAILURE;
    }
    return DISPLAY_SUCCESS;
}

static int32_t DisplayUninit(void)
{
    LayerUninitialize(g_displayTest.layerFuncs);
    GrallocUninitialize(g_displayTest.grallocFuncs);
    GfxUninitialize(g_displayTest.gfxFuncs);
    return DISPLAY_SUCCESS;
}

static void GetLayerInfo(LayerInfo *layInfo)
{
    layInfo->width = g_displayTest.displayInfo.width;
    layInfo->height = g_displayTest.displayInfo.height;
    layInfo->bpp = LAYER_BPP;
    layInfo->pixFormat = PIXEL_FMT_RGBA_5551;
    layInfo->type = LAYER_TYPE_GRAPHIC;
}

static void WriteDataToBuf(int32_t width, int32_t height, uint16_t *pBuf)
{
    int32_t x;
    int32_t y;

    for (y = ((height / LINE_WIDTH) - LINE_WIDTH); y < ((height / LINE_WIDTH) + LINE_WIDTH); y++) {
        for (x = 0; x < width; x++) {
            *((uint16_t*)pBuf + y * width + x) = HIFB_RED_1555;
        }
    }
    for (y = 0; y < height; y++) {
        for (x = ((width / LINE_WIDTH) - LINE_WIDTH); x < ((width / LINE_WIDTH) + LINE_WIDTH); x++) {
            *((uint16_t*)pBuf + y * width + x) = HIFB_RED_1555;
        }
    }
}

int DisplayServiceSample(void)
{    
    int32_t ret;
    g_displayTest.devId = DEVID;

    /* 获取display驱动接口 */
    ret = GetDisplayInterfaces();
    if (ret != DISPLAY_SUCCESS) {
        HDF_LOGE("get display interfaces ops failed");
        return ret;
    }
    /* 初始化显示设备 */
    if (g_displayTest.layerFuncs->InitDisplay != NULL) {
        ret = g_displayTest.layerFuncs->InitDisplay(g_displayTest.devId);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("initialize display failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 获取显示设备的信息 */
    if (g_displayTest.layerFuncs->GetDisplayInfo != NULL) {
        ret = g_displayTest.layerFuncs->GetDisplayInfo(g_displayTest.devId, &g_displayTest.displayInfo);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("get disp info failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 打开显示设备的特定图层 */
    if (g_displayTest.layerFuncs->OpenLayer != NULL) {
        LayerInfo layInfo;
        GetLayerInfo(&layInfo);
        ret = g_displayTest.layerFuncs->OpenLayer(g_displayTest.devId, &layInfo, &g_displayTest.layerId);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("open layer failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 获取图层buffer并填充buffer */
    if (g_displayTest.layerFuncs->GetLayerBuffer != NULL) {
        ret = g_displayTest.layerFuncs->GetLayerBuffer(g_displayTest.devId, g_displayTest.layerId, &g_displayTest.buffer);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("get layer buffer failed");
            return DISPLAY_FAILURE;
        }
        uint16_t *pBuf = (uint16_t *)g_displayTest.buffer.data.virAddr;
        WriteDataToBuf(g_displayTest.displayInfo.width, g_displayTest.displayInfo.height, pBuf);
    }
    /* 刷新图层数据进行显示 */
    if (g_displayTest.layerFuncs->Flush != NULL) {
        ret = g_displayTest.layerFuncs->Flush(g_displayTest.devId, g_displayTest.layerId, &g_displayTest.buffer);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("flush layer failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 关闭显示设备的特定图层 */
    if (g_displayTest.layerFuncs->CloseLayer != NULL) {
        ret = g_displayTest.layerFuncs->CloseLayer(g_displayTest.devId, g_displayTest.layerId);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("close layer failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 关闭显示设备 */
    if (g_displayTest.layerFuncs->DeinitDisplay != NULL) {
        ret = g_displayTest.layerFuncs->DeinitDisplay(g_displayTest.devId);
        if (ret != DISPLAY_SUCCESS) {
            HDF_LOGE("deinit display failed");
            return DISPLAY_FAILURE;
        }
    }
    /* 注销显示驱动接口 */
    ret = DisplayUninit();
    if (ret != DISPLAY_SUCCESS) {
        HDF_LOGE("DisplayUninit fail");
        return ret;
    }
    return 0;
}

zhao_haipeng / drivers_peripheral

Display

简介

目录

接口说明

使用说明

相关仓

简介

发行版

贡献者

近期动态

zhao_haipeng / drivers_peripheral .gitee-modal { width: 500px !important; }

Display

简介

目录

接口说明

使用说明

相关仓

简介

发行版

贡献者

近期动态

搜索帮助

zhao_haipeng / drivers_peripheral