!1314 #I4MT5L完成，请审核

Merge pull request !1314 from Annie_wang/PR902

en/device-dev/driver/Readme-EN.md

@@ -11,7 +11,7 @@
   - [ADC](driver-platform-adc-develop.md)
   - [GPIO](driver-platform-gpio-develop.md)
   - [I2C](driver-platform-i2c-develop.md)
-  - [MIPI-DSI](driver-platform-mipidsi-develop.md)
+  - [MIPI DSI](driver-platform-mipidsi-develop.md)
   - [MMC](driver-platform-mmc-develop.md)
   - [PWM](driver-platform-pwm-develop.md)
   - [RTC](driver-platform-rtc-develop.md)
@@ -19,6 +19,7 @@
   - [SPI](driver-platform-spi-develop.md)
   - [UART](driver-platform-uart-develop.md)
   - [Watchdog](driver-platform-watchdog-develop.md)
+  - [MIPI CSI](driver-platform-mipicsi-develop.md)
 - [Platform Driver Usage](driver-platform.md)
   - [GPIO](driver-platform-gpio-des.md)
   - [I2C](driver-platform-i2c-des.md)
@@ -29,6 +30,7 @@
   - [Watchdog](driver-platform-watchdog-des.md)
   - [MIPI DSI](driver-platform-mipidsi-des.md)
   - [PWM](driver-platform-pwm-des.md)
+  - [MIPI CSI](driver-platform-mipicsi-des.md)
 - [Peripheral Driver Usage](driver-peripherals.md)
   - [LCD](driver-peripherals-lcd-des.md)
   - [Touchscreen](driver-peripherals-touch-des.md)

en/device-dev/driver/driver-platform-mipidsi-des.md

@@ -4,7 +4,7 @@
 -   [Available APIs](#section12720125432316)
 -   [Usage Guidelines](#section037231715335)
     -   [How to Use](#section49299119344)
-    -   [Obtains a MIPI DSI device handle.](#section5126155683811)
+    -   [Obtaining a MIPI DSI Device Handle](#section5126155683811)
     -   [Setting MIPI DSI Configuration Parameters](#section201164274344)
     -   [Sending/Receiving the Pointer to a Command](#section199401342173415)
     -   [Releasing the MIPI DSI Device Handle](#section161011610357)
@@ -96,9 +96,9 @@
 [Figure 2](#fig129103491241)  shows the process of using a MIPI DSI device.
 
 **Figure  2**  Process of using a MIPI DSI device<a name="fig129103491241"></a>  
-![](figures/process-of-using-a-mipi-dsi-device.png "process-of-using-a-mipi-dsi-device")
+![](figures/process-of-using-a-mipi-dsi-device.png)
 
-### Obtains a MIPI DSI device handle.<a name="section5126155683811"></a>
+### Obtaining a MIPI DSI Device Handle<a name="section5126155683811"></a>
 
 Before performing MIPI DSI communication, obtain a MIPI DSI device handle by calling  **MipiDsiOpen**. This function returns a MIPI DSI device handle with a specified channel ID.
 
@@ -213,7 +213,7 @@ cfg.timingInfo.vsaLines = 76;
 cfg.timingInfo.vfpLines = 120;
 cfg.timingInfo.xResPixels = 1342;
 /* Set MIPI DSI configuration parameters. */
-ret = MipiDsiSetCfg(g_handle, &cfg);
+ret = MipiDsiSetCfg(mipiDsiHandle, &cfg);
 if (ret != 0) {
     HDF_LOGE("%s: SetMipiCfg fail! ret=%d\n", __func__, ret);
     return -1;
@@ -265,7 +265,7 @@ int32\_t MipiDsiGetCfg\(DevHandle handle, struct MipiCfg \*cfg\);
 int32_t ret;
 struct MipiCfg cfg;
 memset(&cfg, 0, sizeof(struct MipiCfg));
-ret = MipiDsiGetCfg(g_handle, &cfg);
+ret = MipiDsiGetCfg(mipiDsiHandle, &cfg);
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("%s: GetMipiCfg fail!\n", __func__);
     return HDF_FAILURE;
@@ -409,9 +409,9 @@ if (cmdRead->payload == NULL) {
     return HDF_FAILURE;
 }
 *(cmdRead->payload) = DDIC_REG_STATUS;
-MipiDsiSetLpMode(g_handle);
-ret = MipiDsiRx(g_handle, cmdRead, sizeof(readVal), &readVal);
-MipiDsiSetHsMode(g_handle);
+MipiDsiSetLpMode(mipiDsiHandle);
+ret = MipiDsiRx(mipiDsiHandle, cmdRead, sizeof(readVal), &readVal);
+MipiDsiSetHsMode(mipiDsiHandle);
 if (ret != HDF_SUCCESS) {
     HDF_LOGE("%s: MipiDsiRx fail! ret=%d\n", __func__, ret);
     HdfFree(cmdRead->payload);
@@ -463,13 +463,13 @@ void PalMipiDsiTestSample(void)
 {
     uint8_t chnId;
     int32_t ret;  
-    DevHandle handle = NULL;
+    DevHandle mipiDsiHandle = NULL;
     
     /* Device channel ID */
     chnId = 0; 
     /* Obtain the MIPI DSI device handle based on a specified channel ID. */
-    handle = MipiDsiOpen(chnId);
-    if (handle == NULL) {
+    mipiDsiHandle = MipiDsiOpen(chnId);
+    if (mipiDsiHandle == NULL) {
         HDF_LOGE("MipiDsiOpen: failed!\n");
         return;
     }
@@ -490,7 +490,7 @@ void PalMipiDsiTestSample(void)
     cfg.timingInfo.vfpLines = 120;
     cfg.timingInfo.xResPixels = 1342;
     /* Set MIPI DSI configuration parameters. */
-    ret = MipiDsiSetCfg(g_handle, &cfg);
+    ret = MipiDsiSetCfg(mipiDsiHandle, &cfg);
     if (ret != 0) {
         HDF_LOGE("%s: SetMipiCfg fail! ret=%d\n", __func__, ret);
         return;
@@ -533,9 +533,9 @@ void PalMipiDsiTestSample(void)
         return;
     }
     *(cmdRead->payload) = DDIC_REG_STATUS;
-    MipiDsiSetLpMode(g_handle);
-    ret = MipiDsiRx(g_handle, cmdRead, sizeof(readVal), &readVal);
-    MipiDsiSetHsMode(g_handle);
+    MipiDsiSetLpMode(mipiDsiHandle);
+    ret = MipiDsiRx(mipiDsiHandle, cmdRead, sizeof(readVal), &readVal);
+    MipiDsiSetHsMode(mipiDsiHandle);
     if (ret != HDF_SUCCESS) {
         HDF_LOGE("%s: MipiDsiRx fail! ret=%d\n", __func__, ret);
         HdfFree(cmdRead->payload);

en/device-dev/driver/driver-platform-mipidsi-develop.md

-# MIPI-DSI<a name="EN-US_TOPIC_0000001199825369"></a>
+# MIPI DSI<a name="EN-US_TOPIC_0000001199825369"></a>
 
 -   [Overview](#section1266787503161538)
 -   [How to Develop](#section545182932161538)
@@ -8,14 +8,14 @@
 
 ## Overview<a name="section1266787503161538"></a>
 
-The Display Serial Interface \(DSI\) is a specification developed by the Mobile Industry Processor Interface \(MIPI\) Alliance to reduce the cost of display controllers in mobile devices. In the Hardware Driver Foundation (HDF) framework, the MIPI-DSI module uses the service-free mode for API adaptation. The service-free mode applies to the devices that do not provide user-mode APIs or the OS system that does not distinguish the user mode and the kernel mode. In the service-free mode,  **DevHandle**  \(a void pointer\) directly points to the kernel-mode address of the device object.
+The Display Serial Interface \(DSI\) is a specification developed by the Mobile Industry Processor Interface \(MIPI\) Alliance to reduce the cost of display controllers in mobile devices. In the Hardware Driver Foundation (HDF) framework, the MIPI DSI module uses the service-free mode for API adaptation. The service-free mode applies to the devices that do not provide user-mode APIs or the OS system that does not distinguish the user mode and the kernel mode. In the service-free mode,  **DevHandle**  \(a void pointer\) directly points to the kernel-mode address of the device object.
 
 **Figure  1**  Service-free mode<a name="fig207610236189"></a>  
-![](figures/service-free-mode-9.png "service-free-mode-9")
+![](figures/service-free-mode.png "service-free-mode")
 
 ## How to Develop<a name="section545182932161538"></a>
 
-The MIPI-DSI module adaptation involves the following steps:
+The MIPI DSI module adaptation involves the following steps:
 
 1.  Instantiate the driver entry.
     -   Instantiate the  **HdfDriverEntry**  structure.
@@ -25,7 +25,7 @@ The MIPI-DSI module adaptation involves the following steps:
     -   Add the  **deviceNode**  information to the  **device\_info.hcs**  file.
     -   \(Optional\) Add the  **mipidsi\_config.hcs**  file.
 
-3.  Instantiate the MIPI-DSI controller object.
+3.  Instantiate the MIPI DSI controller object.
     -   Initialize  **MipiDsiCntlr**.
     -   Instantiate  **MipiDsiCntlrMethod**  in the  **MipiDsiCntlr**  object.
 
@@ -70,7 +70,7 @@ struct MipiDsiCntlrMethod {// Member functions of the core layer structure
 </thead>
 <tbody><tr id="row318920102175"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.1 "><p id="p01891103178"><a name="p01891103178"></a><a name="p01891103178"></a>setCntlrCfg</p>
 </td>
-<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p1518931041716"><a name="p1518931041716"></a><a name="p1518931041716"></a><strong id="b14872821599"><a name="b14872821599"></a><a name="b14872821599"></a>cntlr</strong>: structure pointer to the MIPI-DSI controller.</p>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p1518931041716"><a name="p1518931041716"></a><a name="p1518931041716"></a><strong id="b14872821599"><a name="b14872821599"></a><a name="b14872821599"></a>cntlr</strong>: structure pointer to the MIPI DSI controller.</p>
 </td>
 <td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.3 "><p id="p51893103174"><a name="p51893103174"></a><a name="p51893103174"></a>–</p>
 </td>
@@ -81,7 +81,7 @@ struct MipiDsiCntlrMethod {// Member functions of the core layer structure
 </tr>
 <tr id="row10189210151713"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.1 "><p id="p518991017171"><a name="p518991017171"></a><a name="p518991017171"></a>setCmd</p>
 </td>
-<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p177917412215"><a name="p177917412215"></a><a name="p177917412215"></a><strong id="b4791144113213"><a name="b4791144113213"></a><a name="b4791144113213"></a>cntlr</strong>: structure pointer to the MIPI-DSI controller. </p>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p177917412215"><a name="p177917412215"></a><a name="p177917412215"></a><strong id="b4791144113213"><a name="b4791144113213"></a><a name="b4791144113213"></a>cntlr</strong>: structure pointer to the MIPI DSI controller. </p>
 <p id="p12189131018174"><a name="p12189131018174"></a><a name="p12189131018174"></a><strong id="b192414338012"><a name="b192414338012"></a><a name="b192414338012"></a>cmd</strong>: structure pointer to the input instruction.</p>
 </td>
 <td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.3 "><p id="p191891210111710"><a name="p191891210111710"></a><a name="p191891210111710"></a>–</p>
@@ -93,7 +93,7 @@ struct MipiDsiCntlrMethod {// Member functions of the core layer structure
 </tr>
 <tr id="row2190161061714"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.1 "><p id="p111901810181715"><a name="p111901810181715"></a><a name="p111901810181715"></a>getCmd</p>
 </td>
-<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p121902101179"><a name="p121902101179"></a><a name="p121902101179"></a><strong id="b516432716114"><a name="b516432716114"></a><a name="b516432716114"></a>cntlr</strong>: structure pointer to the MIPI-DSI controller.</p>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p121902101179"><a name="p121902101179"></a><a name="p121902101179"></a><strong id="b516432716114"><a name="b516432716114"></a><a name="b516432716114"></a>cntlr</strong>: structure pointer to the MIPI DSI controller.</p>
 </td>
 <td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.3 "><p id="p1519018101171"><a name="p1519018101171"></a><a name="p1519018101171"></a>cmd: structure pointer to the instruction to output.</p>
 </td>
@@ -104,7 +104,7 @@ struct MipiDsiCntlrMethod {// Member functions of the core layer structure
 </tr>
 <tr id="row1919071016171"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.1 "><p id="p16190131051710"><a name="p16190131051710"></a><a name="p16190131051710"></a>toHs</p>
 </td>
-<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p151906102178"><a name="p151906102178"></a><a name="p151906102178"></a><strong id="b159559351014"><a name="b159559351014"></a><a name="b159559351014"></a>cntlr</strong>: structure pointer to the MIPI-DSI controller.</p>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p151906102178"><a name="p151906102178"></a><a name="p151906102178"></a><strong id="b159559351014"><a name="b159559351014"></a><a name="b159559351014"></a>cntlr</strong>: structure pointer to the MIPI DSI controller.</p>
 </td>
 <td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.3 "><p id="p10190181031720"><a name="p10190181031720"></a><a name="p10190181031720"></a>–</p>
 </td>
@@ -115,7 +115,7 @@ struct MipiDsiCntlrMethod {// Member functions of the core layer structure
 </tr>
 <tr id="row01911510161718"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.1 "><p id="p10191141081717"><a name="p10191141081717"></a><a name="p10191141081717"></a>toLp</p>
 </td>
-<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p819121011714"><a name="p819121011714"></a><a name="p819121011714"></a><strong id="b189629351219"><a name="b189629351219"></a><a name="b189629351219"></a>cntlr</strong>: structure pointer to the MIPI-DSI controller.</p>
+<td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.2 "><p id="p819121011714"><a name="p819121011714"></a><a name="p819121011714"></a><strong id="b189629351219"><a name="b189629351219"></a><a name="b189629351219"></a>cntlr</strong>: structure pointer to the MIPI DSI controller.</p>
 </td>
 <td class="cellrowborder" valign="top" width="20%" headers="mcps1.2.6.1.3 "><p id="p3191510171717"><a name="p3191510171717"></a><a name="p3191510171717"></a>–</p>
 </td>
@@ -133,7 +133,7 @@ The following uses  **mipi\_tx\_hi35xx.c**  as an example to present the content
 
 1.  Generally, you need to configure the device attributes in  **xx\_config.hcs**  and add the  **deviceNode**  information to the  **device\_info.hcs**  file. The device attribute values are closely related to the default values or value range of the  **MipiDsiCntlr**  members at the core layer. The  **deviceNode**  information is related to the driver entry registration.
 
-    In this example, no additional attribute needs to be configured for the MIPI-DSI controller. If required, you need to add the  **deviceMatchAttr**  information to  **deviceNode**  in the  **device\_info**  file and add the  **mipidsi\_config**  file.
+    In this example, no additional attribute needs to be configured for the MIPI DSI controller. If required, you need to add the  **deviceMatchAttr**  information to  **deviceNode**  in the  **device\_info**  file and add the  **mipidsi\_config**  file.
 
     -   **device\_info.hcs**  configuration reference
 
@@ -162,7 +162,7 @@ The following uses  **mipi\_tx\_hi35xx.c**  as an example to present the content
 
     Generally, HDF calls the  **Bind**  function and then the  **Init**  function to load a driver. If  **Init**  fails to be called, HDF calls  **Release**  to release driver resources and exits.
 
-    -   MIPI-DSI driver entry reference
+    -   MIPI DSI driver entry reference
 
         ```
         struct HdfDriverEntry g_mipiTxDriverEntry = {
@@ -177,7 +177,7 @@ The following uses  **mipi\_tx\_hi35xx.c**  as an example to present the content
 3.  Initialize the  **MipiDsiCntlr**  object at the core layer, including initializing the vendor custom structure \(transferring parameters and data\), instantiating  **MipiDsiCntlrMethod**  \(used to call underlying functions of the driver\) in  **MipiDsiCntlr**, and implementing the  **HdfDriverEntry**  member functions \(**Bind**,  **Init**, and  **Release**\).
     -   Custom structure reference
 
-        To the driver, the custom structure carries parameters and data. The values in the  **config**  file are used to initialize the structure members. In this example, the MIPI-DSI has no device attribute file. Therefore, the basic member structure is similar to that of  **MipiDsiCntlr**.
+        To the driver, the custom structure carries parameters and data. The values in the  **config**  file are used to initialize the structure members. In this example, the MIPI DSI has no device attribute file. Therefore, the basic member structure is similar to that of  **MipiDsiCntlr**.
 
         ```
         typedef struct {