OpenHarmony 适配HDMI接口声卡

高清多媒体接口（High Definition Multimedia Interface，HDMI  ）是一种全数字化视频和声音发送接口，可以发送未压缩的音频及视频信号。HDMI可用于机顶盒、DVD播放机、个人计算机、电视、游戏主机、综合扩大机、数字音响与电视机等设备。HDMI可以同时发送音频和视频信号，由于音频和视频信号采用同一条线材，大大简化系统线路的安装难度。这块是百度百科对HDMI的简单介绍，我们再看看HDMI不同版本对音频的支持情况：

当前我们使用最多的是2.0版本，本文介绍了OpenHarmony系统支持HDMI声卡的适配过程，带有HDMI声卡的设备包括电视、投影仪和一些带有音响的显示器。

1 功能描述

OpenHarmony系统中音频系统使用ADM框架，下面是ADM框架的组成：

ADM框架是基于HDF系统框架开发，Card Manager是用来管理多个声卡链表，Controller是声卡的控制模块包含了音量、静音、通路选择等控制功能。

Audio Control Dispath是控制功能的中转站负责接收HDI下发的控制命令和将控制命令转发给各个声卡组件。Audio Stream Dispatch是数据流的中转站，播放过程中负责接收HDI的数据流，在录音过程中负责上传声卡的录音数据流。

Run Time Device中包括的这些模块就是一个声卡工作需要的驱动服务。其中codec编解码模块驱动服务、dai数字音频接口驱动服务和platform片上系统也就是DMA模块驱动服务是大多数声卡所必须的。HDMI声卡和其他声卡一样由三个模块组成codec编解码模块、dai数字音频接口和platform片上系统也就是DMA模块。

HDMI的codec是集成在HDMI转换芯片内部的我们只需要将PCM音频流给到HDMI转换芯片就可以。DAI这块使用的是I2S总线连接HDMI芯片和platform。要实现对HDMI声卡的支持，就需要将这几个模块的驱动注册到ADM框架中。

本文基于3月1日的OpenHarmony master分支进行介绍。基于yangfan平台介绍，如适配其他平台相关配置根据具体平台进行修改。

OpenHarmony系统支持HDMI声卡的插拔识别，支持HDMI声卡的播放功能，包括启动、停止、暂停、恢复功能。

2 准备工作

2.1 查询物理连接

这是一个HDMI设备模块的逻辑试图，图中可以看到音频数据可以通过两种接口I2S或者SPIDIF将音频数据传给HDMI设备，此处我们使用的是I2S总线。

首先需要查看芯片手册HDMI模块和SOC是如何连接的，找到音频数据传输相应的I2S总线，这块是更具rk3568芯片查到的数据，I2S0连接的是HDMI。

2.2 查询寄存器地址

因为我们使用I2S总线就要对其进行配置所以我们需要找到I2S总线的基地址和I2S总线的寄存器说明。查看芯片手册找到I2S总线对应的寄存器基地址。

3 代码介绍

HDMI的驱动codec的代码ADM框架中已经实现了，我们只需要根据不同的单板平台修改平台下面的配置文件。Dai和platform的驱动代码需要根据各自平台自行开发。yangfan开发板Dai和platform驱动代码路径在device\board\isoftstone\yangfan\kernel\hdf\drivers\audio下面的dai和soc目录下面。

涉及到的配置文件如下：vendor/isoftstone/yangfan/hdf_config/khdf/audio$ tree

├── audio_config.hcs   // 此配置文件配置声卡信息
├── codec_config.hcs   // 此配置文件配置codec信息
├── dai_config.hcs     // 此配置文件配置dai信息
└── dma_config.hcs    // 此配置文件配置platform信息
vendor/isoftstone/yangfan/hdf_config/khdf/device_info/
device_info.hcs  //此配置文件配置声卡驱动服务信息

修改涉及的代码仓：device_board_hihope、vendor_isoftstone和kernel_linux_config

4 构建开关

OpenHarmony系统要支持HDMI声卡首先要打开构建开关：在文件kernel/linux/config/linux-5.10/arch/arm64/configs/rockchip_standard_defconfig

添加：CONFIG_DRIVERS_HDF_AUDIO_HDMI=y

5 功能配置

HCS(HDF Configuration Source)是HDF驱动框架的配置描述源码，内容以Key-Value为主要形式。它实现了配置代码与驱动代码解耦，便于开发者进行配置管理。

5.1 配置文件：device_info.hcs 添加hdmi声卡节点信息。

文件路径：vendor/isoftstone/yangfan/hdf_config/khdf/device_info/

HDMI声卡插入后系统会根据此处配置的声卡节点加载HDMI声卡驱动。

  audio :: host {
            hostName = "audio_host";
            priority = 110;
            device_dai :: device {...