7.9.5. 设计说明¶

7.9.5.1. 源码说明¶

源代码位于 bsp/artinchip/：

bsp/artinchip/drv/rtp/drv_rtp.c，RTP Driver 层实现
bsp/artinchip/hal/rtp/hal_rtp.c，RTP HAL 层实现
bsp/artinchip/include/hal/hal_rtp.h，RTP HAL 层接口头文件

7.9.5.2. 模块架构¶

RTP 驱动 Driver 层采用 RT-Thread 的 Touch设备驱动框架，如果只使用HAL层也可以支持 baremetal 方式的应用场景。

图 7.66 RTP驱动的软件架构图¶

7.9.5.3. 关键流程设计¶

7.9.5.3.1. 初始化流程¶

RTP 驱动的初始化接口通过 INIT_DEVICE_EXPORT(drv_rtp_init) 完成，主要是通过调用 Touch子系统的接口 rt_device_touch_register() 注册一个 Touch设备。

RTP 控制器的初始化过程，主要步骤有：

初始化模块的clk
注册中断
初始化默认参数，使能RTP控制器
向设备框架中注册Touch设备

7.9.5.3.2. 中断处理流程¶

RTP控制器采集的数据完全依赖中断来上报给应用层，包括触摸位置、按下、抬起信息。流程如下图：

图 7.67 RTP驱动的中断处理流程¶

7.9.5.4. 数据结构设计¶

7.9.5.4.1. struct aic_rtp_dev¶

属于 HAL 层接口，管理RTP控制器的设备资源。

struct aic_rtp_dev {
    u32 pclk_rate;

    s32 pressure_det;
    s32 ignore_fifo_data;
    enum aic_rtp_mode mode;
    u32 max_press;
    u32 smp_period;
    u32 x_plate;
    u32 y_plate;
    u32 fuzz;

    u32 intr;
    u32 fcr;
    struct aic_rtp_dat latest;
    aicos_sem_t sem;
    struct aic_rtp_ebuf ebuf;
};

7.9.5.4.2. struct aic_rtp_ebuf¶

属于 HAL 层接口，用于缓存给应用层上报的坐标event。

struct aic_rtp_event {
    u16 x;
    u16 y;
    u16 pressure;
    u16 down;
};

struct aic_rtp_ebuf {
    u16 rd_pos;
    u16 wr_pos;
    struct aic_rtp_event event[AIC_RTP_EVT_BUF_SIZE];
};

7.9.5.5. Driver 层接口设计¶

以下接口是 Touch 设备驱动框架的标准接口。

struct rt_touch_ops
{
    rt_size_t (*touch_readpoint)(struct rt_touch_device *touch, void *buf, rt_size_t touch_num);
    rt_err_t (*touch_control)(struct rt_touch_device *touch, int cmd, void *arg);
};

7.9.5.5.1. drv_rtp_read_point¶

函数原型	rt_size_t drv_rtp_read_point(struct rt_touch_device touch, void buf, rt_size_t touch_num)
功能说明	打开RTP设备，驱动会使能RTP控制器
参数定义	touch - 指向Touch设备 buf - 用于保存返回的坐标事件信息，struct rt_touch_data类型 touch_num - 要读取的坐标个数，目前固定为1
返回值	1，成功读取到一个坐标事件； 0，失败
注意事项

7.9.5.5.2. drv_rtp_control¶

函数原型	rt_err_t drv_rtp_control(struct rt_touch_device touch, int cmd, void arg)
功能说明	RTP 驱动的ioctl接口
参数定义	touch - 指向Touch设备 cmd - ioctl 命令码 args - ioctl 命令相应的参数
返回值	0，成功；<0，失败
注意事项	目前仅支持RTP中断的使能和关闭，其他ioctl命令将返回-1

7.9.5.6. HAL 层接口设计¶

HAL 层的函数接口声明存放在 hal_rtp.h 中，主要接口有：

void hal_rtp_status_show(struct aic_rtp_dev *rtp);

void hal_rtp_enable(struct aic_rtp_dev *rtp, int en);
void hal_rtp_int_enable(struct aic_rtp_dev *rtp, int en);
void hal_rtp_auto_mode(struct aic_rtp_dev *rtp);

irqreturn_t hal_rtp_isr(int irq, void *arg);

u32 hal_rtp_ebuf_read_space(struct aic_rtp_ebuf *ebuf);
#define hal_rtp_ebuf_write_space(buf) \
        (AIC_RTP_EVT_BUF_SIZE - hal_rtp_ebuf_read_space(buf))
#define hal_rtp_ebuf_full(buf) (hal_rtp_ebuf_write_space(buf) == 0)
#define hal_rtp_ebuf_empty(buf) (hal_rtp_ebuf_read_space((buf)) == 0)
s32 hal_rtp_ebuf_write(struct aic_rtp_ebuf *ebuf, struct aic_rtp_event *e);
s32 hal_rtp_ebuf_read(struct aic_rtp_ebuf *ebuf, struct aic_rtp_event *e);