fix: update development guide for touchscreen

Signed-off-by: Nzhusiyuan2 <zhusiyuan2@huawei.com>

zh-cn/device-dev/driver/driver-peripherals-touch-des.md

@@ -7,17 +7,17 @@
 
 Touchscreen驱动用于驱动触摸屏使其正常工作，该驱动主要完成如下工作：对触摸屏驱动IC进行上电、配置硬件管脚并初始化其状态、注册中断、配置通信接口（I2C或SPI）、设定Input相关配置、下载及更新固件等操作。
 
-### 运作机制
+在HDF（Hardware Driver Foundation）[驱动管理框架](../driver/driver-hdf-development.md)的基础上，Input驱动模型通过调用OSAL接口层和Platform接口层提供的基础接口进行开发，涉及的接口包括bus通信接口、操作系统原生接口（memory、lock、thread、timer等）。由于OSAL接口和Platform接口屏蔽了芯片平台的差异，所以基于Input驱动模型实现的Touchscreen驱动可以进行跨平台、跨OS迁移，从而实现驱动的一次开发、多端部署。
 
-本节主要介绍基于Input驱动模型开发的Touchscreen器件驱动，Input模型整体的框架如下图所示。
+### 运作机制
 
-Input驱动模型基于HDF驱动框架、Platform接口、OSAL接口进行开发，向上对接规范化的驱动接口HDI（Hardware Device Interface）层，通过Input-HDI层对外提供硬件能力，即上层Input Service可以通过HDI接口层获取相应的驱动能力，进而操控Touchscreen等输入设备。
+Input模型整体的框架如图1所示。Input驱动模型基于HDF驱动框架、Platform接口、OSAL接口进行开发，向上对接规范化的驱动接口HDI（Hardware Device Interface）层，通过Input-HDI层对外提供硬件能力，即上层Input Service可以通过HDI接口层获取相应的驱动能力，进而操控Touchscreen等输入设备。
 
 **图1** 基于HDF驱动框架的Input驱动模型
 
 ![image](figures/基于HDF驱动框架的input驱动模型.png "基于HDF驱动框架的input驱动模型")
 
-Input驱动模型核心部分由**设备管理层**、**公共驱动层**、**器件驱动层**组成。器件产生的数据借助平台数据通道能力从内核传递到用户态，驱动模型通过配置文件适配不同器件及硬件平台，提高开发者对器件驱动的开发效率。如下为模型各部分的说明：
+Input驱动模型核心部分由设备管理层、公共驱动层、器件驱动层组成。器件产生的数据借助平台数据通道能力从内核传递到用户态，驱动模型通过配置文件适配不同器件及硬件平台，提高开发者对器件驱动的开发效率。如下为模型各部分的说明：
 
 - Input设备管理：为各类输入设备驱动提供Input设备的注册、注销接口，同时对Input设备列表进行统一管理。
 - Input平台驱动：指各类Input设备的公共抽象驱动（例如触摸屏的公共驱动），该部分主要负责对板级硬件进行初始化、硬件中断处理、向manager注册Input设备等。
@@ -25,7 +25,16 @@ Input驱动模型核心部分由**设备管理层**、**公共驱动层**、**
 - Input数据通道：提供一套通用的数据上报通道，各类别的Input设备驱动均可用此通道上报Input事件。
 - Input配置解析：负责对Input设备的板级配置及器件私有配置进行解析及管理。
 
-**器件硬件接口**
+
+## 开发指导
+
+### 场景介绍
+
+Input模块主要完成如下工作：对触摸屏驱动IC进行上电、配置硬件管脚并初始化其状态、注册中断、配置通信接口（I2C或SPI）、设定Input相关配置、下载及更新固件等操作。
+
+### 接口说明
+
+### 硬件接口
 
 Touchscreen器件的硬件接口相对简单，根据PIN脚的属性，可以简单分为如下三类：
 
@@ -55,26 +64,12 @@ Touchscreen器件的硬件接口相对简单，根据PIN脚的属性，可以简
 
 3. **通信接口**
 
-   - I2C：由于Touchscreen的报点数据量相对较少，所以一般选用I2C方式传输数据。I2C的具体协议及对应操作接口，可以参考Platform接口层中的[“I2C”使用指南](../driver/driver-platform-i2c-des.md#概述)。
-   - SPI：在需要传递的数据不止包含报点坐标，还包含基础容值的情况下，由于需要传递的数据量较大，所以部分厂商会选用SPI通信方式。SPI的具体协议及对应操作接口，可以参考Platform接口层中的[“SPI” 使用指南](../driver/driver-platform-spi-des.md#概述)。
-
+   - I2C：由于Touchscreen的报点数据量相对较少，所以一般选用I2C方式传输数据。I2C的具体协议及对应操作接口，可以参考Platform接口层中的[I2C使用指南](../driver/driver-platform-i2c-des.md#概述)。
+   - SPI：在需要传递的数据不止包含报点坐标，还包含基础容值的情况下，由于需要传递的数据量较大，所以部分厂商会选用SPI通信方式。SPI的具体协议及对应操作接口，可以参考Platform接口层中的[SPI使用指南](../driver/driver-platform-spi-des.md#概述)。
 
-**基于HDF驱动框架开发器件驱动的优势**
+### 软件接口
 
-在HDF（Hardware Driver Foundation）[驱动管理框架](../driver/driver-hdf-development.md)的基础上，Input驱动模型通过调用OSAL接口层和Platform接口层提供的基础接口进行开发，涉及的接口包括bus通信接口、操作系统原生接口（memory、lock、thread、timer等）。由于OSAL接口和Platform接口屏蔽了芯片平台的差异，所以基于Input驱动模型实现的Touchscreen驱动可以进行跨平台、跨OS迁移，从而实现驱动的一次开发、多端部署。
-
-
-## 开发指导
-
-### 场景介绍
-
-Input模块主要完成如下工作：对触摸屏驱动IC进行上电、配置硬件管脚并初始化其状态、注册中断、配置通信接口（I2C或SPI）、设定Input相关配置、下载及更新固件等操作。
-
-### 接口说明
-
-Input HDF驱动提供给系统服务Input Service调用的HDI驱动能力接口，按照业务范围可以分为三大模块：**input设备管理模块**、**input数据上报模块**、**input业务控制模块**，具体的接口如[表1 Input HDI接口列表](#table1513255710559)所示，包括：输入设备打开及关闭接口、注册设备监听的回调接口、设备信息查询接口、电源状态控制接口等。
-
-**表 1**  Input HDI接口列表
+Input HDF驱动提供给系统服务Input Service调用的HDI驱动能力接口，按照业务范围可以分为三大模块：Input设备管理模块、Input数据上报模块、Input业务控制模块，具体的接口如下表所示，包括：输入设备打开及关闭接口、注册设备监听的回调接口、设备信息查询接口、电源状态控制接口等。
 
 - input_manager.h
 
@@ -111,9 +106,7 @@ Input HDF驱动提供给系统服务Input Service调用的HDI驱动能力接口
 
 ### 开发步骤
 
-基于HDF框架、Platform接口和OSAL接口开发的Input驱动模型，可以做到不区分操作系统和芯片平台，并为Touchscreen等输入器件提供统一的驱动开发架构。
-
-下面以Touchscreen器件驱动为例，说明Input驱动模型的完整加载流程：
+以Touchscreen器件驱动为例，Input驱动模型的完整加载流程可以分为六步：
 
 （1）设备描述配置：由开发者参考已有模板进行设备描述配置，配置的信息包括驱动加载顺序、板级硬件信息、器件私有数据信息等。
 
@@ -127,7 +120,8 @@ Input HDF驱动提供给系统服务Input Service调用的HDI驱动能力接口
 
 （6）Input设备注册：在器件初始化完成后，实例化Input设备，并将其注册到Input manager进行管理。
 
-请参考如下相关步骤：
+
+根据Input驱动模型的加载流程可知，Touchscreen器件驱动的开发过程主要包含以下三个步骤：
 
 1. 设备描述配置
    目前Input驱动基于HDF驱动框架编写，驱动的加载启动由HDF驱动管理框架统一处理。首先需要在对应的配置文件中，将驱动信息注册进去，如是否加载、加载优先级，此后HDF驱动框架会逐一启动注册过的驱动模块。驱动的相关配置请参考[HDF驱动框架配置指导](../driver/driver-hdf-development.md#驱动开发步骤)。
@@ -141,10 +135,10 @@ Input HDF驱动提供给系统服务Input Service调用的HDI驱动能力接口
 
 ## 开发实例
 
-本实例提供Touchscreen驱动开发示例，并简要对具体关键点进行开发说明。
+下面以rk3568开发板的Input模块为例，说明Touchscreen器件的适配和接口使用方法。
 
 
-### 设备描述配置
+1. 设备描述配置
 
 如下配置主要包含Input驱动模型各模块层级信息，具体原理可参考[HDF驱动开发指南](../driver/driver-hdf-development.md)，HDF框架依据该配置信息实现对Input模型各模块的依次加载等。
 
@@ -191,7 +185,7 @@ input :: host {
 ```
 
 
-### 板级配置及器件私有配置
+2. 板级配置及器件私有配置
 
 如下配置包含板级硬件配置及器件私有数据配置，实际业务开发时，可根据具体需求增删及修改如下配置文件信息。
 
@@ -282,7 +276,7 @@ root {
 ```
 
 
-### 添加器件驱动
+3. 添加器件驱动
 
 在器件驱动中，主要实现了平台预留的差异化接口，以器件数据获取及解析进行示例说明。具体开发过程，需要根据实际使用的单板及器件进行适配。
 
@@ -440,3 +434,82 @@ struct HdfDriverEntry g_touchSampleChipEntry = {
 
 HDF_INIT(g_touchSampleChipEntry);
 ```
+
+4. Input HDI接口的使用
+
+下面通过示例代码说明上层输入系统服务调用Input HDI的步骤。
+
+```c
+#include "input_manager.h"
+#define DEV_INDEX 1
+
+IInputInterface *g_inputInterface;
+InputReportEventCb g_callback;
+
+/* 定义数据上报的回调函数 */
+static void ReportEventPkgCallback(const EventPackage **pkgs, uint32_t count)
+{
+    if (pkgs == NULL || count > MAX_PKG_NUM) {
+        return;
+    }
+    for (uint32_t i = 0; i < count; i++) {
+        HDF_LOGI("%s: pkgs[%d] = 0x%x, 0x%x, %d", __func__, i, pkgs[i]->type, pkgs[i]->code, pkgs[i]->value);
+    }
+}
+
+int InputServiceSample(void)
+{
+    uint32_t devType = INIT_DEFAULT_VALUE;
+
+    /* 获取Input驱动能力接口 */
+    int ret = GetInputInterface(&g_inputInterface);
+    if (ret != INPUT_SUCCESS) {
+        HDF_LOGE("%s: get input interfaces failed, ret = %d", __func__, ret);
+        return ret;
+    }
+
+    INPUT_CHECK_NULL_POINTER(g_inputInterface, INPUT_NULL_PTR);
+    INPUT_CHECK_NULL_POINTER(g_inputInterface->iInputManager, INPUT_NULL_PTR);
+    /* 打开特定的input设备 */
+    ret = g_inputInterface->iInputManager->OpenInputDevice(DEV_INDEX);
+    if (ret) {
+        HDF_LOGE("%s: open input device failed, ret = %d", __func__, ret);
+ 	    return ret;
+    }
+
+    INPUT_CHECK_NULL_POINTER(g_inputInterface->iInputController, INPUT_NULL_PTR);
+    /* 获取对应input设备的类型 */
+    ret = g_inputInterface->iInputController->GetDeviceType(DEV_INDEX, &devType);
+    if (ret) {
+        HDF_LOGE("%s: get device type failed, ret: %d", __FUNCTION__, ret);
+        return ret;
+    }
+    HDF_LOGI("%s: device1's type is %u\n", __FUNCTION__, devType);
+
+    /* 给特定的input设备注册数据上报回调函数 */
+    g_callback.ReportEventPkgCallback = ReportEventPkgCallback;
+    INPUT_CHECK_NULL_POINTER(g_inputInterface->iInputReporter, INPUT_NULL_PTR);
+    ret  = g_inputInterface->iInputReporter->RegisterReportCallback(DEV_INDEX, &g_callback);
+    if (ret) {
+        HDF_LOGE("%s: register callback failed, ret: %d", __FUNCTION__, ret);
+	    return ret;
+    }
+    HDF_LOGI("%s: wait 10s for testing, pls touch the panel now", __FUNCTION__);
+    OsalMSleep(KEEP_ALIVE_TIME_MS);
+
+    /* 注销特定input设备上的回调函数 */
+    ret = g_inputInterface->iInputReporter->UnregisterReportCallback(DEV_INDEX);
+    if (ret) {
+        HDF_LOGE("%s: unregister callback failed, ret: %d", __FUNCTION__, ret);
+        return ret;
+    }
+
+    /* 关闭特定的input设备 */
+    ret = g_inputInterface->iInputManager->CloseInputDevice(DEV_INDEX);
+    if (ret) {
+        HDF_LOGE("%s: close device failed, ret: %d", __FUNCTION__, ret);
+	    return ret;
+    }
+    return 0;
+}
+```