。

常见的输入设备有键盘、鼠标、游戏杆、触摸屏等。

本文档将介绍基于

HDF_Input

输入设备是用户与计算机系统进行人机交互的主要装置之一是用户与计算机或者其他设备通信的桥梁。

常见的输入设备有键盘、鼠标、游戏杆、触摸屏等。

本文档将介绍基于

HDF_Input

Foundation驱动管理框架的基础上Input驱动模型通过调用OSAL接口层和Platform接口层提供的基础接口进行开发涉及的接口包括bus通信接口、操作系统原生接口memory、lock、thread、timer等。

由于OSAL接口和Platform接口屏蔽了芯片平台的差异所以基于Input驱动模型实现的Touchscreen驱动可以进行跨平台、跨OS迁移从而实现驱动的一次开发、多端部署。

Touchscreen驱动用于驱动触摸屏使其正常工作该驱动主要完成如下工作对触摸屏驱动IC进行上电、配置硬件管脚并初始化其状态、注册中断、配置通信接口I2C或SPI、设定Input相关配置、下载及更新固件等操作。

1.1.运作机制

内核子系统多内核与驱动子系统统一的驱动框架是松耦合的关系仅通过一个OSALOperating

System

Layer操作系统抽象层进行交互。

OSAL只为驱动框架提供内核部分关键能力的抽象接口而隐藏了接口在不同内核中的实现细节。

驱动框架通过OSAL来适配不同的内核而具体的设备则完全基于驱动框架提供的能力来实现驱动程序并通过HDIHardware

Driver

Interface硬件驱动接口对上层提供驱动服务设备驱动完全不需要知道也不会知道自己运行在什么样的内核之上。

Input驱动模型基于HDF驱动框架、Platform接口、OSAL接口进行开发向上对接规范化的驱动接口HDIHardware

Device

Interface层通过Input-HDI层对外提供硬件能力即上层Input

Service可以通过HDI接口层获取相应的驱动能力进而操控Touchscreen等输入设备。

基于HDF驱动框架的Input驱动模型如下图所示

Input驱动模型核心部分由设备管理层、公共驱动层、器件驱动层组成。

器件产生的数据借助平台数据通道能力从内核传递到用户态驱动模型通过配置文件适配不同器件及硬件平台提高开发者对器件驱动的开发效率。

如下为模型各部分的说明

Input设备管理为各类输入设备驱动提供Input设备的注册、注销接口同时对Input设备列表进行统一管理。

Input平台驱动指各类Input设备的公共抽象驱动例如触摸屏的公共驱动该部分主要负责对板级硬件进行初始化、硬件中断处理、向manager注册Input设备等。

Input器件驱动指各器件厂家的差异化驱动开发者可以通过适配平台驱动预留的差异化接口进行器件驱动开发实现器件驱动开发量最小化。

Input数据通道提供一套通用的数据上报通道各类别的Input设备驱动均可用此通道上报Input事件。

Input配置解析负责对Input设备的板级配置及器件私有配置进行解析及管理。

2.Touchscreen

都会提供中断支持。

当有触屏事件发生时会触发主机中断管脚完成一次中断响应。

中断处理函数中主机通过

I2C

Touchscreen器件的硬件接口相对简单根据PIN脚的属性可以简单分为如下三类

电源接口

Service调用的HDI驱动能力接口按照业务范围可以分为三大模块

Input设备管理模块Input数据上报模块Input业务控制模块

2.3.开发步骤

设备描述配置由开发者参考已有模板进行设备描述配置配置的信息包括驱动加载顺序、板级硬件信息、器件私有数据信息等。

加载Input设备管理驱动由HDF驱动加载Input设备管理驱动完成设备manager的创建并对其初始化。

加载平台驱动平台驱动由HDF框架加载主要完成板级配置解析及硬件初始化并提供器件注册接口。

加载器件驱动器件驱动也由HDF框架加载完成器件设备的实例化包括器件私有配置解析和平台预留的差异化接口适配。

器件设备向平台驱动注册将实例化的器件设备注册到平台驱动实现设备和驱动的绑定并完成中断注册、上下电等器件初始化工作。

Input设备注册在器件初始化完成后实例化Input设备并将其注册到Input

根据Input驱动模型的加载流程可知Touchscreen器件驱动的开发过程主要包含以下三个步骤

设备描述配置目前Input驱动基于HDF驱动框架编写驱动的加载启动由HDF驱动管理框架统一处理。

首先需要在对应的配置文件中将驱动信息注册进去如是否加载、加载优先级此后HDF驱动框架会逐一启动注册过的驱动模块。

板级配置及Touchscreen器件私有配置配置对应的IO管脚功能例如对单板上为Touchscreen设计预留的I2C

实现器件差异化适配接口根据硬件单板设计的通信接口使用Platform接口层提供的管脚操作接口配置对应的复位管脚、中断管脚以及电源操作。

3.HDF

drivers/hdf_core/framework/model/input/driver/touchscreen/vendor/hihope/rk3568/hdf_config/khdf/device_info/device_info.hcsvendor/hihope/rk3568/hdf_config/khdf/input/input_config.hcs

主要代码框架

drivers_hdf_core\adapter\khdf\linux\model\input\Kconfig

config

driver....drivers_hdf_core\adapter\khdf\linux\model\input\Makefile

INPUT_ROOT_DIR

../../../../../framework/model/input/driverobj-$(CONFIG_DRIVERS_HDF_INPUT)

\$(INPUT_ROOT_DIR)/input_bus_ops/input_i2c_ops.o

\$(INPUT_ROOT_DIR)/hdf_input_device_manager.o

\$(INPUT_ROOT_DIR)/input_config_parser.o

\$(INPUT_ROOT_DIR)/hdf_hid_adapter.oobj-$(CONFIG_DRIVERS_HDF_TP_5P5_GT911)

\$(INPUT_ROOT_DIR)/touchscreen/touch_gt911.o

\$(INPUT_ROOT_DIR)/touchscreen/touch_ft5x06.o

obj-$(CONFIG_DRIVERS_HDF_TP_2P35_FT6236)

\$(INPUT_ROOT_DIR)/touchscreen/touch_ft6336.o

obj-$(CONFIG_DRIVERS_HDF_INPUT_INFRARED)

\$(INPUT_ROOT_DIR)/hdf_infrared.o

obj-$(CONFIG_DRIVERS_HDF_TP_5P43_FT5406)

\$(INPUT_ROOT_DIR)/touchscreen/touch_ft5406.o3.2.Input

设备配置

3.2.1.配置设备描述信息vendor/hihope/rk3568/hdf_config/khdf/device_info/device_info.hcs

驱动注册到

框架所需要的设备驱动描述信息如驱动是否加载以及加载次序等。

device_info.hcs

HDF

框架所必需的信息开发者无特殊场景需求无需改动。

各驱动层私有配置信息通过**“deviceMatchAttr”字段与

input_config.hcs

加载优先级在input模块内manager模块优先级应为最高preload

0660;moduleName

manager目前不需要私有配置因此为空}}device_hdf_touch

device

hdf_input_event1;deviceMatchAttr

touch_device1;

“match_attr”字段一致}}//适配gt911_5p5触摸屏驱动描述信息device_touch_chip

device

//驱动按需加载字段,0默认加载1当系统支持快速启动的时候则在系统完成之后再加载这一类驱动

0660;

//驱动名称该字段的值必须和驱动入口结构的moduleName值一致serviceName

hdf_touch_gt911_service;//驱动对外发布服务的名称必须唯一deviceMatchAttr

zsj_gt911_5p5;

//驱动私有数据匹配的关键字必须和驱动私有数据配置表中的match_attr值相等。

}}...}从上面可以看出与触摸相关的主要是3个节点刚好与实现TS驱动模型对应

HDF_INPUT_MANAGERInput设备管理HDF_TOUCH触摸屏的公共抽象驱动HDF_TOUCH_GT911具体的Input器件驱动

“priority”决定驱动加载顺序

”需要与私有配置信息中的“match_attr”字段保持一致。

HDF

3.2.2.板级配置及器件私有配置vendor/hihope/rk3568/hdf_config/khdf/input/input_config.hcs

如果驱动配置有deviceMatchAttr参数需添加一个私有配置文件。

器件私有信息包括上下电时序等平台硬件信息包括器件连接主板的

GPIO

中的信息由驱动代码进行读取解析主要由公共驱动层的私有配置信息及器件驱动层的私有配置信息组成。

文件中的配置包含板级硬件信息及器件私有配置信息实际业务开发时可根据具体需求增删及修改对应内容。

root

interrupt对应pin的寄存器配置}powerConfig

{/*

/*1~4字符代表产品名5~6字符代表IC型号7~9字符代表模型型号*/busType

0x5D;

1代表上升沿触发2代表下降沿触发4代表高电平触发8代表低电平触发*/maxSpeed

400;

与设备描述配置信息中器件私有配置信息的“match_attr”字段保持一致

*/match_attr

}示例中“touchConfig”包含了“touch0”touch0包含了“boardConfig”与“chipConfig”“boardConfig”字段包含了

Hi3516DV300

板级硬件信息“chipConfig”包含了触摸屏器件的私有信息如果需要替换触摸屏器件重新配置“chipConfig”对应的字段信息即可。

同时产品可以配置多款触摸屏示例中用“touch0”代表了套件中默认的触摸屏的硬件接口以及器件的配置信息如产品需要配置副屏可在与“touch0”并列的位置配置“touch1”的信息。

3.2.3.将配置文件添加到板级配置

./vendor/hihope/rk3568/hdf_config/khdf/hdf.hcs

#include

device_info/device_info.hcs3.3.驱动实现

对于touch

drivers_hdf_core\framework\model\input\driver\hdf_touch.c

适配gt911触摸屏需要完成器件层驱动初始化、释放资源、注册驱动至HDF框架及触摸屏器件差异化接口适配。

drivers_hdf_core\framework\model\input\driver\touchscreen\touch_gt911.c

3.3.1.GT911器件驱动

1).注册到HDF框架(注意g_touchGoodixChipEntry没有实现Bind接口)

drivers_hdf_core\framework\model\input\driver\touchscreen\touch_gt911.c:

//驱动注册到HDF框架函数

//驱动名称该字段的值必须和驱动信息配置文件中moduleName的值一致.Init

};HDF_INIT(g_touchGoodixChipEntry);2).器件层驱动初始化

//函数操作集主要包括初始化休眠唤醒数据处理固件更新能力设置等接口

static

ChipConfigInstance(device);//器件实例化

chipDev

ChipDeviceInstance();chipDev-chipCfg

chipCfg;chipDev-ops

chipCfg-chipName;chipDev-vendorName

(void

(RegisterTouchChipDevice(chipDev)

HDF_SUCCESS)

}RegisterTouchChipDevice()函数主要负责

DeviceBindDriver绑定设备与驱动从而通过InputDeviceInstance函数创建inputDev。

ChipDriverInit

主要是上电操作Detect设备UpdateFirmware配置使能中断设置中断处理函数(坐标上报等就在里面)等操作。

RegisterInputDevice将InputDev设备注册至input驱动管理层

hdf_input_device_manager.c。

chipDev-ops-SetAbility调用chipdev的SetAbility接口。

3).器件层驱动数据上报

函数用于触摸屏和外部进行数据通信但是公共驱动层HDF_TOUCH已经用HdfTouchDriverBind函数实现器件不用重新实现可以直接使用。

3.3.2.

drivers_hdf_core\framework\model\input\driver\hdf_touch.c

struct

//驱动对外提供的服务能力将相关的务接口绑定到HDF框架.Init

HdfTouchDriverProbe,

};HDF_INIT(g_hdfTouchEntry);.Bind

HdfTouchDriverBind

通过Bind对外提供IoService接口(Dispatch)主要有以下接口

static

HdfTouchDispatch,};device-service

touchService;return

TouchSetPowerStatus(touchDriver,

data);break;case

TouchGetPowerStatus(touchDriver,

cmd

添加驱动至公共驱动层驱动管理链表当设备与驱动进行绑定时使用该链表进行查询

*/AddTouchDriver(touchDriver);device-priv

(void

*)touchDriver;//对于RK平台这里会注册一个PM的监听器用来处理休眠和唤醒#if

defined(CONFIG_ARCH_ROCKCHIP)HdfTouchDriverRegisterPowerListener(device);

#endifreturn

*g_touchDriverList[MAX_TOUCH_DEVICE];

static

drivers_hdf_core\framework\model\input\driver\hdf_input_device_manager.c

struct

};HDF_INIT(g_hdfInputEntry);RegisterInputDevice

int32_t

RegisterInputDevice(InputDevice

*inputDev)

该函数包含了对hid类设备的特殊处理对于触摸屏驱动该函数无实质操作

*/ret

内核态数据传送至用户态需使用IOService能力需要申请buffer

*/ret

AllocPackageBuffer(inputDev);#ifndef

__LITEOS_M__ret

InitEventWorkQueue(inputDev);if

(ret

*/AddInputDevice(inputDev);return

ret;

内核子系统多内核与驱动子系统统一的驱动框架是松耦合的关系仅通过一个OSALOperating

System

Layer操作系统抽象层进行交互。

OSAL只为驱动框架提供内核部分关键能力的抽象接口而隐藏了接口在不同内核中的实现细节。

驱动框架通过OSAL来适配不同的内核而具体的设备则完全基于驱动框架提供的能力来实现驱动程序并通过HDIHardware

Driver

Interface硬件驱动接口对上层提供驱动服务设备驱动完全不需要知道也不会知道自己运行在什么样的内核之上。

Input模块HDIHardware

Interface接口定义及其实现对上层输入服务提供操作input设备的驱动能力接口HDI接口主要包括如下三大类

InputManager管理输入设备包括输入设备的打开、关闭、设备列表信息获取等

InputReporter负责输入事件的上报包括注册、注销数据上报回调函数等

InputController提供input设备的业务控制接口包括获取器件信息及设备类型、设置电源状态等

4.1.代码框架

drivers/peripheral/下是用于管理各驱动模块的HDI接口定义这些接口定义使用IDL语言描述并以.idl文件形式保存。

drivers_peripheral

input模块的单元测试代码drivers_peripheral仓核心功能是提供Input驱动能力接口供上层输入系统服务调用提供的驱动能力接口统一归属为HDI接口层。

4.2.接口说明

Service可直接调用的驱动能力接口按照属性分类三类input设备管理模块、input数据上报模块、input业务控制模块例如提供输入设备打开及关闭接口、注册设备监听的回调接口、设备信息查询接口、电源状态控制接口等。

提供的部分接口所示

refer

https://zhuanlan.zhihu.com/p/673299244https://ost.51cto.com/posts/8176https://laval.csdn.net/65b796d92c13685765def369.htmlhttps://www.elecfans.com/d/2044123.htmlhttps://gitee.com/openharmony/drivers_peripheral/blob/master/input/README_zh.mdhttps://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/driver/driver-peripherals-touch-des.md