|
EDA365欢迎您登录!
您需要 登录 才可以下载或查看,没有帐号?注册
x
如今触摸屏的使用越来越广泛,从手机、平板到蜂巢取货等场合,都是用了触摸屏,触摸屏的使用非常便捷高效。在本章就来学习一下如何在 Linux 下编写电容触摸屏驱动。
# F/ N( a! S% b+ O. s! k54.1 Linux 下电容触摸屏驱动框架1 }5 m. Z& i7 a( u. r' X
54.1.1 多点触摸协议详解
# h" N" t8 R- s4 l4 T: G在前面的裸板实验中,已经详细讲解过了电容触摸驱动的基本原理,根据前面的实验可以总结出电容触摸屏驱动其实就是一下几种 linux 驱动框架的组合:
, P) L; _- ^$ ]7 \; V5 s① IIC 设备驱动,因为电容触摸 IC 基本都是 IIC 接口的,因此大框架就是 IIC 设备驱动。
4 d5 r; A8 q, ^; J- K O② 通过中断引脚(INT)向 linux 内核上报触摸信息,因此需要用到 linux 中断驱动框架。坐标的上报在中断服务函数中完成。
" B# u4 Z4 F( D* w) Y; [③ 触摸屏的坐标信息、屏幕按下和抬起信息都属于 linux 的 input 子系统,因此向 linux 内核上报触摸屏坐标信息就得使用 input 子系统。只是,我们得按照 linux 内核规定的规则来上报坐标信息。, w. r, K6 v7 O/ G5 d ^, f
在上面的驱动框架组合中我们发现 I2C 驱动、中断驱动、input 子系统都已经学习了解过了,还没有学习过 input 子系统下的多点电容触摸协议,这个就是本章学习的重点,linux 内核中有一份文档详细的讲解了多点电容触摸屏协议,文档路径为:Documentation/input/multitouch-protocol.txt。, c5 p9 Y4 h, k: k. {
MT 协议被分为两种类型,TypeA 和 TypeB,这两种类型的区别如下:6 b4 ^2 ~ k/ T' t7 [
TypeA:适用于触摸点不能被区分或者追踪,此类型的设备上报原始数据(此类型在实际使用中非常少!)。; C ?9 I6 K: l4 D8 q' u, L
Type B:适用于有硬件追踪并能区分触摸点的触摸设备,此类型设备通过 slot 更新某一个触摸点的信息,FT5426 就属于此类型,一般的多点电容触摸屏 IC 都有此能力。
+ w) [( F8 |) n" n6 R' H' e触摸点的信息通过一系列的 ABS_MT 事件(有的资料也叫消息)上报给 linux 内核,只有 ABS_MT 事件是用于多点触摸的,ABS_MT 事件定义在文件 linux/input.h 中,相关事件如下所示:& g6 J( [/ g B) z6 l
852 #define ABS_MT_SLOT 0x2f /* MT slot being modified */
# S: Y* g' j/ R853 #define ABS_MT_TOUCH_MAJOR 0x30 /* Major axis of touching ellipse */
: {9 v% Z$ c* P# w/ z! M; v854 #define ABS_MT_TOUCH_MINOR 0x31 /* Minor axis (omit if circular) */% v2 G4 J( }, j4 s. I; {) C
855 #define ABS_MT_WIDTH_MAJOR 0x32 /* Major axis of approaching ellipse */
- w' R0 a! I! N+ i856 #define ABS_MT_WIDTH_MINOR 0x33 /* Minor axis (omit if circular) */: r: w3 Z1 X2 M; A0 e. O+ v
857 #define ABS_MT_ORIENTATION 0x34 /* Ellipse orientation */2 u( r7 f) [0 W3 b: l" q
858 #define ABS_MT_POSITION_X 0x35 /* Center X touch position */
! @* [+ k. m! d* h: n859 #define ABS_MT_POSITION_Y 0x36 /* Center Y touch position */
. Q, b1 f* @2 K+ ?9 c860 #define ABS_MT_TOOL_TYPE 0x37 /* Type of touching device */
; E1 m# x8 W( ~& O861 #define ABS_MT_BLOB_ID 0x38 /* Group a set of packets as a blob */
2 g6 n% p( n4 ~# g3 y& e" C862 #define ABS_MT_TRACKING_ID 0x39 /* Unique ID of initiated contact */
% R. T8 s( ]& q1 a863 #define ABS_MT_PRESSURE 0x3a /* Pressure on contact area */8 X; c( h2 C$ v
864 #define ABS_MT_DISTANCE 0x3b /* Contact hover distance */0 ]6 ^ H5 c* {) S$ Y3 S
865 #define ABS_MT_TOOL_X 0x3c /* Center X tool position */# ^& ?% N* t* Z: k
866 #define ABS_MT_TOOL_Y 0x3d /* Center Y tool position */& J7 j9 R; x" x4 W+ X
在上面这些众多的 ABS_MT 事件中,我们最常用的就是 ABS_MT_SLOT 、 ABS_MT_POSITION_X 、ABS_MT_POSITION_Y 和 ABS_MT_TRACKING_ID 。其中 ABS_MT_POSITION_X 和 ABS_MT_POSITION_Y 用来上报触摸点的 (X,Y) 坐标信息,ABS_MT_SLOT 用来上报触摸点 ID ,对于 Type B 类型的设备,需要用到ABS_MT_TRACKING_ID 事件来区分触摸点。
! r5 e+ d: |( f/ q, I$ r: S0 B/ u& Z对于 TypeA 类型的设备,通过 input_mt_sync()函数来隔离不同的触摸点数据信息,此函数原型如下所示:( d q$ _/ b0 I) B
void input_mt_sync(struct input_dev *dev)/ r% E7 i: c1 Z
此函数只要一个参数,类型为 input_dev,用于指定具体的 input_dev 设备。input_mt_sync()函数会触发 SYN_MT_REPORT 事件,此事件会通知接收者获取当前触摸数据,并且准备接收下一个触摸点数据。
8 ?7 s( A" P2 M" X; M# \. @: k# K# W对于 Type B 类型的设备,上报触摸点信息的时候需要通过 input_mt_slot()函数区分是哪一个触摸点,input_mt_slot()函数原型如下所示:
$ T& Y3 D" h1 `2 ?8 Kvoid input_mt_slot(struct input_dev *dev, int slot)
5 g8 {/ N- n! r* d此函数有两个参数,第一个参数是 input_dev 设备,第二个参数 slot 用于指定当前上报的是哪个触摸点信息。input_mt_slot()函数会触发 ABS_MT_SLOT 事件,此事件会告诉接收者当前正在更新的是哪个触摸点(slot)的数据。
2 M; W5 V+ G2 O不管是哪个类型的设备,最终都要调用 input_sync()函数来标识多点触摸信息传输完成,告诉接收者处理之前累计的所有消息,并且准备好下一次接收。Type B 和 Type A 相比最大的区别就是 Type B 可以区分出触摸点, 因此可以减少发送到用户空间的数据。Type B 使用 slot 协议区分具体的触摸点,slot 需要用
, v3 N8 G2 e3 f; p: o, [+ B' U到 ABS_MT_TRACKING_ID 消息,这个 ID 需要硬件提供,或者通过原始数据计算出来。对于 TypeA 设备,内核驱动需要一次性将触摸屏上所有的触摸点信息全部上报,每个触摸点的信息在本次上报事件流中的顺序不重要,因为事件的过滤和手指(触摸点)跟踪是在内核空间处理的。
- o$ `' j) _1 y$ S/ X1 y7 w- vType B 设备驱动需要给每个识别出来的触摸点分配一个 slot,后面使用这个 slot 来上报触摸点信息。可以通过 slot 的 ABS_MT_TRACKING_ID 来新增、替换或删除触摸点。一个非负数的 ID 表示一个有效的触摸点,-1 这个 ID 表示未使用 slot。一个以前不存在的 ID 表示这是一个新加的触摸点,一个 ID 如果再也不存在了就表示删除了。
; l& B3 S: ?- `; z7 D/ d有些设备识别或追踪的触摸点信息要比他上报的多,这些设备驱动应该给硬件上报的每个触摸点分配一个 Type B 的 slot。一旦检测到某一个 slot 关联的触摸点 ID 发生了变化,驱动就应该改变这个 slot 的ABS_MT_TRACKING_ID,使这个 slot 失效。如果硬件设备追踪到了比他正在上报的还要多的触摸点,那么驱动程序应该发送 BTN_TOOL_*TAP 消息,并且调用 input_mt_report_pointer_emulation()函数,将此函数的第二个参数 use_count 设置为 false。1 C- E: l: {8 y! X5 g' n: A
54.1.2 Type A 触摸点信息上报时序. R8 }% _$ z2 v% S' g
对于 Type A 类型的设备,发送触摸点信息的时序如下所示,这里以 2 个触摸点为例:8 E+ P- M8 C: B) a9 C9 e: b. J
1 ABS_MT_POSITION_X x[0]
( C& s0 p+ F3 U2 ABS_MT_POSITION_Y y[0]/ q( A- n9 p8 @& @6 }
3 SYN_MT_REPORT
/ w9 Z! c- Q+ D2 F0 B2 c4 d4 ABS_MT_POSITION_X x[1]
: S( T$ `+ V4 u& c# V5 ABS_MT_POSITION_Y y[1]
1 J1 e v$ c" n* \: ~6 SYN_MT_REPORT
0 _" v4 s2 s/ A& N* H! r7 SYN_REPORT c; a" `. m$ I; Z; n
第 1 行,通过 ABS_MT_POSITION_X 事件上报第一个触摸点的 X 坐标数据,通过 input_report_abs 函数实现,下面同理。
8 M& B' a* a, v第 2 行,通过 ABS_MT_POSITION_Y 事件上报第一个触摸点的 Y 坐标数据。 X' G( m5 r5 [8 n# D) F
第 3 行,上报 SYN_MT_REPORT 事件,通过调用 input_mt_sync 函数来实现。( u) R: p5 p& }/ y/ b* N; S# J
第 4 行,通过 ABS_MT_POSITION_X 事件上报第二个触摸点的 X 坐标数据。 H/ H2 T7 G* x
第 5 行,通过 ABS_MT_POSITION_Y 事件上报第二个触摸点的 Y 坐标数据。
7 z) n; I; W$ w( u第 6 行,上报 SYN_MT_REPORT 事件,通过调用 input_mt_sync 函数来实现。$ f/ k9 t4 x+ w# u
第 7 行,上报 SYN_REPORT 事件,通过调用 input_sync 函数实现。
! K( A4 n2 J- A& a" K( w9 o$ z3 Z, j我们在编写 TypeA 类型的多点触摸驱动的时候就需要按照上述代码中的时序上报坐标信息。Linux 内核 里 面 也 有 Type A 类 型 的 多 点 触 摸 驱 动 , 找 到 st2332.c 这 个 驱 动 文 件 , 路 径 为drivers/input/touchscreen/st1232.c,找到 st1232_ts_irq_handler 函数,此函数里面就是上报触摸点坐标信息的。
( q: F& P) f q) j103 static irqreturn_t st1232_ts_irq_handler(int irq, void *dev_id)" V2 {# {' ?, K4 }. Q
104 {, N7 R4 t% }8 T. x
......$ ^8 x0 E% T: h, r- n6 }. D: I
111 ret = st1232_ts_read_data(ts);" q( d& a. B( h+ Y/ n
112 if (ret < 0)( `. m7 g( K) X# P" }4 @4 f
113 goto end;
9 R9 u# u$ b2 [. y- E/ N1143 r$ H. G" N- s8 i% C3 Z1 l- w
115 /* multi touch protocol */: `5 T" t7 ]: P8 l. X
116 for (i = 0; i < MAX_FINGERS; i++) {
" m5 ]! W6 M# N& c/ m117 if (!finger.is_valid)! [, Y2 j# e# U2 k# Z6 v( J3 G
118 continue;% f6 g# D5 L2 w- S; L. C
119
6 `. m- g5 v" A# N% z% {120 input_report_abs(input_dev, ABS_MT_TOUCH_MAJOR, finger.t);9 S! X, V- J" O+ f& }
121 input_report_abs(input_dev, ABS_MT_POSITION_X, finger.x);; P# I2 W1 V: ]) X: [
122 input_report_abs(input_dev, ABS_MT_POSITION_Y, finger.y);; I" H& B i: C. J7 v
123 input_mt_sync(input_dev);. z% g' m) ]0 x, c
124 count++;: h9 w( _8 o l# d4 j( Q
125 }+ d; O3 J1 N* l% l
......# M* H2 L# F! R/ Z- [6 I
140) B! Y/ K2 x& J+ l# Z0 K/ O. y9 M+ x
141 /* SYN_REPORT */8 m! d7 @ O8 q8 E' f% O( b
142 input_sync(input_dev);9 k. c$ \( d5 @
143* a/ c+ D3 [) g' G0 i$ R5 m& ^6 y
144 end:
9 d/ W3 h- O. B+ @5 w7 J$ V145 return IRQ_HANDLED;" c( C7 }6 H+ ?- L3 [
146 }1 @1 ~$ Z8 |- o6 m" l
第 111 行,获取所有触摸点信息。, f8 m% [- w- Y* O$ B" m
第 116~125 行,按照 Type A 类型轮流上报所有的触摸点坐标信息,第 121 和 122 行分别上报触摸点的(X,Y)轴坐标,也就是 ABS_MT_POSITION_X 和 ABS_MT_POSITION_Y 事件。每上报完一个触摸点坐标,都要在第 123 行调用 input_mt_sync 函数上报一个 SYN_MT_REPORT 信息。; p6 f/ h/ u+ X- B7 E7 g
第 142 行,每上报完一轮触摸点信息就调用一次 input_sync 函数,也就是发送一个 SYN_REPORT 事件" E" |7 t% e F) d! J
3 d" f' D1 w/ E1 N: o/ ^$ s! w+ [
54.1.3 Type B 触摸点信息上报时序
6 R" F- n) l. J8 x对于 Type B 类型的设备,发送触摸点信息的时序如下所示,这里以 2 个触摸点为例:8 h7 v7 q/ v+ k) j
1 ABS_MT_SLOT 0, B2 q0 {! Y8 |* ^) W1 b/ P
2 ABS_MT_TRACKING_ID 45! k, }9 P) T% ?6 b2 b( m; Q
3 ABS_MT_POSITION_X x[0]' K6 E3 j& {4 a0 m! ?5 A
4 ABS_MT_POSITION_Y y[0]
G) a' o1 D* }$ G5 ABS_MT_SLOT 1' O G. g6 Q) x5 J, \: S
6 ABS_MT_TRACKING_ID 46$ t9 a' E* _% ]1 E2 i9 {5 }8 X+ |! d
7 ABS_MT_POSITION_X x[1]) j: A+ o1 J6 E4 r/ p8 S
8 ABS_MT_POSITION_Y y[1]
" W4 X# A. c6 T2 G9 SYN_REPORT3 J+ B3 C+ P' D. I
第 1 行,上报 ABS_MT_SLOT 事件,也就是触摸点对应的 SLOT。每次上报一个触摸点坐标之前要先使用 input_mt_slot 函数上报当前触摸点 SLOT,触摸点的 SLOT 其实就是触摸点 ID,需要由触摸 IC 提供。5 ~* Y9 i/ V# G$ k3 R
第 2 行,根据 Type B 的要求,每个 SLOT 必须关联一个 ABS_MT_TRACKING_ID,通过修改 SLOT 关联 的 ABS_MT_TRACKING_ID 来 完 成 对 触 摸 点 的 添 加 、 替 换 或 删 除 。 具 体 用 到 的 函 数 就 是input_mt_report_slot_state,如果是添加一个新的触摸点,那么此函数的第三个参数 active 要设置为 true,linux 内核会自动分配一个 ABS_MT_TRACKING_ID 值,不需要用户去指定具体的 ABS_MT_TRACKING_ID 值。' `7 J. s% Y* Y0 C
第 3 行,上报触摸点 0 的 X 轴坐标,使用函数 input_report_abs 来完成。+ R" |. [$ o$ X ~+ M3 C4 l2 |
第 4 行,上报触摸点 0 的 Y 轴坐标,使用函数 input_report_abs 来完成。7 O3 n* h; X5 G- C% W& Z6 R# A% S
第 5~8 行,和第 1~4 行类似,只是换成了上报触摸点 0 的(X,Y)坐标信息1 o" o/ V% ?9 f+ Z8 L5 H$ x, W
第 9 行,当所有的触摸点坐标都上传完毕以后就得发送 SYN_REPORT 事件,使用 input_sync 函数来完成。( G: G! d ]4 U) }0 C3 p0 U) g
当一个触摸点移除以后,同样需要通过 SLOT 关联的 ABS_MT_TRACKING_ID 来处理,时序如下所示:9 y2 z( r# c2 b2 A( f
1 ABS_MT_TRACKING_ID -1& ]8 q, U) n0 W
2 SYN_REPORT9 T0 w5 S9 }% Y) J- f" n) U3 r: i
第 1 行,当一个触摸点(SLOT)移除以后,需要通过 ABS_MT_TRACKING_ID 事件发送一个-1 给内核。方法很简单,同样使用 input_mt_report_slot_state 函数来完成,只需要将此函数的第三个参数 active 设置为false 即可,不需要用户手动去设置-1。 v* c, x1 N7 X" |) K( G" x& Y
第 2 行,当所有的触摸点坐标都上传完毕以后就得发送 SYN_REPORT 事件。
3 N7 j/ d' B3 v, o当要编写 Type B 类型的多点触摸驱动的时候就需要按照上述代码中的时序上报坐标信息。Linux 内核里面有大量的 Type B 类型的多点触摸驱动程序,我们可以参考这些现成的驱动程序来编写自己的驱动代码。这里就以 ili210x 这个触摸驱动 IC 为例,看看是 Type B 类型是如何上报触摸点坐标信息的。找到ili210x.c 这个驱动文件,路径 为 drivers/input/touchscreen/ili210x.c,找到 ili210x_report_events 函数,此函数就是用于上报 ili210x 触摸坐标信息的,函数内容如下所示:
: i6 w$ S% n' @4 M$ P& ?78 static void ili210x_report_events(struct input_dev *input,
4 m. z! d4 I6 v. U79 const struct touchdata *touchdata)
2 n: k9 t9 T$ y, |0 z1 P4 Y/ @* C80 {
* o: J* K( G6 }" m3 F% b" U81 int i;! H; D8 I7 |5 Z0 I e
82 bool touch;
5 C: _( f8 H9 O- A1 {/ Z# z+ _83 unsigned int x, y;
) |% s1 t* N% U, ~84 const struct finger *finger;) J. i" t: c- q
85$ c5 M' D' ]6 m( o
86 for (i = 0; i < MAX_TOUCHES; i++) {
6 C: ]* N b0 ~2 q# E2 A87 input_mt_slot(input, i);: P" @1 V' o( l" q% \# p
88
: B3 D0 {+ E% z0 ~89 finger = &touchdata->finger;5 [( ~' r( W# h$ B$ Q5 G- D/ [
90/ I5 n0 a1 I3 T: S+ j3 M7 p. [* M. s' C
91 touch = touchdata->status & (1 << i);
+ j- o- T1 |8 ^% i/ j92 input_mt_report_slot_state(input, MT_TOOL_FINGER, touch);
" ~( a3 _$ ^+ E* c93 if (touch) {
& L5 {1 V+ J0 o( F94 x = finger->x_low | (finger->x_high << 8);6 R9 j0 g6 e$ |7 f
95 y = finger->y_low | (finger->y_high << 8);2 A/ h" U1 @% G# s
96. h; N" I" l8 g# V% i, `
97 input_report_abs(input, ABS_MT_POSITION_X, x);4 B0 }% l* B4 w1 R- b% j! B% H! P
98 input_report_abs(input, ABS_MT_POSITION_Y, y);0 B8 |3 g+ ]2 k. p+ O: J1 d
99 }
5 E/ d0 r9 F# _3 q# |7 Q100 }( E& y9 H/ h: D
101$ D& f+ P8 K7 i9 A5 f1 Y
102 input_mt_report_pointer_emulation(input, false);4 E' A9 J8 b- `3 f0 C" X
103 input_sync(input);& _- C2 k8 B% }1 g1 h& ~" A6 A6 [
104 }8 O0 A0 t% m3 V- A8 x' j7 b3 A
第 86~100 行,使用 for 循环实现上报所有的触摸点坐标,第 87 行调用 input_mt_slot 函数上报ABS_MT_SLOT 事件。第 92 行调用 input_mt_report_slot_state 函数上报 ABS_MT_TRACKING_ID 事件,也就是给 SLOT 关联一个 ABS_MT_TRACKING_ID。第 97 和 98 行使用 input_report_abs 函数上报触摸点对应的(X,Y)坐标值。7 i* p" \* }$ R& {$ \9 t
第 103 行,使用 input_sync 函数上报 SYN_REPORT 事件。
' B, @, F+ @7 M9 D) O; ^1 N7 Q6 X
2 s& F6 i+ L% e G8 V54.1.4 MT 其他事件的使用* {4 M7 @" l* E) R: Z! [2 N
在 54.1.1 小节中给出了 Linux 所支持的所有 ABS_MT 事件,大家可以根据实际需求将这些事件组成各种事件组合。最简单的组合就是 ABS_MT_POSITION_X 和 ABS_MT_POSITION_Y,可以通过在这两个事件上报触摸点,如果设备支持的话,还可以使用 ABS_MT_TOUCH_MAJOR 和 ABS_MT_WIDTH_MAJOR 这两个消息 上 报 触 摸 面 积 信 息 , 关 于 其 他 ABS_MT 事 件 的 具 体 含 义 大 家 可 以 查 看 Linux 内 核 中 的multi-touch-protocol.txt 文档,这里我们重点补充一下 ABS_MT_TOOL_TYPE 事件。0 M+ ~+ V# W/ Y5 P
ABS_MT_TOOL_TYPE 事件用于上报触摸工具类型,很多内核驱动都不能区分出触摸设备类型,是手指还是触摸笔?这种情况下,这个事件可以忽略掉。目前的协议支持 MT_TOOL_FINGER(手指)、MT_TOOL_PEN(笔)和 MT_TOOL_PALM(手掌)这三种触摸设备类,于 Type B 类 型 ,此事件由 input 子系统内核处理。如果驱动程序需要上报 ABS_MT_TOOL_TYPE 事件,那么可以使用 input_mt_report_slot_state 函数来完成此工作。9 `, a- R9 C6 L5 N+ ^* [4 o
关于 Linux 系统下的多点触摸(MT)协议就讲解到这里,简单总结一下,MT 协议隶属于 linux 的 input子系统,驱动通过大量的 ABS_MT 事件向 linux 内核上报多点触摸坐标数据。根据触摸 IC 的不同,分为TypeA 和 Type B 两种类型,不同的类型其上报时序不同,目前使用最多的是 Type B 类型。
% f' D6 `7 l% a+ ?6 c9 x
) C! N5 h+ r. }0 m4 h54.1.5 多点触摸使用到的 API 函数; g3 y; Y) G/ x* n2 t
根据前面的讲解,我们知道 linux 下的多点触摸协议其实就是通过不同的事件来上报触摸点坐标信息,这些事件都是通过 Linux 内核提供的对应 API 函数实现的,本小节我们来看一下一些常见的 API 函数。7 r2 s% k4 l7 p4 h' Z
1 、input_mt_init_slots 函数: h( r/ G0 ]' a% R+ d) h9 G
input_mt_init_slots 函数用于初始化 MT 的输入 slots,编写 MT 驱动的时候必须先调用此函数初始化slots,此函数定义在文件 drivers/input/input-mt.c 中,函数原型如下所示:
& ~4 B* Z% j" ~2 R' Oint input_mt_init_slots( struct input_dev *dev,: X5 O) c- Q. C4 f; ~1 i2 y
unsigned int num_slots,% n2 o' w# @5 y5 |
unsigned int flags)
* A1 C% t$ c2 } A函数参数和返回值含义如下:( x9 r$ C( X' W
dev: MT 设备对应的 input_dev,因为 MT 设备隶属于 input_dev。
& H/ U) ^' h/ Nnum_slots:设备要使用的 SLOT 数量,也就是触摸点的数量。
9 n; w4 ^- F% G/ P7 iflags:其他一些 flags 信息,可设置的 flags 如下所示:9 x4 _6 c4 b; G# P
#define INPUT_MT_POINTER 0x0001 /* pointer device, e.g. trackpad */
$ J3 y$ I. p" x( _#define INPUT_MT_DIRECT 0x0002 /* direct device, e.g. touchscreen */- c- g; Q8 r) w' z5 d5 s. [
#define INPUT_MT_DROP_UNUSED0x0004 /* drop contacts not seen in frame */( @) d U9 J% N$ Y
#define INPUT_MT_TRACK 0x0008 /* use in-kernel tracking */
/ A3 \1 B: s8 Q3 T% v8 h#define INPUT_MT_SEMI_MT 0x0010 /* semi-mt device, finger count handled manually */
# }4 C5 J' U* W* F8 \) |可以采用‘|’运算来同时设置多个 flags 标识。( ~, p0 U. e% v. u! l9 u
返回值:0,成功;负值,失败。
6 F( d" m2 i0 c2 、input_mt_slot 函数, W* n8 n% I/ y0 R7 M
此函数用于 Type B 类型,此函数用于产生 ABS_MT_SLOT 事件,告诉内核当前上报的是哪个触摸点的坐标数据,此函数定义在文件 include/linux/input/mt.h 中,函数原型如下所示:1 d; ]7 x j+ ~
void input_mt_slot(struct input_dev *dev,
Q! N" N. R% K+ K: v- Z+ Q2 Oint slot), E. R3 H+ C3 }- q3 I- o
函数参数和返回值含义如下:
6 D* S& Z1 \ G5 v& Adev: MT 设备对应的 input_dev。
4 n. |, K& j1 b+ V8 Nslot:当前发送的是哪个 slot 的坐标信息,也就是哪个触摸点。
; h4 X) Y8 D* P返回值:无。" ?0 @4 g3 F& `% v
3 、input_mt_report_slot_state 函数
0 q) P2 s, x/ s0 I5 M5 U2 B7 ]此 函 数 用 于 Type B 类 型 , 用 于 产 生 ABS_MT_TRACKING_ID 和 ABS_MT_TOOL_TYPE 事 件 ,ABS_MT_TRACKING_ID 事件给 slot 关联一个 ABS_MT_TRACKING_ID , ABS_MT_TOOL_TYPE 事件指定触摸类 型(是笔还是手指等)。此函数定义在文件 drivers/input/input-mt.c 中,此函数原型如下所示:+ j* ?( e- F" w+ q' m% ]
void input_mt_report_slot_state( struct input_dev *dev,
9 M# i2 K# M+ Ounsigned int tool_type,1 r9 g% Y2 r# U& @0 c
bool active)
1 K3 Z% R& K( @ N) F' B( E函数参数和返回值含义如下:
$ n6 n: F7 V; ~* S% x/ Zdev: MT 设备对应的 input_dev。
; `6 }. z- C- [0 O, V; _tool_type:触摸类型,可以选择 MT_TOOL_FINGER(手指)、MT_TOOL_PEN(笔)或MT_TOOL_PALM(手掌),对于多点电容触摸屏来说一般都是手指。* ?! P5 ]9 V! p5 o% \4 l5 H5 |
active:true,连续触摸,input 子系统内核会自动分配一个 ABS_MT_TRACKING_ID 给 slot。
" C @% S) `' o' ]false,触摸点抬起,表示某个触摸点无效了,input 子系统内核会分配一个-1 给 slot,表示触摸点溢出。1 n2 J5 v0 [5 W6 c! ~5 }( C
返回值:无。$ S- H2 o2 M8 H4 Z( q, D* P
4 、input_report_abs 函数( s' L; e1 B# b' o7 L6 h
TypeA 和 Type B 类 型 都 使 用 此 函 数 上 报 触 摸 点 坐 标 信 息 , 通 过 ABS_MT_POSITION_X 和ABS_MT_POSITION_Y 事件实现 X 和 Y 轴坐标信息上报。此函数定义在文件 include/linux/input.h 中,函数
& c* w) L3 V% m' T. @" M1 Y& ]原型如下所示:
: Y T W7 v) j4 p& y1 U" S5 ^% [void input_report_abs( struct input_dev *dev,
4 J: ~0 t# P( k6 Y5 Kunsigned int code,' {3 M7 O, k1 _+ d8 M1 T5 {' q
int value)
4 z5 V0 U) C- _* P) _函数参数和返回值含义如下:
2 f6 v% B( G( U- m9 @4 ddev: MT 设备对应的 input_dev。0 r9 l7 B& u) y" I
code:要上报的是什么数据,可以设置为 ABS_MT_POSITION_X 或 ABS_MT_POSITION_Y,也就是 X 轴或者 Y 轴坐标数据。
B$ H7 h |; Q& Jvalue:具体的 X 轴或 Y 轴坐标数据值。1 \- t& I `( R/ A/ S- H* e
返回值:无。4 T* J: R' v+ B
5 、input_mt_report_pointer_emulation 函数
6 s' v2 x6 F( m9 Y! {* J5 n# |如果追踪到的触摸点数量多于当前上报的数量,驱动程序使用 BTN_TOOL_TAP 事件来通知用户空间当前追踪到的触摸点总数量,然后调用 input_mt_report_pointer_emulation 函数将 use_count 参数设置为false。否则的话将 use_count 参数设置为 true,表示当前的触摸点数量(此函数会获取到具体的触摸点数量,不需要用户给出),此函数定义在文件 drivers/input/input-mt.c 中,函数原型如下:* k6 f; g) R* E% ?( _
void input_mt_report_pointer_emulation(struct input_dev *dev,
9 i5 i( j# x, d5 G9 `bool use_count)
0 F3 M+ f: {6 ^: t函数参数和返回值含义如下:
6 w# |" c7 i! Tdev: MT 设备对应的 input_dev。
Z' Q9 q4 W% [5 U( e4 Z* x6 Fuse_count:true,有效的触摸点数量;false,追踪到的触摸点数量多于当前上报的数量。; x. h/ @4 t% [( u6 _" Y4 b
返回值:无。5 ?) o- |' c. P( S
9 j- j) n0 Q( _1 ?- p54.1.6 多点电容触摸驱动框架5 \6 `# Z4 X7 Y! d/ Y
前面几小节已经详细的讲解了 linux 下多点触摸屏驱动原理,本小节我们来梳理一下 linux 下多点电容触摸驱动的编写框架和步骤。首先确定驱动需要用到哪些知识点,哪些框架?根据前面的分析,我们在编写驱动的时候需要注意一下几点:3 n( j' ~/ Z8 o( D* R
① 多点电容触摸芯片的接口,一般都为 I2C 接口,因此驱动主框架肯定是 I2C。
/ P. _7 R0 [* w; \$ ]② linux 里面一般都是通过中断来上报触摸点坐标信息,因此需要用到中断框架。
/ w6 g) W9 m# ?9 q2 ~2 _( a3 ~③ 多点电容触摸属于 input 子系统,因此还要用到 input 子系统框架。
4 h( }4 u& y+ E0 U `/ a④ 在中断处理程序中按照 linux 的 MT 协议上报坐标信息。
2 i E/ z' _* Z+ ^; q6 {8 s根据上面的分析,多点电容触摸驱动编写框架以及步骤如下:
, V# g+ V" p8 A% W. _/ C; {" g1 、I2C 驱动框架
, }& a( s; I2 `: u8 e y' }; X驱动总体采用 I2C 框架,参考框架代码如下所示:
4 p, C: A* X8 K7 Z3 c+ u5 l1 /* 设备树匹配表 */
; B& ?' k" z, o0 H2 static const struct i2c_device_id xxx_ts_id[] = {
; r/ W3 w* o) n t9 O& I3 { "xxx", 0, },
# }* Y6 h! H/ X+ d _! p4 { /* sentinel */ }' |; F# ^5 M6 |+ t5 b
5 };; x5 y9 K% x/ f' R: h
6& V6 A0 \% S( j% z$ K
7 /* 设备树匹配表 */
7 G t0 f" ^" Q8 static const struct of_device_id xxx_of_match[] = { [" a' [' \$ d% d- U$ T8 _
9 { .compatible = "xxx", },9 i0 d" d; |) N! o
10 { /* sentinel */ }- j1 {. o1 Y+ e9 R3 ?
11 };* {9 X' Y& ?) ]8 F+ J7 ^% l3 B: X
12
$ G% l8 n$ ?2 W! t9 X' q% i) ^* |7 |13 /* i2c 驱动结构体 */7 j0 g6 T& P# m# g" Z
14 static struct i2c_driver ft5x06_ts_driver = {
# u$ }; @4 P7 ?! i& C `/ E7 l15 .driver = {' C. M' V# x) I9 i6 E; a2 Q, l
16 .owner = THIS_MODULE,
% j% K$ k" Z# V* G% a: u17 .name = "edt_ft5x06",, o& L5 o8 o4 W I% t+ C8 n6 X" B* s
18 .of_match_table = of_match_ptr(xxx_of_match),5 S- x. L( j& F+ I
19 },
% e1 D2 J h' Z+ v20 .id_table = xxx_ts_id,. g/ H6 G/ Z& e1 w. c( M
21 .probe = xxx_ts_probe,- j1 d( R- m8 T# ?& A
22 .remove = xxx_ts_remove,/ |, ~6 R0 X- o: I0 G
23 };
x, Q7 R/ T6 |% [0 Q" l3 b1 [24
, G6 _# C5 v5 J8 J9 Y0 Y25 /*
' n3 G0 H5 l+ }3 t26 * @description : 驱动入口函数0 B/ p% f- O* L4 F" ]! |% X
27 * @param : 无$ p" M+ @6 q" i8 m8 m
28 * @return : 无
7 c* q$ J# ^5 N! b- L$ @29 */
0 d! R$ A2 f' K/ c3 m! e) t30 static int __init xxx_init(void)
' Z" }7 Q M* x( @31 {
- X; ?* _) d6 W2 @! g32 int ret = 0;0 b; h6 e3 }6 x6 E. q5 i6 R( _* t
33
& [( v6 r6 j9 v. h& l) z34 ret = i2c_add_driver(&xxx_ts_driver);
. J4 r- ~. K2 }( d' D* A3 j6 ~/ o357 i! }5 c1 F: r: l8 z! u9 W' n! ~
36 return ret;
! Z8 Z4 R# `7 T! J8 W37 }9 ^# ^. y! c; \: x
38, T5 h! [9 ~, S
39 /*2 `6 V! s) H! s2 G
40 * @description : 驱动出口函数" r. u( [# i0 z9 A) [
41 * @param : 无( X/ @/ ?+ F3 F- G
42 * @return : 无0 C, j/ p6 v% i8 J
43 */8 x# x0 }0 _' W) h1 w, J* c/ t- M
44 static void __exit xxx_exit(void)) a X: A& S& f3 q, b& P) C- e
45 {
3 q3 g, ^3 c$ j1 n F46 i2c_del_driver(&ft5x06_ts_driver);! |/ Y4 G4 M# w7 L( Q
47 }
* C/ z" S( f, y2 H48+ o8 @8 L' q m# H
49 module_init(xxx_init);; [+ u/ H9 z+ H6 M5 X6 e- I
50 module_exit(xxx_exit);# Q( i7 l7 L- u2 \# j5 r+ B9 v
51 MODULE_LICENSE("GPL");; a; B) a9 r# `" \
52 MODULE_AUTHOR("topeet");1 c6 E7 e" G& j! D8 q+ N
当设备树中触摸 IC 的设备节点和驱动匹配以后,第 21 行的 xxx_ts_probe 函数就会执行,我们可以在此函数中初始化触摸 IC,中断和 input 子系统等。' Z, m. ?! X7 @ S7 B
2摸 、初始化触摸 IC和 、中断和 input 子系统
4 o! l7 K! R) D2 p& J初始化操作都是在 xxx_ts_probe 函数中完成,参考框架如下所示:, k4 m6 Q* T) [
1 static int xxx_ts_probe(struct i2c_client *client, const struct i2c_device_id *id), \ R+ C; q1 H1 h3 p+ B- q9 B
2 {
' Q) ?' N' [! ^* G2 f5 l3 struct input_dev *input;
, e) V5 `+ a7 @1 n; s. I4$ w% L; ~2 f& L5 W
5 /* 1、初始化 I2C */
( P% R, D8 k6 u5 z( c) |6 ......; \' C3 u' [- a% t: c, i; R! ^
76 W0 H" y2 P. I+ ]$ n$ f: L8 p
8 /* 2,申请中断, */
9 X6 U$ p. f' V+ N; W! I* ?9 devm_request_threaded_irq(&client->dev, client->irq, NULL,; H/ p; i6 z, J" ^5 V( x
10 xxx_handler, IRQF_TRIGGER_FALLING | IRQF_ONESHOT," l) G6 W/ ?8 q, b# ^3 J8 X
11 client->name, &xxx);
& s- g5 k/ f) t4 b12 ......
+ _: A+ U3 Z l3 R8 F13
M" d) p( [0 @( H, ~# _0 c14 /* 3,input 设备申请与初始化 */1 x) a& g! \9 a+ X
15 input = devm_input_allocate_device(&client->dev);
D, k. `+ {8 ?& [/ q# T16' y8 \3 \ q# o& s' J
17 input->name = client->name;
5 u2 ?# \- E5 D, Q4 e0 W" A18 input->id.bustype = BUS_I2C;# y; Z1 Q; N% W- [/ o
19 input->dev.parent = &client->dev;
x: D4 ]; H$ w$ m; D( |* _) I20 ......! E2 a* p/ Z, `* G! g; q% P, g
21
! c k l; x. E; S8 n. I22 /* 4,初始化 input 和 MT */5 b9 o9 X5 o% `: b
23 __set_bit(EV_ABS, input->evbit);
# U6 U, p2 Y I# G& B% \9 K& h24 __set_bit(BTN_TOUCH, input->keybit);
2 G4 {6 U! ?+ q% z( w# R f. b25
4 k- o" ~8 ~/ I: q4 n26 input_set_abs_params(input, ABS_X, 0, width, 0, 0);/ J. N$ W+ @! X
27 input_set_abs_params(input, ABS_Y, 0, height, 0, 0);
' l5 ~- t8 a' z+ Y0 u2 o6 B28 input_set_abs_params(input, ABS_MT_POSITION_X,0, width, 0, 0);
8 X/ ?3 ^" G; W29 input_set_abs_params(input, ABS_MT_POSITION_Y,0, height, 0, 0);% r+ }% O0 h3 o$ v
30 input_mt_init_slots(input, MAX_SUPPORT_POINTS, 0);5 \' E/ A9 ~& P/ o" w
31 ......4 g9 I' {% H- i' E
32% v- j: R7 o0 u6 F
33 /* 5,注册 input_dev */
6 Y& r2 W$ U( G, P/ H34 input_register_device(input);
$ o/ Y5 G8 f/ F" Q$ F4 c35 ......) J& @8 l' |9 Z9 |4 P. z1 u$ X9 s
36 }% V+ ^# t0 l8 a s8 u
第 5~7 行,首先肯定是初始化触摸芯片,包括芯片的相关 IO,比如复位、中断等 IO 引脚,然后就是芯片本身的初始化,也就是配置触摸芯片的相关寄存器。% G, u8 r1 d/ K w7 V
第 9 行,因为一般触摸芯片都是通过中断来向系统上报触摸点坐标信息的,因此我们需要初始化中断。大家可能会发现第 9 行并没有使用 request_irq 函数申请中断,而是采用了 devm_request_threaded_irq 这个函数,为什么使用这个函数呢?是不是 request_irq 函数不能使用?答案肯定不是的,这里用 request_irq函数是绝对没问题的。那为何要用 devm_request_threaded_irq 呢?这里我们就简单的介绍一下这个 API7 j2 U6 T. h/ Q: L+ G% o
函数,devm_request_threaded_irq 函数特点如下:9 X2 _/ j! Q8 H6 J$ k4 {
① 用于申请中断,作用和 request_irq 函数类似。+ V" Z+ b( U3 c% O0 u! Z
② 此函数的作用是中断线程化,大家如果直接在网上搜索“devm_request_threaded_irq”会发现相关解释很少。但是大家去搜索 request_threaded_irq 函数就会有很多讲解的博客和帖子,这两个函数在名字上的差别就是前者比后者多了个“devm_”前缀,“devm_”前缀稍后讲解。大家应该注意到了
H: Z# Q# e9 g, \% t7 S1 U“request_threaded_irq”相比“request_irq”多了个 threaded 函数,也就是线程的意思。那么为什么要中断线程化呢?我们都是知道硬件中断具有最高优先级,不论什么时候只要硬件中断发生,那么内核都会终止当前正在执行的操作,转而去执行中断处理程序(不考虑关闭中断和中断优先级的情况),如果中断非常频
5 V' q& r- T* K# X繁的话那么内核将会频繁的执行中断处理程序,导致任务得不到及时的处理。中断线程化以后中断将作为内核线程运行,而且也可以被赋予不同的优先级,任务的优先级可能比中断线程的优先级高,这样做的目的就是保证高优先级的任务能被优先处理。大家可能会疑问,前面不是说可以将比较耗时的中断放到下半
8 D( L3 D9 M8 }( @% n部(bottom half)处理吗?虽然下半部可以被延迟处理,但是依旧先于线程执行,中断线程化可以让这些比较耗时的下半部与进程进行公平竞争。6 E: g8 L2 n, a
要注意,并不是所有的中断都可以被线程化,重要的中断就不能这么操作。对于触摸屏而言只要手指放到屏幕上,它可能就会一直产生中断(视具体芯片而定,FT5426 是这样的),中断处理程序里面需要通过 I2C读取触摸信息并上报给内核,I2C 的速度最大只有 400KHz,算是低速外设。不断的产生中断、读取触摸信6 y2 Z( v1 ]7 q
息、上报信息会导致处理器在触摸中断上花费大量的时间,但是触摸相对来说不是那么重要的事件,因此可以将触摸中断线程化。如果你觉得触摸中断很重要,那么就可以不将其进行线程化处理。总之,要不要将一个中断进行线程化处理是需要自己根据实际情况去衡量的。
+ @3 z6 w. b2 F③ 最后来看一下“devm_”前缀,在 linux 内核中有很多的申请资源类的 API 函数都有对应的“devm_”前缀版本。比如 devm_request_irq 和 request_irq 这两个函数,这两个函数都是申请中断的,我们使用request_irq 函数申请中断的时候,如果驱动初始化失败的话就要调用 free_irq 函数对申请成功的 irq 进行
! s ]# B Z, w: q& {* y释放,卸载驱动的时候也需要我们手动调用 free_irq 来释放 irq。假如我们的驱动里面申请了很多资源,比如:gpio、irq、input_dev,那么就需要添加很多goto 语句对其做处理,当这样的标签多了以后代码看起来就不整洁了。“devm_”函数就是为了处理这种情况而诞生的,“devm_”函数最大的作用就是:
+ z% U0 ]( P9 T使用“devm_”前缀的函数申请到的资源可以由系统自动释放,不需要我们手动处理。 如果我们使用devm_request_threaded_irq 函数来申请中断,那么就不需要我们再调用 free_irq 函数对其进行释放。大家可以注意一下,带有“devm_”前缀的都是一些和设备资源管理有关的函数。关于“devm_”函数的实现原理这里就不做详细的讲解了,我们的重点在于学会如何使用这些 API 函数,感兴趣的可以查阅一些其他文档或者帖子来看一下“devm_”函数的实现原理。
6 w5 Y8 \- L5 O1 ^5 d% C" P第 15 行,接下来就是申请 input_dev,因为多点电容触摸属于 input 子系统。这里同样使用devm_input_allocate_device 函数来申请 input_dev,也就是我们前面讲解的 input_allocate_device 函数加“devm_”前缀版本。申请到 input_dev 以后还需要对其进行初始化操作。+ Z# T# t) z1 q6 V) F9 ]
第 23~24 行,设置 input_dev 需要上报的事件为 EV_ABS 和 BTN_TOUCH,因为多点电容屏的触摸坐标为绝对值,因此需要上报 EV_ABS 事件。触摸屏有按下和抬起之分,因此需要上报 BTN_TOUCH 按键。
0 N0 O# a7 x! X4 p& b- k- J第 26~29 行,调用 input_set_abs_params 函数设置 EV_ABS 事件需要上报 ABS_X、ABS_Y、ABS_MT_POSITION_X 和 ABS_MT_POSITION_Y。单点触摸需要上报 ABS_X 和 ABS_Y,对于多点触摸需要上报 ABS_MT_POSITION_X 和 ABS_MT_POSITION_Y。
' X8 k$ I; f8 }0 F) t8 W第 30 行,调用 input_mt_init_slots 函数初始化多点电容触摸的 slots。7 y+ R- ~6 n* @$ l0 W: c- N9 E
第 34 行,调用 input_register_device 函数系统注册前面申请到的 input_dev。
( u: q- Y6 D1 E# F3 、上报坐标信息
- F! _- x; A8 }# d最后就是在中断服务程序中上报读取到的坐标信息,根据所使用的多点电容触摸设备类型选择使用TypeA 还是 Type B 时序。由于大多数的设备都是 Type B 类型,因此这里就以 Type B 类型为例讲解一下上报过程,参考驱动框架如下所示:1 _- s# g; Q; `9 S/ C* F! Q% b
1 static irqreturn_t xxx_handler(int irq, void *dev_id)
6 q1 g% [# Q1 }' c: g$ B2 {0 f* _1 S! s* T9 c+ K
3
. Q q% r+ x. _0 |4 int num; /* 触摸点数量 */1 O" A* B* C( x; {. j
5 int x[n], y[n]; /* 保存坐标值 */# C i6 a, I- V0 T- R) X, M. \
6
0 b- P4 A' I7 r. U, c6 N1 N7 /* 1、从触摸芯片获取各个触摸点坐标值 */
. O7 o& _# C7 w ^9 a8 J( z8 ......5 y- ]- c3 z9 m8 `+ @
9* d% {% F; N+ ~1 k' F
10 /* 2、上报每一个触摸点坐标 */6 D' s9 X% k& r
11 for (i = 0; i < num; i++) {3 K# \& Y2 O( x9 q" \
12 input_mt_slot(input, id);9 h9 |" j1 t5 Z$ ~ }
13 input_mt_report_slot_state(input, MT_TOOL_FINGER, true);- `6 U4 E+ W/ ~8 n. D) [, c0 h
14 input_report_abs(input, ABS_MT_POSITION_X, x);6 @7 x* n, d' c/ S
15 input_report_abs(input, ABS_MT_POSITION_Y, y);
4 v! `1 J ?' K1 s# _" o2 B16 }
; m' |6 {+ L0 S$ K7 A7 n; Z, \17 ......& ?) K: \) T9 H: I6 [, j4 W2 n
18& ~5 b. o' B! _7 S* k: A2 I" z
19 input_sync(input);6 A0 P2 I- h$ D- i; L% [5 s
20 ......
: c4 U4 f- e$ c( F, q$ \4 J4 L217 S4 N X: C3 n
22 return IRQ_HANDLED;
, ]0 v/ f$ z+ a* g2 N/ e* ^% x23 }
7 b% Z4 B4 _$ a- v+ Z% E2 g进入中断处理程序以后首先肯定是从触摸 IC 里面读取触摸坐标以及触摸点数量,假设触摸点数量保存到 num 变量,触摸点坐标存放到 x,y 数组里面。. t5 g- [% @9 i8 H+ R8 O0 R1 h) v
第 11~16 行,循环上报每一个触摸点坐标,一定要按照 Type B 类型的时序进行。
7 l, v3 n) Z0 c% {第 19 行,每一轮触摸点坐标上报完毕以后就调用一次 input_sync 函数发送一个 SYN_REPORT 事件。) h) n; ]/ d. L$ a0 d7 H7 H1 s
关于多点电容触摸驱动框架就讲解到这里,接下来我们就实际编写一个多点电容触摸驱动程序。! E' F3 |9 y r+ b0 Q- `3 [
|
|