RK3588 android12 适配 ilitek i2c接口TP

news2025/5/18 18:12:44

一，Ilitek 触摸屏简介

Ilitek 提供多种型号的触控屏控制器，如 ILI6480、ILI9341 等，采用 I2C 接口。
这些控制器能够支持多点触控，并具有优秀的灵敏度和响应速度。

Ilitek 的触摸屏控制器监测屏幕上的触摸事件。
当触摸发生时，控制器将触摸坐标（通常是 x 和 y 坐标）通过 I2C 总线发送给主机。

二，驱动移植

1. 设备树配置

查看原理图TP是挂在i2c5节点下：

&i2c5 {
        ilitek: ilitek@41 {
                compatible = "tchip,ilitek";
                reg = <0x41>;          //I2C设备地址
                pinctrl-names = "default";
                pinctrl-0 = <&ilitek_touch_gpio>;
                ilitek,irq-gpio = <&gpio3 RK_PC0 IRQ_TYPE_LEVEL_LOW>;   //使能引脚
                ilitek,reset-gpio = <&gpio3 RK_PC1 GPIO_ACTIVE_HIGH>;   //中断引脚
                status = "okay";
        };
};

&pinctrl {
        ilitek-touch {
                ilitek_touch_gpio: ilitek-touch-gpio {
                        rockchip,pins =
                                <3 RK_PC1 RK_FUNC_GPIO &pcfg_pull_down>,
                                <3 RK_PC0 RK_FUNC_GPIO &pcfg_pull_up>;
                };
        };
};

注：一定要对应的I2C bus节点（硬件原理图上会有标注）。

2. 驱动文件配置

a. 拷贝驱动文件

各个文件说明如下：

ilitek_ts.h：驱动头文件，包含驱动中要用到的一些头文件以及宏和函数的声明等。
ilitek_platform_init.c：平台加载初始化需要的文件。
ilitek_main.c：驱动主文件，完成probe的具体实现，GPIO注册、读取TP信息、注册输入设备信息，报点，休眠唤醒处理等。
ilitek_update.c：驱动升级IC固件功能的具体实现。
ilitek_tool.c：用于支持TouchUtility apk 以及创建用命令升级固件、sensor test、查看固件版本的设备节点，以及一些调试命令的使用等等。
ilitek_protocol.c：共用的函数与ilitek protocol等。
ilitek_mp.c：用于sensor test功能。

驱动下载链接：https://download.csdn.net/download/weixin_45639314/90592022

将以上驱动文件( ilitek)拷贝到如下目录：

kernel-5.10/drivers/input/touchscreen/

b. 修改Makefile以及Kconfig

kernel-5.10/drivers/input/touchscreen/Makefile中添加：
obj-$(CONFIG_TOUCHSCREEN_ILITEK)     += ilitek/

-------------------------------------------------------
kernel-5.10/drivers/input/touchscreen/Kconfig中添加：
config TOUCHSCREEN_ILITEK
       tristate "ILITEK touchscreens matched with screen support for rockchip platform"
       depends on I2C && ARCH_ROCKCHIP
       help
         Say Y here if you have a touchscreen interface using the ILITEK
         touchscreen chip on Rockchip platform, and your board-specific
         initialization code includes that in its table of IIC devices.
         If unsure, say N.

c. 内核中加载驱动

kernel-5.10/arch/arm64/configs/rockchip_defconfig中添加：
CONFIG_TOUCHSCREEN_ILITEK=y

添加结束后单编内核即可。

三，部分驱动代码解析

int ilitek_power_on(bool status)
当定义了 ILITEK_ENABLE_REGULATOR_POWER_ON 宏时才有具体实现，对应的 ilitek_data->vdd 或 ilitek_data->vdd_i2c 需在平台初始化代码中实现。若采用其他供电方式，需根据具体方式修改。

int ilitek_get_gpio_num(void)
用于获取 reset 和 irq GPIO 编号。若无需动态获取，需直接定义ILITEK_RESET_GPIO和 ILITEK_IRQ_GPIO 为固定值。

int ilitek_request_gpio(void)
申请 GPIO 资源。若申请失败，会先释放再重试一次。成功后会将 reset 设置为输出高电平，irq 设置为输入模式。GPIO 操作需以具体平台接口为准。

复位函数（reset）
参数 delay 表示从拉低到拉高后的延时时间，需大于 IC 的初始化时间。

void ilitek_reset(int delay) {
    tp_log_info("delay = %d\n", delay);
    if (ilitek_data->reset_gpio > 0) {
        #if ILITEK_PLAT != ILITEK_PLAT_MTK
            gpio_direction_output(ilitek_data->reset_gpio, 1);
            mdelay(10);
            gpio_direction_output(ilitek_data->reset_gpio, 0);
            mdelay(10);
            gpio_direction_output(ilitek_data->reset_gpio, 1);
            mdelay(delay);
        #else
            tpd_gpio_output(ilitek_data->reset_gpio, 1);
            mdelay(10);
            tpd_gpio_output(ilitek_data->reset_gpio, 0);
            mdelay(10);
            tpd_gpio_output(ilitek_data->reset_gpio, 1);
            mdelay(delay);
        #endif
    } else {
        tp_log_err("reset pin is invalid\n");
    }
    return;
}

int ilitek_read_tp_info(void)

检测到 IC 型号为 ILI2511 时，会将 ilitek_repeat_start 置为 false。
对于大尺寸 IC，若通过 0xC0 命令读到数据 0x55（即 Bootloader 模式），会强制设置升级标志 ilitek_data->force_update
按键信息数组 keyinfo 默认大小为 10，若按键数超过 10，需在struct ilitek_ts_data中修改 keyinfo 的容量。

static int ilitek_request_irq(void)

#if ILITEK_PLAT != ILITEK_PLAT_MTK
    ilitek_data->client->irq = gpio_to_irq(ilitek_data->irq_gpio);
#else
    node = of_find_matching_node(NULL, touch_of_match);
    if (node) {
        ilitek_data->client->irq = irq_of_parse_and_map(node, 0);
    }
#endif