OpenHarmony HDF Input驱动模型分析与使用 精华

./drivers/framework/model/input/driver/input_config_parser.c
1.

static int32_t ParseAttr(struct DeviceResourceIface *parser, const struct DeviceResourceNode *attrNode, BoardAttrCfg *attr)
{
int32_t ret;
// 获取inputType字段信息，保存在BoardAttrCfg结构体中
    ret = parser->GetUint8(attrNode, "inputType", &attr->devType, 0);     
    CHECK_PARSER_RET(ret, "GetUint8");
    ...
    return HDF_SUCCESS;
}
1.
2.
3.
4.
5.
6.
7.
8.
9.

./drivers/framework/model/input/driver/hdf_input_device_manager.c
static int32_t HdfInputManagerInit(struct HdfDeviceObject *device)
{ 
/* 分配内存给manager，manager中将存放所有input设备 */
    g_inputManager = InputManagerInstance();
    ...
}
struct HdfDriverEntry g_hdfInputEntry = {
    .moduleVersion = 1,
    .moduleName = "HDF_INPUT_MANAGER",
    .Bind = HdfInputManagerBind,
    .Init = HdfInputManagerInit,
    .Release = HdfInputManagerRelease,
};
HDF_INIT(g_hdfInputEntry);        //驱动注册入口
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

./drivers/framework/model/input/driver/hdf_touch.c
static int32_t HdfTouchDriverProbe(struct HdfDeviceObject *device)
{
   ...
    /* 板级信息结构体内存申请及hcs配置信息解析 */
    boardCfg = BoardConfigInstance(device);
    ...
    /* 公共驱动结构体内存申请 */
    touchDriver = TouchDriverInstance();
    ...
    /* 依据解析出的板级信息进行公共资源初始化，如IIC初始化 */
    ret = TouchDriverInit(touchDriver, boardCfg);
    if (ret == HDF_SUCCESS) {
        ...
       /* 添加驱动至公共驱动层驱动管理链表，当设备与驱动进行绑定时使用该链表进行查询 */
        AddTouchDriver(touchDriver);
        ...
    }
    ...
}
struct HdfDriverEntry g_hdfTouchEntry = {
    .moduleVersion = 1,
    .moduleName = "HDF_TOUCH",
    .Bind = HdfTouchDriverBind,
    .Init = HdfTouchDriverProbe,
    .Release = HdfTouchDriverRelease,
};
                               
HDF_INIT(g_hdfTouchEntry);       //驱动注册入口
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.

./drivers/framework/model/input/driver/hdf_touch.c
int32_t RegisterChipDevice(ChipDevice *chipDev)
{
…
/* 绑定设备与驱动，从而通过InputDeviceInstance函数创建inputDev */
    DeviceBindDriver(chipDev);
…
/* 主要包含器件中断注册及中断处理函数,处理函数中有数据上报用户态的数据通道 */
ChipDriverInit(chipDev);
…
    /* 申请内存实例化InputDev */
inputDev = InputDeviceInstance(chipDev);
    …
    /* 将InputDev设备注册至input驱动管理层 */
RegisterInputDevice(inputDev);
…
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.

./drivers/framework/model/input/driver/hdf_input_device_manager.c
int32_t RegisterInputDevice(InputDevice *inputDev)
{
…
    /* 申请ID，该ID对于不同input设备唯一 */
    ret = AllocDeviceID(inputDev);
…
/* 该函数包含了对hid类设备的特殊处理，对于触摸屏驱动，该函数无实质操作； */
    CreateDeviceNode(inputDev);
    /* 内核态数据传送至用户态需使用IOService能力，需要申请buffer */
    AllocPackageBuffer(inputDev);
    /* 将input设备添加进设备全局管理链表 */
    AddInputDevice(inputDev);
    ···
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

./drivers/adapter/khdf/linux/hcs/device_info/device_info.hcs
1.

input :: host {
hostName = "input_host";
priority = 100;
device_input_manager :: device {       // Input管理层设备描述信息
device0 :: deviceNode {
policy = 2;                      // 向内核用户态均发布服务
priority = 100;                   // input管理层驱动优先级默认为100
preload = 0;                     // 加载该驱动
permission = 0660;               // 驱动创建设备节点权限
moduleName = "HDF_INPUT_MANAGER"; // 与驱动入口moduleName匹配
serviceName = "hdf_input_host";  // HDF框架生成的节点名
deviceMatchAttr = "";         // manager目前不需要私有配置，因此为空
}
}
device_hdf_touch :: device {              // Input公共驱动层设备描述信息
device0 :: deviceNode {
        policy = 2;                     // 向内核用户态均发布服务
        priority = 120;                 // input公共驱动优先级默认为120
        preload = 0;                   // 加载该驱动
        permission = 0660;             // 驱动创建设备节点权限
        moduleName = "HDF_TOUCH";   // 与驱动入口的moduleName匹配
        serviceName = "hdf_input_event1";  // HDF框架生成的节点名
        deviceMatchAttr = "touch_device1";  // 与 “match_attr”字段一致
    }
}
device_touch_chip :: device {              // Input器件驱动层信息
    device0 :: deviceNode {
        policy = 0;                    // 向内核用户态均不发布服务
        priority = 130;                 // input器件驱动优先级默认为130
        preload = 0;                   // 加载该驱动
        permission = 0660;             // 驱动创建设备节点权限
        moduleName = "HDF_TOUCH_GT911";   // 与moduleName匹配
        serviceName = "hdf_touch_gt911_service"; // HDF框架节点名
        deviceMatchAttr = "zsj_gt911_5p5"; // 与“match_attr”字段一致
    }
}
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.

./drivers/adapter/khdf/linux/hcs/input/input_config.hcs
1.

          pinConfig {
              rstGpio = 3;      // 复位管脚连接主机芯片的3号管脚
              intGpio = 4;     // 中断管脚连接主机芯片的4号管脚
              rstRegCfg = [0x112f0094, 0x400];   // 复位管脚配置信息
              intRegCfg = [0x112f0098, 0x400];  // 中断管脚配置信息
          }
          powerConfig {
              /* 0:unused 1:ldo 2:gpio 3:pmic */
              vccType = 2;             // GPIO供电
              vccNum = 20;            // gpio20
              vccValue = 1800;         // 电压幅值为1800mV
              vciType = 1;             // LDO供电
              vciNum = 12;            // ldo12
              vciValue = 3300;         // 电压幅值为3300mV 
          }
featureConfig {
              capacitanceTest = 0;      // 容值测试
              gestureMode = 0;        // 手势模式
              gloverMode = 0;         // 手套模式
              coverMode = 0;          // 皮套模式
              chargerMode = 0;        // 充电模式
              knuckleMode = 0;        // 指关节模式
          }
      }
      chipConfig {                    // 器件私有信息配置
          template touchChip {        // 模板
              match_attr = "";
              chipName = "gt911";    // 触摸屏IC型号
              vendorName = "zsj";    // 供应商
              chipInfo = "AAAA11222";    
 /*1~4字符代表产品名，5~6字符代表IC型号，7~9字符代表模型型号*/
              busType = 0;            // 0代表I2C，1代表SPI
              deviceAddr = 0x5D;      // 器件IC通信地址
/* 1代表上升沿触发，2代表下降沿触发，4代表高电平触发，8代表低电平触发*/
              irqFlag = 2;               
              maxSpeed = 400;        // 最大通信速率为400Hz
              chipVersion = 0;         // 触摸屏IC版本号
powerSequence {
/* 上电时序的配置含义说明： [类型, 状态, 方向 , 延时]
<type> 0代表空，1代表vcc电源1.8V，2代表VCI电源3.3V，
3代表复位管脚，4代表中断管脚
 <status> 0代表下电或拉低，1代表上电或拉高，2代表无操作
<dir> 0代表输入方向，1代表输出方向，2代表无操作
<delay> 代表延时多少毫秒, 例如20代表延时20ms
 */
powerOnSeq = [4, 0, 1, 0,    // 中断管脚配置为输出，且进行拉低
             3, 0, 1, 10,   // 复位管脚配置为输出，且进行拉低，延时10ms
             3, 1, 2, 60,   // 复位管脚无操作，且进行拉高，延时60ms
             4, 2, 0, 0];   // 中断管脚配置为输入
suspendSeq = [3, 0, 2, 10];   // 复位管脚无操作，且进行拉低，延时10ms
resumeSeq = [3, 1, 2, 10];    // 复位管脚无操作，且进行拉高，延时10ms
powerOffSeq = [3, 0, 2, 10,   // 复位管脚无操作，且进行拉低，延时10ms
             1, 0, 2, 20];   // 电源正极管脚无操作，且进行拉低，延时20ms
}
}
chip0 :: touchChip {
/* 与设备描述配置信息中器件私有配置信息的“match_attr”字段保持一致 */
          match_attr = "zsj_gt911_5p5";   
/* 产品名+模组编号+芯片编号的组合信息 用于给用户态区分当前器件 */            
          chipInfo = "ZIDN45100";    
/*  IC型号的版本 */              
          chipVersion = 0;           
                }
            }
        }
    }
}
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.

./drivers/framework/model/input/driver/touchscreen/touch_gt911.c
static struct TouchChipOps g_gt911ChipOps = {     // 器件IC接口
.Init = ChipInit,                         // 初始化
.Detect = ChipDetect,                   // 器件检测
.Resume = ChipResume,                 // 唤醒
.Suspend = ChipSuspend,                // 休眠
.DataHandle = ChipDataHandle,           // 器件数据读取
.UpdateFirmware = UpdateFirmware,      // 固件升级
};
/* 不同触摸屏厂家使用的IC不一样，对应的寄存器操作也不一样，因此器件驱动层代码重点适配差异化接口部分，如下示例代码展示了GT911的数据解析*/
static int32_t ChipDataHandle(ChipDevice *device)
{
...
/*  GT911获取坐标之前需先读取状态寄存器  */
reg[0] = (GT_BUF_STATE_ADDR >> ONE_BYTE_OFFSET) & ONE_BYTE_MASK; 
reg[1] = GT_BUF_STATE_ADDR & ONE_BYTE_MASK;
ret = InputI2cRead(i2cClient, reg, GT_ADDR_LEN, &touchStatus, 1);
if (ret < 0 || touchStatus == GT_EVENT_INVALID) {
return HDF_FAILURE;
}
...
/* 根据状态寄存器的值读取数据寄存器数据 */
reg[0] = (GT_X_LOW_BYTE_BASE >> ONE_BYTE_OFFSET) & ONE_BYTE_MASK;
reg[1] = GT_X_LOW_BYTE_BASE & ONE_BYTE_MASK;
pointNum = touchStatus & GT_FINGER_NUM_MASK;
if (pointNum == 0 || pointNum > MAX_SUPPORT_POINT) {
HDF_LOGE("%s: pointNum is invalid, %u", __func__, pointNum);
 (void)ChipCleanBuffer(i2cClient);
OsalMutexUnlock(&device->driver->mutex);
return HDF_FAILURE;
}
frame->realPointNum = pointNum;
frame->definedEvent = TOUCH_DOWN;
(void)InputI2cRead(i2cClient, reg, GT_ADDR_LEN, buf, GT_POINT_SIZE * pointNum);
/* 对获取的数据进行解析 */
ParsePointData(device, frame, buf, pointNum);
...
}

static void ParsePointData(ChipDevice *device, FrameData *frame, uint8_t *buf, uint8_t pointNum)
{
    ...
/* 每个坐标值由两个字节组成，对获取的单字节数据进行拼接得到最终的坐标值 */
for (i = 0; i < pointNum; i++) {
frame->fingers[i].trackId = buf[GT_POINT_SIZE * i + GT_TRACK_ID];
frame->fingers[i].y = (buf[GT_POINT_SIZE * i + GT_X_LOW] & ONE_BYTE_MASK) | ((buf[GT_POINT_SIZE * i + GT_X_HIGH] & ONE_BYTE_MASK) << ONE_BYTE_OFFSET);
        frame->fingers[i].x = (buf[GT_POINT_SIZE * i + GT_Y_LOW] & ONE_BYTE_MASK) | ((buf[GT_POINT_SIZE * i + GT_Y_HIGH] & ONE_BYTE_MASK) << ONE_BYTE_OFFSET);
/* 对解析出来的坐标值进行打印 */
  HDF_LOGD("%s: x = %d, y = %d", __func__, frame->fingers[i].x,
frame->fingers[i].y);
}
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.

./drivers/framework/model/input/driver/touchscreen/touch_gt911.c
static int32_t HdfGoodixChipInit(struct HdfDeviceObject *device)
{
    ...
/* 器件配置结构体内存申请、配置信息解析及挂载 */
    chipCfg = ChipConfigInstance(device);
    ...
/* 器件实例化 */
    chipDev = ChipDeviceInstance();
    ...
    /* 器件信息挂载及器件私有操作挂载 */
    chipDev->chipCfg = chipCfg;
    chipDev->ops = &g_gt911ChipOps;
    ...
    /* 注册器件驱动至平台驱动 */
    RegisterChipDevice(chipDev);
    ...
}
struct HdfDriverEntry g_touchGoodixChipEntry = {
.moduleVersion = 1,
/* 该moduleName与device_info.hcs文件中器件驱动层的moduleName信息相匹配*/
.moduleName = "HDF_TOUCH_GT911",   
.Init = HdfGoodixChipInit,           // 器件驱动初始化函数
};
HDF_INIT(g_touchGoodixChipEntry);      // 注册器件驱动至HDF框架
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.

./drivers/adapter/khdf/linux/model/input/Makefile
1.

obj-$(CONFIG_DRIVERS_HDF_TP_5P5_GT911) += \
$(INPUT_ROOT_DIR)/touchscreen/touch_gt911.o
1.
2.