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)
+    -   [功能简介](#section2)
-   [使用指导](#section3)
+    -   [基本概念](#section3) 
-    -   [使用流程](#section4)
+    -   [运作机制](#section4) 
-    -   [打开ADC设备](#section5)
+    -   [约束与限制](#section5)
-    -   [读取AD转换结果](#section6)
+-   [使用指导](#section6)
-    -   [关闭ADC设备](#section7)
+    -   [场景介绍](#section7)
+    -   [接口说明](#section8) 
-   [使用实例](#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>  
+### 基本概念<a name="section3"></a>
-    ![](figures/ADC物理连线示意图.png "ADC物理连线示意图")
+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>
+| AdcOpen  | 打开ADC设备      |
-</th>
+| AdcClose | 关闭ADC设备      |
-<th class="cellrowborder" valign="top" width="53.339999999999996%"><p>描述</p>
+| AdcRead  | 读取AD转换结果值 |
-</th>
-</tr>
+### 开发步骤<a name="section9"></a>
-</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>
 使用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>
+| number     | ADC设备号         |
-</th>
+| **返回值** | **返回值描述**    |
-</tr>
+| NULL       | 打开ADC设备失败   |
-</thead>
+| 设备句柄   | 打开的ADC设备句柄 |
-<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>
 假设系统中存在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>
+| handle     | ADC设备句柄    |
-</th>
+| channel    | ADC设备通道号  |
-</tr>
+| val        | AD转换结果     |
-</thead>
+| **返回值** | **返回值描述** |
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
+| 0          | 读取成功       |
-</td>
+| 负数       | 读取失败       |
-<td class="cellrowborder" valign="top" width="50%"><p>ADC设备句柄</p>
-</td>
+读取转换结果示例（以通道1为例）：
-</tr>
-<tr><td class="cellrowborder" valign="top" width="50%"><p>channel</p>
+```c
-</td>
+uint32_t value;
-<td class="cellrowborder"valign="top" width="50%"><p>ADC设备通道号</p>
+int32_t ret;
-</td>
-</tr>
+ret = AdcRead(adcHandle, 1, &value);
-<tr><td class="cellrowborder" valign="top" width="50%"><p>val</p>
+if (ret != 0) {
-</td>
+    HDF_LOGE("ADC read fail!\n");
-<td class="cellrowborder" valign="top" width="50%"><p>AD转换结果</p>
+    return;
-</td>
+}
-</tr>
+```
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
-</td>
+#### 关闭ADC设备
-<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>
 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>
+| handle | ADC设备句柄 |
-</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>
 关闭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)
+    -   [功能简介](#section2)
-   [使用指导](#section3)
+    -   [基本概念](#section3)
-    -   [使用流程](#section4)
+    -   [运作机制](#section4)
-    -   [打开HDMI控制器](#section5)
+    -   [约束与限制](#section5)
-    -   [注册热插拔回调函数](#section6)
+-   [使用指导](#section6)
-    -   [读取EDID](#section7)
+    -   [场景介绍](#section7)
-    -   [设置属性](#section8)
+    -   [接口说明](#section8)
-    -   [启动HDMI传输](#section10)
+    -   [开发步骤](#section9)
-    -   [停止HDMI传输](#section11)
+    -   [使用实例](#section10)
-    -   [注销热插拔回调函数](#section12)
-    -   [关闭HDMI控制器](#section13)
-   [使用实例](#section14)
 ## 概述<a name="section1"></a>
-   HDMI（High-Definition Multiface Interface）是Hitachi, Panasonic, Philips, SiliconImage, Sony, Thomson, Toshiba共同发布的一款音视频传输协议。
+### 功能简介<a name="section2"></a>
-   HDMI以主从方式工作，通常有一个Source端和一个Sink端。
-   HDMI接口定义了完成HDMI传输的通用方法集合，包括：
+- HDMI（High-Definition Multiface Interface），即高清多媒体接口，主要用于DVD、机顶盒等音视频Source到TV、显示器等Sink设备的传输。
+- HDMI以主从方式工作，通常有一个Source端和一个Sink端。
+- HDMI接口定义了完成HDMI传输的通用方法集合，包括：
    - HDMI控制器管理：打开或关闭HDMI控制器
    - HDMI启动/停止传输：启动或停止HDMI传输
    - 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>
+| HdmiOpen                      | 打开HDMI控制器             |
-</th>
+| HdmiClose                     | 关闭HDMI控制器             |
-<th class="cellrowborder" valign="top" width="53.339999999999996%"><p>描述</p>
+| HdmiStart                     | 启动HDMI传输               |
-</th>
+| HdmiStop                      | 停止HDMI传输               |
-</tr>
+| HdmiAvmuteSet                 | 声音图像消隐设置           |
-</thead>
+| HdmiDeepColorSet              | 设置色彩深度               |
-<tbody><tr><td class="cellrowborder" bgcolor="#ffffff" rowspan="2" valign="top" width="18.63%"><p>HDMI控制器管理接口</p>
+| HdmiDeepColorGet              | 获取色彩深度               |
-</td>
+| HdmiSetVideoAttribute         | 设置视频属性               |
-<td class="cellrowborder" valign="top" width="28.03%"><p>HdmiOpen</p>
+| HdmiSetAudioAttribute         | 设置音频属性               |
-</td>
+| HdmiSetHdrAttribute           | 设置HDR属性                |
-<td class="cellrowborder" valign="top" width="53.339999999999996%">打开HDMI控制器</p>
+| HdmiReadSinkEdid              | 读取Sink端原始EDID数据     |
-</td>
+| HdmiRegisterHpdCallbackFunc   | 注册HDMI热插拔检测回调函数 |
-</tr>
+| HdmiUnregisterHpdCallbackFunc | 注销HDMI热插拔检测回调函数 |
-<tr><td class="cellrowborder" valign="top"><p>HdmiClose</p>
-</td>
+### 开发步骤<a name="section9"></a>
-<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>
 使用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>
+| number     | HDMI控制器号         |
-</th>
+| **返回值** | **返回值描述**       |
-</tr>
+| NULL       | 打开HDMI控制器失败   |
-</thead>
+| 控制器句柄 | 打开的HDMI控制器句柄 |
-<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>
 假设系统中存在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>
+| handle     | HDMI控制器句柄     |
-</th>
+| callback   | 热插拔回调函数信息 |
-</tr>
+| **返回值** | **返回值描述**     |
-</thead>
+| 0          | 注册成功           |
-<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>
 注册热插拔检测回调函数示例：
@@ -236,30 +140,31 @@ int32_t HdmiRegisterHpdCallbackFunc(DevHandle handle, struct HdmiHpdCallbackInfo
 static void HdmiHpdHandle(void *data, bool hpd)
 {
    if (data == NULL) {
-    HDF_LOGE("priv data is NULL");
+        HDF_LOGE("priv data is NULL");
-    return;
+        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;
+struct HdmiHpdCallbackInfo info = {0};
-    info.callbackFunc = HdmiHpdHandle;
+info.data = handle;
-    ret = HdmiRegisterHpdCallbackFunc(hdmiHandle, info);
+info.callbackFunc = HdmiHpdHandle;
-    if (ret != 0) {
+ret = HdmiRegisterHpdCallbackFunc(hdmiHandle, info);
-        HDF_LOGE("HdmiRegisterHpdCallbackFunc: Register failed.");
+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>
+| handle     | HDMI控制器句柄         |
-</th>
+| buffer     | 数据缓冲区             |
-</tr>
+| len        | 数据长度               |
-</thead>
+| **返回值** | **返回值描述**         |
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
+| 正整数     | 成功读取的原始EDID数据 |
-</td>
+| 负数或0    | 读取失败               |
-<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>
 读取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>
+| handle | HDMI控制器句柄 |
-</th>
+| attr   | 音频属性       |
-</tr>
+| 返回值 | 返回值描述     |
-</thead>
+| 0      | 设置成功       |
-<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>
 设置音频属性示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</th>
+| attr       | 视频属性       |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 设置成功       |
-<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>
 设置视频属性示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</th>
+| attr       | HDR属性        |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 设置成功       |
-<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>
 设置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>
+| handle     | HDMI控制器句柄    |
-</th>
+| enable     | 使能/去使能avmute |
-</tr>
+| **返回值** | **返回值描述**    |
-</thead>
+| 0          | 设置成功          |
-<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>
 设置声音图像消隐示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</th>
+| color      | 色彩深度       |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 设置成功       |
-<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>
 设置色彩深度示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</th>
+| color      | 色彩深度       |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 获取成功       |
-<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>
 获取色彩深度示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</th>
+| **返回值** | **返回值描述** |
-</tr>
+| 0          | 启动成功       |
-</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>
 启动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>
+| handle     | HDMI控制器句柄 |
-</th>
+| **返回值** | **返回值描述** |
-</tr>
+| 0          | 停止成功       |
-</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>
 停止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>
+| handle     | HDMI控制器句柄 |
-</th>
+| **返回值** | **返回值描述** |
-</tr>
+| 0          | 注销成功       |
-</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>
 注销热插拔检测回调函数示例：
@@ -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>
+| handle     | HDMI控制器句柄 |
-</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>
 关闭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)
+    - [功能简介](#2)
- [开发实例](#3)
+    - [基本概念](#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模块当前仅支持轻量和小型系统内核（LiteOS） 。
+## 开发指导 <a name="6"></a>
+### 场景介绍 <a name="7"></a>
+HDMI具有体积小，传输速率高，传输带宽宽，兼容性好，能同时传输无压缩音视频信号等优点。与传统的全模拟接口相比，HDMI不但增加了设备间接线的便捷性，还提供了一些HDMI特有的智能化功能，可用于小体积设备进行高质量音视频传输的场景。
+### 接口说明 <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);
+    bool (*hotPlugStateGet)(struct HdmiCntlr *cntlr);
+    bool (*hotPlugInterruptStateGet)(struct HdmiCntlr *cntlr);
+    void (*lowPowerSet)(struct HdmiCntlr *cntlr, bool enable);
+    void (*tmdsModeSet)(struct HdmiCntlr *cntlr, enum HdmiTmdsModeType mode);
+    int32_t (*tmdsConfigSet)(struct HdmiCntlr *cntlr, struct HdmiTmdsConfig mode);
+    void (*infoFrameEnable)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, bool enable);
+    int32_t (*infoFrameSend)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, uint8_t *data, uint32_t len);
+    int32_t (*infoFrameDataSet)(struct HdmiCntlr *cntlr, uint32_t type, uint8_t *data, uint32_t len);
+    int32_t (*cecMsgSend)(struct HdmiCntlr *cntlr, struct HdmiCecMsg *msg);
+    void (*audioPathEnable)(struct HdmiCntlr *cntlr, bool enable);
+    void (*audioPathSet)(struct HdmiCntlr *cntlr, struct HdmiAudioConfigInfo *config);
+    void (*phyOutputEnable)(struct HdmiCntlr *cntlr, bool enable);
+    void (*phyOutputSet)(struct HdmiCntlr *cntlr, struct HdmiPhyCfg *cfg);
+    void (*blackDataSet)(struct HdmiCntlr *cntlr, bool enable);
+    void (*videoMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
+    void (*videoPathSet)(struct HdmiCntlr *cntlr, struct HdmiVideoAttr *attr);
+    void (*audioMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
+    void (*avmuteSet)(struct HdmiCntlr *cntlr, bool enable);
+    int32_t (*ddcTransfer)(struct HdmiCntlr *cntlr, struct HdmiDdcCfg *ddcCfg);
+    bool (*scdcSourceScrambleGet)(struct HdmiCntlr *cntlr);
+    int32_t (*scdcSourceScrambleSet)(struct HdmiCntlr *cntlr, bool enable);
+    void (*frlSet)(struct HdmiCntlr *cntlr);
+    int32_t (*frlEnable)(struct HdmiCntlr *cntlr, bool enable);
+    int32_t (*audioNctsSet)(struct HdmiCntlr *cntlr, struct HdmiFrlAudioNctsConfig *cfg);
+    void (*frlTrainingConfigSet)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainConfig *cfg);
+    void (*frlTrainingStart)(struct HdmiCntlr *cntlr);
+    void (*frlGetTriningRslt)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainRslt *rslt);
+    void (*hdcpRegInit)(struct HdmiCntlr *cntlr);
+    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. **实例化驱动入口：** 
+- **实例化驱动入口：** 
    - 实例化HdfDriverEntry结构体成员。
    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
-2. **配置属性文件：**
+- **配置属性文件：**
    - 在device_info.hcs文件中添加deviceNode描述。
    - 【可选】添加hdmi_config.hcs器件属性文件。
-3. **实例化HDMI控制器对象：**
+- **实例化HDMI控制器对象：**
    - 初始化HdmiCntlr成员。
-    - 实例化HdmiCntlr成员HdmiCntlrOps方法集合，其定义和成员函数说明见下文。
+    - 实例化HdmiCntlr成员HdmiCntlrOps方法集合。
-    HdmiCntlrOps定义：
+1. **实例化驱动入口**
-    ```c
-    struct HdmiCntlrOps {
-        void (*hardWareInit)(struct HdmiCntlr *cntlr);
-        void (*hardWareStatusGet)(struct HdmiCntlr *cntlr, struct HdmiHardwareStatus *status);
-        void (*controllerReset)(struct HdmiCntlr *cntlr);
-        bool (*hotPlugStateGet)(struct HdmiCntlr *cntlr);
-        bool (*hotPlugInterruptStateGet)(struct HdmiCntlr *cntlr);
-        void (*lowPowerSet)(struct HdmiCntlr *cntlr, bool enable);
-        void (*tmdsModeSet)(struct HdmiCntlr *cntlr, enum HdmiTmdsModeType mode);
-        int32_t (*tmdsConfigSet)(struct HdmiCntlr *cntlr, struct HdmiTmdsConfig mode);
-        void (*infoFrameEnable)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, bool enable);
-        int32_t (*infoFrameSend)(struct HdmiCntlr *cntlr, enum HdmiPacketType infoFrameType, uint8_t *data, uint32_t len);
-        int32_t (*infoFrameDataSet)(struct HdmiCntlr *cntlr, uint32_t type, uint8_t *data, uint32_t len);
-        int32_t (*cecMsgSend)(struct HdmiCntlr *cntlr, struct HdmiCecMsg *msg);
-        void (*audioPathEnable)(struct HdmiCntlr *cntlr, bool enable);
-        void (*audioPathSet)(struct HdmiCntlr *cntlr, struct HdmiAudioConfigInfo *config);
-        void (*phyOutputEnable)(struct HdmiCntlr *cntlr, bool enable);
-        void (*phyOutputSet)(struct HdmiCntlr *cntlr, struct HdmiPhyCfg *cfg);
-        void (*blackDataSet)(struct HdmiCntlr *cntlr, bool enable);
-        void (*videoMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
-        void (*videoPathSet)(struct HdmiCntlr *cntlr, struct HdmiVideoAttr *attr);
-        void (*audioMuteEnable)(struct HdmiCntlr *cntlr, bool enable);
-        void (*avmuteSet)(struct HdmiCntlr *cntlr, bool enable);
-        int32_t (*ddcTransfer)(struct HdmiCntlr *cntlr, struct HdmiDdcCfg *ddcCfg);
-        bool (*scdcSourceScrambleGet)(struct HdmiCntlr *cntlr);
-        int32_t (*scdcSourceScrambleSet)(struct HdmiCntlr *cntlr, bool enable);
-        void (*frlSet)(struct HdmiCntlr *cntlr);
-        int32_t (*frlEnable)(struct HdmiCntlr *cntlr, bool enable);
-        int32_t (*audioNctsSet)(struct HdmiCntlr *cntlr, struct HdmiFrlAudioNctsConfig *cfg);
-        void (*frlTrainingConfigSet)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainConfig *cfg);
-        void (*frlTrainingStart)(struct HdmiCntlr *cntlr);
-        void (*frlGetTriningRslt)(struct HdmiCntlr *cntlr, struct HdmiFrlTrainRslt *rslt);
-        void (*hdcpRegInit)(struct HdmiCntlr *cntlr);
-        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结构体成员的回调函数功能说明
+    驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
-   | 函数成员                 | 入参                                                         | 出参                                   | 返回值             | 功能                                               |
-   | ------------------------ | ------------------------------------------------------------ | -------------------------------------- | ------------------ | -------------------------------------------------- |
-   | 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对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
    一般在加载驱动时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,10 +237,12 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        }
        ```
-3. 最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。
+3. **实例化控制器对象**
+    最后一步，完成驱动入口注册之后，要以核心层HdmiCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化HdmiCntlr成员HdmiCntlrOps（让用户可以通过接口来调用驱动底层函数），实现HdfDriverEntry成员函数（Bind，Init，Release）。
    - 自定义结构体参考
        > ![](../public_sys-resources/icon-note.gif) **说明：** 
        > 从驱动角度看，自定义结构体是参数和数据的载体。HDF会读取hdmi_config.hcs文件中的数值并通过DeviceResourceIface来初始化结构体成员，且其中一些重要数值（例如设备号、总线号等）也会被传递给核心层HdmiCntlr对象。
@@ -213,7 +254,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
            uint32_t regSize;               //【必要】寄存器位宽
            uint32_t irqNum;                //【必要】中断号
        };
        /* HdmiCntlr是核心层控制器结构体，其中的成员在Init函数中被赋值 */
        struct HdmiCntlr {
            struct IDeviceIoService service;
@@ -240,7 +281,7 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        };
        ```
-    - **【重要】** HdmiCntlr成员回调函数结构体HdmiCntlrOps的实例化
+    -  HdmiCntlr成员回调函数结构体HdmiCntlrOps的实例化
        ```c 
        static struct HdmiCntlrOps g_hdmiAdapterHostOps = {
@@ -280,15 +321,15 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
            .hdrTimerSet = HdmiAdapterHdrTimerSet,
        };
        ```
-    - **Bind函数参考**
+    - Bind函数参考
-        > **入参：** 
+        **入参：** 
-        >  HdfDeviceObject 是整个驱动对外呈现的接口参数，具备 HCS 配置文件的信息
+        HdfDeviceObject 是整个驱动对外呈现的接口参数，具备 HCS 配置文件的信息
-        > 
-        > **返回值：**
+        **返回值：**
-        > HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
+        HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
        |状态(值)|状态描述|
        |:-|:-|
        |HDF_ERR_INVALID_OBJECT|控制器对象非法|
@@ -297,12 +338,12 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
        |HDF_ERR_IO            |I/O 错误|
        |HDF_SUCCESS           |传输成功|
        |HDF_FAILURE           |传输失败|
-        > **函数说明：** 
+        **函数说明：** 
-        > 初始化自定义结构体对象HdmiAdapterHost，初始化HdmiCntlr成员，调用核心层HdmiCntlrAdd函数。
+        初始化自定义结构体对象HdmiAdapterHost，初始化HdmiCntlr成员，调用核心层HdmiCntlrAdd函数。
-        >
-        > HdmiCntlr，HdmiAdapterHost，HdfDeviceObject之间互相赋值，方便其他函数可以相互转化。
+        HdmiCntlr，HdmiAdapterHost，HdfDeviceObject之间互相赋值，方便其他函数可以相互转化。
        ```c
        static int32_t HdmiAdapterBind(struct HdfDeviceObject *obj)
        {
@@ -339,37 +380,37 @@ HDMI模块适配的三个环节是配置属性文件，实例化驱动入口以
            return ret;
        }
        ```
-    - **init函数参考**
+    - Init函数参考
-        >**入参：** 
+        **入参：** 
-        >HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
-        >
-        >**返回值：**
+        **返回值：**
-        >HDF_STATUS相关状态 
+        HDF_STATUS相关状态 
-        >
-        >函数说明：
+        **函数说明**：
-        >
-        >实现HdmiAdapterInit函数。
+        实现HdmiAdapterInit函数。
        ```c
        static int32_t HdmiAdapterInit(struct HdfDeviceObject *obj)
        {
            return HDF_SUCCESS;
        }
        ```
-    - **Release 函数参考**
+    - Release 函数参考
-        > **入参：** 
+        **入参：** 
-        > HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 
-        >
-        > **返回值：**
+        **返回值：**
-        > 无
+        无
-        > 
-        > **函数说明：**
+        **函数说明：**
-        > 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。
+        释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 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)
+    -   [功能简介](#section2)
-   [使用指导](#section3)
+    -   [基本概念](#section3)
-    -   [使用流程](#section4)
+    -   [运作机制](#section4)
-    -   [打开I3C控制器](#section5)
+    -   [约束与限制](#section5)
-    -   [进行I3C通信](#section6)
+-   [使用指导](#section6)
-    -   [获取I3C控制器配置](#section7)
+    -   [场景介绍](#section7)
-    -   [配置I3C控制器](#section8)
+    -   [接口说明](#section8)
-    -   [请求IBI（带内中断）](#section9)
+    -   [开发步骤](#section9)
-    -   [释放IBI（带内中断）](#section10)
+    -   [使用实例](#section10)
-    -   [关闭I3C控制器](#section11)
-   [使用实例](#section12)
 ## 概述<a name="section1"></a>
- I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
+### 功能简介<a name="section2"></a>
- I3C总线向下兼容传统的I2C设备，同时增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。
+I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
+- I3C接口定义了完成I3C传输的通用方法集合，包括：
+    I3C控制器管理：打开或关闭I3C控制器。
+    I3C控制器配置：获取或配置I3C控制器参数。
+    I3C消息传输：通过消息传输结构体数组进行自定义传输。
+    I3C带内中断：请求或释放带内中断。
+### 基本概念<a name="section3"></a>
+- I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。
+- I3C增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。
 - I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。
-   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 兼容设备类型（例如，加速度计、陀螺仪等）。
-    -   I3C控制器管理：打开或关闭I3C控制器。
+### 运作机制<a name="section4"></a>
-    -   I3C控制器配置：获取或配置I3C控制器参数。
-    -   I3C消息传输：通过消息传输结构体数组进行自定义传输。
-    -   I3C带内中断：请求或释放带内中断。
- -    I3C的物理连接如[图1](#fig1)所示：  
-    **图 1**  I3C物理连线示意图<a name="fig1"></a>  
-    ![](figures/I3C物理连线示意图.png "I3C物理连线示意图")
-## 接口说明<a name="section2"></a>
+在HDF框架中，I3C模块接口适配模式采用统一服务模式，这需要一个设备服务来作为I3C模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如I3C可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。
-**表 1**  I3C驱动API接口功能介绍
+ 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。一路I3C总线上，可以连接多个设备，这些设备可以是I2C从设备、I3C从设备和I3C次级主设备，但只能同时存在一个主设备，一般为控制器本身。
-<a name="table1"></a>
+**图 1**  I3C物理连线示意图<a name="fig1"></a>  
+![](figures/I3C物理连线示意图.png "I3C物理连线示意图")
+### 约束与限制<a name="section5"></a>
+I3C模块当前仅支持轻量和小型系统内核（LiteOS） 。
-<table><thead align="left"><tr><th class="cellrowborder" valign="top" width="18.63%"><p>功能分类</p>
+## 使用指导<a name="section6"></a>
-</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>
+### 场景介绍<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="section9"></a>
-### 使用流程<a name="section4"></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>
+| number     | I3C控制器号         |
-</th>
+| **返回值** | **返回值描述**      |
-</tr>
+| NULL       | 打开I3C控制器失败   |
-</thead>
+| 控制器句柄 | 打开的I3C控制器句柄 |
-<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>
 假设系统中存在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>
+| handle     | I3C控制器句柄                                |
-</th>
+| msgs       | 待传输数据的消息结构体数组                   |
-</tr>
+| count      | 消息数组长度                                 |
-</thead>
+| mode       | 传输模式，0：I2C模式；1：I3C模式；2：发送CCC |
-<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>
 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>
+| handle     | I3C控制器句柄  |
-</th>
+| config     | I3C控制器配置  |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 获取成功       |
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
+| 负数       | 获取失败       |
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器句柄</p>
+获取I3C控制器配置示例：
-</td>
-</tr>
+```c
-<tr><td class="cellrowborder" valign="top" width="50%"><p>config</p>
+struct I3cConfig config;
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器配置</p>
+ret = I3cGetConfig(i3cHandle, &config);
-</td>
+if (ret != HDF_SUCCESS) {
-</tr>
+    HDF_LOGE("%s: Get config fail!", __func__);
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
+    return HDF_FAILURE;
-</td>
+}
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
+```
-</td>
-</tr>
+#### 配置I3C控制器<a name="section8"></a>
-<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>
 ```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>
+| handle     | I3C控制器句柄  |
-</th>
+| config     | I3C控制器配置  |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 配置成功       |
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
+| 负数       | 配置失败       |
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器句柄</p>
+配置I3C控制器示例：
-</td>
-</tr>
+```c
-<tr><td class="cellrowborder" valign="top" width="50%"><p>config</p>
+struct I3cConfig config;
-</td>
-<td class="cellrowborder" valign="top" width="50%"><p>I3C控制器配置</p>
+config->busMode = I3C_BUS_HDR_MODE;
-</td>
+config->curMaster = NULL;
-</tr>
+ret = I3cSetConfig(i3cHandle, &config);
-<tr><td class="cellrowborder" valign="top" width="50%"><p><strong>返回值</strong></p>
+if (ret != HDF_SUCCESS) {
-</td>
+    HDF_LOGE("%s: Set config fail!", __func__);
-<td class="cellrowborder" valign="top" width="50%"><p><strong>返回值描述</strong></p>
+    return HDF_FAILURE;
-</td>
+}
-</tr>
+```
-<tr><td class="cellrowborder" valign="top" width="50%"><p>0</p>
-</td>
+#### 请求IBI（带内中断）<a name="section9"></a>
-<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>
 ```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>
+| handle     | I3C控制器句柄  |
-</th>
+| addr       | I3C设备地址    |
-</tr>
+| func       | IBI回调函数    |
-</thead>
+| payload    | IBI有效载荷    |
-<tbody><tr><td class="cellrowborder" valign="top" width="50%"><p>handle</p>
+| **返回值** | **返回值描述** |
-</td>
+| 0          | 请求成功       |
-<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>
 ```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>
+| handle     | I3C控制器句柄  |
-</th>
+| addr       | I3C设备地址    |
-</tr>
+| **返回值** | **返回值描述** |
-</thead>
+| 0          | 释放成功       |
-<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>
 ```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>
+| handle     | I3C控制器句柄  |
-</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>
+关闭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)
+    - [功能简介](#2)
- [开发实例](#3)
+    - [基本概念](#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>
+I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
+### 基本概念<a name="3"></a>
+I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。 相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。
+- 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） ：通用命令代码（CCC），所有I3C设备均支持CCC，可以直接将其传输到特定的I3C从设备，也可以同时传输到所有I3C从设备。
+- BCR（Bus Characteristic Register）：总线特性寄存器，每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 （BCR），该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。
+- DCR（Device Characteristic Register）：设备特性寄存器，连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型（例如，加速度计、陀螺仪等）。
+### 运作机制<a name="4"></a>
+在HDF框架中，同类型控制器对象较多时（可能同时存在十几个同类型控制器），如果采用独立服务模式则需要配置更多的设备节点，且相关服务会占据更多的内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现）,实现便捷管理和节约资源的目的。I3C模块接口适配模式采用统一服务模式（如[图1](#fig1)所示）。
+I3C模块各分层的作用为：接口层提供打开控制器、传输消息、获取和设置控制器参数以及关闭控制器的接口。核心层主要提供绑定设备、初始化设备以及释放设备的能力。适配层实现其他具体的功能。
+ **图 1**  I3C统一服务模式<a name="fig1"></a> 
 ![image1](figures/统一服务模式结构图.png)
-## 开发步骤 <a name="2"></a>
+### 约束与限制<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);
+    int32_t (*setConfig)(struct I3cCntlr *cntlr, struct I3cConfig *config);
+    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>
 I3C模块适配的四个环节是实例化驱动入口、配置属性文件、实例化I3C控制器对象以及注册中断处理子程序。
-1. **实例化驱动入口：** 
+- **实例化驱动入口：** 
    - 实例化HdfDriverEntry结构体成员。
    - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。
-2. **配置属性文件：**
+- **配置属性文件：**
    - 在device_info.hcs文件中添加deviceNode描述。
    - 【可选】添加i3c_config.hcs器件属性文件。
-3. **实例化I3C控制器对象：**
+- **实例化I3C控制器对象：**
    - 初始化I3cCntlr成员。
    - 实例化I3cCntlr成员I3cMethod方法集合，其定义和成员函数说明见下文。
-4. **注册中断处理子程序：**
+- **注册中断处理子程序：**
    为控制器注册中断处理程序，实现设备热接入和IBI（带内中断）功能。
-    I3cMethod定义：
+1. **实例化驱动入口**
-    ```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);
-        int32_t (*setConfig)(struct I3cCntlr *cntlr, struct I3cConfig *config);
-        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="3"></a>
-1. 驱动开发首先需要实例化驱动入口，驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
+    驱动入口必须为HdfDriverEntry（在 hdf_device_desc.h 中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。
    一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。
    I3C驱动入口参考：
    > I3C模块这种类型的控制器会出现很多个控制器挂接的情况，因而在HDF框架中首先会为这类型的控制器创建一个管理器对象，并同时对外发布一个管理器服务来统一处理外部访问。这样，用户需要打开某个控制器时，会先获取到管理器服务，然后管理器服务根据用户指定参数查找到指定控制器。
-    >
+    > 
-    > I3C管理器服务的驱动由核心层实现，**厂商不需要关注这部分内容的实现，但在实现Init函数的时候需要调用核心层的I3cCntlrAdd函数，它会实现相应功能。**
+    > I3C管理器服务的驱动由核心层实现，厂商不需要关注这部分内容的实现，但在实现Init函数的时候需要调用核心层的I3cCntlrAdd函数，它会实现相应功能。
    ```c
    static struct HdfDriverEntry g_virtualI3cDriverEntry = {
        .moduleVersion = 1,
@@ -87,17 +129,19 @@ 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管理器，其各项参数必须如下设置: 
    |成员名|值|
    |-|-|
    |moduleName |HDF_PLATFORM_I3C_MANAGER|
    |serviceName|无（预留）|
    |policy|0|
    |cntlrMatchAttr| 无（预留）|
    从第二个节点开始配置具体I3C控制器信息，此节点并不表示某一路I3C控制器，而是代表一个资源性质设备，用于描述一类I3C控制器的信息。本例只有一个I3C控制器，如有多个控制器，则需要在device_info文件增加deviceNode信息，以及在i3c_config文件中增加对应的器件属性。
    - device_info.hcs 配置参考
@@ -151,14 +195,16 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        }
        ```
-3. 配置属性文件完成后，要以核心层I3cCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化I3cCntlr成员I3cMethod（让用户可以通过接口来调用驱动底层函数）。
+3. **实例化I3C控制器对象**
+    配置属性文件完成后，要以核心层I3cCntlr对象的初始化为核心，包括厂商自定义结构体（传递参数和数据），实例化I3cCntlr成员I3cMethod（让用户可以通过接口来调用驱动底层函数）。
    此步骤需要通过实现HdfDriverEntry成员函数（Bind，Init，Release）来完成。
    - 自定义结构体参考
        > 从驱动的角度看，自定义结构体是参数和数据的载体，而且i3c_config.hcs文件中的数值会被HDF读入通过DeviceResourceIface来初始化结构体成员，其中一些重要数值也会传递给核心层I3cCntlr对象，例如设备号、总线号等。
        ```c
        struct VirtualI3cCntlr {
            struct I3cCntlr cntlr;   //【必要】是核心层控制对象，具体描述见下面
@@ -173,7 +219,7 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
            uint32_t i2cFmRate;
            uint32_t i2cFmPlusRate;
        };
        /* I3cCntlr是核心层控制器结构体，其中的成员在Init函数中被赋值 */
        struct I3cCntlr {
            OsalSpinlock lock;
@@ -188,109 +234,109 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        };
        ```
-        > **【重要】** I3cCntlr成员回调函数结构体I3cMethod的实例化，I3cLockMethod回调函数结构体本例未实现，若要实例化，可参考I2C驱动开发，其他成员在Init函数中初始化
+         > I3cCntlr成员回调函数结构体I3cMethod的实例化，I3cLockMethod回调函数结构体本例未实现，若要实例化，可参考I2C驱动开发，其他成员在Init函数中初始化
+    - init函数参考
-    - **init函数参考**
+        **入参：** 
-        > **入参：** 
+          HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
-        >  HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息
-        > 
+        **返回值：**
-        > **返回值：**
+         HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
-        > HDF_STATUS相关状态 （下表为部分展示，如需使用其他状态，可见//drivers/framework/include/utils/hdf_base.h中HDF_STATUS 定义）
+         |状态(值)|问题描述|
+         |:-|:-:|
+         |HDF_ERR_INVALID_OBJECT|控制器对象非法|
+         |HDF_ERR_INVALID_PARAM |参数非法|
+         |HDF_ERR_MALLOC_FAIL   |内存分配失败|
+         |HDF_ERR_IO            |I/O 错误|
+         |HDF_SUCCESS           |传输成功|
+         |HDF_FAILURE           |传输失败|
+         **函数说明：**
+         初始化自定义结构体对象，初始化I3cCntlr成员，调用核心层I3cCntlrAdd函数。
+         ```c
+         static int32_t VirtualI3cParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node)
+         {
+             int32_t ret;
+             struct VirtualI3cCntlr *virtual = NULL;    //【必要】自定义结构体对象
+             (void)device;
+             virtual = (struct VirtualI3cCntlr *)OsalMemCalloc(sizeof(*virtual)); //【必要】内存分配
+             if (virtual == NULL) {
+                 HDF_LOGE("%s: Malloc virtual fail!", __func__);
+                 return HDF_ERR_MALLOC_FAIL;
+             }
+             ret = VirtualI3cReadDrs(virtual, node);     //【必要】将i3c_config文件的默认值填充到结构体中
+             if (ret != HDF_SUCCESS) {
+                 HDF_LOGE("%s: Read drs fail! ret:%d", __func__, ret);
+                 goto __ERR__;
+             }
+             ...
+             virtual->regBase = OsalIoRemap(virtual->regBasePhy, virtual->regSize);//【必要】地址映射
+             ret = OsalRegisterIrq(hi35xx->softIrqNum, OSAL_IRQF_TRIGGER_NONE, I3cIbiHandle, "I3C", virtual); //【必要】注册中断程序
+             if (ret != HDF_SUCCESS) {
+                 HDF_LOGE("%s: register irq failed!", __func__);
+                 return ret;
+             }
+             ...
+             VirtualI3cCntlrInit(virtual);              //【必要】I3C设备的初始化
+             virtual->cntlr.priv = (void *)node;        //【必要】存储设备属性
+             virtual->cntlr.busId = virtual->busId;     //【必要】初始化I3cCntlr成员
+             virtual->cntlr.ops = &g_method;            //【必要】I3cMethod的实例化对象的挂载
+             (void)OsalSpinInit(&virtual->spin);
+             ret = I3cCntlrAdd(&virtual->cntlr);        //【必要且重要】调用此函数将控制器添加至核心，返回成功信号后驱动才完全接入平台核心层 
+             if (ret != HDF_SUCCESS) {
+                 HDF_LOGE("%s: add i3c controller failed! ret = %d", __func__, ret);
+                 (void)OsalSpinDestroy(&virtual->spin);
+                 goto __ERR__;
+             }
+             return HDF_SUCCESS;
+         __ERR__:                                       //若控制器添加失败，需要执行去初始化相关函数
+             if (virtual != NULL) {
+                 OsalMemFree(virtual);
+                 virtual = NULL;
+             }
+             return ret;
+         }
+         static int32_t VirtualI3cInit(struct HdfDeviceObject *device)
+         {
+             int32_t ret;
+             const struct DeviceResourceNode *childNode = NULL;
+             if (device == NULL || device->property == NULL) {
+                 HDF_LOGE("%s: device or property is NULL", __func__);
+                 return HDF_ERR_INVALID_OBJECT;
+             }
+             DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {
+                 ret = VirtualI3cParseAndInit(device, childNode);
+                 if (ret != HDF_SUCCESS) {
+                     break;
+                 }
+             }
+             return ret;
+         }
+         ```
+    - Release 函数参考
+        **入参：** 
+        HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 。
-        |状态(值)|问题描述|
+        **返回值：**
-        |:-|:-:|
+        无。
-        |HDF_ERR_INVALID_OBJECT|控制器对象非法|
-        |HDF_ERR_INVALID_PARAM |参数非法|
+        **函数说明：**
-        |HDF_ERR_MALLOC_FAIL   |内存分配失败|
+        释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
-        |HDF_ERR_IO            |I/O 错误|
-        |HDF_SUCCESS           |传输成功|
-        |HDF_FAILURE           |传输失败|
-        > **函数说明：**
-        > 初始化自定义结构体对象，初始化I3cCntlr成员，调用核心层I3cCntlrAdd函数。
-        ```c
-        static int32_t VirtualI3cParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node)
-        {
-            int32_t ret;
-            struct VirtualI3cCntlr *virtual = NULL;    //【必要】自定义结构体对象
-            (void)device;
-            virtual = (struct VirtualI3cCntlr *)OsalMemCalloc(sizeof(*virtual)); //【必要】内存分配
-            if (virtual == NULL) {
-                HDF_LOGE("%s: Malloc virtual fail!", __func__);
-                return HDF_ERR_MALLOC_FAIL;
-            }
-            ret = VirtualI3cReadDrs(virtual, node);     //【必要】将i3c_config文件的默认值填充到结构体中
-            if (ret != HDF_SUCCESS) {
-                HDF_LOGE("%s: Read drs fail! ret:%d", __func__, ret);
-                goto __ERR__;
-            }
-            ...
-            virtual->regBase = OsalIoRemap(virtual->regBasePhy, virtual->regSize);//【必要】地址映射
-            ret = OsalRegisterIrq(hi35xx->softIrqNum, OSAL_IRQF_TRIGGER_NONE, I3cIbiHandle, "I3C", virtual); //【必要】注册中断程序
-            if (ret != HDF_SUCCESS) {
-                HDF_LOGE("%s: register irq failed!", __func__);
-                return ret;
-            }
-            ...
-            VirtualI3cCntlrInit(virtual);              //【必要】I3C设备的初始化
-            virtual->cntlr.priv = (void *)node;        //【必要】存储设备属性
-            virtual->cntlr.busId = virtual->busId;     //【必要】初始化I3cCntlr成员
-            virtual->cntlr.ops = &g_method;            //【必要】I3cMethod的实例化对象的挂载
-            (void)OsalSpinInit(&virtual->spin);
-            ret = I3cCntlrAdd(&virtual->cntlr);        //【必要且重要】调用此函数将控制器添加至核心，返回成功信号后驱动才完全接入平台核心层 
-            if (ret != HDF_SUCCESS) {
-                HDF_LOGE("%s: add i3c controller failed! ret = %d", __func__, ret);
-                (void)OsalSpinDestroy(&virtual->spin);
-                goto __ERR__;
-            }
-            return HDF_SUCCESS;
-        __ERR__:                                       //若控制器添加失败，需要执行去初始化相关函数
-            if (virtual != NULL) {
-                OsalMemFree(virtual);
-                virtual = NULL;
-            }
-            return ret;
-        }
-        static int32_t VirtualI3cInit(struct HdfDeviceObject *device)
-        {
-            int32_t ret;
-            const struct DeviceResourceNode *childNode = NULL;
-            if (device == NULL || device->property == NULL) {
-                HDF_LOGE("%s: device or property is NULL", __func__);
-                return HDF_ERR_INVALID_OBJECT;
-            }
-            DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) {
-                ret = VirtualI3cParseAndInit(device, childNode);
-                if (ret != HDF_SUCCESS) {
-                    break;
-                }
-            }
-            return ret;
-        }
-        ```
-    - **Release 函数参考**
-        > **入参：** 
-        > HdfDeviceObject 是整个驱动对外暴露的接口参数，具备 HCS 配置文件的信息 。
-        > 
-        > **返回值：**
-        > 无。
-        > 
-        > **函数说明：**
-        > 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给 Release 接口， 当HDF框架调用Init函数初始化驱动失败时，可以调用 Release 释放驱动资源。所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。
        ```c
        static void VirtualI3cRemoveByNode(const struct DeviceResourceNode *node)
        {
@@ -327,9 +373,9 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        static void VirtualI3cRelease(struct HdfDeviceObject *device)
        {
            const struct DeviceResourceNode *childNode = NULL;
            HDF_LOGI("%s: enter", __func__);
            if (device == NULL || device->property == NULL) {
                HDF_LOGE("%s: device or property is NULL", __func__);
                return;
@@ -342,7 +388,9 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        }
        ```
-4. 最后一步，实现中断处理程序，在中断处理程序中通过判断中断产生的地址，实现热接入、IBI等操作。
+4. **注册中断处理子程序**
+    在中断处理程序中通过判断中断产生的地址，实现热接入、IBI等操作。
    ```c
    static int32_t VirtualI3cReservedAddrWorker(struct VirtualI3cCntlr *virtual, uint16_t addr)
@@ -378,7 +426,7 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
        struct I3cDevice *device = NULL;
        uint16_t ibiAddr;
        char *testStr = "Hello I3C!";
        (void)irq;
        if (data == NULL) {
            HDF_LOGW("%s: data is NULL!", __func__);
@@ -404,7 +452,7 @@ I3C模块适配的四个环节是实例化驱动入口、配置属性文件、
            /* 根据产生IBI的I3C设备调用IBI回调函数 */
            return I3cCntlrIbiCallback(device);
        }
        return HDF_SUCCESS;
    }
    ```
\ No newline at end of file
--- 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