当前位置： 首页 > article >正文

OpenHarmony（鸿蒙南向）——平台驱动指南【HDMI】

article 2024/11/16 23:29:40

往期知识点记录：

  • 鸿蒙（HarmonyOS）应用层开发（北向）知识点汇总
  • 鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
  • 持续更新中……

概述

功能简介

HDMI（High Definition Multimedia Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频Source到TV、显示器等Sink设备的传输。

HDMI以主从方式工作，通常有一个Source端和一个Sink端。

HDMI接口定义了完成HDMI传输的通用方法集合，包括：

  • HDMI控制器管理：打开或关闭HDMI控制器

  • HDMI启动/停止传输：启动或停止HDMI传输

  • HDMI控制器设置：设置音频、视频及HDR属性，设置色彩深度、声音图像消隐等

  • HDMI读取EDID：读取Sink端原始的EDID数据

  • HDMI热插拔：注册/注销热插拔回调函数

基本概念

HDMI是Hitachi、Panasonic、Philips、Silicon Image、Sony、Thomson、Toshiba共同发布的一款音视频传输协议。传输过程遵循TMDS（Transition Minimized Differential Signaling）协议。

  • TMDS（Transition Minimized Differential signal）：过渡调制差分信号，也被称为最小化传输差分信号，用于发送音频、视频及各种辅助数据。

  • DDC（Display Data Channel）：显示数据通道，发送端与接收端可利用DDC通道得知彼此的发送与接收能力，但HDMI仅需单向获知接收端（显示器）的能力。

  • CEC（Consumer Electronics Control）：消费电子控制，该功能应该能够在连接HDMI的发送设备与接收设备之间实现交互操作。

  • FRL（Fixed Rate Link）：TMDS 的架构进行讯号传输时，最高带宽可达 18Gbps，而FRL模式的带宽则提升到48 Gbps。

  • HDCP（High-bandwidth Digital Content Protection）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。

  • EDID（Extended Display Identification Data）：扩展显示标识数据，通常存储在显示器的固件中，标识供应商信息、EDID版本信息、最大图像大小、颜色设置、厂商预设置、频率范围的限制以及显示器名和序列号的字符串。

运作机制

在HDF框架中，HDMI模块接口适配模式拟采用独立服务模式，如图1所示。在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDF设备管理器的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用。

独立服务模式下，核心层不会统一发布一个服务供上层使用，因此这种模式下驱动要为每个控制器发布一个服务，具体表现为：

  • 驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。

  • device_info.hcs文件中deviceNode的policy字段为1或2，不能为0。

图 1 HDMI独立服务模式结构图

HDMI模块各分层作用：

  • 接口层提供打开HDMI设备、启动HDMI传输、停止HDMI传输、声音图像消隐设置、设置色彩深度、获取色彩深度、设置视频属性、获取视频属性、设置HDR属性、读取Sink端原始EDID数据、注册HDMI热插拔检测回调函数、注销HDMI热插拔检测回调函数、关闭HDMI设备的接口。

  • 核心层主要提供HDMI控制器的打开、关闭及管理的能力，通过钩子函数与适配层交互。

  • 适配层主要是将钩子函数的功能实例化，实现具体的功能。

HDMI的Source端提供+5V和GND，用于DDC和CEC通信。通过DDC通道，Source端可以读取Sink端的各项参数，如接受能力等；CEC为可选通道，用于同步Source端与Sink端的控制信号，改善用户体验。TMDS通道有四组差分信号，TMDS Clock Channel为TMDS提供时钟信号，其余三组传输音视频数据及各种辅助数据；HDP为热插拔检测端口，当有Sink端接入时，Source端会通过中断服务程序进行响应。

HDMI物理连接如图2所示：

图 2 HDMI物理连线示意图

约束与限制

HDMI模块当前仅支持轻量和小型系统内核（LiteOS），暂无实际适配驱动 。

使用指导

场景介绍

HDMI具有体积小，传输速率高，传输带宽宽，兼容性好，能同时传输无压缩音视频信号等优点。与传统的全模拟接口相比，HDMI不但增加了设备间接线的便捷性，还提供了一些HDMI特有的智能化功能，可用于小体积设备进行高质量音视频传输的场景。

接口说明

HDMI模块提供的主要接口如下所示，具体API详见//drivers/hdf_core/framework/include/platform/hdmi_if.h。

表 1 HDMI驱动API接口功能介绍

接口名描述
HdmiOpen打开HDMI控制器
HdmiClose关闭HDMI控制器
HdmiStart启动HDMI传输
HdmiStop停止HDMI传输
HdmiAvmuteSet声音图像消隐设置
HdmiDeepColorSet设置色彩深度
HdmiDeepColorGet获取色彩深度
HdmiSetVideoAttribute设置视频属性
HdmiSetAudioAttribute设置音频属性
HdmiSetHdrAttribute设置HDR属性
HdmiReadSinkEdid读取Sink端原始EDID数据
HdmiRegisterHpdCallbackFunc注册HDMI热插拔检测回调函数
HdmiUnregisterHpdCallbackFunc注销HDMI热插拔检测回调函数

开发步骤

使用HDMI设备的一般流程如图3所示。

图 3 HDMI设备使用流程图

打开HDMI控制器

在进行HDMI通信前，首先要调用HdmiOpen打开HDMI控制器。

DevHandle HdmiOpen(int16_t number);

表 2 HdmiOpen参数和返回值描述

参数参数描述
numberint16_t类型，HDMI控制器号
返回值返回值描述
NULL打开HDMI控制器失败
控制器句柄打开的HDMI控制器句柄

假设系统中存在2个HDMI控制器，编号从0到1，以下代码示例为获取0号控制器：

DevHandle hdmiHandle = NULL;  // HDMI控制器句柄

// 打开HDMI控制器
hdmiHandle = HdmiOpen(0);
if (hdmiHandle == NULL) {
    HDF_LOGE("HdmiOpen: hdmi open fail!\n");
    return NULL;
}
注册热插拔检测回调函数
int32_t HdmiRegisterHpdCallbackFunc(DevHandle handle, struct HdmiHpdCallbackInfo *callback);

表 3 HdmiRegisterHpdCallbackFunc参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
callback结构体指针，热插拔回调函数信息
返回值返回值描述
HDF_SUCCESS注册成功
负数注册失败

注册热插拔检测回调函数示例：

// 热插拔检测回调函数定义
static void HdmiHpdHandle(void *data, bool hpd)
{
    if (data == NULL) {
        HDF_LOGE("priv data is NULL");
        return;
    }
    if (hpd == true) {
        HDF_LOGD("HdmiHpdHandle: hot plug");
        // 调用者添加相关处理
    } else {
        HDF_LOGD("HdmiHpdHandle: hot unplug");
        // 调用者添加相关处理
    }
}

// 热插拔检测回调函数注册示例
struct HdmiHpdCallbackInfo info = {0};
info.data = handle;
info.callbackFunc = HdmiHpdHandle;
ret = HdmiRegisterHpdCallbackFunc(hdmiHandle, info);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiRegisterHpdCallbackFunc: Register hpd callback func fail, ret:%d", ret);
    return ret;
}
读取EDID
int32_t HdmiReadSinkEdid(DevHandle handle, uint8_t *buffer, uint32_t len);

表 4 HdmiReadSinkEdid参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
bufferuint8_t类型指针，数据缓冲区
lenuint32_t类型，数据长度
返回值返回值描述
正整数成功读取的原始EDID数据
负数或0读取失败

读取Sink端的原始EDID数据示例：

int32_t len;
uint8_t edid[HDMI_EDID_MAX_LEN] = {0};

len = HdmiReadSinkEdid(hdmiHandle, edid, HDMI_EDID_MAX_LEN);
if (len <= 0) {
    HDF_LOGE("HdmiReadSinkEdid: hdmi read sink edid fail, len = %d.", len);
	return HDF_FAILURE;
}
设置音频属性
int32_t HdmiSetAudioAttribute(DevHandle handle, struct HdmiAudioAttr *attr);

表 5 HdmiSetAudioAttribute参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
attr结构体指针，音频属性
返回值返回值描述
HDF_SUCCESS设置成功
负数设置失败

设置音频属性示例：

struct HdmiAudioAttr audioAttr = {0};
int32_t ret;

audioAttr.codingType = HDMI_AUDIO_CODING_TYPE_MP3;
audioAttr.ifType = HDMI_AUDIO_IF_TYPE_I2S;
audioAttr.bitDepth = HDMI_ADIO_BIT_DEPTH_16;
audioAttr.sampleRate = HDMI_SAMPLE_RATE_8K;
audioAttr.channels = HDMI_AUDIO_FORMAT_CHANNEL_3;
ret = HdmiSetAudioAttribute(handle, &audioAttr);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiSetAudioAttribute: hdmi set audio attribute fail!, ret:%d", ret);
    return ret;
}
设置视频属性
int32_t HdmiSetVideoAttribute(DevHandle handle, struct HdmiVideoAttr *attr);

表 6 HdmiSetVideoAttribute参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
attr结构体指针，视频属性
返回值返回值描述
HDF_SUCCESS设置成功
负数设置失败

设置视频属性示例：

struct HdmiVideoAttr videoAttr = {0};
int32_t ret;

videoAttr.colorSpace = HDMI_COLOR_SPACE_YCBCR444;
videoAttr.colorimetry = HDMI_COLORIMETRY_EXTENDED;
videoAttr.extColorimetry = HDMI_EXTENDED_COLORIMETRY_BT2020_CONST_LUM;
videoAttr.quantization = HDMI_QUANTIZATION_RANGE_FULL;
ret = HdmiSetVideoAttribute(handle, &videoAttr);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiSetVideoAttribute: hdmi set video attribute fail, ret:%d.", ret);
    return ret;
}
设置HDR属性
int32_t HdmiSetHdrAttribute(DevHandle handle, struct HdmiHdrAttr *attr);

表 7 HdmiSetHdrAttribute参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
attr结构体指针，HDR属性
返回值返回值描述
HDF_SUCCESS设置成功
负数设置失败

设置HDR属性示例：

struct HdmiHdrAttr hdrAttr = {0};
int32_t ret;

hdrAttr.mode = HDMI_HDR_MODE_CEA_861_3;
hdrAttr.userMode = HDMI_HDR_USERMODE_DOLBY;
hdrAttr.eotfType = HDMI_EOTF_SMPTE_ST_2048;
hdrAttr.metadataType = HDMI_DRM_STATIC_METADATA_TYPE_1;
hdrAttr.colorimetry = HDMI_HDR_EXTENDED_COLORIMETRY_XV_YCC_709;
ret = HdmiSetHdrAttribute(handle, &hdrAttr);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiSetHdrAttribute: hdmi set hdr attribute fail, ret:%d", ret);
    return ret;
}
设置HDMI声音图像消隐
int32_t HdmiAvmuteSet(DevHandle handle, bool enable);

表 8 HdmiAvmuteSet参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
enable布尔值，使能/去使能avmute
返回值返回值描述
HDF_SUCCESS设置成功
负数设置失败

设置声音图像消隐示例：

int32_t ret;

ret = HdmiAvmuteSet(hdmiHandle, true);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiAvmuteSet: hdmi avmute set fail, ret:%d", ret);
    return ret;
}
设置色彩深度
int32_t HdmiDeepColorSet(DevHandle handle, enum HdmiDeepColor color);

表 9 HdmiDeepColorSet参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
color枚举类型，色彩深度
返回值返回值描述
HDF_SUCCESS设置成功
负数设置失败

设置色彩深度示例：

int32_t ret;

ret = HdmiDeepColorSet(handle, HDMI_DEEP_COLOR_48BITS);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiDeepColorSet: hdmi deep color set fail, ret:%d.", ret);
    return ret;
}
获取色彩深度
int32_t HdmiDeepColorGet(DevHandle handle, enum HdmiDeepColor *color);

表 10 HdmiDeepColorGet参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
color枚举类型指针，色彩深度
返回值返回值描述
HDF_SUCCESS获取成功
负数获取失败

获取色彩深度示例：

enum HdmiDeepColor color;
int32_t ret;

ret = HdmiDeepColorGet(handle, &color);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiDeepColorGet: hdmi deep color get fail, ret:%d", ret);
    return ret;
}
启动HDMI传输
int32_t HdmiStart(DevHandle handle);

表 11 HdmiStart参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
返回值返回值描述
HDF_SUCCESS启动成功
负数启动失败

启动HDMI传输示例：

int32_t ret;

ret = HdmiStart(hdmiHandle);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiStart: start transmission fail, ret:%d", ret);
    return ret;
}
停止HDMI传输
int32_t HdmiStop(DevHandle handle);

表 12 HdmiStop参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
返回值返回值描述
HDF_SUCCESS停止成功
负数停止失败

停止HDMI传输示例：

int32_t ret;

ret = HdmiStop(hdmiHandle);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiStop: stop transmission fail, ret:%d.", ret);
    return ret;
}
注销热插拔检测回调函数
int32_t HdmiUnregisterHpdCallbackFunc(DevHandle handle);

表 13 HdmiUnregisterHpdCallbackFunc参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄
返回值返回值描述
HDF_SUCCESS注销成功
负数注销失败

注销热插拔检测回调函数示例：

int32_t ret;

ret = HdmiUnregisterHpdCallbackFunc(hdmiHandle);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("HdmiUnregisterHpdCallbackFunc：unregister fail, ret:%d.", ret);
    return ret;
}
关闭HDMI控制器
void HdmiClose(DevHandle handle);

表 14 HdmiClose参数和返回值描述

参数参数描述
handleDevHandle类型，HDMI控制器句柄

关闭HDMI控制器示例：

HdmiClose(hdmiHandle);

使用实例

本例程以操作开发板上的HDMI设备为例，详细展示HDMI接口的完整使用流程。

本例拟在Hi3516DV300开发板上对虚拟驱动进行简单的传输操作：

  • SOC：hi3516dv300。

  • HDMI控制器：使用0号HDMI控制器。

示例如下：

#include "hdmi_if.h"          /* HDMI标准接口头文件 */
#include "hdf_log.h"         /* 标准日志打印头文件 */
#include "osal_time.h"       /* 标准延迟&睡眠接口头文件 */

/* 热插拔回调函数 */
static void HdmiHpdHandle(void *data, bool hpd)
{
    if (data == NULL) {
    HDF_LOGE("priv data is NULL");
    return;
    }

    if (hpd == true) {
        HDF_LOGD("HdmiHpdHandle: hot plug");
        /* 调用者添加相关处理 */
    } else {
        HDF_LOGD("HdmiHpdHandle: hot unplug");
        /* 调用者添加相关处理 */
    }
}

/* 设置HDMI相关属性 */
static int32_t TestHdmiSetAttr(DevHandle handle)
{
    enum HdmiDeepColor color;
    struct HdmiVideoAttr videoAttr = {0};
    struct HdmiAudioAttr audioAttr = {0};
    struct HdmiHdrAttr hdrAttr = {0};
    int32_t ret;

    ret = HdmiDeepColorSet(handle, HDMI_DEEP_COLOR_48BITS);

    if (ret != 0) {
        HDF_LOGE("HdmiDeepColorSet failed.");
        return ret;
    }
    ret = HdmiDeepColorGet(handle, &color);
    if (ret != 0) {
        HDF_LOGE("HdmiDeepColorGet failed.");
        return ret;
    }
    HDF_LOGE("HdmiDeepColorGet successful, color = %d.", color);
    videoAttr.colorSpace = HDMI_COLOR_SPACE_YCBCR444;
    videoAttr.colorimetry = HDMI_COLORIMETRY_EXTENDED;
    videoAttr.extColorimetry = HDMI_EXTENDED_COLORIMETRY_BT2020_CONST_LUM;
    videoAttr.quantization = HDMI_QUANTIZATION_RANGE_FULL;
    ret = HdmiSetVideoAttribute(handle, &videoAttr);
    if (ret != 0) {
        HDF_LOGE("HdmiSetVideoAttribute failed.");
        return ret;
    }
    audioAttr.codingType = HDMI_AUDIO_CODING_TYPE_MP3;
    audioAttr.ifType = HDMI_AUDIO_IF_TYPE_I2S;
    audioAttr.bitDepth = HDMI_ADIO_BIT_DEPTH_16;
    audioAttr.sampleRate = HDMI_SAMPLE_RATE_8K;
    audioAttr.channels = HDMI_AUDIO_FORMAT_CHANNEL_3;
    ret = HdmiSetAudioAttribute(handle, &audioAttr);
    if (ret != 0) {
        HDF_LOGE("HdmiSetAudioAttribute failed.");
        return ret;
    }
    hdrAttr.mode = HDMI_HDR_MODE_CEA_861_3;
    hdrAttr.userMode = HDMI_HDR_USERMODE_DOLBY;
    hdrAttr.eotfType = HDMI_EOTF_SMPTE_ST_2048;
    hdrAttr.metadataType = HDMI_DRM_STATIC_METADATA_TYPE_1;
    hdrAttr.colorimetry = HDMI_HDR_EXTENDED_COLORIMETRY_XV_YCC_709;
    ret = HdmiSetHdrAttribute(handle, &hdrAttr);
    if (ret != 0) {
        HDF_LOGE("HdmiSetHdrAttribute failed.");
        return ret;
    }

    return 0;
}

/* HDMI例程总入口 */
static int32_t TestCaseHdmi(void)
{
    DevHandle handle = NULL;
    int32_t ret;

    struct HdmiHpdCallbackInfo info = {0};
    uint8_t data[128] = {0};

    HDF_LOGD("HdmiAdapterInit: successful.");
    handle = HdmiOpen(0);
    if (handle == NULL) {
        HDF_LOGE("HdmiOpen failed.");
        return ret;
    }
    info.data = handle;
    info.callbackFunc = HdmiHpdHandle;
    ret = HdmiRegisterHpdCallbackFunc(handle, &info);
    if (ret != 0) {
        HDF_LOGE("HdmiRegisterHpdCallbackFunc failed.");
        return ret;
    }

    ret = HdmiReadSinkEdid(handle, data, 128);
    if (ret <= 0) {
        HDF_LOGE("HdmiReadSinkEdid failed.");
        return ret;
    }
    HDF_LOGE("HdmiReadSinkEdid successful, data[6] = %d, data[8] = %d.", data[6], data[8]);

    ret = TestHdmiSetAttr(handle);
    if (ret != 0) {
        HDF_LOGE("TestHdmiSetAttr failed.");
        return ret;
    }

    ret = HdmiStart(handle);
    if (ret != 0) {
        HDF_LOGE("HdmiStart failed.");
        return ret;
    }

    OsalMSleep(1000);

    ret = HdmiStop(handle);
    if (ret != 0) {
        HDF_LOGE("HdmiStop failed.");
        return ret;
    }

    ret = HdmiUnregisterHpdCallbackFunc(handle);
    if (ret != 0) {
        HDF_LOGE("HdmiUnregisterHpdCallbackFunc failed.");
        return ret;
    }
    HdmiClose(handle);
    return 0;
}

最后

经常有很多小伙伴抱怨说：不知道学习鸿蒙开发哪些技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？

为了能够帮助到大家能够有规划的学习，这里特别整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

在这里插入图片描述

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）:https://gitcode.com/HarmonyOS_MN/733GH/overview

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

鸿蒙开发面试真题（含参考答案）:

在这里插入图片描述

OpenHarmony 设备开发学习手册:https://gitcode.com/HarmonyOS_MN/733GH/overview

图片
在这里插入图片描述

http://www.kler.cn/a/321673.html

相关文章：

  • LogViewer NLog, Log4Net, Log4j 文本日志可视化
  • 初识Linux · 共享内存
  • 【卡尔曼滤波】数据融合Fusion的应用 C语言、Python实现（Kalman Filter）
  • 生成自签名证书并配置 HTTPS 使用自签名证书
  • C++——视频问题总结
  • 《鸿蒙生态：开发者的机遇与挑战》
  • 倾斜单体化重建异形和异形建筑思路整理
  • 力扣583-两个字符串的删除操作（Java详细题解）
  • Spring Boot的核心技术有哪些?
  • AIGC引领数智未来：企业架构演进的深度解析与实践路径，The Open Group 2024生态系统架构·可持续发展年度大会专题报道
  • 深入理解 CompletableFuture 的底层原理
  • 使用npm link 把一个本地项目变成依赖,引入到另一个项目中
  • xlsx库插件读取excel文件
  • 在使用 Docker 时，用户可能会遇到各种常见的错误和问题
  • 使用python进行自然语言处理的示例
  • jmeter-请求参数加密-MD5加密
  • 美食共享圈：Spring Boot校园周边美食平台
  • uniapp踩坑 tabbar页面数据刷新了但视图没有更新
  • 【1分钟学会】JSON
  • Sentinel-1 数据处理时如何手动下载高程数据
  • 形象解释暂停方法和旁路方法
  • 力扣30. 串联所有单词的子串
  • Linux中的进程替换
  • linux：chown用法详解
  • 微调大模型（Finetuning Large Language Models）—Where finetuning fits in（二）
  • Oracle 相关的工具使用 SQL Developer ， sqlplus