鸿蒙OpenHarmony【外设驱动使用之Display VDI 接入】 子系统

Display VDI 接入指南

概述

显示VDI（Vendor Device Interface）接口是为了方便芯片厂商接入OpenHarmony显示驱动框架模型而提供的接口。 显示VDI接口分为Composer和Buffer部分：

• Composer：负责图层（Layer）合成和显示。
• Buffer：负责申请和释放SurfaceBuffer。

Composer部分

图 1 Display Composer HDI架构

该框架模型内部分为三层，依次为框架层、HDI实现层、和Vendor驱动层。各层基本概念如下：

• 框架层：对接HDI实现层的控制、图层的显示和合成，管理显示模块各个硬件设备等功能。
• HDI实现层：实现OHOS（OpenHarmony Operation System）Composer HDI接口。
• Vendor驱动层：屏蔽底层芯片和OS（Operation System）差异，支持多平台适配。

Buffer部分

图 2 Display Buffer HDI架构

该框架模型内部分为三层，依次为框架层、HDI实现层、和Vendor驱动层。各层基本概念如下：

• 框架层：对接HDI实现层的控制、图形buffer的申请和释放。
• HDI实现层：实现OHOS（OpenHarmony Operation System）Buffer HDI接口。
• Vendor驱动层：屏蔽底层芯片和OS（Operation System）差异，支持多平台适配。

开发指导

Composer部分

接口说明

注：以下接口列举的为VDI接口，接口声明见文件/drivers/peripheral/display/composer/hdi_service/include/idisplay_composer_vdi.h，获取路径为：https://gitee.com/openharmony/drivers_peripheral/tree/master/display/composer。

• idisplay_composer_vdi.h

  功能描述	接口名称
  注册热插拔事件回调	int32_t RegHotPlugCallback(HotPlugCallback cb, void* data)
  获取显示设备能力集	int32_t GetDisplayCapability(uint32_t devId, DisplayCapability& info)
  获取显示设备支持的显示模式信息	int32_t GetDisplaySupportedModes(uint32_t devId, std::vector& modes)
  获取显示设备当前的显示模式	int32_t GetDisplayMode(uint32_t devId, uint32_t& modeId)
  设置显示设备的显示模式	int32_t SetDisplayMode(uint32_t devId, uint32_t modeId)
  获取显示设备当前的电源状态	int32_t GetDisplayPowerStatus(uint32_t devId, DispPowerStatus& status)
  设置显示设备当前的电源状态	int32_t SetDisplayPowerStatus(uint32_t devId, DispPowerStatus status)
  获取显示设备当前的背光值	int32_t GetDisplayBacklight(uint32_t devId, uint32_t& level)
  设置显示设备当前的背光值	int32_t SetDisplayBacklight(uint32_t devId, uint32_t level)
  获取显示设备属性值	int32_t GetDisplayProperty(uint32_t devId, uint32_t id, uint64_t& value)
  获取显示设备合成类型有变化的layer	int32_t GetDisplayCompChange(uint32_t devId, std::vector& layers, std::vector& types)
  设置显示设备的裁剪区域	int32_t SetDisplayClientCrop(uint32_t devId, const IRect& rect)
  设置显示设备的显示缓存	int32_t SetDisplayClientBuffer(uint32_t devId, const BufferHandle& buffer, int32_t fence)
  设置显示设备的显示脏区	int32_t SetDisplayClientDamage(uint32_t devId, std::vector& rects)
  使能垂直同步信号	int32_t SetDisplayVsyncEnabled(uint32_t devId, bool enabled)
  注册VBlank事件回调	int32_t RegDisplayVBlankC