28. 电容触摸屏—触摸画板¶
本章参考资料：《STM32F4xx参考手册》、《STM32F4xx规格书》、库帮助文档《stm32f4xx_dsp_stdperiph_lib_um.chm》。
关于开发板配套的结构尺寸参数可查阅《4.3电容触摸屏结构尺寸》，触摸面板配套的触摸控制芯片可查阅《GT917S Datasheet》及《gt91x编程指南》配套资料获知。。
在前面我们学习了如何使用FSMC外设控制液晶屏并用它显示各种图形及文字，利用液晶屏，STM32的系统具有了高级信息输出功能，然而我们还希望有用户友好的输入设备，触摸屏是不二之选，目前大部分电子设备都使用触摸屏配合液晶显示器组成人机交互系统。
28.1. 触摸屏简介¶
触摸屏又称触控面板，它是一种把触摸位置转化成坐标数据的输入设备，根据触摸屏的检测原理，主要分为电阻式触摸屏和电容式触摸屏。相对来说，电阻屏造价便宜，能适应较恶劣的环境，但它只支持单点触控(一次只能检测面板上的一个触摸位置)，触摸时需要一定的压力，使用久了容易造成表面磨损，影响寿命；而电容屏具有支持多点触控、检测精度高的特点，电容屏通过与导电物体产生的电容效应来检测触摸动作，只能感应导电物体的触摸，湿度较大或屏幕表面有水珠时会影响电容屏的检测效果。
图 28‑1单电阻屏、电阻液晶屏（带触摸控制芯片）
图 28‑2单电容屏、电容液晶屏(带触摸控制芯片)
图28_1 和 图28_2 分别是带电阻触摸屏及电容触摸屏的两种屏幕，从外观上并没有明显的区别， 区分电阻屏与电容屏最直接的方法就是使用绝缘物体点击屏幕，因为电阻屏通过压力能正常检测触摸动作， 而该绝缘物体无法影响电容屏所检测的信号，因而无法检测到触摸动作。目前电容式触摸屏被大部分应用在智能手机、 平板电脑等电子设备中，而在汽车导航、工控机等设备中电阻式触摸屏仍占主流。
28.1.1. 电阻式触摸屏检测原理¶
电阻式的触摸屏结构见 图28_3。它主要由表面硬涂层、两个ITO层、间隔点以及玻璃底层构成，这些结构层都是透明的， 整个触摸屏覆盖在液晶面板上，透过触摸屏可看到液晶面板。表面涂层起到保护作用，玻璃底层起承载的作用， 而两个ITO层是触摸屏的关键结构，它们是涂有铟锡金属氧化物的导电层。两个ITO层之间使用间隔点使两层分开， 当触摸屏表面受到压力时，表面弯曲使得上层ITO与下层ITO接触，在触点处连通电路。
图 28‑3 电阻式触摸屏结构
两个ITO涂层的两端分别引出X-、X+、Y-、Y+四个电极，见 图28_4，这是电阻屏最常见的四线结构， 通过这些电极，外部电路向这两个涂层可以施加匀强电场或检测电压。
图 28‑4 XY的ITO层结构
当触摸屏被按下时，两个ITO层相互接触，从触点处把ITO层分为两个电阻，且由于ITO层均匀导电， 两个电阻的大小与触点离两电极的距离成比例关系，利用这个特性，可通过以下过程来检测坐标， 这也正是电阻触摸屏名称的由来，见 图28_5。
计算X坐标时，在X+电极施加驱动电压Vref，X-极接地，所以X+与X-处形成了匀强电场， 而触点处的电压通过Y+电极采集得到，由于ITO层均匀导电，触点电压与Vref之比等于触点X坐标与屏宽度之比，从而：
计算Y坐标时，在Y+电极施加驱动电压Vref，Y-极接地，所以Y+与Y-处形成了匀强电场， 而触点处的电压通过X+电极采集得到，由于ITO层均匀导电，触点电压与V:sub:ref之比等于触点Y坐标与屏高度之比，从而：
图 28‑5 触摸检测等效电路
为了方便检测触摸的坐标，一些芯片厂商制作了电阻屏专用的控制芯片，控制上述采集过程、采集电压， 外部微控制器直接与触摸控制芯片通讯直接获得触点的电压或坐标。 如 图28_1 中我们生产的这款3.2寸电阻触摸屏就是采用XPT2046芯片作为触摸控制芯片， XPT2046芯片控制4线电阻触摸屏，STM32与XPT2046采用SPI通讯获取采集得的电压，然后转换成坐标。
28.1.2. 电容式触摸屏检测原理¶
与电阻式触摸屏不同，电容式触摸屏不需要通过压力使触点变形，再通过触点处电压值来检测坐标，它的基本原理和前面定时器章节中介绍的电容按键类似，都是利用充电时间检测电容大小，从而通过检测出电容值的变化来获知触摸信号。见图 29‑6，电容屏的最上层是玻璃(不会像电阻屏那样形变)，核心层部分也是由ITO材料构成的，这些导电材料在屏幕里构成了人眼看不见的静电网，静电网由多行X轴电极和多列Y轴电极构成，两个电极之间会形成电容。触摸屏工作时，X轴电极发出AC交流信号，而交流信号能穿过电容，即通过Y轴能感应出该信号，当交流电穿越时电容会有充放电过程，检测该充电时间可获知电容量。若手指触摸屏幕，会影响触摸点附近两个电极之间的耦合，从而改变两个电极之间的电容量，若检测到某电容的电容量发生了改变，即可获知该电容处有触摸动作（这就是为什么它被称为电容式触摸屏以及绝缘体触摸没有反应的原因）。
图 28‑6 电容触摸屏基本原理
电容屏ITO层的结构见 图28_7，这是比较常见的形式，电极由多个菱形导体组成，生产时使用蚀刻工艺在ITO层生成这样的结构。
图 28‑7 电容触摸屏的ITO层结构
X轴电极与Y轴电极在交叉处形成电容，即这两组电极构成了电容的两极，这样的结构覆盖了整个电容屏，每个电容单元在触摸屏中都有其特定的物理位置，即电容的位置就是它在触摸屏的XY坐标。检测触摸的坐标时，第1条X轴的电极发出激励信号，而所有Y轴的电极同时接收信号，通过检测充电时间可检测出各个Y轴与第1条X轴相交的各个互电容的大小，各个X轴依次发出激励信号，重复上述步骤，即可得到整个触摸屏二维平面的所有电容大小。当手指接近时，会导致局部电容改变，根据得到的触摸屏电容量变化的二维数据表，可以得知每个触摸点的坐标，因此电容触摸屏支持多点触控。
其实电容触摸屏可看作是多个电容按键组合而成，就像机械按键中独立按键和矩阵按键的关系一样，甚至电容触摸屏的坐标扫描方式与矩阵按键都是很相似的。
28.2. 电容触摸屏控制芯片¶
相对来说，电容屏的坐标检测比电阻屏的要复杂，因而它也有专用芯片用于检测过程，下面我们以本章重点讲述的电容屏使用的触控芯片GT917S为例进行讲解，关于它的详细说明可从《gt91x编程指南》和《GT917S Datasheet》文档了解。
28.2.1. GT917S芯片的引脚¶
GT917S芯片的外观可以 图28_2 中找到，其内部结构框图见 图28_8。
图 28‑8 GT917S结构框图
该芯片对外引出的信号线介绍如下：
表 28‑1 GT917S信号线说明
信号线 |
说明 |
AVDD、AVDD18、DVDD12、VDDDIO、GND |
电源和地 |
Driving channels |
激励信号输出的引脚，一共有0-25个引脚，它连接到电容屏ITO层引出的各个激励信号轴 |
Sensing channels |
信号检测引脚，一共有0-13个引脚，它连接到电容屏ITO层引出的各个电容量检测信号轴 |
I2C |
I2C通信信号线，包含SCL与SDA，外部控制器通过它与GT917S芯片通讯，配置GT917S的工作方式或获取坐标信号 |
INT |
中断信号，GT917S芯片通过它告诉外部控制器有新的触摸事件 |
/RSTB |
复位引脚，用于复位GT917S芯片；在上电时还与INT引脚配合设置IIC通讯的设备地址 |
若您把电容触摸屏与液晶面板分离开来，在触摸面板的背面，可看到它的边框有一些电路走线，它们就是触摸屏ITO层引出的XY轴信号线，这些信号线分别引出到GT917S芯片的Driving channels及Sensing channels引脚中。也正是因为触摸屏有这些信号线的存在，所以手机厂商追求的屏幕无边框是比较难做到的。
28.2.2. 上电时序与I2C设备地址¶
GT917S触控芯片有两个备选的I2C通讯地址，这是由芯片的上电时序设定的，见图 29‑9。上电时序有Reset引脚和INT引脚生成，若Reset引脚从低电电平转变到高电平期间，INT引脚为高电平的时候，触控芯片使用的I2C设备地址为0x28/0x29(8位写、读地址)，7位地址为0x14；若Reset引脚从低电电平转变到高电平期间，INT引脚一直为低电平，则触控芯片使用的I2C设备地址为0xBA/0xBB(8位写、读地址)，7位地址为0x5D。
图 28‑9 GT917S的上电时序及I2C设备地址
28.2.3. 寄存器配置¶
上电复位后，GT917S芯片需要通过外部主控芯片加载寄存器配置，设定它的工作模式，这些配置通过I2C信号线传输到GT917S，它的配置寄存器地址都由两个字节来表示，这些寄存器的地址从0x8047- 0x8135，一般来说，我们实际配置的时候会按照GT917S生产厂商给的默认配置来控制芯片，仅修改部分关键寄存器， 其中部分寄存器说明见 图28_10。（注意，由于芯片厂商并没有发布GT917S的寄存器列表说明文档， 此处使用旧型号芯片GT9157的寄存器表截图来进行说明，这两个型号大部分兼容）
图 28‑10 部分寄存器配置说明
这些寄存器介绍如下：
配置版本寄存器
0x8047配置版本寄存器，它包含有配置文件的版本号，若新写入的版本号比原版本大，或者版本号相等，但配置不一样时，才会更新配置文件到寄存器中。其中配置文件是指记录了寄存器0x8048-0x80FE控制参数的一系列数据。
为了保证每次都更新配置，我们一般把配置版本寄存器设置为“0x00”，这样版本号会默认初始化为‘A’，这样每次我们修改其它寄存器配置的时候，都会写入到GT917S中。
X、Y分辨率
0x8048-0x804B寄存器用于配置触控芯片输出的XY坐标的最大值，为了方便使用，我们把它配置得跟液晶面板的分辨率一致，这样就能使触控芯片输出的坐标一一对应到液晶面板的每一个像素点了。
触点个数
0x804C触点个数寄存器用于配置它最多可输出多少个同时按下的触点坐标，这个极限值跟触摸屏面板有关，如我们本章实验使用的触摸面板最多支持5点触控。
模式切换
0x804D模式切换寄存器中的X2Y位可以用于交换XY坐标轴；而INT触发方式位可以配置不同的触发方式，当有触摸信号时，INT引脚会根据这里的配置给出触发信号。
配置校验
0x80FF配置校验寄存器用于写入前面0x8047-0x80FE寄存器控制参数字节之和的补码，GT917S收到前面的寄存器配置时，会利用这个数据进行校验，若不匹配，就不会更新寄存器配置。
配置更新
0x8100配置更新寄存器用于控制GT917S进行更新，传输了前面的寄存器配置并校验通过后，对这个寄存器写1，GT917S会更新配置。
28.2.4. 读取坐标信息¶
28.2.4.1. 坐标寄存器¶
上述寄存器主要是由外部主控芯片给GT917S写入配置的，而它则使用 图28_11 中的寄存器向主控器反馈信息。
图 28‑11 坐标信息寄存器
产品ID及版本
0x8140-0x8143 寄存器存储的是产品ID，上电后我们可以利用I2C读取这些寄存器的值来判断I2C是否正常通讯，这些寄存器中包含有“5688”字样; 而0x8144-0x8145则保存有固件版本号，不同版本可能不同。
X/Y分辨率
0x8146-0x8149寄存器存储了控制触摸屏的分辨率，它们的值与我们前面在配置寄存器写入的XY控制参数一致。所以我们可以通过读取这两个寄存器的值来确认配置参数是否正确写入。
状态寄存器
0x814E地址的是状态寄存器，它的Buffer status位存储了坐标状态，当它为1时，表示新的坐标数据已准备好，可以读取，0表示未就绪，数据无效，外部控制器读取完坐标后，须对这个寄存器位写0 。number of touch points位表示当前有多少个触点。其余数据位我们不关心。
坐标数据
从地址0x814F-0x8156的是触摸点1的坐标数据，从0x8157-0x815E的是触摸点2的坐标数据，依次还有存储3-10触摸点坐标数据的寄存器。读取这些坐标信息时，我们通过它们的track id来区分笔迹，多次读取坐标数据时，同一个track id号里的数据属于同一个连续的笔划轨迹。
28.2.4.2. 读坐标流程¶
上电、配置完寄存器后，GT917S就会开监测触摸屏，若我们前面的配置使INT采用中断上升沿报告触摸信号的方式，整个读取坐标信息的过程如下：
待机时INT引脚输出低电平；
有坐标更新时，INT引脚输出上升沿；
INT输出上升沿后，INT 脚会保持高直到下一个周期（该周期可由配置 Refresh_Rate 决定）。外部主控器在检测到INT的信号后，先读取状态寄存器(0x814E)中的number of touch points位获当前有多少个触摸点，然后读取各个点的坐标数据，读取完后将 buffer status位写为 0。外部主控器的这些读取过程要在一周期内完成，该周期由0x8056地址的Refresh_Rate寄存器配置；
上一步骤中INT输出上升沿后，若主控未在一个周期内读走坐标，下次 GT917S即使检测到坐标更新会再输出一个 INT 脉冲但不更新坐标；
若外部主控一直未读走坐标，则 GT917S会一直输出 INT 脉冲。
28.3. 电容触摸屏—触摸画板实验¶
本小节讲解如何驱动电容触摸屏，并利用触摸屏制作一个简易的触摸画板应用。
学习本小节内容时，请打开配套的“电容触摸屏—触摸画板”工程配合阅读。
28.3.1. 硬件设计¶
图 28‑12 液晶屏实物图
本实验使用的液晶电容屏实物见 图28_12，屏幕背面的PCB电路对应 图28_13、图28_14 中的原理图， 分别是触摸屏接口及排针接口。
我们这个触摸屏出厂时就与GT917S芯片通过柔性电路板连接在一起了，柔性电路板从GT917S芯片引出VCC、GND、SCL、SDA、RSTN及INT引脚，再通过FPC座子引出到屏幕的PCB电路板中，PCB电路板加了部分电路，如I2C的上拉电阻，然后把这些引脚引出到屏幕下方的排针处，方便整个屏幕与外部器件相连。
图 28‑13 电容屏接口
以上是我们STM32F407实验板使用的4.3寸屏原理图，它通过屏幕上的排针接入到实验板的液晶排母接口，与STM32芯片的引脚相连，连接见 图28_14。
图 28‑14 屏幕与实验板的引脚连接
图28_14 中23~27号引脚即电容触摸屏相关的控制引脚。在本硬件设计中，没有使用STM32的硬件I2C引脚， 只使用普通的GPIO与触摸芯片的SCL、SDA连接，在程序上使用软件模拟I2C与触摸芯片进行通讯。
以上原理图可查阅《LCD4.3寸液晶原理图》及《野火F407开发板底板原理图》文档获知，若您使用的液晶屏或实验板不一样，请根据实际连接的引脚修改程序。
28.3.2. 软件设计¶
本工程中的GT917S芯片驱动主要是从官方提供的Linux驱动修改过来的，我们把这部分文件存储到“gt9xx.c”及“gt9xx.h”文件中，而这些驱动的底层I2C通讯接口我们存储到了“bsp_i2c_touch.c”及“bsp_i2c_touch.h”文件中，这些文件也可根据您的喜好命名，它们不属于STM32HAL库的内容，是由我们自己根据应用需要编写的。在我们提供的资料《GT5663 驱动.zip》压缩包里有官方的原Linux驱动，感兴趣的读者可以对比这些文件，了解如何移植驱动。
28.3.2.1. 编程要点¶
分析官方的gt9xx驱动，了解需要提供哪些底层接口；
编写底层驱动接口；
利用gt9xx驱动，获取触摸坐标；
编写测试程序检验驱动。
28.3.2.2. 代码分析¶
28.3.2.2.1. 触摸屏硬件相关宏定义¶
根据触摸屏与STM32芯片的硬件连接，我们把触摸屏硬件相关的配置都以宏的形式定义到 “bsp_i2c_touch.h”文件中，见 代码清单28_1 触摸屏硬件配置相关的宏(bsp_i2c_touch.h文件)。
/*设定使用的电容屏IIC设备地址*/
#define GTP_ADDRESS 0xBA
#define I2CT_FLAG_TIMEOUT ((uint32_t)0x1000)
#define I2CT_LONG_TIMEOUT ((uint32_t)(10 * I2CT_F
#define GTP_I2C_SCL_CLK() __GPIOD_CLK_ENABLE()
#define GTP_I2C_SDA_CLK() __GPIOD_CLK_ENABLE()
#define GTP_I2C_RST_CLK() __GPIOD_CLK_ENABLE()
#define GTP_I2C_GTP_CLK() __GPIOG_CLK_ENABLE()
/*I2C引脚*/
#define GTP_I2C_SCL_PIN GPIO_PIN_7
#define GTP_I2C_SCL_GPIO_PORT GPIOD
#define GTP_I2C_SDA_PIN GPIO_PIN_3
#define GTP_I2C_SDA_GPIO_PORT GPIOD
/*复位引脚*/
#define GTP_RST_GPIO_PORT GPIOD
#define GTP_RST_GPIO_PIN GPIO_PIN_6
/*中断引脚*/
#define GTP_INT_GPIO_PORT GPIOG
#define GTP_INT_GPIO_PIN GPIO_PIN_8
#define GTP_INT_EXTI_IRQ EXTI9_5_IRQn
/*中断服务函数*/
#define GTP_IRQHandler EXTI9_5_IRQHandler
以上代码根据硬件的连接，把与触摸屏通讯使用的引脚号、引脚源以及复用功能映射都以宏封装起来。在这里还定义了与GT917S芯片通讯的I2C设备地址，该地址是一个8位的写地址，它是由我们的上电时序决定的。
28.3.2.2.2. 初始化触摸屏控制引脚¶
利用上面的宏，编写触摸屏控制引脚的初始化函数，见 代码清单28_2 触摸屏控制引脚的GPIO初始化函数(bsp_i2c_touch.c文件)。
static void I2C_GPIO_Config(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
/*使能触摸屏使用的引脚的时钟*/
RCC_AHB1PeriphClockCmd(GTP_I2C_SCL_GPIO_CLK|
GTP_I2C_SDA_GPIO_CLK|
GTP_RST_GPIO_CLK|GTP_INT_GPIO_CLK,
ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE);
/*配置SCL引脚 */
GPIO_InitStructure.GPIO_Pin = GTP_I2C_SCL_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_OD;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_Init(GTP_I2C_SCL_GPIO_PORT, &GPIO_InitStructure);
/*配置SDA引脚 */
GPIO_InitStructure.GPIO_Pin = GTP_I2C_SDA_PIN;
GPIO_Init(GTP_I2C_SDA_GPIO_PORT, &GPIO_InitStructure);
/*配置RST引脚，下拉推挽输出 */
GPIO_InitStructure.GPIO_Pin = GTP_RST_GPIO_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN;
GPIO_Init(GTP_RST_GPIO_PORT, &GPIO_InitStructure);
/*配置 INT引脚，下拉推挽输出，方便初始化 */
GPIO_InitStructure.GPIO_Pin = GTP_INT_GPIO_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
//设置为下拉，方便初始化
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN;
GPIO_Init(GTP_INT_GPIO_PORT, &GPIO_InitStructure);
}
以上函数初始化了触摸屏用到的I2C信号线，并且把RST及INT引脚也初始化成了下拉推挽输出模式，以便刚上电的时候输出上电时序，设置触摸屏的I2C设备地址。
28.3.2.2.3. 配置I2C的模式¶
接下来需要配置I2C的工作模式，GT9157芯片使用的是标准7位地址模式的I2C通讯， 所以I2C这部分的配置跟我们在EEPROM实验中的是一样的，不了解这部分内容的请阅读EEPROM章节， 见 代码清单28_3 软件I2C相关的部分函数(bsp_i2c_touch.c文件)。
//软件IIC使用的宏(这部分宏在bsp_i2c_touch.h文件)
#define I2C_SCL_1() GPIO_SetBits(GTP_I2C_SCL_GPIO_PORT, GTP_I2C_SCL_PIN) /* SCL = 1 */
#define I2C_SCL_0() GPIO_ResetBits(GTP_I2C_SCL_GPIO_PORT, GTP_I2C_SCL_PIN) /* SCL = 0 */
#define I2C_SDA_1() GPIO_SetBits(GTP_I2C_SDA_GPIO_PORT, GTP_I2C_SDA_PIN) /* SDA = 1 */
#define I2C_SDA_0() GPIO_ResetBits(GTP_I2C_SDA_GPIO_PORT, GTP_I2C_SDA_PIN) /* SDA = 0 */
#define I2C_SDA_READ() GPIO_ReadInputDataBit(GTP_I2C_SDA_GPIO_PORT, GTP_I2C_SDA_PIN) /* 读SDA口线状态 */
/*
***********************************************************
* 函 数 名: i2c_Start
* 功能说明: CPU发起I2C总线启动信号
* 形 参：无
* 返 回 值: 无
***********************************************************
*/
void i2c_Start(void)
{
/* 当SCL高电平时，SDA出现一个下跳沿表示I2C总线启动信号 */
I2C_SDA_1();
I2C_SCL_1();
i2c_Delay();
I2C_SDA_0();
i2c_Delay();
I2C_SCL_0();
i2c_Delay();
}
/*
**********************************************************
* 函 数 名: i2c_Start
* 功能说明: CPU发起I2C总线停止信号
* 形 参：无
* 返 回 值: 无
**********************************************************
*/
void i2c_Stop(void)
{
/* 当SCL高电平时，SDA出现一个上跳沿表示I2C总线停止信号 */
I2C_SDA_0();
I2C_SCL_1();
i2c_Delay();
I2C_SDA_1();
}
/*
***********************************************************
* 函 数 名: i2c_ReadByte
* 功能说明: CPU从I2C总线设备读取8bit数据
* 形 参：无
* 返 回 值: 读到的数据
***********************************************************
*/
uint8_t i2c_ReadByte(void)
{
uint8_t i;
uint8_t value;
/* 读到第1个bit为数据的bit7 */
value = 0;
for (i = 0; i < 8; i++) {
value <<= 1;
I2C_SCL_1();
i2c_Delay();
if (I2C_SDA_READ()) {
value++;
}
I2C_SCL_0();
i2c_Delay();
}
return value;
}
考虑到硬件I2C在实际驱动时存在无法成功发送信号的情况，本工程中关于I2C的底层驱动使用软件I2C。
所谓软件I2C，即直接控制STM32的IO引脚的电平，根据I2C的时序产生对应的起始信号、结束信号、应答和非应答信号等。上述代码中使用I2C_SCL_1、I2C_SCL_0宏控制引脚产生高低电平逻辑，从而产生I2C需要的SCL时钟信号；I2C_SDA_1、I2C_SDA_0宏控制I2C总线的SDA数据线，产生数据输出，当需要读取数据时，使用宏I2C_SDA_READ。实际上这些宏都是对GPIO进行基本的读写，只是把它们按照I2C协议的要求来组织，就产生了I2C协议的通讯逻辑，实现了I2C通讯。（上述代码中省略了部分软件I2C的函数，感兴趣的请直接在配套代码中查看）
相对于硬件I2C，软件I2C所有逻辑的产生均由CPU直接控制，不过这并不会比前面硬件I2C读写EEPROM的驱动消耗更多的CPU资源，因为在该硬件I2C的驱动中，CPU需要轮询硬件I2C的事件标志，并不会省下CPU的时间。而软件I2C的访问速度可通过调整i2c_Delay函数的延时来修改，使用时不会比硬件I2C慢。
28.3.2.2.4. 使用上电时序设置触摸屏的I2C地址¶
在上面配置完成STM32的引脚后，就可以开始控制这些引脚对触摸屏进行控制了，为了使用I2C通讯，首先要根据GT917S芯片的上电时序给它设置I2C设备地址，见 代码清单28_4 使用上电时序设置触摸屏的I2C地址(bsp_i2c_touch.c文件)。
/**
* @brief 对GT91xx芯片进行复位
* @param 无
* @retval 无
*/
void I2C_ResetChip(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
/*配置 INT引脚，下拉推挽输出，方便初始化 */
GPIO_InitStructure.GPIO_Pin = GTP_INT_GPIO_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_DOWN; //设置为下拉，方便初始化
GPIO_Init(GTP_INT_GPIO_PORT, &GPIO_InitStructure);
/*初始化GT5688,rst为高电平，int为低电平，则gt5688的设备地址被配置为0xBA*/
/*复位为低电平，为初始化做准备*/
GPIO_ResetBits (GTP_RST_GPIO_PORT,GTP_RST_GPIO_PIN);
Delay(0x0FFFFF);
/*拉高一段时间，进行初始化*/
GPIO_SetBits (GTP_RST_GPIO_PORT,GTP_RST_GPIO_PIN);
Delay(0x0FFFFF);
/*把INT引脚设置为浮空输入模式，以便接收触摸中断信号*/
GPIO_InitStructure.GPIO_Pin = GTP_INT_GPIO_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_Init(GTP_INT_GPIO_PORT, &GPIO_InitStructure);
}
这段函数中控制RST引脚由低电平改变至高电平，且期间INT一直为低电平，这样的上电时序可以控制触控芯片的I2C写地址为0xBA， 读地址为0xBB,即(0xBA|0x01)。输出完上电时序后，把STM32的INT引脚模式改成浮空输入模式， 使它可以接收触控芯片输出的触摸中断信号。接下来我们在I2C_GTP_IRQEnable函数中使能INT中断，见 代码清单28_5。
/**
* @brief 使能触摸屏中断
* @param 无
* @retval 无
*/
void I2C_GTP_IRQEnable(void)
{
EXTI_InitTypeDef EXTI_InitStructure;
NVIC_InitTypeDef NVIC_InitStructure;
GPIO_InitTypeDef GPIO_InitStructure;
/*配置 INT 为浮空输入 */
GPIO_InitStructure.GPIO_Pin = GTP_INT_GPIO_PIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_Init(GTP_INT_GPIO_PORT, &GPIO_InitStructure);
/* 连接 EXTI 中断源 到INT 引脚 */
SYSCFG_EXTILineConfig(GTP_INT_EXTI_PORTSOURCE, GTP_INT_EXTI_PINSOURCE);
/* 选择 EXTI 中断源 */
EXTI_InitStructure.EXTI_Line = GTP_INT_EXTI_LINE;
EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt;
EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Rising;
EXTI_InitStructure.EXTI_LineCmd = ENABLE;
EXTI_Init(&EXTI_InitStructure);
/* 配置中断优先级 */
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_1);
/*使能中断*/
NVIC_InitStructure.NVIC_IRQChannel = GTP_INT_EXTI_IRQ;
NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1;
NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1;
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
NVIC_Init(&NVIC_InitStructure);
}
这个INT引脚我们配置为上升沿触发，是跟后面写入到触控芯片的配置参数一致的。
28.3.2.2.5. 初始化封装¶
利用以上函数，我们把信号引脚及I2C设备地址初始化的过程都封装到函数I2C_Touch_Init中，见 代码清单28_6。
/**
* @brief I2C 外设(gt9xx)初始化
* @param 无
* @retval 无
*/
void I2C_Touch_Init(void)
{
I2C_GPIO_Config();
I2C_ResetChip();
I2C_GTP_IRQEnable();
}
28.3.2.2.6. I2C基本读写函数¶
为了与上层“gt9xx.c”驱动文件中的函数对接，本实验中的I2C读写函数与EEPROM实验中的有稍微不同，见 代码清单28_7。
#define I2C_DIR_WR 0 /* 写控制bit */
#define I2C_DIR_RD 1 /* 读控制bit */
/**
* @brief 使用IIC读取数据
* @param
* @arg ClientAddr:从设备地址
* @arg pBuffer:存放由从机读取的数据的缓冲区指针
* @arg NumByteToRead:读取的数据长度
* @retval 无
*/
uint32_t I2C_ReadBytes(uint8_t ClientAddr,uint8_t* pBuffer, uint16_t NumByteToRead)
{
/* 第1步：发起I2C总线启动信号 */
i2c_Start();
/* 第2步：发起控制字节，高7bit是地址，bit0是读写控制位，0表示写，1表示读 */
i2c_SendByte(ClientAddr | I2C_DIR_RD); /* 此处是读指令 */
/* 第3步：等待ACK */
if (i2c_WaitAck() != 0)
{
goto cmd_fail; /* 器件无应答 */
}
while(NumByteToRead)
{
if(NumByteToRead == 1)
{
i2c_NAck(); /* 最后1个字节读完后，CPU产生NACK信号(驱动SDA = 1) */
/* 发送I2C总线停止信号 */
i2c_Stop();
}
*pBuffer = i2c_ReadByte();
/* 读指针自增 */
pBuffer++;
/*计数器自减 */
NumByteToRead--;
i2c_Ack(); /* 中间字节读完后，CPU产生ACK信号(驱动SDA = 0) */
}
/* 发送I2C总线停止信号 */
i2c_Stop();
return 0; /* 执行成功 */
cmd_fail: /* 命令执行失败后，切记发送停止信号，避免影响I2C总线上其他设备 */
/* 发送I2C总线停止信号 */
i2c_Stop();
return 1;
}
/**
* @brief 使用IIC写入数据
* @param
* @arg ClientAddr:从设备地址
* @arg pBuffer:缓冲区指针
* @arg NumByteToWrite:写的字节数
* @retval 无
*/
uint32_t I2C_WriteBytes(uint8_t ClientAddr,uint8_t* pBuffer, uint8_t NumByteToWrite)
{
uint16_t m;
/* 第0步：发停止信号，启动内部写操作 */
i2c_Stop();
/* 通过检查器件应答的方式，判断内部写操作是否完成, 一般小于 10ms
CLK频率为200KHz时，查询次数为30次左右
*/
for (m = 0; m < 1000; m++)
{
/* 第1步：发起I2C总线启动信号 */
i2c_Start();
/* 第2步：发起控制字节，高7bit是地址，bit0是读写控制位，0表示写，1表示读 */
i2c_SendByte(ClientAddr | I2C_DIR_WR); /* 此处是写指令 */
/* 第3步：发送一个时钟，判断器件是否正确应答 */
if (i2c_WaitAck() == 0)
{
break;
}
}
if (m == 1000)
{
goto cmd_fail; /* EEPROM器件写超时 */
}
while(NumByteToWrite--)
{
/* 第4步：开始写入数据 */
i2c_SendByte(*pBuffer);
/* 第5步：检查ACK */
if (i2c_WaitAck() != 0)
{
goto cmd_fail; /* 器件无应答 */
}
pBuffer++; /* 地址增1 */
}
/* 命令执行成功，发送I2C总线停止信号 */
i2c_Stop();
return 0;
cmd_fail: /* 命令执行失败后，切记发送停止信号，避免影响I2C总线上其他设备 */
/* 发送I2C总线停止信号 */
i2c_Stop();
return 1;
}
为了与后面的gt9xx.c文件的读写接口兼容，这里的读写函数都是很纯粹的I2C通讯过程，即读函数只有读过程，不包含发送寄存器地址的过程，而写函数也是只有写过程，没有包含寄存器的地址，大家可以对比一下它们与前面EEPROM实验中的差别。这两个函数都只包含从I2C的设备地址、缓冲区指针以及数据量。
28.3.2.2.7. Linux的I2C驱动接口¶
使用前面的基本读写函数，主要是为了对接原“gt9xx.c”驱动里使用的Linux I2C接口函数I2C_Transfer，实现了这个函数后，移植时就可以减少“gt9xx.c”文件的修改量。I2C_Transfer函数见 代码清单28_8。
/* 表示读数据 */
#define I2C_M_RD 0x0001
/*
* 存储I2C通讯的信息
* @addr： 从设备的I2C设备地址
* @flags: 控制标志
* @len： 读写数据的长度
* @buf： 存储读写数据的指针
**/
struct i2c_msg
{
uint8_t addr; /*从设备的I2C设备地址 */
uint16_t flags; /*控制标志*/
uint16_t len; /*读写数据的长度 */
uint8_t *buf; /*存储读写数据的指针 */
};
/**
* @brief 使用IIC进行数据传输
* @param
* @arg i2c_msg:数据传输结构体
* @arg num:数据传输结构体的个数
* @retval 正常完成的传输结构个数，若不正常，返回0xff
*/
static int I2C_Transfer( struct i2c_msg *msgs,int num)
{
int im = 0;
int ret = 0;
//输出调试信息，可忽略
GTP_DEBUG_FUNC();
for (im = 0; ret == 0 && im != num; im++)
{
//根据flag判断是读数据还是写数据
if ((msgs[im].flags&I2C_M_RD))
{
//IIC读取数据
ret = I2C_ReadBytes(msgs[im].addr, msgs[im].buf, msgs[im].len);
}
else
{
//IIC写入数据
ret = I2C_WriteBytes(msgs[im].addr, msgs[im].buf, msgs[im].len);
}
}
if (ret)
return ret;
return im; //正常完成的传输结构个数
}
I2C_Transfer的主要输入参数是i2c_msg结构体的指针以及要传输多少个这样的结构体。i2c_msg结构体包含以下几个成员：
addr
这是从机的I2C设备地址，通讯时无论是读方向还是写方向，给这个成员赋值为写地址即可(本实验中为0xBA)。
flags
这个成员存储了控制标志，它用于指示本i2c_msg结构体要求以什么方式来传输。在原Linux驱动中有很多种控制方式，在我们这个工程中，只支持读或写控制标志，flags被赋值为I2C_M_RD宏的时候表示读方向，其余值表示写方向。
len
本成员存储了要读写的数据长度。
buf
本成员存储了指向读写数据缓冲区的指针。
利用这个结构体，我们再来看I2C_Transfer函数做了什么工作。
输入参数中可能包含有多个要传输的i2c_msg结构体，利用for循环把这些结构体一个个地传输出去；
(2) 传输的时候根据i2c_msg结构体中的flags标志，确定应该调用I2C读函数还是写函数， 这些函数即前面定义的I2C基本读写函数。调用这些函数的时候，以i2c_msg结构体的成员作为参数。
28.3.2.2.8. I2C复合读写函数¶
理解了I2C_Transfer函数的代码，我们发现它还是什么都没做，只是对I2C基本读写函数封装了比较特别的调用形式而已，而我们知道GT917S触控芯片都有很多不同的寄存器，如果我们仅用上面的函数，如何向特定寄存器写入参数或读取特定寄存器的内容呢？这就需要再利用I2C_Transfer函数编写具有I2C通讯复合时序的读写函数了。Linux驱动进行这样的封装是为了让它的核心层与具体设备独立开来，对于这个巨型系统，这样写代码是很有必要的，上述的I2C_Transfer函数属于Linux内部的驱动层，它对外提供接口，而像GT917S、EEPROM等使用I2C的设备，都利用这个接口编写自己具体的驱动文件，GT917S的这些I2C复合读写函数见 代码清单28_9。
//寄存器地址的长度
#define GTP_ADDR_LENGTH 2
/**
* @brief 从IIC设备中读取数据
* @param
* @arg client_addr:设备地址
* @arg buf[0~1]: 读取数据寄存器的起始地址
* @arg buf[2~len-1]: 存储读出来数据的缓冲buffer
* @arg len: GTP_ADDR_LENGTH + read bytes count（寄存器地址长度+读取的数据字节数）
* @retval i2c_msgs传输结构体的个数，2为成功，其它为失败
*/
static int32_t GTP_I2C_Read(uint8_t client_addr, uint8_t *buf, int32_t len)
{
struct i2c_msg msgs[2];
int32_t ret=-1;
int32_t retries = 0;
GTP_DEBUG_FUNC();
/*一个读数据的过程可以分为两个传输过程:
* 1. IIC 写入 要读取的寄存器地址
* 2. IIC 读取 数据
* */
msgs[0].flags = !I2C_M_RD; //写入
msgs[0].addr = client_addr; //IIC设备地址
msgs[0].len = GTP_ADDR_LENGTH; //寄存器地址为2字节(即写入两字节的数据)
msgs[0].buf = &buf[0]; //buf[0~1]存储的是要读取的寄存器地址
msgs[1].flags = I2C_M_RD; //读取
msgs[1].addr = client_addr; //IIC设备地址
msgs[1].len = len - GTP_ADDR_LENGTH; //要读取的数据长度
msgs[1].buf = &buf[GTP_ADDR_LENGTH]; //buf[GTP_ADDR_LENGTH]之后的缓冲区存储读出的数据
while (retries < 5) {
ret = I2C_Transfer( msgs, 2); //调用IIC数据传输过程函数，有2个传输过程
if (ret == 2)break;
retries++;
}
if ((retries >= 5)) {
GTP_ERROR("I2C Read: 0x%04X, %d bytes failed, errcode: %d! Process reset.",
(((uint16_t)(buf[0] << 8)) | buf[1]), len-2, ret);
}
return ret;
}
/**
* @brief 向IIC设备写入数据
* @param
* @arg client_addr:设备地址
* @arg buf[0~1]: 要写入的数据寄存器的起始地址
* @arg buf[2~len-1]: 要写入的数据
* @arg len: GTP_ADDR_LENGTH + write bytes count（寄存器地址长度+写入的数据字节数）
* @retval i2c_msgs传输结构体的个数，1为成功，其它为失败
*/
static int32_t GTP_I2C_Write(uint8_t client_addr,uint8_t *buf,int32_t len)
{
struct i2c_msg msg;
int32_t ret = -1;
int32_t retries = 0;
GTP_DEBUG_FUNC();
/*一个写数据的过程只需要一个传输过程:
* 1. IIC连续 写入 数据寄存器地址及数据
* */
msg.flags = !I2C_M_RD; //写入
msg.addr = client_addr; //从设备地址
msg.len = len; //长度直接等于(寄存器地址长度+写入的数据字节数)
msg.buf = buf; //直接连续写入缓冲区中的数据(包括了寄存器地址)
while (retries < 5) {
ret = I2C_Transfer(&msg, 1); //调用IIC数据传输过程函数，1个传输过程
if (ret == 1)break;
retries++;
}
if ((retries >= 5)) {
GTP_ERROR("I2C Write: 0x%04X, %d bytes failed, errcode: %d! Process reset.",
(((uint16_t)(buf[0] << 8)) | buf[1]) , len-2, ret);
}
return ret;
}
可以看到，复合读写函数都包含有client_addr、buf及len输入参数，其中client_addr表示I2C的设备地址，buf存储了要读写的寄存器地址及数据，len表示buf的长度。在函数的内部处理中，复合读写过程被分解成两个基本的读写过程，输入参数被转化存储到i2c_msg结构体中，每个基本读写过程使用一个i2c_msg结构体来表示，见表 29‑2和表 29‑3。
表 29-29‑2 复合读过程的步骤分解
复合读过程的步骤分解 |
说明 |
传输寄存器地址 |
这相当于一个I2C的基本写过程，写入一个2字节长度的寄存器地址，buf指针的前两个字节内容被解释为寄存器地址。 |
从寄存器读取内容 |
这是一个I2C的基本读过程，读取到的数据存储到buf指针的第3个地址开始的空间中。 |
表 29‑3 复合写过程的步骤分解
复合写过程的步骤分解 |
说明 |
传输寄存器地址 |
这相当于一个I2C的基本写过程，写入一个2字节长度的寄存器地址，buf指针的前两个字节内容被解释为寄存器地址。 |
向寄存器写入内容 |
这也是一个I2C的基本写过程，写入的数据为buf指针的第3个地址开始的内容。 |
复合过程的分解主要是针对寄存器地址传输和实际数据传输来划分的，调用这两个复合读写过程的时候，我们需要注意buf的前两个字节为寄存器地址，且len的长度为buf的整体长度。
28.3.2.2.9. 读取触控芯片的产品ID及版本号¶
利用上述复合读写函数，我们就可以使用I2C控制触控芯片了，首先是最简单的读取版本函数，见 代码清单28_10。
/*******************************************************
Function:
Read chip version.
Input:
client: i2c device
version: buffer to keep ic firmware version
Output:
read operation return.
2: succeed, otherwise: failed
*******************************************************/
int32_t GTP_Read_Version(void)
{
int32_t ret = -1;
uint8_t buf[8] = {GTP_REG_VERSION >> 8, GTP_REG_VERSION & 0xff}; //寄存器地址
GTP_DEBUG_FUNC();
ret = GTP_I2C_Read(GTP_ADDRESS, buf, sizeof(buf));
if (ret < 0)
{
GTP_ERROR("GTP read version failed");
return ret;
}
if (buf[2] == '5')
{
GTP_INFO("IC1 Version: %c%c%c%c_%02x%02x", buf[2], buf[3], buf[4], buf[5], buf[7], buf[6]);
//GT5688芯片
if(buf[2] == '5' && buf[3] == '6' && buf[4] == '8'&& buf[5] == '8')
touchIC = GT5688;
}
else if (buf[5] == 0x00)
{
GTP_INFO("IC2 Version: %c%c%c_%02x%02x", buf[2], buf[3], buf[4], buf[7], buf[6]);
//GT911芯片
if(buf[2] == '9' && buf[3] == '1' && buf[4] == '1')
touchIC = GT911;
}
else if (buf[5] == '7')
{
GTP_INFO("IC3 Version: %c%c%c%c_%02x%02x", buf[2], buf[3], buf[4], buf[5], buf[7], buf[6]);
//GT9147芯片
if(buf[2] == '9' && buf[3] == '1' && buf[4] == '4' && buf[5] == '7')
touchIC = GT9147;
}
else
{
GTP_INFO("IC3 Version: %c%c%c%c_%02x%02x", buf[2], buf[3], buf[4], buf[5], buf[7], buf[6]);
//GT9157芯片
if(buf[2] == '9' && buf[3] == '1' && buf[4] == '5' && buf[5] == '7')
touchIC = GT9157;
}
return ret;
}
这个函数定义了一个8字节的buf数组，并且向它的第0和第1个元素写入产品ID寄存器的地址，然后调用复合读取函数，即可从芯片中读取这些寄存器的信息，结果使用宏GTP_INFO输出。
28.3.2.2.10. 向触控芯片写入配置参数¶
万事俱备，现在我们可以使用I2C向触摸芯片写入寄存器配置了，见 代码清单28_11。
// 4.3寸屏GT917S驱动配置
const uint8_t CTP_CFG_GT917S[] = {
0x84,0x20,0x03,0xE0,0x01,0x05,0x05,0x00,0x00,0x40,
0x00,0x0F,0x78,0x64,0x53,0x11,0x00,0x00,0x00,0x00,
0x23,0x17,0x19,0x1D,0x0F,0x04,0x00,0x00,0x00,0x00,
0x00,0x00,0x04,0x51,0x14,0x00,0x00,0x00,0x00,0x00,
0x32,0x00,0x00,0x50,0x38,0x28,0x8A,0x20,0x11,0x37,
0x39,0xA2,0x07,0x38,0x6D,0x28,0x11,0x03,0x24,0x00,
0x01,0x28,0x50,0xC0,0x94,0x02,0x00,0x00,0x53,0xB8,
0x2E,0xA2,0x35,0x8F,0x3B,0x80,0x42,0x75,0x49,0x6B,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0xF0,0x4C,0x3C,
0xFF,0xFF,0x07,0x14,0x14,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x50,0x73,
0x50,0x32,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x20,0x00,0x00,0x00,0x00,0x00,0x00,
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x1F,0x1D,0x1B,0x1A,0x19,0x18,0x17,0x16,0x15,0x09,
0x0A,0x0B,0x0C,0x0D,0x0E,0x0F,0x10,0xFF,0xFF,0xFF,
0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,
0xFF,0xFF,0x1C,0x1B,0x1A,0x19,0x18,0x17,0x15,0x14,
0x13,0x12,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,
0xFF,0xFF,0xFF,0xFF,0x00,0x00,0x05,0x00,0x00,0x0F,
0x00,0x00,0x00,0x80,0x46,0x08,0x96,0x50,0x32,0x0A,
0x0A,0x64,0x32,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
0x32,0x03,0x0C,0x08,0x23,0x00,0x14,0x23,0x00,0x28,
0x46,0x30,0x3C,0xD0,0x07,0x50,0x70,0xB0,0x01
};
/*******************************************************
Function:
Initialize gtp.
Input:
ts: goodix private data
Output:
Executive outcomes.
0: succeed, otherwise: failed
*******************************************************/
int32_t GTP_Init_Panel(void)
{
int32_t ret = -1;
int32_t i = 0;
uint16_t check_sum = 0;
int32_t retry = 0;
const uint8_t* cfg_info;
uint8_t cfg_info_len ;
uint8_t* config;
uint8_t cfg_num =0 ; //需要配置的寄存器个数
GTP_DEBUG_FUNC();
//uint8_t config[GTP_CONFIG_MAX_LENGTH + GTP_ADDR_LENGTH]
// = {GTP_REG_CONFIG_DATA >> 8, GTP_REG_CONFIG_DATA & 0xff};
I2C_Touch_Init();
ret = GTP_I2C_Test();
if (ret < 0)
{
GTP_ERROR("I2C communication ERROR!");
return ret;
}
//获取触摸IC的型号
GTP_Read_Version();
#if UPDATE_CONFIG
config = (uint8_t *)malloc (GTP_CONFIG_MAX_LENGTH + GTP_ADDR_LENGTH);
config[0] = GTP_REG_CONFIG_DATA >> 8;
config[1] = GTP_REG_CONFIG_DATA & 0xff;
//根据IC的型号指向不同的配置
if(touchIC == GT5688)
{
cfg_info = CTP_CFG_GT5688; //指向寄存器配置
cfg_info_len = CFG_GROUP_LEN(CTP_CFG_GT5688);//计算配置表的大小
}
else if(touchIC == GT917S)
{
cfg_info = CTP_CFG_GT917S; //指向寄存器配置
cfg_info_len = CFG_GROUP_LEN(CTP_CFG_GT917S);//计算配置表的大小
}
else
{//默认配置为GT917S
cfg_info = CTP_CFG_GT917S; //指向寄存器配置
cfg_info_len = CFG_GROUP_LEN(CTP_CFG_GT917S);//计算配置表的大小
}
memset(&config[GTP_ADDR_LENGTH], 0, GTP_CONFIG_MAX_LENGTH);
memcpy(&config[GTP_ADDR_LENGTH], cfg_info, cfg_info_len);
cfg_num = cfg_info_len;
GTP_DEBUG("cfg_info_len = %d ",cfg_info_len);
GTP_DEBUG("cfg_num = %d ",cfg_num);
GTP_DEBUG_ARRAY(config,6);
/*根据LCD的扫描方向设置分辨率*/
config[GTP_ADDR_LENGTH+1] = LCD_X_LENGTH & 0xFF;
config[GTP_ADDR_LENGTH+2] = LCD_X_LENGTH >> 8;
config[GTP_ADDR_LENGTH+3] = LCD_Y_LENGTH & 0xFF;
config[GTP_ADDR_LENGTH+4] = LCD_Y_LENGTH >> 8;
/*根据扫描模式设置X2Y交换*/
switch(LCD_SCAN_MODE)
{
case 0:case 2:case 4: case 6:
config[GTP_ADDR_LENGTH+6] |= (X2Y_LOC);
break;
case 1:case 3:case 5: case 7:
config[GTP_ADDR_LENGTH+6] &= ~(X2Y_LOC);
break;
}
//计算要写入checksum寄存器的值
check_sum = 0;
for (i = GTP_ADDR_LENGTH; i < (cfg_num+GTP_ADDR_LENGTH -3); i += 2)
{
check_sum += (config[i] << 8) + config[i + 1];
}
check_sum = 0 - check_sum;
GTP_DEBUG("Config checksum: 0x%04X", check_sum);
//更新checksum
config[(cfg_num+GTP_ADDR_LENGTH -3)] = (check_sum >> 8) & 0xFF;
config[(cfg_num+GTP_ADDR_LENGTH -2)] = check_sum & 0xFF;
config[(cfg_num+GTP_ADDR_LENGTH -1)] = 0x01;
//写入配置信息
for (retry = 0; retry < 5; retry++)
{
ret = GTP_I2C_Write(GTP_ADDRESS, config , cfg_num + GTP_ADDR_LENGTH+2);
if (ret > 0)
{
break;
}
}
Delay(0xfffff); //延迟等待芯片更新
#if 1 //读出写入的数据，检查是否正常写入
//检验读出的数据与写入的是否相同
{
uint16_t i;
uint8_t buf[300];
buf[0] = config[0];
buf[1] =config[1]; //寄存器地址
GTP_DEBUG_FUNC();
ret = GTP_I2C_Read(GTP_ADDRESS, buf, sizeof(buf));
GTP_DEBUG("read ");
GTP_DEBUG_ARRAY(buf,cfg_num);
GTP_DEBUG("write ");
GTP_DEBUG_ARRAY(config,cfg_num);
//不对比版本号
for(i=1;i<cfg_num+GTP_ADDR_LENGTH-3;i++)
{
if(config[i] != buf[i])
{
GTP_ERROR("Config fail ! i = %d ",i);
free(config);
return -1;
}
}
if(i==cfg_num+GTP_ADDR_LENGTH-3)
GTP_DEBUG("Config success ! i = %d ",i);
}
#endif
free(config);
#endif
/*使能中断，这样才能检测触摸数据*/
I2C_GTP_IRQEnable();
GTP_Get_Info();
return 0;
}
这段代码调用I2C_Touch_Init初始化了STM32的I2C外设，设定触控芯片的I2C设备地址，然后调用了GTP_Read_Version尝试获取触控芯片的版本号。接下来是函数的主体，它使用GTP_I2C_Write函数通过I2C把配置参数表CTP_CFG_GT917S写入到触控芯片的的配置寄存器中，注意传输中包含有checksum寄存器的值。写入完参数后调用I2C_GTP_IRQEnable以使能INT引脚检测中断。
28.3.2.2.11. INT中断服务函数¶
经过上面的函数初始化后，触摸屏就可以开始工作了，当触摸时，INT引脚会产生触摸中断，会进入中断服务函数GTP_IRQHandler，见 代码清单28_12。
void GTP_IRQHandler(void)
{ //确保是否产生了EXTI Line中断
if (__HAL_GPIO_EXTI_GET_IT(GTP_INT_GPIO_PIN) != RESET) {
LED2_TOGGLE;
GTP_TouchProcess();
__HAL_GPIO_EXTI_CLEAR_IT(GTP_INT_GPIO_PIN); //清除中断标志位
}
}
中断服务函数只是简单地调用了GTP_TouchProcess函数，它是读取触摸坐标的主体，而它又直接调用了函数Goodix_TS_Work_Func。
28.3.2.2.12. 读取坐标数据¶
Goodix_TS_Work_Func函数的内容见 代码清单28_13。
/*状态寄存器地址*/
#define GTP_READ_COOR_ADDR 0x814E
/**
* @brief 触屏处理函数，轮询或者在触摸中断调用
* @param 无
* @retval 无
*/
static void Goodix_TS_Work_Func(void)
{
uint8_t end_cmd[3] = {GTP_READ_COOR_ADDR >> 8, GTP_READ_COOR_ADDR & 0xFF, 0};
uint8_t point_data[2 + 1 + 8 * GTP_MAX_TOUCH + 1]={GTP_READ_COOR_ADDR >> 8, GTP_READ_COOR_ADDR & 0xFF};
uint8_t touch_num = 0;
uint8_t finger = 0;
static uint16_t pre_touch = 0;
static uint8_t pre_id[GTP_MAX_TOUCH] = {0};
uint8_t client_addr=GTP_ADDRESS;
uint8_t* coor_data = NULL;
int32_t input_x = 0;
int32_t input_y = 0;
int32_t input_w = 0;
uint8_t id = 0;
int32_t i = 0;
int32_t ret = -1;
GTP_DEBUG_FUNC();
ret = GTP_I2C_Read(client_addr, point_data, 12);//10字节寄存器加2字节地址
if (ret < 0)
{
GTP_ERROR("I2C transfer error. errno:%d\n ", ret);
return;
}
finger = point_data[GTP_ADDR_LENGTH];//状态寄存器数据
if (finger == 0x00) //没有数据，退出
{
return;
}
if((finger & 0x80) == 0)//判断buffer status位
{
goto exit_work_func;//坐标未就绪，数据无效
}
touch_num = finger & 0x0f;//坐标点数
if (touch_num > GTP_MAX_TOUCH)
{
goto exit_work_func;//大于最大支持点数，错误退出
}
if (touch_num > 1)//不止一个点
{
uint8_t buf[8 * GTP_MAX_TOUCH] = {(GTP_READ_COOR_ADDR + 10) >> 8, (GTP_READ_COOR_ADDR + 10) & 0xff};
ret = GTP_I2C_Read(client_addr, buf, 2 + 8 * (touch_num - 1));
memcpy(&point_data[12], &buf[2], 8 * (touch_num - 1)); //复制其余点数的数据到point_data
}
if (pre_touch>touch_num) //pre_touch>touch_num,表示有的点释放了
{
for (i = 0; i < pre_touch; i++) //一个点一个点处理
{
uint8_t j;
for(j=0; j<touch_num; j++)
{
coor_data = &point_data[j * 8 + 3];
id = coor_data[0] & 0x0F; //track id
if(pre_id[i] == id)
break;
if(j >= touch_num-1) //遍历当前所有id都找不到pre_id[i]，表示已释放
{
GTP_Touch_Up( pre_id[i]);
}
}
}
}
if (touch_num)
{
for (i = 0; i < touch_num; i++) //一个点一个点处理
{
coor_data = &point_data[i * 8 + 3];
id = coor_data[0] & 0x0F; //track id
pre_id[i] = id;
input_x = coor_data[1] | (coor_data[2] << 8); //x坐标
input_y = coor_data[3] | (coor_data[4] << 8); //y坐标
input_w = coor_data[5] | (coor_data[6] << 8); //size
{
#if 0
/*根据扫描模式更正X/Y起始方向*/
switch(LCD_SCAN_MODE)
{
case 0:case 7:
input_y = LCD_Y_LENGTH - input_y;
break;
case 2:case 3:
input_x = LCD_X_LENGTH - input_x;
input_y = LCD_Y_LENGTH - input_y;
break;
case 1:case 6:
input_x = LCD_X_LENGTH - input_x;
break;
default:
break;
}
#endif
GTP_Touch_Down( id, input_x, input_y, input_w);//数据处理
}
}
}
else if (pre_touch) //touch_ num=0 且pre_touch！=0
{
for(i=0;i<pre_touch;i++)
{
GTP_Touch_Up(pre_id[i]);
}
}
pre_touch = touch_num;
exit_work_func:
{
ret = GTP_I2C_Write(client_addr, end_cmd, 3);
if (ret < 0)
{
GTP_INFO("I2C write end_cmd error!");
}
}
}
这个函数的内容比较长，它首先是读取了状态寄存器，获当前有多少个触点，然后根据触点数去读取各个点的数据，其中还有包含有pre_touch点的处理，pre_touch保存了上一次的触点数据，利用这些数据和触点的track id号，可以确认同一条笔迹。这个读取过程完毕后，还对状态寄存器的buffer status位写0，结束读取。在实际应用中，我们并不需要掌握这个Goodix_TS_Work_Func函数的所有细节，因为在这个函数中提供了两个坐标获取接口，我们只要在这两个接口中修改即可简单地得到坐标信息。
28.3.2.2.13. 触点释放和触点按下的坐标接口¶
Goodix_TS_Work_Func函数中获取到新的坐标数据时会调用触点释放和触点按下这两个函数，我们只要在这两个函数中添加自己的坐标处理过程即可，见 代码清单28_14。
/**
* @brief 用于处理或报告触屏检测到按下
* @param
* @arg id: 触摸顺序trackID
* @arg x: 触摸的 x 坐标
* @arg y: 触摸的 y 坐标
* @arg w: 触摸的 大小
* @retval 无
*/
/*用于记录连续触摸时(长按)的上一次触摸位置，负数值表示上一次无触摸按下*/
static int16_t pre_x[GTP_MAX_TOUCH] = {-1,-1,-1,-1,-1};
static int16_t pre_y[GTP_MAX_TOUCH] = {-1,-1,-1,-1,-1};
static void GTP_Touch_Down(int32_t id,int32_t x,int32_t y,int32_t w)
{
GTP_DEBUG_FUNC();
/*取x、y初始值大于屏幕像素值*/
GTP_DEBUG("ID:%d, X:%d, Y:%d, W:%d", id, x, y, w);
/* 处理触摸按钮，用于触摸画板 */
Touch_Button_Down(x,y);
/*处理描绘轨迹，用于触摸画板 */
Draw_Trail(pre_x[id],pre_y[id],x,y,&brush);
/************************************/
/*在此处添加自己的触摸点按下时处理过程即可*/
/* (x,y) 即为最新的触摸点 *************/
/************************************/
/*prex,prey数组存储上一次触摸的位置，id为轨迹编号(多点触控时有多轨迹)*/
pre_x[id] = x;
pre_y[id] =y;
}
/**
* @brief 用于处理或报告触屏释放
* @param 释放点的id号
* @retval 无
*/
static void GTP_Touch_Up( int32_t id)
{
/*处理触摸释放,用于触摸画板*/
Touch_Button_Up(pre_x[id],pre_y[id]);
/*****************************************/
/*在此处添加自己的触摸点释放时的处理过程即可*/
/* pre_x[id],pre_y[id] 即为最新的释放点 ****/
/*******************************************/
/***id为轨迹编号(多点触控时有多轨迹)********/
/*触笔释放，把pre xy 重置为负*/
pre_x[id] = -1;
pre_y[id] = -1;
GTP_DEBUG("Touch id[%2d] release!", id);
}
以上是我们工程中对这两个接口的应用，我们把触摸画板的坐标处理过程直接放到接口里了，大家可参考我们的演示，在函数的注释部分，根据自己的应用编写坐标处理过程。
注意这两个坐标接口都还是在中断服务函数里调用的(中断服务函数调用Goodix_TS_Work_Func函数，该函数再调用这两个坐标接口)，实际应用中可以先把这些坐标信息存储起来，等待到系统空闲的时候再处理，就可以减轻中断服务程序的负担了。
28.3.2.3. main函数¶
完成了触摸屏的驱动，就可以应用了，以下我们来看工程的主体main函数，见 代码清单28_15。
int main ( void )
{
LED_GPIO_Config();
NT35510_Init (); //LCD 初始化
Debug_USART_Config();
//其中0、3、5、6 模式适合从左至右显示文字，
//不推荐使用其它模式显示文字 其它模式显示文字会有镜像效果
//其中 6 模式为大部分液晶例程的默认显示方向
NT35510_GramScan ( 3 );
/* 设定好液晶扫描方向后，再初始化触摸屏，触摸屏会根据液晶的扫描方向输出匹配的触摸坐标 */
/* 每次修改液晶扫描方向后，应重新调用一次GTP_Init_Panel函数更新触摸配置 */
GTP_Init_Panel();
printf("\r\n ********** 触摸画板程序 *********** \r\n");
printf("\r\n 若汉字显示不正常，请阅读工程中的readme.txt文件说明，根据要求给FLASH重刷字模数据\r\n");
//绘制触摸画板界面
Palette_Init(LCD_SCAN_MODE);
while ( 1 )
{
}
}
main函数初始化触摸屏、液晶屏后，调用了Palette_Init函数初始化了触摸画板应用，关于触摸画板应用的内容在“palette.c”及“palette.h”文件中，这些都是与STM32无关上层应用，感兴趣的读者可在工程中阅读，本教程就不讲解这些内容了。
28.3.3. 下载验证¶
编译程序下载到实验板，并上电复位，液晶屏会显示出触摸画板的界面，点击屏幕可以在该界面画出简单的图形。