docs: Modify some details and adjust the document structure.

Signed-off-by: N yafeng_wang <wangyafeng15@huawei.com>

docs: Modify some details and adjust the document structure.
Signed-off-by: N yafeng_wang <wangyafeng15@huawei.com>
501c6999 · yafeng_wang · 488a719c · 501c6999 · 501c6999 · 501c6999
7 changed file
--- a/zh-cn/device-dev/driver/driver-platform-adc-des.md
+++ b/zh-cn/device-dev/driver/driver-platform-adc-des.md
 # ADC<a name="1"></a>

 -   [概述](#section1)
-   [接口说明](#section2)
-   [使用指导](#section3)
-    -   [使用流程](#section4)
-    -   [打开ADC设备](#section5)
-    -   [读取AD转换结果](#section6)
-    -   [关闭ADC设备](#section7)
-
-   [使用实例](#section8)
+    -   [功能简介](#section2)
+    -   [基本概念](#section3) 
+    -   [运作机制](#section4) 
+    -   [约束与限制](#section5)
+-   [使用指导](#section6)
+    -   [场景介绍](#section7)
+    -   [接口说明](#section8) 
+    -   [开发步骤](#section9)
+    -   [使用实例](#section10)

 ## 概述<a name="section1"></a>

+### 功能简介<a name="section2"></a>
+
 -   ADC（Analog to Digital Converter），即模拟-数字转换器，是一种将模拟信号转换成对应数字信号的设备。

 -   ADC接口定义了完成ADC传输的通用方法集合，包括：
    -   ADC设备管理：打开或关闭ADC设备。
    -   ADC读取转换结果：读取AD转换结果。

-    **图 1**  ADC物理连线示意图<a name="fig1"></a>  
-    ![](figures/ADC物理连线示意图.png "ADC物理连线示意图")
+### 基本概念<a name="section3"></a>
+
+ADC主要用于将模拟量转换成数字量，从而便于存储与计算等。
+
+ADC的主要技术参数有：
+
+- 分辨率
+  分辨率指的是ADC模块能够转换的二进制位数，位数越多分辨率越高。
+
+- 转换误差
+  转换误差通常是以输出误差的最大值形式给出。它表示A/D转换器实际输出的数字量和理论上的输出数字量之间的差别。常用最低有效位的倍数表示。
+
+- 转换时间
+  转换时间是指A/D转换器从转换控制信号到来开始，到输出端得到稳定的数字信号所经过的时间。
+
+### 运作机制<a name="section4"></a>
+
+在HDF框架中，同类型设备对象较多时（可能同时存在十几个同类型配置器），如果采用独立服务模式则需要配置更多的设备节点，且相关服务会占据更多的内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现），实现便捷管理和节约资源的目的。ADC模块接口适配模式采用统一服务模式。
+
+ADC模块各分层的作用为：接口层提供打开设备，写入数据，关闭设备的接口。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
+
+除电源线和地线之外，ADC只需要1根线与被测量的设备进行连接，其物理连线如[图1](#fig1)所示：
+
+**图 1**  ADC物理连线示意图<a name="fig1"></a>  
+![](figures/ADC物理连线示意图.png "ADC物理连线示意图")
+
+### 约束与限制<a name="section5"></a>
+
+ADC模块当前仅支持轻量和小型系统内核（LiteOS） 。
+
+## 使用指导<a name="section6"></a>

-## 接口说明<a name="section2"></a>
+### 场景介绍<a name="section7"></a>
+
+ADC设备通常用于将模拟电压转换为数字量，如与咪头搭配进行声音采集、与NTC电阻搭配进行温度测量，或者将其他模拟传感器的输出量转换为数字量的场景。
+
+### 接口说明<a name="section8"></a>
+
+ADC模块提供的主要接口如[表1](#table1)所示，更多关于接口的介绍请参考对应的API接口文档。

 **表 1**  ADC驱动API接口功能介绍

 <a name="table1"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="18.63%"><p>功能分类</p>
-</th>
-<th class="cellrowborder" valign="top" width="28.03%"><p>接口名</p>
-</th>
-<th class="cellrowborder" valign="top" width="53.339999999999996%"><p>描述</p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>ADC设备管理接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>AdcOpen</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">打开ADC设备</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>AdcClose</p>
-</td>
-<td valign="top"><p>关闭ADC设备</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" valign="top" width="18.63%"><p>ADC读取转换结果接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>AdcRead</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%"><p>读取AD转换结果值</p>
-</td>
-</tr>
-</table>
-
-## 使用指导<a name="section3"></a>
-
-### 使用流程<a name="section4"></a>
+| 接口名   | 描述             |
+| -------- | ---------------- |
+| AdcOpen  | 打开ADC设备      |
+| AdcClose | 关闭ADC设备      |
+| AdcRead  | 读取AD转换结果值 |
+
+### 开发步骤<a name="section9"></a>

 使用ADC设备的一般流程如[图2](#fig2)所示。

 **图 2**  ADC使用流程图<a name="fig2"></a>  
 ![](figures/ADC使用流程图.png "ADC使用流程图") 

-### 打开ADC设备<a name="section5"></a>
+
+#### 打开ADC设备

 在进行AD转换之前，首先要调用AdcOpen打开ADC设备。

@@ -77,34 +91,12 @@ DevHandle AdcOpen(int16_t number);

 <a name="table2"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="20.66%"><p>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="79.34%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="20.66%"><p>number</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>ADC设备号</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>NULL</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开ADC设备失败</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>设备句柄</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开的ADC设备句柄</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述          |
+| ---------- | ----------------- |
+| number     | ADC设备号         |
+| **返回值** | **返回值描述**    |
+| NULL       | 打开ADC设备失败   |
+| 设备句柄   | 打开的ADC设备句柄 |

 假设系统中存在2个ADC设备，编号从0到1，那么我们现在打开1号设备。

@@ -114,12 +106,12 @@ DevHandle adcHandle = NULL;  /* ADC设备句柄 /
 /* 打开ADC设备 */
 adcHandle = AdcOpen(1);
 if (adcHandle == NULL) {
-    HDF_LOGE("AdcOpen: failed\n");
+    HDF_LOGE("AdcOpen: fail\n");
    return;
 }
 ```

-### 读取AD转换结果<a name="section6"></a>
+#### 读取AD转换结果

 ```c
 int32_t AdcRead(DevHandle handle, uint32_t channel, uint32_t *val);
@@ -129,46 +121,29 @@ int32_t AdcRead(DevHandle handle, uint32_t channel, uint32_t *val);

 <a name="table3"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>ADC设备句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>channel</p>
-</td>
-<td class="cellrowborder"valign="top" width="50%"><p>ADC设备通道号</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>val</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>AD转换结果</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>读取成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>读取失败</p>
-</td>
-</tr>
-</tbody>
-</table>
-
-### 关闭ADC设备<a name="section7"></a>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | ADC设备句柄    |
+| channel    | ADC设备通道号  |
+| val        | AD转换结果     |
+| **返回值** | **返回值描述** |
+| 0          | 读取成功       |
+| 负数       | 读取失败       |
+
+读取转换结果示例（以通道1为例）：
+
+```c
+uint32_t value;
+int32_t ret;
+
+ret = AdcRead(adcHandle, 1, &value);
+if (ret != 0) {
+    HDF_LOGE("ADC read fail!\n");
+    return;
+}
+```
+
+#### 关闭ADC设备

 ADC通信完成之后，需要关闭ADC设备。
 ```c
@@ -178,29 +153,11 @@ void AdcClose(DevHandle handle);

 <a name="table4"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p>参数</p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p>参数描述</p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>ADC设备句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>无</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>无</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数   | 参数描述    |
+| ------ | ----------- |
+| handle | ADC设备句柄 |
+| 返回值 | 返回值描述  |
+| 无     | 无          |

 关闭ADC设备示例：

@@ -208,7 +165,7 @@ void AdcClose(DevHandle handle);
 AdcClose(adcHandle); /* 关闭ADC设备 */
 ```

-## 使用实例<a name="section8"></a>
+### 使用实例<a name="section10"></a>

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

@@ -249,7 +206,7 @@ static int32_t TestCaseAdc(void)
    for (i = 0; i < 30; i++) {
        ret = AdcRead(adcHandle, ADC_CHANNEL_NUM, &Readbuf[i]);
        if (ret != HDF_SUCCESS) {
-            HDF_LOGE("%s: tp ADC write reg fail!:%d", __func__, ret);
+            HDF_LOGE("%s: ADC read fail!:%d", __func__, ret);
            AdcClose(adcHandle);
            return -1;
        }
@@ -262,4 +219,3 @@ static int32_t TestCaseAdc(void)
    return 0;
 }
 ```
-
--- a/zh-cn/device-dev/driver/driver-platform-hdmi-des.md
+++ b/zh-cn/device-dev/driver/driver-platform-hdmi-des.md
 # HDMI<a name="1"></a>

 -   [概述](#section1)
-   [接口说明](#section2)
-   [使用指导](#section3)
-    -   [使用流程](#section4)
-    -   [打开HDMI控制器](#section5)
-    -   [注册热插拔回调函数](#section6)
-    -   [读取EDID](#section7)
-    -   [设置属性](#section8)
-    -   [启动HDMI传输](#section10)
-    -   [停止HDMI传输](#section11)
-    -   [注销热插拔回调函数](#section12)
-    -   [关闭HDMI控制器](#section13)
-    
-   [使用实例](#section14)
+    -   [功能简介](#section2)
+    -   [基本概念](#section3)
+    -   [运作机制](#section4)
+    -   [约束与限制](#section5)
+-   [使用指导](#section6)
+    -   [场景介绍](#section7)
+    -   [接口说明](#section8)
+    -   [开发步骤](#section9)
+    -   [使用实例](#section10)

 ## 概述<a name="section1"></a>

-   HDMI（High-Definition Multiface Interface）是Hitachi, Panasonic, Philips, SiliconImage, Sony, Thomson, Toshiba共同发布的一款音视频传输协议。
+### 功能简介<a name="section2"></a>
+
+- HDMI（High-Definition Multiface Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频Source到TV、显示器等Sink设备的传输。
 - HDMI以主从方式工作，通常有一个Source端和一个Sink端。
 - HDMI接口定义了完成HDMI传输的通用方法集合，包括：

@@ -26,112 +24,66 @@
    - HDMI控制器设置：设置音频、视频及HDR属性，设置色彩深度、声音图像消隐等
    - HDMI读取EDID：读取Sink端原始的EDID数据
    - HDMI热插拔：注册/注销热插拔回调函数
-   HDMI物理连接如[图1](#fig1)所示：  
-     **图 1**  HDMI物理连线示意图<a name="fig1"></a>  
-     ![](figures/HDMI物理连线示意图.png "HDMI物理连线示意图")

-## 接口说明<a name="section2"></a>
+### 基本概念<a name="section3"></a>
+
+HDMI（High-Definition Multiface Interface）是Hitachi、Panasonic、Philips、SiliconImage、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版本信息、最大图像大小、颜色设置、厂商预设置、频率范围的限制以及显示器名和序列号的字符串。
+
+### 运作机制<a name="section4"></a>
+
+HDMI的Source端提供+5V和GND，用于DDC和CEC通信。通过DDC通道，Source端可以读取Sink端的各项参数，如接受能力等；CEC为可选通道，用于同步Source端与Sink端的控制信号，改善用户体验。TMDS通道有四组差分信号，TMDS Clock Channel为TMDS提供时钟信号，其余三组传输音视频数据及各种辅助数据；HDP为热插拔检测端口，当有Sink端接入时，Source端会通过中断服务程序进行响应。
+
+HDMI物理连接如[图1](#fig1)所示：  
+**图 1**  HDMI物理连线示意图<a name="fig1"></a>  
+![](figures/HDMI物理连线示意图.png "HDMI物理连线示意图")
+
+### 约束与限制<a name="section5"></a>
+
+HDMI模块当前仅支持轻量和小型系统内核（LiteOS） 。
+
+## 使用指导<a name="section6"></a>
+
+### 场景介绍<a name="section7"></a>
+
+HDMI具有体积小，传输速率高，传输带宽宽，兼容性好，能同时传输无压缩音视频信号等优点。与传统的全模拟接口相比，HDMI不但增加了设备间接线的便捷性，还提供了一些HDMI特有的智能化功能，可用于小体积设备进行高质量音视频传输的场景。
+
+### 接口说明<a name="section8"></a>

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

 <a name="table1"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="18.63%"><p>功能分类</p>
-</th>
-<th class="cellrowborder" valign="top" width="28.03%"><p>接口名</p>
-</th>
-<th class="cellrowborder" valign="top" width="53.339999999999996%"><p>描述</p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>HDMI控制器管理接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiOpen</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">打开HDMI控制器</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiClose</p>
-</td>
-<td class="cellrowborder" valign="top"><p>关闭HDMI控制器</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>启动/停止HDMI传输接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiStart</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">启动HDMI传输</p>
-</td>
-</tr>
-<tr id="row5632152611414"><td class="cellrowborder" valign="top"><p>HdmiStop</p>
-</td>
-<td class="cellrowborder" valign="top"><p>停止HDMI传输</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="6" valign="top" width="18.63%"><p>HDMI控制器设置接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiAvmuteSet</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">HDMI声音图像消隐设置</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiDeepColorSet</p>
-</td>
-<td class="cellrowborder" valign="top" headers="mcps1.2.4.1.2 "><p>设置色彩深度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiDeepColorGet</p>
-</td>
-<td class="cellrowborder" valign="top"><p>获取色彩深度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiSetVideoAttribute</p>
-</td>
-<td class="cellrowborder" valign="top"><p>设置视频属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiSetAudioAttribute</p>
-</td>
-<td class="cellrowborder" valign="top"><p>设置音频属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiSetHdrAttribute</p>
-</td>
-<td class="cellrowborder" valign="top"><p>设置HDR属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" valign="top" width="18.63%"><p>EDID获取接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiReadSinkEdid</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">HDMI读取Sink端原始EDID数据</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>HDMI热插拔相关接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiRegisterHpdCallbackFunc</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">注册HDMI热插拔检测回调函数</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>HdmiUnregisterHpdCallbackFunc</p>
-</td>
-<td class="cellrowborder" valign="top"><p>注销HDMI热插拔检测回调函数</p>
-</td>
-</tr>
-</tbody>
-</table>
-
-## 使用指导<a name="section3"></a>
-
-### 使用流程<a name="section4"></a>
+| 接口名                        | 描述                       |
+| ----------------------------- | -------------------------- |
+| HdmiOpen                      | 打开HDMI控制器             |
+| HdmiClose                     | 关闭HDMI控制器             |
+| HdmiStart                     | 启动HDMI传输               |
+| HdmiStop                      | 停止HDMI传输               |
+| HdmiAvmuteSet                 | 声音图像消隐设置           |
+| HdmiDeepColorSet              | 设置色彩深度               |
+| HdmiDeepColorGet              | 获取色彩深度               |
+| HdmiSetVideoAttribute         | 设置视频属性               |
+| HdmiSetAudioAttribute         | 设置音频属性               |
+| HdmiSetHdrAttribute           | 设置HDR属性                |
+| HdmiReadSinkEdid              | 读取Sink端原始EDID数据     |
+| HdmiRegisterHpdCallbackFunc   | 注册HDMI热插拔检测回调函数 |
+| HdmiUnregisterHpdCallbackFunc | 注销HDMI热插拔检测回调函数 |
+
+### 开发步骤<a name="section9"></a>

 使用HDMI设备的一般流程如[图2](#fig2)所示。

 **图 2**  HDMI设备使用流程图<a name="fig2"></a>  
 ![](figures/HDMI使用流程图.png "HDMI使用流程图")

-### 打开HDMI控制器<a name="section5"></a>
+#### 打开HDMI控制器

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

@@ -143,34 +95,12 @@ DevHandle HdmiOpen(int16_t number);

 <a name="table2"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="20.66%"><p>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="79.34%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="20.66%"><p>number</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>HDMI控制器号</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>NULL</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开HDMI控制器失败</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>控制器句柄</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开的HDMI控制器句柄</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述             |
+| ---------- | -------------------- |
+| number     | HDMI控制器号         |
+| **返回值** | **返回值描述**       |
+| NULL       | 打开HDMI控制器失败   |
+| 控制器句柄 | 打开的HDMI控制器句柄 |

 假设系统中存在2个HDMI控制器，编号从0到1，那么我们现在获取0号控制器：

@@ -185,7 +115,7 @@ if (hdmiHandle == NULL) {
 }
 ```

-### 注册热插拔检测回调函数<a name="section6"></a>
+#### 注册热插拔检测回调函数

 ```c
 int32_t HdmiRegisterHpdCallbackFunc(DevHandle handle, struct HdmiHpdCallbackInfo *callback);
@@ -195,39 +125,13 @@ int32_t HdmiRegisterHpdCallbackFunc(DevHandle handle, struct HdmiHpdCallbackInfo

 <a name="table3"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>callback</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>热插拔回调函数信息</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>注册成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>注册失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述           |
+| ---------- | ------------------ |
+| handle     | HDMI控制器句柄     |
+| callback   | 热插拔回调函数信息 |
+| **返回值** | **返回值描述**     |
+| 0          | 注册成功           |
+| 负数       | 注册失败           |

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

@@ -238,28 +142,29 @@ 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 unplog");
+        HDF_LOGD("HdmiHpdHandle: hot unplug");
        /* 调用者添加相关处理 */
    }
 }

-    /* 热插拔检测回调函数注册示例 */
-    struct HdmiHpdCallbackInfo info = {0};
-    info.data = handle;
-    info.callbackFunc = HdmiHpdHandle;
-    ret = HdmiRegisterHpdCallbackFunc(hdmiHandle, info);
-    if (ret != 0) {
+/* 热插拔检测回调函数注册示例 */
+···
+struct HdmiHpdCallbackInfo info = {0};
+info.data = handle;
+info.callbackFunc = HdmiHpdHandle;
+ret = HdmiRegisterHpdCallbackFunc(hdmiHandle, info);
+if (ret != 0) {
    HDF_LOGE("HdmiRegisterHpdCallbackFunc: Register failed.");
-    }
+}
+···
 ```

-### 读取EDID<a name="section7"></a>
+#### 读取EDID

 ```c
 int32_t HdmiReadSinkEdid(DevHandle handle, uint8_t *buffer, uint32_t len);
@@ -269,44 +174,14 @@ int32_t HdmiReadSinkEdid(DevHandle handle, uint8_t *buffer, uint32_t len);

 <a name="table4"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>buffer</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>数据缓冲区</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>len</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>数据长度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>正整数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>成功读取的原始EDID数据</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数或0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>读取失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述               |
+| ---------- | ---------------------- |
+| handle     | HDMI控制器句柄         |
+| buffer     | 数据缓冲区             |
+| len        | 数据长度               |
+| **返回值** | **返回值描述**         |
+| 正整数     | 成功读取的原始EDID数据 |
+| 负数或0    | 读取失败               |

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

@@ -320,8 +195,6 @@ if (len <= 0) {
 }
 ```

-### 设置音频、视频及HDR属性<a name="section8"></a>
-
 #### 设置音频属性

 ```c
@@ -332,39 +205,13 @@ int32_t HdmiSetAudioAttribute(DevHandle handle, struct HdmiAudioAttr *attr);

 <a name="table5"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>attr</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>音频属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数   | 参数描述       |
+| ------ | -------------- |
+| handle | HDMI控制器句柄 |
+| attr   | 音频属性       |
+| 返回值 | 返回值描述     |
+| 0      | 设置成功       |
+| 负数   | 设置失败       |

 设置音频属性示例：

@@ -393,39 +240,13 @@ int32_t HdmiSetVideoAttribute(DevHandle handle, struct HdmiVideoAttr *attr);

 <a name="table6"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>attr</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>视频属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| attr       | 视频属性       |
+| **返回值** | **返回值描述** |
+| 0          | 设置成功       |
+| 负数       | 设置失败       |

 设置视频属性示例：

@@ -453,39 +274,13 @@ int32_t HdmiSetHdrAttribute(DevHandle handle, struct HdmiHdrAttr *attr);

 <a name="table7"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>attr</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDR属性</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| attr       | HDR属性        |
+| **返回值** | **返回值描述** |
+| 0          | 设置成功       |
+| 负数       | 设置失败       |

 设置HDR属性示例：

@@ -504,8 +299,6 @@ if (ret != 0) {
 }
 ```

-### 其他可选设置<a name="section9"></a>
-
 #### 设置HDMI声音图像消隐

 ```c
@@ -516,39 +309,13 @@ int32_t HdmiAvmuteSet(DevHandle handle, bool enable);

 <a name="table8"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>enable</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>使能/去使能avmute</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述          |
+| ---------- | ----------------- |
+| handle     | HDMI控制器句柄    |
+| enable     | 使能/去使能avmute |
+| **返回值** | **返回值描述**    |
+| 0          | 设置成功          |
+| 负数       | 设置失败          |

 设置声音图像消隐示例：

@@ -571,39 +338,13 @@ int32_t HdmiDeepColorSet(DevHandle handle, enum HdmiDeepColor color);

 <a name="table9"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>color</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>色彩深度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>设置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| color      | 色彩深度       |
+| **返回值** | **返回值描述** |
+| 0          | 设置成功       |
+| 负数       | 设置失败       |

 设置色彩深度示例：

@@ -626,39 +367,13 @@ int32_t HdmiDeepColorGet(DevHandle handle, enum HdmiDeepColor *color);

 <a name="table10"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>color</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>色彩深度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>获取成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>获取失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| color      | 色彩深度       |
+| **返回值** | **返回值描述** |
+| 0          | 获取成功       |
+| 负数       | 获取失败       |

 获取色彩深度示例：

@@ -672,7 +387,7 @@ if (ret != 0) {
 }
 ```

-### 启动HDMI传输<a name="section10"></a>
+#### 启动HDMI传输

 ```c
 int32_t HdmiStart(DevHandle handle);
@@ -682,34 +397,12 @@ int32_t HdmiStart(DevHandle handle);

 <a name="table11"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>启动成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>启动失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| **返回值** | **返回值描述** |
+| 0          | 启动成功       |
+| 负数       | 启动失败       |

 启动HDMI传输示例：

@@ -722,7 +415,7 @@ if (ret != 0) {
 }
 ```

-### 停止HDMI传输<a name="section11"></a>
+#### 停止HDMI传输<a name="section11"></a>

 ```c
 int32_t HdmiStop(DevHandle handle);
@@ -732,34 +425,12 @@ int32_t HdmiStop(DevHandle handle);

 <a name="table12"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>停止成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>停止失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| **返回值** | **返回值描述** |
+| 0          | 停止成功       |
+| 负数       | 停止失败       |

 停止HDMI传输示例：

@@ -772,7 +443,7 @@ if (ret != 0) {
 }
 ```

-### 注销热插拔检测回调函数<a name="section12"></a>
+#### 注销热插拔检测回调函数

 ```c
 int32_t HdmiUnregisterHpdCallbackFunc(DevHandle handle);
@@ -782,34 +453,12 @@ int32_t HdmiUnregisterHpdCallbackFunc(DevHandle handle);

 <a name="table13"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>注销成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>注销失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |
+| **返回值** | **返回值描述** |
+| 0          | 注销成功       |
+| 负数       | 注销失败       |

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

@@ -822,7 +471,7 @@ if (ret != 0) {
 }
 ```

-### 关闭HDMI控制器<a name="section13"></a>
+#### 关闭HDMI控制器

 ```c
 void HdmiClose(DevHandle handle);
@@ -832,19 +481,9 @@ void HdmiClose(DevHandle handle);

 <a name="table14"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>HDMI控制器句柄</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | HDMI控制器句柄 |

 关闭HDMI控制器示例：

@@ -852,7 +491,7 @@ void HdmiClose(DevHandle handle);
 HdmiClose(hdmiHandle);
 ```

-## 使用实例<a name="section14"></a>
+### 使用实例<a name="section10"></a>

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

@@ -882,7 +521,7 @@ static void HdmiHpdHandle(void *data, bool hpd)
        HDF_LOGD("HdmiHpdHandle: hot plug");
        /* 调用者添加相关处理 */
    } else {
-        HDF_LOGD("HdmiHpdHandle: hot unplog");
+        HDF_LOGD("HdmiHpdHandle: hot unplug");
        /* 调用者添加相关处理 */
    }
 }

--- a/zh-cn/device-dev/driver/driver-platform-hdmi-develop.md
+++ b/zh-cn/device-dev/driver/driver-platform-hdmi-develop.md
 # HDMI 

 - [概述](#1)
- [开发步骤](#2)
- [开发实例](#3)
+    - [功能简介](#2)
+    - [基本概念](#3)
+    - [运作机制](#4)
+    - [约束与限制](#5)  
+- [开发指导](#6)
+    - [场景介绍](#7)
+    - [接口说明](#8)
+    - [开发步骤](#9)

 ## 概述 <a name="1"></a>

-HDMI（High-Definition Multiface Interface）是Hitachi、Panasonic、Philips、SiliconImage、Sony、Thomson、Toshiba共同发布的一款音视频传输协议，主要用于DVD、机顶盒等音视频source到TV、显示器等sink设备的传输。传输过程遵循TMDS（Transition Minimized Differential Signaling）协议。
+### 功能简介<a name="2"></a>

-在HDF框架中，HDMI的接口适配模式采用独立服务模式，在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用率。
+HDMI（High-Definition Multiface Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频source到TV、显示器等sink设备的传输。

- **图 1**  HDMI统一服务模式<a name="fig1"></a> 
+### 基本概念<a name="3"></a>
+
+HDMI（High-Definition Multiface Interface）是Hitachi、Panasonic、Philips、SiliconImage、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）：即高带宽数字内容保护技术，当用户对高清晰信号进行非法复制时，该技术会进行干扰，降低复制出来的影像的质量，从而对内容进行保护。
+
+
+### 运作机制<a name="4"></a>
+
+在HDF框架中，HDMI的接口适配模式采用独立服务模式（如[图1](#fig1)），在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用率。
+
+ **图 1**  HDMI独立服务模式<a name="fig1"></a> 

 ![image1](figures/独立服务模式结构图.png)

-## 开发步骤 <a name="2"></a>
+### 约束与限制<a name="5"></a>

-HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以及实例化HDMI控制器对象。
+HDMI模块当前仅支持轻量和小型系统内核（LiteOS） 。

-1. **实例化驱动入口：** 
-    - 实例化HdfDriverEntry结构体成员。
-    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
+## 开发指导 <a name="6"></a>

-2. **配置属性文件：**
-    - 在device_info.hcs文件中添加deviceNode描述。
-    - 【可选】添加hdmi_config.hcs器件属性文件。
+### 场景介绍 <a name="7"></a>

-3. **实例化HDMI控制器对象：**
-    - 初始化HdmiCntlr成员。
-    - 实例化HdmiCntlr成员HdmiCntlrOps方法集合，其定义和成员函数说明见下文。
+HDMI具有体积小，传输速率高，传输带宽宽，兼容性好，能同时传输无压缩音视频信号等优点。与传统的全模拟接口相比，HDMI不但增加了设备间接线的便捷性，还提供了一些HDMI特有的智能化功能，可用于小体积设备进行高质量音视频传输的场景。

-    HdmiCntlrOps定义：
-    ```c
-    struct HdmiCntlrOps {
+### 接口说明 <a name="8"></a>
+
+HdmiCntlrOps定义：
+```c
+struct HdmiCntlrOps {
    void (*hardWareInit)(struct HdmiCntlr *cntlr);
    void (*hardWareStatusGet)(struct HdmiCntlr *cntlr, struct HdmiHardwareStatus *status);
    void (*controllerReset)(struct HdmiCntlr *cntlr);
@@ -67,49 +87,66 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
    int32_t (*hdcpGenerateAksvAndAn)(struct HdmiCntlr *cntlr);
    int32_t (*hdcpOptReg)(struct HdmiCntlr *cntlr, enum HdmiHdcpRegOptType type, uint8_t *data, uint32_t len);
    void (*hdrTimerSet)(struct HdmiCntlr *cntlr, struct HdmiHdrTimerConfig *config);
-    };
-    ```
+};
+```
+
+**表1** HdmiCntlrOps结构体成员的回调函数功能说明
+
+| 函数成员                 | 入参                                                         | 出参                                   | 返回值             | 功能                                               |
+| ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- |
+| hardWareInit             | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | 无 | 初始化HDMI硬件 |
+| hardWareStatusGet        | **cntlr**: 结构体指针，核心层HDMI控制器;<br /> | **status**：HDMI硬件状态 ; | 无 | 获取HDMI当前硬件状态         |
+| controllerReset          | **cntlr**: 结构体指针，核心层HDMI控制器; | 无      | 无 | 复位HDMI控制器        |
+| hotPlugStateGet          | **cntlr**: 结构体指针，核心层HDMI控制器;                     | 无                         | bool: HDMI热插拔状态 | 获取HDMI热插拔状态             |
+| hotPlugInterruptStateGet | **cntlr**: 结构体指针，核心层HDMI控制器;                     | 无           | bool: HDMI热插拔中断状态 | 获取HDMI热插拔中断状态                      |
+| lowPowerSet              | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能 | 无                                     | 无 | 使能/去使能低功耗 |
+| tmdsModeSet              | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**:TMDS模式 | 无                                     | 无 | 设置TMDS模式                                      |
+|tmdsConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**: TMDS参数|无|HDF_STATUS相关状态|配置TMDS参数|
+|infoFrameEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**enable**: bool，使能/去使能|无|无|使能/去使能infoFrame|
+|infoFrameSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**data**: infoFrame数据<br />**len**:数据长度|无|HDF_STATUS相关状态|发送inforFrame|
+|cecMsgSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**msg**: CEC消息|无|HDF_STATUS相关状态|发送CEC消息|
+|audioPathEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio通路|
+|audioPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: 配置信息|无|无|设置audio通路配置信息|
+|phyOutputEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能物理层输出状态|
+|phyOutputSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**: 配置信息|无|无|设置物理层配置信息|
+|blackDataSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|设置黑屏|
+|videoMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能video静音|
+|videoPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**attr**： 配置信息|无|无|设置viedo通路配置信息|
+|audioMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio静音|
+|avmuteSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能声音图像消隐|
+|ddcTransfer|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**ddcCfg**：DDC配置参数|**ddcCfg**：DDC配置参数|HDF_STATUS相关状态|读写DDC数据|
+|scdcSourceScrambleGet|**cntlr**: 结构体指针，核心层HDMI控制器;|无|bool，加扰状态|获取source端的加扰状态|
+|scdcSourceScrambleSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能source端的加扰|
+|frlEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能FRL|
+|audioNctsSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：N/CTS配    置参数|无|HDF_STATUS相关状态|设置audio的N/CTS信息|
+|frlTrainingConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：FRL Traning配置参数|无|无|设置FRL Traning配置信息|
+|frlTrainingStart|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|开始FRL Traning流程|
+|frlGetTriningRslt|**cntlr**: 结构体指针，核心层HDMI控制器;|**rslt**：FRL Traning结果|无|获取FRL Traning结果|
+|hdcpRegInit|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|初始化HDCP流程相关的寄存器|
+|hdcpGenerateAksvAndAn|**cntlr**: 结构体指针，核心层HDMI控制器;|无|HDF_STATUS相关状态|HDCP流程中生成aksv和an|
+|hdcpOptReg|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**type**: 操作类型<br />**data**: 寄存器数据<br />**len**: 数据长度|**data**: 寄存器数据|HDF_STATUS相关状态|HDCP流程中读写相关寄存器|
+|hdrTimerSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: timer配置信息|无|无|设置HDR相关的timer配置信息|
+
+
+### 开发步骤 <a name="9"></a>
+
+HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以及实例化HDMI控制器对象。

-    表1 HdmiCntlrOps结构体成员的回调函数功能说明
-
-   | 函数成员                 | 入参                                                         | 出参                                   | 返回值             | 功能                                               |
-   | ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- |
-   | hardWareInit             | **cntlr**: 结构体指针，核心层HDMI控制器; | 无 | 无 | HDMI硬件初始化 |
-   | hardWareStatusGet        | **cntlr**: 结构体指针，核心层HDMI控制器;<br /> | **status**：HDMI硬件状态 ; | 无 | 获取HDMI当前硬件状态         |
-   | controllerReset          | **cntlr**: 结构体指针，核心层HDMI控制器; | 无      | 无 | HDMI控制器复位          |
-   | hotPlugStateGet          | **cntlr**: 结构体指针，核心层HDMI控制器;                     | 无                         | bool: HDMI热插拔状态 | 获取HDMI热插拔状态             |
-   | hotPlugInterruptStateGet | **cntlr**: 结构体指针，核心层HDMI控制器;                     | 无           | bool: HDMI热插拔中断状态 | 获取HDMI热插拔中断状态                      |
-   | lowPowerSet              | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能 | 无                                     | 无 | 使能/去使能低功耗 |
-   | tmdsModeSet              | **cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**:TMDS模式 | 无                                     | 无 | 设置TMDS模式                                      |
-   |tmdsConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**mode**: TMDS参数|无|HDF_STATUS相关状态|配置TMDS参数|
-   |infoFrameEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**enable**: bool，使能/去使能|无|无|使能/去使能infoFrame|
-   |infoFrameSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**infoFrameType**: packet类型<br />**data**: infoFrame数据<br />**len**:数据长度|无|HDF_STATUS相关状态|发送inforFrame|
-   |cecMsgSend|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**msg**: CEC消息|无|HDF_STATUS相关状态|发送CEC消息|
-   |audioPathEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio通路|
-   |audioPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: 配置信息|无|无|设置audio通路配置信息|
-   |phyOutputEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能物理层输出状态|
-   |phyOutputSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**: 配置信息|无|无|设置物理层配置信息|
-   |blackDataSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|黑屏设置|
-   |videoMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能video静音|
-   |videoPathSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**attr**： 配置信息|无|无|设置viedo通路配置信息|
-   |audioMuteEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能audio静音|
-   |avmuteSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|无|使能/去使能声音图像消隐|
-   |ddcTransfer|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**ddcCfg**：DDC配置参数|**ddcCfg**：DDC配置参数|HDF_STATUS相关状态|DDC读写数据|
-   |scdcSourceScrambleGet|**cntlr**: 结构体指针，核心层HDMI控制器;|无|bool，加扰状态|获取source端的加扰状态|
-   |scdcSourceScrambleSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能source端的加扰|
-   |frlEnable|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**enable**: bool，使能/去使能|无|HDF_STATUS相关状态|使能/去使能FRL|
-   |audioNctsSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：N/CTS配    置参数|无|HDF_STATUS相关状态|设置audio的N/CTS信息|
-   |frlTrainingConfigSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**cfg**：FRL Traning配置参数|无|无|设置FRL Traning配置信息|
-   |frlTrainingStart|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|开始FRL Traning流程|
-   |frlGetTriningRslt|**cntlr**: 结构体指针，核心层HDMI控制器;|**rslt**：FRL Traning结果|无|获取FRL Traning结果|
-   |hdcpRegInit|**cntlr**: 结构体指针，核心层HDMI控制器;|无|无|初始化HDCP流程相关的寄存器|
-   |hdcpGenerateAksvAndAn|**cntlr**: 结构体指针，核心层HDMI控制器;|无|HDF_STATUS相关状态|HDCP流程中生成aksv和an|
-   |hdcpOptReg|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**type**: 操作类型<br />**data**: 寄存器数据<br />**len**: 数据长度|**data**: 寄存器数据|HDF_STATUS相关状态|HDCP流程中的相关寄存器读写操作|
-   |hdrTimerSet|**cntlr**: 结构体指针，核心层HDMI控制器;<br />**config**: timer配置信息|无|无|设置HDR相关的timer配置信息|
-
-## 开发实例 <a name="3"></a>
-
-1. 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
+- **实例化驱动入口：** 
+    - 实例化HdfDriverEntry结构体成员。
+    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
+
+- **配置属性文件：**
+    - 在device_info.hcs文件中添加deviceNode描述。
+    - 【可选】添加hdmi_config.hcs器件属性文件。
+
+- **实例化HDMI控制器对象：**
+    - 初始化HdmiCntlr成员。
+    - 实例化HdmiCntlr成员HdmiCntlrOps方法集合。
+
+1. **实例化驱动入口**
+
+    驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。

    一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。

@@ -126,7 +163,9 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
    HDF_INIT(g_hdmiDriverEntry);            //调用HDF_INIT将驱动入口注册到HDF框架中
    ```

-2. 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在hdmi_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层HdmiCntlr相关成员的默认值或限制范围有密切关系。
+2. **配置属性文件**
+
+    完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在hdmi_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层HdmiCntlr相关成员的默认值或限制范围有密切关系。

    从第一个节点开始配置具体HDMI控制器信息，此节点并不表示某一路HDMI控制器，而是代表一个资源性质设备，用于描述一类HDMI控制器的信息。本例只有一个HDMI控制器，如有多个控制器，则需要在device_info文件增加deviceNode信息，以及在hdmi_config文件中增加对应的器件属性。

@@ -198,7 +237,9 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        }
        ```

-3. 最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。
+3. **实例化控制器对象**
+
+    最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。

    - 自定义结构体参考

@@ -240,7 +281,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        };
        ```

-    - **【重要】** HdmiCntlr成员回调函数结构体HdmiCntlrOps的实例化
+    -  HdmiCntlr成员回调函数结构体HdmiCntlrOps的实例化

        ```c 
        static struct HdmiCntlrOps g_hdmiAdapterHostOps = {
@@ -281,13 +322,13 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        };
        ```

-    - **Bind函数参考**
+    - Bind函数参考

-        > **入参：** 
-        >  HdfDeviceObject 是整个驱动对外呈现的接口参数，具备 HCS 配置文件的信息
-        > 
-        > **返回值：**
-        > HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
+        **入参：** 
+        HdfDeviceObject 是整个驱动对外呈现的接口参数，具备 HCS 配置文件的信息
+        
+        **返回值：**
+        HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）

        |状态(值)|状态描述|
        |:-|:-|
@@ -298,10 +339,10 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        |HDF_SUCCESS           |传输成功|
        |HDF_FAILURE           |传输失败|

-        > **函数说明：** 
-        > 初始化自定义结构体对象HdmiAdapterHost，初始化HdmiCntlr成员，调用核心层HdmiCntlrAdd函数。
-        >
-        > HdmiCntlr，HdmiAdapterHost，HdfDeviceObject之间互相赋值，方便其他函数可以相互转化。
+        **函数说明：** 
+        初始化自定义结构体对象HdmiAdapterHost，初始化HdmiCntlr成员，调用核心层HdmiCntlrAdd函数。
+        
+        HdmiCntlr，HdmiAdapterHost，HdfDeviceObject之间互相赋值，方便其他函数可以相互转化。

        ```c
        static int32_t HdmiAdapterBind(struct HdfDeviceObject *obj)
@@ -340,17 +381,17 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        }
        ```

-    - **init函数参考**
+    - Init函数参考
+
+        **入参：** 
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
+        
+        **返回值：**
+        HDF_STATUS相关状态 
+        
+        **函数说明**：
        
-        >**入参：** 
-        >HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
-        >
-        >**返回值：**
-        >HDF_STATUS相关状态 
-        >
-        >函数说明：
-        >
-        >实现HdmiAdapterInit函数。
+        实现HdmiAdapterInit函数。

        ```c
        static int32_t HdmiAdapterInit(struct HdfDeviceObject *obj)
@@ -359,16 +400,16 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        }
        ```

-    - **Release 函数参考**
+    - Release 函数参考

-        > **入参：** 
-        > HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 
-        >
-        > **返回值：**
-        > 无
-        > 
-        > **函数说明：**
-        > 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。
+        **入参：** 
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 
+       
+        **返回值：**
+        无
+        
+        **函数说明：**
+        释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。

        ```c
        static void HdmiAdapterRelease(struct HdfDeviceObject *obj)
@@ -380,4 +421,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
            HimciDeleteHost((struct HimciAdapterHost *)cntlr->priv);//厂商自定义的内存释放函数,这里有HdmiCntlr到HimciAdapterHost的强制转化
        }
        ```
-        > 所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
+        
+        > ![](../public_sys-resources/icon-note.gif) **说明：** 
+        > 所有强制转换获取相应对象的操作前提是在Init函数中具备对应赋值的操作。
+
--- a/zh-cn/device-dev/driver/driver-platform-i3c-des.md
+++ b/zh-cn/device-dev/driver/driver-platform-i3c-des.md
 # I3C<a name="1"></a>

 -   [概述](#section1)
-   [接口说明](#section2)
-   [使用指导](#section3)
-    -   [使用流程](#section4)
-    -   [打开I3C控制器](#section5)
-    -   [进行I3C通信](#section6)
-    -   [获取I3C控制器配置](#section7)
-    -   [配置I3C控制器](#section8)
-    -   [请求IBI（带内中断）](#section9)
-    -   [释放IBI（带内中断）](#section10)
-    -   [关闭I3C控制器](#section11)
-    
-   [使用实例](#section12)
+    -   [功能简介](#section2)
+    -   [基本概念](#section3)
+    -   [运作机制](#section4)
+    -   [约束与限制](#section5)
+-   [使用指导](#section6)
+    -   [场景介绍](#section7)
+    -   [接口说明](#section8)
+    -   [开发步骤](#section9)
+    -   [使用实例](#section10)

 ## 概述<a name="section1"></a>

- I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
- I3C总线向下兼容传统的I2C设备，同时增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。
- I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。
+### 功能简介<a name="section2"></a>
+
+I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
+
 - I3C接口定义了完成I3C传输的通用方法集合，包括：
+    I3C控制器管理：打开或关闭I3C控制器。
+    I3C控制器配置：获取或配置I3C控制器参数。
+    I3C消息传输：通过消息传输结构体数组进行自定义传输。
+    I3C带内中断：请求或释放带内中断。

-    -   I3C控制器管理：打开或关闭I3C控制器。
-    -   I3C控制器配置：获取或配置I3C控制器参数。
-    -   I3C消息传输：通过消息传输结构体数组进行自定义传输。
-    -   I3C带内中断：请求或释放带内中断。
- -    I3C的物理连接如[图1](#fig1)所示：  
-    **图 1**  I3C物理连线示意图<a name="fig1"></a>  
-    ![](figures/I3C物理连线示意图.png "I3C物理连线示意图")
+### 基本概念<a name="section3"></a>

-## 接口说明<a name="section2"></a>
+- I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。
+- I3C增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。
+- I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。
+- I3C相关缩略词解释：
+    - IBI（In-Band Interrupt）：带内中断。在SCL线没有启动信号时，I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号，从而发出带内中断请求。若有多个从机同时发出中断请求，I3C主机则通过从机地址进行仲裁，低地址优先相应。
+    - DAA（Dynamic Address Assignment）：动态地址分配。I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前，连接到I3C总线上的每个I3C设备都应以两种方式之一来唯一标识：
+    1）设备可能有一个符合I2C规范的静态地址，主机可以使用此静态地址；
+    2）在任何情况下，设备均应具有48位的临时ID。 除非设备具有静态地址且主机使用静态地址，否则主机应使用此48位临时ID。
+    - CCC（Common Command Code） ：通用命令代码，所有I3C设备均支持CCC，可以直接将其传输到特定的I3C从设备，也可以同时传输到所有I3C从设备。
+    - BCR（Bus Characteristic Register）：总线特性寄存器，每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 （BCR），该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。
+    - DCR（Device Characteristic Register）：设备特性寄存器，连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型（例如，加速度计、陀螺仪等）。

-**表 1**  I3C驱动API接口功能介绍
+### 运作机制<a name="section4"></a>

-<a name="table1"></a>
+在HDF框架中，I3C模块接口适配模式采用统一服务模式，这需要一个设备服务来作为I3C模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如I3C可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
+
+ 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。一路I3C总线上，可以连接多个设备，这些设备可以是I2C从设备、I3C从设备和I3C次级主设备，但只能同时存在一个主设备，一般为控制器本身。
+
+**图 1**  I3C物理连线示意图<a name="fig1"></a>  
+![](figures/I3C物理连线示意图.png "I3C物理连线示意图")
+
+### 约束与限制<a name="section5"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="18.63%"><p>功能分类</p>
-</th>
-<th class="cellrowborder" valign="top" width="28.03%"><p>接口名</p>
-</th>
-<th class="cellrowborder" valign="top" width="53.339999999999996%"><p>描述</p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>I3C控制器管理接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>I3cOpen</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">打开I3C控制器</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>I3cClose</p>
-</td>
-<td class="cellrowborder" valign="top"><p>关闭I3C控制器</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor="#ffffff" valign="top" width="18.63%"><p>I3c消息传输接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>I3cTransfer</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%"><p>自定义传输</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor=ffffff rowspan="2" valign="top" width="18.63%"><p>I3C控制器配置接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>I3cSetConfig</p>
-</td>
-<td class="cellrowborder"valign="top" width="53.339999999999996%">配置I3C控制器</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>I3cGetConfig</p>
-</td>
-<td class="cellrowborder" valign="top"><p>获取I3C控制器配置</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" bgcolor=ffffff rowspan="2" valign="top" width="18.63%"><p>I3C带内中断接口</p>
-</td>
-<td class="cellrowborder" valign="top" width="28.03%"><p>I3cRequestIbi</p>
-</td>
-<td class="cellrowborder" valign="top" width="53.339999999999996%">请求带内中断</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top"><p>I3cFreeIbi</p>
-</td>
-<td class="cellrowborder" valign="top"><p>释放带内中断</p>
-</td>
-</tr>
-</table>
+I3C模块当前仅支持轻量和小型系统内核（LiteOS） 。

+## 使用指导<a name="section6"></a>

+### 场景介绍<a name="section7"></a>
+
+I3C可连接单个或多个I3C、I2C从器件，它主要用于：
+1. 与传感器通信，如陀螺仪、气压计或支持I3C协议的图像传感器等；
+2. 通过软件或硬件协议转换，与其他接口（如 UART 串口等）的设备进行通信。
+
+### 接口说明<a name="section8"></a>
+
+**表 1**  I3C驱动API接口功能介绍
+
+<a name="table1"></a>
+
+| 接口名        | 描述              |
+| ------------- | ----------------- |
+| I3cOpen       | 打开I3C控制器     |
+| I3cClose      | 关闭I3C控制器     |
+| I3cTransfer   | 自定义传输        |
+| I3cSetConfig  | 配置I3C控制器     |
+| I3cGetConfig  | 获取I3C控制器配置 |
+| I3cRequestIbi | 请求带内中断      |
+| I3cFreeIbi    | 释放带内中断      |

 >![](../public_sys-resources/icon-note.gif) **说明：** 
 >本文涉及的所有接口，仅限内核态使用，不支持在用户态使用。

-## 使用指导<a name="section3"></a>
-
-### 使用流程<a name="section4"></a>
+### 开发步骤<a name="section9"></a>

 I3C的使用流程如[图2](#fig2)所示。

 **图 2**  I3C使用流程图<a name="fig2"></a>  
 ![](figures/I3C使用流程图.png "I3C使用流程图")

-### 打开I3C控制器<a name="section5"></a>
+#### 打开I3C控制器<a name="section5"></a>

 在进行I3C通信前，首先要调用I3cOpen打开I3C控制器。
 ```c
@@ -113,34 +95,12 @@ DevHandle I3cOpen(int16_t number);

 <a name="table2"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="20.66%"><p>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="79.34%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="20.66%"><p>number</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>I3C控制器号</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>NULL</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开I3C控制器失败</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="20.66%"><p>控制器句柄</p>
-</td>
-<td class="cellrowborder" valign="top" width="79.34%"><p>打开的I3C控制器句柄</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述            |
+| ---------- | ------------------- |
+| number     | I3C控制器号         |
+| **返回值** | **返回值描述**      |
+| NULL       | 打开I3C控制器失败   |
+| 控制器句柄 | 打开的I3C控制器句柄 |

 假设系统中存在8个I3C控制器，编号从0到7，那么我们现在打开1号控制器：

@@ -155,7 +115,7 @@ if (i3cHandle == NULL) {
 }
 ```

-### 进行I3C通信<a name="section6"></a>
+#### 进行I3C通信<a name="section6"></a>

 消息传输
 ```c
@@ -166,49 +126,15 @@ int32_t I3cTransfer(DevHandle handle, struct I3cMsg *msgs, int16_t count, enum T

 <a name="table3"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>msgs</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>待传输数据的消息结构体数组</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>count</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>消息数组长度</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>mode</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>传输模式，0：I2C模式；1：I3C模式；2：发送CCC（Common Command Code）</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>正整数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>成功传输的消息结构体数目</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>执行失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述                                     |
+| ---------- | -------------------------------------------- |
+| handle     | I3C控制器句柄                                |
+| msgs       | 待传输数据的消息结构体数组                   |
+| count      | 消息数组长度                                 |
+| mode       | 传输模式，0：I2C模式；1：I3C模式；2：发送CCC |
+| **返回值** | **返回值描述**                               |
+| 正整数     | 成功传输的消息结构体数目                     |
+| 负数       | 执行失败                                     |

 I3C传输消息类型为I3cMsg，每个传输消息结构体表示一次读或写，通过一个消息数组，可以执行若干次的读写组合操作。

@@ -239,7 +165,7 @@ if (ret != 2) {
 >-   本函数不对每个消息结构体中的数据长度做限制，同样由具体I3C控制器决定。
 >-   本函数可能会引起系统休眠，禁止在中断上下文调用。

-### 获取I3C控制器配置<a name="section7"></a>
+#### 获取I3C控制器配置<a name="section7"></a>

 ```c
 int32_t I3cGetConfig(DevHandle handle, struct I3cConfig *config);
@@ -249,41 +175,27 @@ int32_t I3cGetConfig(DevHandle handle, struct I3cConfig *config);

 <a name="table4"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>config</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器配置</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>获取成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>获取失败</p>
-</td>
-</tr>
-</tbody>
-</table>
-
-### 配置I3C控制器<a name="section8"></a>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | I3C控制器句柄  |
+| config     | I3C控制器配置  |
+| **返回值** | **返回值描述** |
+| 0          | 获取成功       |
+| 负数       | 获取失败       |
+
+获取I3C控制器配置示例：
+
+```c
+struct I3cConfig config;
+
+ret = I3cGetConfig(i3cHandle, &config);
+if (ret != HDF_SUCCESS) {
+    HDF_LOGE("%s: Get config fail!", __func__);
+    return HDF_FAILURE;
+}
+```
+
+#### 配置I3C控制器<a name="section8"></a>

 ```c
 int32_t I3cSetConfig(DevHandle handle, struct I3cConfig *config);
@@ -293,41 +205,29 @@ int32_t I3cSetConfig(DevHandle handle, struct I3cConfig *config);

 <a name="table5"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>config</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器配置</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>配置成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>配置失败</p>
-</td>
-</tr>
-</tbody>
-</table>
-
-### 请求IBI（带内中断）<a name="section9"></a>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | I3C控制器句柄  |
+| config     | I3C控制器配置  |
+| **返回值** | **返回值描述** |
+| 0          | 配置成功       |
+| 负数       | 配置失败       |
+
+配置I3C控制器示例：
+
+```c
+struct I3cConfig config;
+
+config->busMode = I3C_BUS_HDR_MODE;
+config->curMaster = NULL;
+ret = I3cSetConfig(i3cHandle, &config);
+if (ret != HDF_SUCCESS) {
+    HDF_LOGE("%s: Set config fail!", __func__);
+    return HDF_FAILURE;
+}
+```
+
+#### 请求IBI（带内中断）<a name="section9"></a>

 ```c
 int32_t I3cRequestIbi(DevHandle handle, uint16_t addr, I3cIbiFunc func, uint32_t payload);
@@ -337,49 +237,17 @@ int32_t I3cRequestIbi(DevHandle handle, uint16_t addr, I3cIbiFunc func, uint32_t

 <a name="table6"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器设备句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>addr</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C设备地址</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>func</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>IBI回调函数</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>payload</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>IBI有效载荷</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder"valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>请求成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>请求失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | I3C控制器句柄  |
+| addr       | I3C设备地址    |
+| func       | IBI回调函数    |
+| payload    | IBI有效载荷    |
+| **返回值** | **返回值描述** |
+| 0          | 请求成功       |
+| 负数       | 请求失败       |
+
+请求带内中断示例：

 ```c
 static int32_t TestI3cIbiFunc(DevHandle handle, uint16_t addr, struct I3cIbiData data)
@@ -415,7 +283,7 @@ int32_t I3cTestRequestIbi(void)
 }
 ```

-### 释放IBI（带内中断）<a name="section10"></a>
+#### 释放IBI（带内中断）<a name="section10"></a>

 ```c
 int32_t I3cFreeIbi(DevHandle handle, uint16_t addr);
@@ -425,45 +293,21 @@ int32_t I3cFreeIbi(DevHandle handle, uint16_t addr);

 <a name="table7"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p><strong>参数</strong></p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p><strong>参数描述</strong></p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器设备句柄</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>addr</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C设备地址</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>释放成功</p>
-</td>
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>负数</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>释放失败</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | I3C控制器句柄  |
+| addr       | I3C设备地址    |
+| **返回值** | **返回值描述** |
+| 0          | 释放成功       |
+| 负数       | 释放失败       |
+
+释放带内中断示例：

 ```c
 I3cFreeIbi(i3cHandle, 0x3F); /* 释放带内中断 */
 ```

-### 关闭I3C控制器<a name="section11"></a>
+#### 关闭I3C控制器<a name="section11"></a>

 I3C通信完成之后，需要关闭I3C控制器，关闭函数如下所示：
 ```c
@@ -474,26 +318,17 @@ void I3cClose(DevHandle handle);

 <a name="table4"></a>

-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="50%"><p>参数</p>
-</th>
-<th class="cellrowborder" valign="top" width="50%"><p>参数描述</p>
-</th>
-</tr>
-</thead>
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器设备句柄</p>
-</td>
-</tr>
-</tbody>
-</table>
+| 参数       | 参数描述       |
+| ---------- | -------------- |
+| handle     | I3C控制器句柄  |

+关闭I3C控制器实例：

 ```c
 I3cClose(i3cHandle); /* 关闭I3C控制器 */
 ```

-## 使用实例<a name="section12"></a>
+## 使用实例<a name="section10"></a>

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

@@ -511,7 +346,6 @@ I3cClose(i3cHandle); /* 关闭I3C控制器 */

 ```c
 #include "i3c_if.h"          /* I3C标准接口头文件 */
-#include "i3c_ccc.h"         /* I3C通用命令代码头文件 */
 #include "hdf_log.h"         /* 标准日志打印头文件 */
 #include "osal_io.h"         /* 标准IO读写接口头文件 */
 #include "osal_time.h"       /* 标准延迟&睡眠接口头文件 */

--- a/zh-cn/device-dev/driver/driver-platform-i3c-develop.md
+++ b/zh-cn/device-dev/driver/driver-platform-i3c-develop.md
 # I3C 

 - [概述](#1)
- [开发步骤](#2)
- [开发实例](#3)
+    - [功能简介](#2)
+    - [基本概念](#3)
+    - [运作机制](#4)
+    - [约束与限制](#5)  
+- [开发指导](#6)
+    - [场景介绍](#7)
+    - [接口说明](#8)
+    - [开发步骤](#9)

 ## 概述 <a name="1"></a>

-I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。在HDF框架中，I3C模块接口适配模式采用统一服务模式，这需要一个设备服务来作为I3C模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如I3C可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
+### 功能简介<a name="2"></a>

-![image1](figures/统一服务模式结构图.png)
+I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。

-## 开发步骤 <a name="2"></a>
+### 基本概念<a name="3"></a>

-I3C模块适配的四个环节是实例化驱动入口、配置属性文件、实例化I3C控制器对象以及注册中断处理子程序。
+I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。

-1. **实例化驱动入口：** 
-    - 实例化HdfDriverEntry结构体成员。
-    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
+- IBI（In-Band Interrupt）：带内中断。在SCL线没有启动信号时，I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号，从而发出带内中断请求。若有多个从机同时发出中断请求，I3C主机则通过从机地址进行仲裁，低地址优先相应。
+- DAA（Dynamic Address Assignment）：动态地址分配。I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前，连接到I3C总线上的每个I3C设备都应以两种方式之一来唯一标识：
+1）设备可能有一个符合I2C规范的静态地址，主机可以使用此静态地址；
+2）在任何情况下，设备均应具有48位的临时ID。 除非设备具有静态地址且主机使用静态地址，否则主机应使用此48位临时ID。

-2. **配置属性文件：**
+- CCC（Common Command Code） ：通用命令代码（CCC），所有I3C设备均支持CCC，可以直接将其传输到特定的I3C从设备，也可以同时传输到所有I3C从设备。
+- BCR（Bus Characteristic Register）：总线特性寄存器，每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 （BCR），该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。
+- DCR（Device Characteristic Register）：设备特性寄存器，连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型（例如，加速度计、陀螺仪等）。

-    - 在device_info.hcs文件中添加deviceNode描述。
-    - 【可选】添加i3c_config.hcs器件属性文件。

-3. **实例化I3C控制器对象：**
+### 运作机制<a name="4"></a>

-    - 初始化I3cCntlr成员。
-    - 实例化I3cCntlr成员I3cMethod方法集合，其定义和成员函数说明见下文。
+在HDF框架中，同类型控制器对象较多时（可能同时存在十几个同类型控制器），如果采用独立服务模式则需要配置更多的设备节点，且相关服务会占据更多的内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现）,实现便捷管理和节约资源的目的。I3C模块接口适配模式采用统一服务模式（如[图1](#fig1)所示）。

-4. **注册中断处理子程序：**
-    为控制器注册中断处理程序，实现设备热接入和IBI（带内中断）功能。
+I3C模块各分层的作用为：接口层提供打开控制器、传输消息、获取和设置控制器参数以及关闭控制器的接口。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。

-    I3cMethod定义：
-    ```c
-    struct I3cMethod {
+ **图 1**  I3C统一服务模式<a name="fig1"></a> 
+
+![image1](figures/统一服务模式结构图.png)
+
+### 约束与限制<a name="5"></a>
+
+I3C模块当前仅支持轻量和小型系统内核（LiteOS） 。
+
+## 开发指导 <a name="6"></a>
+
+### 场景介绍 <a name="7"></a>
+
+I3C可连接单个或多个I3C、I2C从器件，它主要用于：
+1. 与传感器通信，如陀螺仪、气压计或支持I3C协议的图像传感器等。
+2. 通过软件或硬件协议转换，与其他通信接口（如 UART 串口等）的设备进行通信。
+
+### 接口说明 <a name="8"></a>
+
+I3cMethod定义：
+```c
+struct I3cMethod {
    int32_t (*sendCccCmd)(struct I3cCntlr *cntlr, struct I3cCccCmd *ccc);
    int32_t (*transfer)(struct I3cCntlr *cntlr, struct I3cMsg *msgs, int16_t count);
    int32_t (*i2cTransfer)(struct I3cCntlr *cntlr, struct I3cMsg *msgs, int16_t count);
@@ -41,24 +64,43 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
    int32_t (*getConfig)(struct I3cCntlr *cntlr, struct I3cConfig *config);
    int32_t (*requestIbi)(struct I3cDevice *dev);
    void (*freeIbi)(struct I3cDevice *dev);
-    };
-    ```
+};
+```
+
+**表1** I3cMethod结构体成员的回调函数功能说明
+|函数成员|入参|出参|返回值|功能|
+|-|-|-|-|-|
+|sendCccCmd|**cntlr**: 结构体指针，核心层I3C控制器;<br />**ccc**：传入的通用命令代码结构体指针;|**ccc**：传出的通用命令代码结构体指针;|HDF_STATUS相关状态|发送CCC（Common command Code，即通用命令代码）|
+|Transfer  |**cntlr**: 结构体指针，核心层I3C控制器;<br />**msgs**：结构体指针，用户消息 ;<br />**count**：int16_t，消息数量|**msgs**：结构体指针，用户消息 ;|HDF_STATUS相关状态|使用I3C模式传递用户消息|
+|i2cTransfer |**cntlr**: 结构体指针，核心层I3C控制器;<br />**msgs**：结构体指针，用户消息 ;<br />**count**：int16_t，消息数量|**msgs**：结构体指针，用户消息 ;|HDF_STATUS相关状态|使用I2C模式传递用户消息|
+|setConfig|**cntlr**: 结构体指针，核心层I3C控制器; <br />**config**:  控制器配置参数|无|HDF_STATUS相关状态|设置I3C控制器配置参数|
+|getConfig|**cntlr**: 结构体指针，核心层I3C控制器;|**config**:  控制器配置参数|HDF_STATUS相关状态|获取I3C控制器配置参数|
+|requestIbi|**device**: 结构体指针，核心层I3C设备;|无|HDF_STATUS相关状态|为I3C设备请求IBI（In-Bind Interrupt，即带内中断）|
+|freeIbi|**device**: 结构体指针，核心层I3C设备;|无|HDF_STATUS相关状态|释放IBI|
+
+### 开发步骤 <a name="9"></a>

-    表1 I3cMethod结构体成员的回调函数功能说明
+I3C模块适配的四个环节是实例化驱动入口、配置属性文件、实例化I3C控制器对象以及注册中断处理子程序。
+
+- **实例化驱动入口：** 
+    - 实例化HdfDriverEntry结构体成员。
+    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。

-    |函数成员|入参|出参|返回值|功能|
-    |-|-|-|-|-|
-    |sendCccCmd|**cntlr**: 结构体指针，核心层I3C控制器;<br />**ccc**：传入的通用命令代码结构体指针;|**ccc**：传出的通用命令代码结构体指针;|HDF_STATUS相关状态|发送CCC（Common command Code，即通用命令代码）|
-    |Transfer  |**cntlr**: 结构体指针，核心层I3C控制器;<br />**msgs**：结构体指针，用户消息 ;<br />**count**：int16_t，消息数量|**msgs**：结构体指针，用户消息 ;|HDF_STATUS相关状态|使用I3C模式传递用户消息|
-    |i2cTransfer |**cntlr**: 结构体指针，核心层I3C控制器;<br />**msgs**：结构体指针，用户消息 ;<br />**count**：int16_t，消息数量|**msgs**：结构体指针，用户消息 ;|HDF_STATUS相关状态|使用I2C模式传递用户消息|
-    |setConfig|**cntlr**: 结构体指针，核心层I3C控制器; <br />**config**:  控制器配置参数|无|HDF_STATUS相关状态|设置I3C控制器配置参数|
-    |getConfig|**cntlr**: 结构体指针，核心层I3C控制器;|**config**:  控制器配置参数|HDF_STATUS相关状态|获取I3C控制器配置参数|
-    |requestIbi|**device**: 结构体指针，核心层I3C设备;|无|HDF_STATUS相关状态|为I3C设备请求IBI（In-Bind Interrupt，即带内中断）|
-    |freeIbi|**device**: 结构体指针，核心层I3C设备;|无|HDF_STATUS相关状态|释放IBI|
+- **配置属性文件：**

-## 开发实例 <a name="3"></a>
+    - 在device_info.hcs文件中添加deviceNode描述。
+    - 【可选】添加i3c_config.hcs器件属性文件。
+  
+- **实例化I3C控制器对象：**
+    - 初始化I3cCntlr成员。
+    - 实例化I3cCntlr成员I3cMethod方法集合，其定义和成员函数说明见下文。
+  
+- **注册中断处理子程序：**
+    为控制器注册中断处理程序，实现设备热接入和IBI（带内中断）功能。

-1. 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
+1. **实例化驱动入口**
+
+    驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
    
    一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
    
@@ -66,7 +108,7 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
    
    > I3C模块这种类型的控制器会出现很多个控制器挂接的情况，因而在HDF框架中首先会为这类型的控制器创建一个管理器对象，并同时对外发布一个管理器服务来统一处理外部访问。这样，用户需要打开某个控制器时，会先获取到管理器服务，然后管理器服务根据用户指定参数查找到指定控制器。
    > 
-    > I3C管理器服务的驱动由核心层实现，**厂商不需要关注这部分内容的实现，但在实现Init函数的时候需要调用核心层的I3cCntlrAdd函数，它会实现相应功能。**
+    > I3C管理器服务的驱动由核心层实现，厂商不需要关注这部分内容的实现，但在实现Init函数的时候需要调用核心层的I3cCntlrAdd函数，它会实现相应功能。
    
    ```c
    static struct HdfDriverEntry g_virtualI3cDriverEntry = {
@@ -87,9 +129,11 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
    HDF_INIT(g_i3cManagerEntry);
    ```

-2. 完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在i3c_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层I3cCntlr相关成员的默认值或限制范围有密切关系。
+2. **配置属性文件**
+
+    完成驱动入口注册之后，下一步请在device_info.hcs文件中添加deviceNode信息，并在i3c_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于厂商驱动的实现以及核心层I3cCntlr相关成员的默认值或限制范围有密切关系。

-    **统一服务模式**的特点是device_info文件中第一个设备节点必须为I3C管理器，其各项参数必须如下设置: 
+    统一服务模式的特点是device_info文件中第一个设备节点必须为I3C管理器，其各项参数必须如下设置: 

    |成员名|值|
    |-|-|
@@ -151,7 +195,9 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        }
        ```

-3. 配置属性文件完成后，要以核心层I3cCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化I3cCntlr成员I3cMethod（让用户可以通过接口来调用驱动底层函数）。
+3. **实例化I3C控制器对象**
+
+    配置属性文件完成后，要以核心层I3cCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化I3cCntlr成员I3cMethod（让用户可以通过接口来调用驱动底层函数）。

    此步骤需要通过实现HdfDriverEntry成员函数（Bind，Init，Release）来完成。

@@ -188,16 +234,16 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        };
        ```

-        > **【重要】** I3cCntlr成员回调函数结构体I3cMethod的实例化，I3cLockMethod回调函数结构体本例未实现，若要实例化，可参考I2C驱动开发，其他成员在Init函数中初始化
+         > I3cCntlr成员回调函数结构体I3cMethod的实例化，I3cLockMethod回调函数结构体本例未实现，若要实例化，可参考I2C驱动开发，其他成员在Init函数中初始化

+    - init函数参考

-    - **init函数参考**
+        **入参：** 
+          HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
+
+        **返回值：**
+         HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
             
-        > **入参：** 
-        >  HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
-        > 
-        > **返回值：**
-        > HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）

         |状态(值)|问题描述|
         |:-|:-:|
@@ -208,8 +254,8 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
         |HDF_SUCCESS           |传输成功|
         |HDF_FAILURE           |传输失败|

-        > **函数说明：**
-        > 初始化自定义结构体对象，初始化I3cCntlr成员，调用核心层I3cCntlrAdd函数。
+         **函数说明：**
+         初始化自定义结构体对象，初始化I3cCntlr成员，调用核心层I3cCntlrAdd函数。

         ```c
         static int32_t VirtualI3cParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node)
@@ -280,16 +326,16 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
         }
         ```

-    - **Release 函数参考**
+    - Release 函数参考

-        > **入参：** 
-        > HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 。
-        > 
-        > **返回值：**
-        > 无。
-        > 
-        > **函数说明：**
-        > 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
+        **入参：** 
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 。
+        
+        **返回值：**
+        无。
+        
+        **函数说明：**
+        释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。

        ```c
        static void VirtualI3cRemoveByNode(const struct DeviceResourceNode *node)
@@ -342,7 +388,9 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        }
        ```

-4. 最后一步，实现中断处理程序，在中断处理程序中通过判断中断产生的地址，实现热接入、IBI等操作。
+4. **注册中断处理子程序**
+
+    在中断处理程序中通过判断中断产生的地址，实现热接入、IBI等操作。

    ```c
    static int32_t VirtualI3cReservedAddrWorker(struct VirtualI3cCntlr *virtual, uint16_t addr)

--- a/zh-cn/device-dev/driver/figures/HDMI使用流程图.png
+++ b/zh-cn/device-dev/driver/figures/HDMI使用流程图.png
--- a/zh-cn/device-dev/driver/figures/独立服务模式结构图.png
+++ b/zh-cn/device-dev/driver/figures/独立服务模式结构图.png