【emWin实战教程V2.0】第5章 emWin5.xx的带OS方式移植（F429之RGB接口）

STM32

转最新版本教程
本章节将为大家介绍emWin5.xx的RTOS方式移植，不建议初学者直接学习，因为本章节涉及到的知识点很多，建议对emWin的应用有一些了解后再来看，这样将事半功倍。本章节提供的移植方法支持emWin的多图层配置，多缓冲配置以及STM32F429/439支持的8种颜色格式的实现。同时可以自适应我们生产的4.3寸，5寸和7寸的电阻屏和电容屏。
虽然本章节是以我们开发板为例进行移植的，但是教会大家如何移植到自己的板子上以及移植过程中的注意事项是本章节的重点。
5.1初学者重要提示
5.2显示屏相关的基础知识
5.3移植前的准备工作以及移植STemWin的流程
5.4第1步：下载STemWin库并添加到工程模板
5.5第2步：SDRAM驱动的实现
5.6第3步：LTDC涉及到的引脚配置和时序配置
5.7第4步：电阻屏和电容屏触摸驱动的实现
5.8第5步：STemWin底层接口和配置
5.9第6步：STemWin的RTOS方式接口文件
5.10第7步：添加STemWin应用进行测试
5.11显示屏闪烁文件解决方法
5.12 总结

lee_st · 2017-1-2 00:12:48

3、bsp分组中的文件
这个分组里面的三个文件，emWin都要间接用到。
bsp_tim_pwm.c--- 定时器驱动，显示屏的背光要用到PWM。
bsp_i2c_gpio.c--- I2C接口驱动，EEPROM，GT811，STMPE811和FT5X06都要用到，因为他们的接口都是I2C方式。
bsp_eeprom_24xx.c ---EEPROM驱动，用于存储电阻屏触摸校准参数。
4、StdPeriph_Driver分组中的文件
这个分组里面的两个文件，emWin都要间接用到。
stm32f4xx_tim.c--- 显示屏的背光是用PWM驱动的，需要用到这个定时器库文件。
stm32f4xx_ltdc.c ---LTDC相关的API函数需要用到这个库文件。

lee_st · 2017-1-2 00:13:09

5.5 第2步：SDRAM驱动的实现

（提示：本小节要实现的操作，最简单的方法是复制教程配套例子里面的SDRAM驱动到自己的工程目录进行调试修改即可，或者复制官方F429综合板子或者探索板子的SDRAM驱动进行调试修改也是可以的）
一定要保证SDRAM大批量读写数据时是正常的，SDRAM的测试可以自己专门做一个工程测试下。对于SDRAM的驱动实现，可以学习我们写的教程：http://bbs.armfly.com/read.php?tid=1942 。不管你使用的是镁光的，海力士的，三星的，ISSI的或者华邦的，基本实现方法都是一样的。
教程配套的板子使用的是镁光32位带宽的SDRAM，如果想最大限度发挥STM32F429/439驱动SDRAM的性能，强烈建议使用32位带宽的SDRAM，或者两个16位SDRAM组成32位带宽的SDRAM也是可以的。那SDRAM主要起到什么作用呢？作用有二：
1、用作显示屏的显存
STM32F429/439的LTDC外接RGB接口屏是没有显存的，所以需要SDRAM用作显存。如果用户选择STM32F429/439 LTDC的颜色格式是32位色ARGB8888，那么所需要显存大小（单位字节）是：显示屏宽 * 显示屏高 * （32/8）, 其中32/8是表示这种颜色格式的一个像素点需要4个字节来表示。又比如配置颜色格式是16位色的RGB565，那么需要的显存大小是：显示屏宽 * 显示屏高 * （16/8），其中16/8是表示这种颜色格式的一个像素点需要2个字节来表示。其它的颜色格式，依此类推。
2、用作emWin动态内存
emWin是极其消耗动态内存的，所以用户可以将SDRAM除了用于显存以外的所有内存全部用作emWin动态内存。

lee_st · 2017-1-2 00:13:28

如果SDRAM的驱动测试已经没有问题了，就可以将其添加到工程里面了，开发板使用的SDRAM驱动文件是bsp_fmc_sdram.c。

添加到工程里面后要分配SDRAM的使用，教程配套开发板使用的是16MB，32位带宽的SDRAM，图层1占用4MB，图层2占用4MB，最后8MB给emWin动态内存使用。也许会有初学者会问，每个图层分配4MB是不是有些多了？实际上不多的，因为我们要让不同的颜色格式都通用，而且要满足三缓冲对显存的需求，这里分配4MB的话，教程实例使用很方便。大家实际项目中的使用可以配置成实际大小。

lee_st · 2017-1-2 00:13:57

具体的配置如下，详情见bsp_fmc_sdram.h文件：
复制代码
/*
**********************************************************************************************************
                           LCD显存使用，共使用8MB，SDRAM容量16MB
**********************************************************************************************************
*/
/* LCD显存, 图层1, 分配4M字节 */
#define SDRAM_LCD_BUF1    EXT_SDRAM_ADDR
/* LCD显存, 图层2, 分配4M字节 */
#define SDRAM_LCD_BUF2 (EXT_SDRAM_ADDR + 4 * 1024 * 1024)
/* 仅SDRAM驱动里面的测试代码调用了 */
#define SDRAM_APP_SIZE (8 * 1024 * 1024)
/*
**********************************************************************************************************
                     emWin动态内存使用，除了显存使用的8MB，后8MB给动态内存使用
**********************************************************************************************************
*/
/* emWin动态内存首地址 */
#define SDRAM_APP_BUF    (EXT_SDRAM_ADDR + 8 * 1024 * 1024)
至此，SDRAM的驱动配置也讲解完毕。

lee_st · 2017-1-2 00:14:18

5.7 第4步：电阻屏和电容屏触摸驱动的实现

（提示：本小节要实现的操作，最简单的方法是复制教程配套例子整理好的触摸驱动文件，然后在驱动文件的基础上做修改）

5.7.1 开发板电阻触摸和电容触摸的移植方法

教程配套开发板的显示屏既有电阻屏也有电容屏，电阻屏触摸板使用的芯片是STMPE811，电容屏触摸板使用的芯片有两种，一个是FT5X06，另一个是GT811。由于开发板已经提供了这三款芯片的驱动，将其直接添加到工程中即可（这三款芯片都是I2C通信接口）。另外，特别注意一点，仅电阻屏需要触摸校准，电容屏无需校准。

上面红色方框中的6个文件是触摸相关的：
bsp_i2c_gpio.c --- I2C接口驱动，上面说到的三款触摸芯片都是I2C通信接口。
param.c --- 触摸校准时参数保存和参数加载功能的实现。
bsp_touch.c --- 触摸芯片自适应驱动，根据用户使用的触摸IC选择不同的驱动。另外，电阻屏的触摸扫描，触摸校准也是在这个文件里面实现。
bsp_gt811.c --- 电容触摸芯片GT811的驱动以及触摸扫描的实现。
bsp_ft5x06.c --- 电容触摸芯片FT5X06的驱动以及触摸扫描的实现。
TOUCH_STMPE811.c --- 电阻触摸芯片STMPE811的驱动。

lee_st · 2017-1-2 00:14:38

下面我们对这三款触摸IC做个介绍。

5.7.2  电容屏触摸IC---FT5X06

电容触摸IC都是支持多点触摸的，FT5X06支持多达10点触摸同时按下，并提供了I2C和SPI两种通信接口方式，开发板使用的是I2C通信接口。更多相关知识学习可以在这里下载FT5X06数据手册和应用手册：http://bbs.armfly.com/read.php?tid=16461 。
基于这个触摸芯片的触摸板最简单，我们开发板使用的是触摸芯片和触摸板一体的，使用时不需要配置，直接读取触摸数值即可（注意，这个芯片返回的就是实际的坐标值，比如显示屏的分辨率是800*480，那么返回的就是在这个分辨率范围内的实际坐标），读出数值后怎么跟emWin关联呢？这个是移植的关键，我们这里是通过函数GUI_PID_StoreState将FT5X06读出的实际坐标值存储到指针输入设备的FIFO中即可，默认情况下FIFO可以存储5组。具体实现代码如下（注意，我们这里并没有使用emWin支持的多点触摸功能，仅发送一个触摸值给emWin，一般情况下已经够用）：
复制代码
/*
*********************************************************************************************************
* 函数名: FT5X06_OnePiontScan
* 功能说明: FT5X06_OnePiontScan函数仅读取了电容触摸屏的一次触摸，在bsp_ts_ft5x06.h文件里面设置参数
*          #define FT5X06_TOUCH_POINTS 1
*          专门用于emWin。
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
extern GUI_PID_STATE State;
void FT5X06_OnePiontScan(void)
{
   uint8_t buf[CFG_POINT_READ_BUF];
   uint8_t i;
   static uint8_t s_tp_down = 0;
   uint16_t x, y;
   if (g_tFT5X06.Enable == 0)
   {
      return;
   }

   if (FT5X06_PenInt() == 0)
   {
      return;
   }

   FT5X06_ReadReg(2, buf, 1); //--------------（1）
/* 判断是否有触摸数据 */
   if ((buf[0] & 0x07) == 0)
   {
      if (s_tp_down == 1)
      {
            /* State.x和State.y的数值无需更新，State是全局变量，保存的就是最近一次的数值 */
            s_tp_down = 0;
            State.Pressed = 0;
            GUI_PID_StoreState(&State); /* 释放 */
      }
      return;
   }

   /* 有触摸，读取完整的数据，这里读取了一次 */
   FT5X06_ReadReg(0, buf, CFG_POINT_READ_BUF);
   for (i = 0; i < FT5X06_TOUCH_POINTS; i++)
   {
      uint8_t pointid;

      pointid = (buf[5 + 6*i]) >> 4;
      if (pointid >= 0x0f)
      {
            break;
      }
      else
      {
      g_tFT5X06.X[i] = (int16_t)(buf[3 + 6*i] & 0x0F)<<8 | (int16_t)buf[4 + 6*i];
      g_tFT5X06.Y[i] = (int16_t)(buf[5 + 6*i] & 0x0F)<<8 | (int16_t)buf[6 + 6*i];
      g_tFT5X06.Event[i] = buf[0x3 + 6*i] >> 6;
      g_tFT5X06.id[i] = (buf[5 + 6*i])>>4;
}
}
   /* 检测按下 */
   {
      if ((g_tFT5X06.ChipID == 0x55)||(g_tFT5X06.ChipID == 0xa3))    /* 4.3寸 480 * 272 */
      {
            x = g_tFT5X06.Y[0];
            y = g_tFT5X06.X[0];

            /* 判断值域 */
            if (x > 479)
            {
               x = 479;
            }

            if (y > 271)
            {
               y = 271;
            }
      }
      else if (g_tFT5X06.ChipID == 0x0A) /* 5.0寸 800 * 480 */
      {
            x = g_tFT5X06.X[0];
            y = g_tFT5X06.Y[0];

            /* 判断值域 */
            if (x > 799)
            {
               x = 799;
            }
            if (y > 479)
            {
               y = 479;
            }
      }
      else /* id == 0x06 表示7寸电容屏（FT芯片） */
      {
            x = g_tFT5X06.X[0];
            y = g_tFT5X06.Y[0];

            /* 判断值域 */
            if (x > 799)
            {
               x = 799;
            }
            if (y > 479)
            {
               y = 479;
            }
      }
   }

   if (s_tp_down == 0)  //--------------（2）
   {
      s_tp_down = 1;
      State.x = x;
      State.y = y;
      State.Pressed = 1;
      GUI_PID_StoreState(&State);
   }
   else                //--------------（3）
   {
      State.x = x;
      State.y = y;
      State.Pressed = 1;
      GUI_PID_StoreState(&State);
   }
#if 0
   for (i = 0; i < CFG_POINT_READ_BUF; i++)
   {
      printf("%02X ", buf[i]);
   }
   printf("rn");
#endif
#if 0  /* 打印5个坐标点数据 */    //--------------（4）
   printf("(%5d,%5d,%3d,%3d) ",  g_tFT5X06.X[0], g_tFT5X06.Y[0], g_tFT5X06.Event[0],  g_tFT5X06.id[0]);
   printf("(%5d,%5d,%3d,%3d) ",  g_tFT5X06.X[1], g_tFT5X06.Y[1], g_tFT5X06.Event[1],  g_tFT5X06.id[1]);
   printf("(%5d,%5d,%3d,%3d) ",  g_tFT5X06.X[2], g_tFT5X06.Y[2], g_tFT5X06.Event[2],  g_tFT5X06.id[2]);
   printf("(%5d,%5d,%3d,%3d) ",  g_tFT5X06.X[3], g_tFT5X06.Y[3], g_tFT5X06.Event[3],  g_tFT5X06.id[3]);
   printf("(%5d,%5d,%3d,%3d) ",  g_tFT5X06.X[4], g_tFT5X06.Y[4], g_tFT5X06.Event[4],  g_tFT5X06.id[4]);
   printf("rn");
#endif
}

lee_st · 2017-1-2 00:14:50

1.    从寄存器2读取一个数据，判断是否有触摸数据，如果没有触摸数据，而且变量标志s_tp_down = 1（此变量等于1表示之前处于触摸按下或者移动状态，如果等于0表示之前处于未被触摸状态），那么此时要给emWin发送触摸释放消息，这一步比较重要，切不可省略。如果变量标志s_tp_down= 0，直接退出即可。
2.    如果变量s_tp_down = 0表示之前处于未被触摸状态，这里设置此变量为1，并给emWin发送触摸按下消息和触摸坐标。
3.    如果变量不等于0（其实这里也就是1）表示之前处于按下状态，此时触摸处于移动状态，这里不用重复设置此变量了，但要给emWin发送触摸按下消息和触摸坐标（由于emWin没有移动状态标识，这里继续发送按下状态就可以）。
4.    这里预留的条件编译主要是方便调试阶段使用。

lee_st · 2017-1-2 00:15:18

5.7.3  电容屏触摸IC---GT811

电容触摸IC都是支持多点触摸的，GT811支持多达5点触摸同时按下，并提供了I2C通信接口方式，
基于这个触摸芯片的触摸板配置要麻烦些，因为要配置的寄存器非常多。具体配置就不在教程里面讲解了，大家如果有兴趣可以结合GT811数据手册研究我们提供的驱动配置。配置好GT811后，使用上基本跟FT5X06是一样的（注意，芯片GT811返回的就是实际的坐标值，比如显示屏的分辨率是800*480，那么返回的就是在这个分辨率范围内的实际坐标，跟FT5X06也是一样的）。跟emWin的关联方法也是通过函数GUI_PID_StoreState将实际坐标值存储到指针输入设备的FIFO中（注意，我们这里并没有使用emWin支持的多点触摸功能，仅发送一个触摸坐标给emWin，一般情况下已经够用）：
复制代码
/*
*********************************************************************************************************
* 函数名: GT811_OnePiontScan
* 功能说明: 读取GT811触摸数据，这里仅读取一个触摸点。
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
extern GUI_PID_STATE State;
void GT811_OnePiontScan(void)
{
   uint8_t buf[6];
   static uint8_t s_tp_down = 0;
   uint16_t x, y;

   /* 读取寄存器：0x721  R  TouchpointFlag  Sensor_ID  key  tp4  tp3  tp2  tp1  tp0 */
   GT811_ReadReg(GT811_READ_XY_REG, buf, 1); //--------------（1）

   /* 判断是否按下，没有按下，直接退出 */
   if ((buf[0] & 0x01) == 0)
   {
      if (s_tp_down == 1)
      {
            /* State.x和State.y的数值无需更新，State是全局变量，保存的就是最近一次的数值 */
            s_tp_down = 0;
            State.Pressed = 0;
            GUI_PID_StoreState(&State);
      }
      return;
   }

   /* 读取第一个触摸点0 */
   GT811_ReadReg(GT811_READ_XY_REG + 1, &buf[1], 5);

   /*
   0x721  R  TouchpointFlag  Sensor_ID  key  tp4  tp3  tp2  tp1  tp0
   0x722  R  Touchkeystate    0  0  0  0  key4  key3  key2  key1
   0x723  R  Point0Xh  触摸点 0，X 坐标高 8 位
   0x724  R  Point0Xl  触摸点 0，X 坐标低 8 位
   0x725  R  Point0Yh  触摸点 0，Y 坐标高 8 位
   0x726  R  Point0Yl  触摸点 0，Y 坐标低 8 位
   0x727  R  Point0Pressure  触摸点 0，触摸压力
   */
   g_GT811.TouchpointFlag = buf[0];
   g_GT811.Touchkeystate = buf[1];

   g_GT811.X0 = ((uint16_t)buf[2] << 8) + buf[3];
   g_GT811.Y0 = ((uint16_t)buf[4] << 8) + buf[5];

   /* 检测按下 */
   /* 坐标转换 :
      电容触摸板左下角是 (0，0);  右上角是 (479，799)
      需要转到LCD的像素坐标 (左上角是 (0，0), 右下角是 (799，479)
   */
   x = g_GT811.Y0;
   y = 479 - g_GT811.X0;

   if (s_tp_down == 0)  //--------------（2）
   {
      s_tp_down = 1;
      State.x = x;
      State.y = y;
      State.Pressed = 1;
      GUI_PID_StoreState(&State);
   }
   Else             //--------------（3）
   {
      State.x = x;
      State.y = y;
      State.Pressed = 1;
      GUI_PID_StoreState(&State);
   }
#if 0                //--------------（4）
   printf("%5d,%5d,%3drn",  g_GT811.X0, g_GT811.Y0, g_GT811.P0);
#endif
}

1.    从寄存器GT811_READ_XY_REG种读取一个数据，判断是否有触摸数据，如果没有触摸数据，而且变量标志s_tp_down = 1（此变量等于1表示之前处于触摸按下或者移动状态，如果等于0表示之前处于未被触摸状态），那么此时要给emWin发送触摸释放消息，这一步比较重要，切不可省略。如果变量标志s_tp_down= 0，直接退出即可。
2.    如果变量s_tp_down = 0表示之前处于未被触摸状态，这里设置此变量为1，并给emWin发送触摸按下消息和触摸坐标。
3.    如果变量不等于0（其实这里也就是1）表示之前处于按下状态，此时触摸处于移动状态，这里不用重复设置此变量了，但要给emWin发送触摸按下消息和触摸坐标（由于emWin没有移动状态标识，这里继续发送按下状态就可以）。
4.    这里预留的条件编译主要是方便调试阶段使用。

lee_st · 2017-1-2 00:15:49

5.7.4 电阻屏触摸IC---STMPE811

电阻触摸要比电容触摸麻烦很多，因为电阻触摸要做校准，还要做滤波，否则采集回来的触摸值会抖动或者出现飞点，出现这种情况的主要原因是电阻触摸板的线性度不够好。开发板电阻屏使用的触摸芯片是STMPE811，这个芯片其实就是12位分辨率的ADC，用来采集电阻触摸板的X轴ADC值和Y轴ADC值，然后按照一定的线性关系将ADC值转换为实际的坐标值。其中这个线性关系是通过触摸校准建立起来的，每次采集的X轴和Y轴ADC就可以代入这个线性关系，从而获得实际的坐标值。
配置好后仅需要提供读取的X轴，Y轴的ADC值以及触摸按下状态（判断STMPE811的中断输出引脚就可以了，如果有触摸，这个引脚输出低电平，反之，输出高电平。通过判断这个引脚就可以选择是否读取X轴，Y轴的ADC值，避免不必要的操作）。这些函数是独立于TOUCH_STMPE811.c文件实现的。而触摸值滤波，触摸扫描和触摸校准是在bsp_touch.c文件里面实现的。

lee_st · 2017-1-2 00:16:05

下面是判断触摸按下状态，清除触摸中断标志和X轴，Y轴的ADC值读取的API函数，这些函数被bsp_touch.c文件所调用。
复制代码
/*
*********************************************************************************************************
* 函数名: STMPE811_PenInt
* 功能说明: 判断触摸按下
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
uint8_t STMPE811_PenInt(void)  //--------------（1）
{
   if ((PORT_TP_INT->IDR & PIN_TP_INT) == 0)
   {
      return 1;
   }
   return 0;
}
/*
*********************************************************************************************************
* 函数名: STMPE811_ClearInt
* 功能说明: 清楚触笔中断
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void STMPE811_ClearInt(void)  //--------------（2）
{
   STMPE811_WriteReg1(REG811_INT_STA, 0xFF);
}
/*
*********************************************************************************************************
* 函数名: STMPE811_ReadX
* 功能说明: 读取X坐标adc
* 形参: 无
* 返回值: X坐标值adc
*********************************************************************************************************
*/
uint16_t STMPE811_ReadX(void)  //--------------（3）
{
   /* 按照 XY 读取模式，连续读取3字节数据，然后分解出X,Y
   |  byte0 |    byte1    | byte2  |
   | X[11:4], | X[3:0],Y[11:8] | Y[7:0] |
   */
   uint8_t buf[3];

#if 0
   STMPE811_ReadBytes(buf, REG811_TSC_DATA1, 3);

   s_AdcX = ((uint16_t)buf[0] << 4) | (buf[1] >> 4);
   s_AdcY = ((uint16_t)(buf[1] & 0xF) << 8) | buf[2];
#else
   if (STMPE811_ReadReg1(REG811_TSC_CTRL) & 0x80)
   {
      STMPE811_ReadBytes(buf, REG811_TSC_DATA1, 3);

      s_AdcX = ((uint16_t)buf[0] << 4) | (buf[1] >> 4);
      s_AdcY = ((uint16_t)(buf[1] & 0xF) << 8) | buf[2];

      #if 0
      /* for debug */
      {
            static int32_t s_t1 = 0;
            int32_t tt;

            tt = bsp_GetRunTime();
            if (tt - s_t1 > 1000)
            {
               printf("rn");
               s_t1 = tt;
            }
            printf("(%7d) %5d %5drn", tt, s_AdcX, s_AdcY);
      }
      #endif
   }
   else
   {
      s_AdcX = 0;
      s_AdcY = 0;
   }
#endif

   return s_AdcX;
}
/*
*********************************************************************************************************
* 函数名: STMPE811_ReadX
* 功能说明: 读取Y坐标adc
* 形参: 无
* 返回值: Y坐标值adc
*********************************************************************************************************
*/
uint16_t STMPE811_ReadY(void)  //--------------（4）
{
   return  s_AdcY;
}

1. 通过判断STMPE811的中断输出引脚的高低电平来判断触摸板是否被按下，如果有触摸，这个引脚输出低电平，反之，输出高电平。通过判断这个引脚就可以选择是否读取X轴，Y轴的ADC值，避免不必要的操作。
2. 清除触摸中断标志，检测到触摸屏未被按下时，要做清除。
3. 读取X轴ADC数值。
4. 读取Y轴ADC数值。

lee_st · 2017-1-2 00:16:25

接下来再来看bsp_touch.c文件中STMPE811触摸扫描函数的实现，电阻触摸值与emWin的关联是在触摸扫描中实现的，具体方法也是调用函数GUI_PID_StoreState将触摸坐标信息存储到指针输入设备的FIFO中：
复制代码
/*
*********************************************************************************************************
* 函数名: TOUCH_Scan
* 功能说明: 触摸板事件检测程序。该函数被周期性调用，每ms调用1次. 见 bsp_Timer.c
* 形参:  无
* 返回值: 无
*********************************************************************************************************
*/
void TOUCH_Scan(void)  //--------------（1）
{
   uint16_t usAdcX;
   uint16_t usAdcY;
   static uint16_t s_usXBuf[SAMPLE_COUNT];
   static uint16_t s_usYBuf[SAMPLE_COUNT];
   static uint8_t s_ucPos = 0;
   static uint8_t s_count = 0;
   static uint8_t s_down = 0;
   static uint16_t s_usSaveAdcX, s_usSaveAdcY; /* 用于触笔抬起事件，保存按下和移动的最后采样值 */
   static uint8_t s_ms = 0;
   if (g_GT811.Enable == 1)
   {
      GT811_Timer1ms();  /* 电容触摸屏程序计数器 */
      return;
   }

   if (g_tFT5X06.Enable == 1)
   {
      FT5X06_Timer1ms(); /* 电容触摸屏程序计数器 */
      return;
   }

   if (g_tTP.Enable == 0)
   {
      return;
   }

   if (++s_ms >= 2)          //--------------（2）
   {
      return;
   }

   /* 2ms进入一次 */
   s_ms = 0;

   /* 触笔中断发生 */
   if (STMPE811_PenInt())    //--------------（3）
   {
      /* 获得原始的ADC值，未滤波 */
      usAdcX = STMPE811_ReadX();  //--------------（4）
      usAdcY = STMPE811_ReadY();
      if (TOUCH_PressValid(usAdcX, usAdcY)) //--------------（5）
      {
            /* 按压30ms之后才开始采集数据 */
            if (s_count >= DOWN_VALID / 2)    //--------------（6）
            {
               s_usXBuf[s_ucPos] = usAdcX;
               s_usYBuf[s_ucPos] = usAdcY;
               /* 采集20ms数据进行滤波 */
               if (++s_ucPos >= SAMPLE_COUNT / 2) //--------------（7）
               {
                     s_ucPos = 0;
                     /* 对ADC采样值进行软件滤波 */
                     g_tTP.usAdcNowX = TOUCH_DataFilter(s_usXBuf, SAMPLE_COUNT / 2); //--------（8）
                     g_tTP.usAdcNowY = TOUCH_DataFilter(s_usYBuf, SAMPLE_COUNT / 2);
                     if (s_down == 0) //--------------（9）
                     {
                        s_down = 1;

                        /* 触摸按下事件 */
                        State.x = TOUCH_TransX( g_tTP.usAdcNowX, g_tTP.usAdcNowY);
                        State.y = TOUCH_TransY( g_tTP.usAdcNowX, g_tTP.usAdcNowY);
                        State.Pressed = 1;
                        GUI_PID_StoreState(&State);
                        /* 用于触笔抬起事件，保存按下和移动的最后采样值 */
                        s_usSaveAdcX = g_tTP.usAdcNowX;
                        s_usSaveAdcY = g_tTP.usAdcNowY;
                     }
                     else             //--------------（10）
                     {
                        if (TOUCH_MoveValid(s_usSaveAdcX, s_usSaveAdcY, g_tTP.usAdcNowX,
g_tTP.usAdcNowY))
                        {
                              /* 触摸移动事件 */
                              State.x = TOUCH_TransX( g_tTP.usAdcNowX, g_tTP.usAdcNowY);
                              State.y = TOUCH_TransY( g_tTP.usAdcNowX, g_tTP.usAdcNowY);
                              State.Pressed = 1;
                              GUI_PID_StoreState(&State);
                              /* 用于触笔抬起事件，保存按下和移动的最后采样值 */
                              s_usSaveAdcX = g_tTP.usAdcNowX;
                              s_usSaveAdcY = g_tTP.usAdcNowY;
                        }
                        else
                        {
                              g_tTP.usAdcNowX = 0; /* for debug stop */
                        }
                     }
               }
            }
            else
            {
               s_count++;
            }
      }
      else //--------------（11）
      {
            if (s_count > 0)
            {
               if (--s_count == 0)
               {
                     /* 触摸释放事件 */
                     /* State.x和State.y的数值无需更新，State是全局变量，保存的就是最近一次的数值 */
                     State.Pressed = 0;
                     GUI_PID_StoreState(&State);
                     s_count = 0;
                     s_down = 0;
                     g_tTP.usAdcNowX = 0;
                     g_tTP.usAdcNowY = 0;
                     STMPE811_ClearInt();       /* 清触笔中断标志 */
               }
            }
            s_ucPos = 0;
      }
   }
}

1. 此函数要每1ms被调用一次。
2. 设置每2ms进行一次STMPE811检测，也许不理解的初学者会问直接设置此函数每2ms调用一次不就好了？不可以的，因为这段代码前面还有GT811和FT5X06的程序计数器要执行，这两个是要每1ms执行一次的。但事实上，emWin并没有用到这两个程序计数器，这里仅仅是为了保持跟裸机工程（不含emWin的工程）的触摸检测一致。
3. 这个就是前面一直说的利用STMPE811的中断输出引脚的高低电平来判断触摸板是否被按下。
4. 读取X轴ADC数值和Y轴ADC数值。
5. 通过函数TOUCH_PressValid检测刚刚读取的X轴，Y轴数值是否在有效的范围内。

lee_st · 2017-1-2 00:16:43

函数TOUCH_PressValid的具体实现如下，其中全局变量g_tTP.usMaxAdc = 4095，因为电阻触摸芯片STMPE811是12位ADC，最大触摸值就是2^12 –1 = 4095。
复制代码
/* 有效ADC值的判断门限. 太接近ADC临界值的坐标认为无效 */
#define ADC_VALID_OFFSET 2
/*
*********************************************************************************************************
* 函数名: TOUCH_PressValid
* 功能说明: 判断按压是否有效，根据X, Y的ADC值进行大致判断
* 形参:  无
* 返回值: 1 表示有效； 0 表示无效
*********************************************************************************************************
*/
static uint8_t    TOUCH_PressValid(uint16_t _usX, uint16_t _usY)
{
   if ((_usX <= ADC_VALID_OFFSET) || (_usY <= ADC_VALID_OFFSET)
      || (_usX >= g_tTP.usMaxAdc - ADC_VALID_OFFSET)
      || (_usY >= g_tTP.usMaxAdc - ADC_VALID_OFFSET))
   {
      return 0;
   }
   else
   {
      return 1;
   }
}

6. DOWN_VALID的宏定义是
   #define DOWN_VALID          30
由于是每2ms进行一次检测，这里就表示延迟30ms后进行触摸数据采集。延迟30ms是为了消除触摸抖动。
7. SAMPLE_COUNT 的宏定义是
   #define SAMPLE_COUNT 20
   由于是每2ms进行一次检测，这里就表示采集够10组数据，即20ms后进行下一步操作。
8. 对X轴和Y轴的ADC数值都进行软件滤波。软件滤波函数TOUCH_DataFilter的实现方法是对10组数值由小到大进行排序，对第3个，第4个和第5个数值求和，然后求平均，将平均值作为最终的ADC数值。
9. 变量标识s_down = 0表示触摸之前是未按下状态，在此条件里面设置s_down = 1表示触摸已经按下，并通过函数TOUCH_TransX（这个函数比较关键，是通过触摸校准函数得到的一个线性关系）将当前的X轴和Y轴ADC数值转换成实际的坐标值，然后调用函数GUI_PID_StoreState将当前的坐标信息存储到指针输入设备的FIFO里面。
10.  设置变量标识s_down = 1后会进入此条件里面，在这个条件里面通过函数TOUCH_MoveValid判断当前是否是有效的移动，如果是，就继续调用函数GUI_PID_StoreState将当前的坐标信息存储到指针输入设备的FIFO里面，如果不是，就设置全局变量g_tTP.usAdcNowX = 0。
11.  如果通过STMPE811的中断输出引脚检测到触摸未按下，然后判断变量s_count是否大于0，如果大于0的话，做减减运算，算是做了一个松手延迟，防止抖动。减到0的时候，将触摸未按下或者说触摸释放消息通过函数GUI_PID_StoreState存储到指针输入设备的FIFO里面。

lee_st · 2017-1-2 00:17:47

5.7.5  电阻屏触摸校准

   由于不同电阻触摸板的线性度参差不齐，不能直接采用比例关系将电阻触摸芯片STMPE811的返回值通过比例关系转换成实际的坐标。比如我们操作的显示屏分辨率是800*480，电阻触摸芯片采用STMPE811（12位ADC，触摸值范围0-4095），获得当前的触摸值是（1024, 2048），按照比例关系转换成坐标值就是(1024*800/4096，2048*800/4096)，即（200，400），采用这种方法效果不好，容易出现点击不准确的问题。
   鉴于此原因，要通过触摸校准在ADC数值和显示屏分辨率之间建立一个新的线性关系，简单的说就是由比例关系y = ax升级为y = ax + b。如果有了新的触摸ADC数值，代入这个线性关系里面就可以得到当前实际的坐标值，触摸校准的作用就在这里了。
   另外，emWin本身也是支持两点触摸校准的，后来测试发现自带的这种校准与国内厂商生产的电阻屏配套，效果不够理想，容易出现飞点。现在修改为我们自己实现的4点触摸校准，效果好了很多，基本已经没有飞点了。具体触摸校准的实现，我们这里暂时不做讲解了，因为做的稍有些复杂，不太容易讲解清楚，后面再次升级emWin教程时，会结合我们F407板子的电阻触摸芯片TSC2046和RA8875自带的电阻触摸统一讲解。如果大家有兴趣的话，可以研究代码的实现。
   电阻触摸校准的校准方法在第66章，附件A有讲解。

lee_st · 2017-1-2 00:18:21

5.7.6  不同触摸IC的识别方法

   开发板配套了不同触摸IC的显示屏，所以要做区分，区分方法也比较简单，因为三款芯片GT811，FT5X06和STMPE811都是I2C接口，通过I2C地址就区分开了，具体代码如下：
复制代码
/*
*********************************************************************************************************
* 函数名: bsp_DetectLcdType
* 功能说明: 通过I2C触摸芯片，识别LCD模组类型。结果存放在全局变量 g_LcdType 和 g_TouchType
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void bsp_DetectLcdType(void)
{
   uint8_t i;

   g_TouchType = 0xFF;
   g_LcdType = 0xFF;

   /* 50ms，等待GT811复位就绪，才能探测GT811芯片 ID */
   for (i = 0; i < 5; i++)
   {
      /*
            GT811电容触摸, 有 800 * 480 和 1024 * 600 两种分辨率（根据GT811的 Sensor ID识别（有3个状态）
            GT811 的从设备地址有三组可选，以方便主控调配。三组地址分别为：0xBA/0xBB、0x6E/0x6F和0x28/0x29
      */
      if (i2c_CheckDevice(GT811_I2C_ADDR1) == 0) //--------------（1）
      {
            g_GT811.i2c_addr = GT811_I2C_ADDR1;
            g_TouchType = CT_GT811;
            g_LcdType = LCD_70_800X480;
            touch_printf("检测到7.0寸电容触摸屏 800x480rn");
            break;
      }
      if (i2c_CheckDevice(GT811_I2C_ADDR3) == 0)  //--------------（2）
      {
            g_GT811.i2c_addr = GT811_I2C_ADDR3;
            g_TouchType = CT_GT811;
            g_LcdType = LCD_70_1024X600;
            touch_printf("检测到7.0寸电容触摸屏 1024x600rn");
            break;
      }

      /* FT系列电容触摸触摸 : 4.3寸id = 0x55 5.0寸id = 0x0A  7.0寸id = 0x06 */
      if (i2c_CheckDevice(FT5X06_I2C_ADDR) == 0) //--------------（3）
      {
            uint8_t id;

            bsp_DelayMS(100);                   //--------------（4）

            id = FT5X06_ReadID();                //--------------（5）
            if (id == 0x55)
            {
               g_TouchType = CT_FT5X06;
               g_LcdType = LCD_43_480X272;
               touch_printf("检测到4.3寸电容触摸屏rn");
            }
            else if (id == 0x0A)
            {
               g_TouchType = CT_FT5X06;
               g_LcdType = LCD_50_800X480;
               touch_printf("检测到5.0寸电容触摸屏rn");
            }
            else /* id == 0x06 表示7寸电容屏（FT芯片） */
            {
               g_TouchType = CT_FT5X06;
               g_LcdType = LCD_70_800X480;
               touch_printf("检测到7.0寸电容触摸屏rn");
            }
            break;
      }
      /* 电阻触摸板 */
      if (i2c_CheckDevice(STMPE811_I2C_ADDRESS) == 0) //--------------（6）
      {
            /*
               0  = 4.3寸屏（480X272）
               1  = 5.0寸屏（480X272）
               2  = 5.0寸屏（800X480）
               3  = 7.0寸屏（800X480）
               4  = 7.0寸屏（1024X600）
               5  = 3.5寸屏（480X320）
            */
            uint8_t id;

            g_TouchType = CT_STMPE811;  /* 触摸类型 */

            STMPE811_InitHard(); /* 必须先配置才能读取ID */

            id = STMPE811_ReadIO(); /* 识别LCD硬件类型 */       //--------------（7）
            touch_printf("检测到电阻触摸屏, id = %drn", id);
            switch (id)
            {
               case 0:
                     g_LcdType = LCD_43_480X272;
                     break;
               case 1:
                     g_LcdType = LCD_50_480X272;
                     break;
               case 2:
                     g_LcdType = LCD_50_800X480;
                     break;
               case 3:
                     g_LcdType = LCD_70_800X480;
                     break;
               case 4:
                     g_LcdType = LCD_70_1024X600;
                     break;
               case 5:
                     g_LcdType = LCD_35_480X320;
                     break;

               default:
                     g_LcdType = LCD_35_480X320;
                     break;
            }
            break;
      }

      bsp_DelayMS(10); //--------------（6）
   }

   if (i == 5)
   {
      touch_printf("未识别出显示模块rn");
   }
}

1. 通过GT811的I2C地址GT811_I2C_ADDR1检测是否是7寸800*480分辨率显示屏。
2. 通过GT811的I2C地址GT811_I2C_ADDR3检测是否是7寸1024*600分辨率显示屏。
3. 通过FT5X06的I2C地址FT5X06_I2C_ADDR检查携带此触摸IC的显示屏。
4. 这个延迟函数千万不可以省略，如果这个延迟省略了，FT5X06后面的通信会有问题。加上这个延迟后才正常，估计是因为上电后，FT5X06需要等待一段时间才能进入稳定状态，比如自动的触摸校准是需要时间的。
5. 通过函数FT5X06_ReadID返回的ID号可以识别基于此芯片的4.3寸，5寸和7寸触摸屏。
6. 通过STMPE811的I2C地址STMPE811_I2C_ADDR检查携带此触摸IC的显示屏。
7. 通过函数STMPE811_ReadIO返回的硬件IO状态可以识别基于此芯片的3.5寸480*320分辨率显示屏，4.3寸480*272分辨率显示屏，5寸480*272和800*480分辨率显示屏以及7寸800*480和1024*600分辨率显示屏。
8. 这个延迟函数也千万不要省略，如果这个延迟省略了，GT811后面的通信会有问题。加上这个延迟后才正常，估计是因为上电后，GT811需要等待一段时间才能进入稳定状态，比如自动的触摸校准是需要时间的。这个跟FT5X06是一样的。

lee_st · 2017-1-2 00:18:45

5.7.7  周期性调用触摸扫描函数

   三款触摸芯片都是使用查询方式做的触摸扫描，只是扫描周期不一样，具体实现是将电容触摸GT811为20ms调用一次，电容触摸FT5X06设置为10ms调用一次，而电阻触摸STMPE811设置为1ms调用一次，调用方法是将触摸扫描函数放在uCOS-III的启动任务里面实现，启动任务的代码如下：
复制代码
/*
*********************************************************************************************************
* 函数名: AppTaskStart
* 功能说明: 这是一个启动任务，在多任务系统启动后，必须初始化滴答计数器。本任务主要实现按键和触摸检测。
* 形参: p_arg 是在创建该任务时传递的形参
* 返回值: 无
   优先级: 2
*********************************************************************************************************
*/
static  void  AppTaskStart (void *p_arg)  //--------------（1）
{
   OS_ERR    err;
   uint8_t  ucCount = 0;
   uint8_t  ucCount1 = 0;

/* 仅用于避免编译器告警，编译器不会产生任何目标代码 */
(void)p_arg;

   /* BSP 初始化。 BSP = Board Support Package 板级支持包，可以理解为底层驱动。*/
   CPU_Init();  /* 此函数要优先调用，因为外设驱动中使用的us和ms延迟是基于此函数的 */
   bsp_Init();
   BSP_Tick_Init();

#if OS_CFG_STAT_TASK_EN > 0u
   OSStatTaskCPUUsageInit(&err);
#endif
#ifdef CPU_CFG_INT_DIS_MEAS_EN
CPU_IntDisMeasMaxCurReset();
#endif

   /* 创建应用程序的任务 */
   AppTaskCreate();

   /* 创建任务通信 */
   AppObjCreate();

while(1)
{
      /* 1ms一次触摸扫描，电阻触摸屏 */
      if(g_tTP.Enable == 1)  //--------------（2）
      {
            TOUCH_Scan();

            /* 按键扫描 */
            ucCount++;
            if(ucCount == 10)
            {
               ucCount = 0;
               bsp_KeyScan();
            }
         OSTimeDly(1, OS_OPT_TIME_DLY, &err);
      }

      /* 20ms一次触摸扫描，电容触摸屏GT811
         GT811取20ms比较稳定，取10ms偶尔会有跳动。
      */
      if(g_GT811.Enable == 1)  //--------------（3）
      {
            bsp_KeyScan();
            ucCount1++;
            if(ucCount1 == 2)
            {
               ucCount1 = 0;
               GT811_OnePiontScan();
            }
         OSTimeDly(10, OS_OPT_TIME_DLY, &err);
      }

      /* 10ms一次触摸扫描，电容触摸屏FT5X06 */
      if(g_tFT5X06.Enable == 1)  //--------------（4）
      {
            bsp_KeyScan();
            FT5X06_OnePiontScan();
         OSTimeDly(10, OS_OPT_TIME_DLY, &err);
      }
}
}

1. 启动任务。
2. 电阻屏STMPE811的扫描函数。变量g_tTP.Enable的使能是通过用户调用了初始化函数bsp_DetectLcdType()和TOUCH_InitHard()来实现的。

lee_st · 2017-1-2 00:19:12

其中函数bsp_DetectLcdType用来识别不同的显示屏，函数TOUCH_InitHard根据识别出的显示屏在函数内部将g_tTP.Enable设置为1。
复制代码
/*
*********************************************************************************************************
* 函数名: TOUCH_InitHard
* 功能说明: 初始化触摸芯片。再之前，必须先执行 bsp_DetectLcdType() 识别触摸出触摸芯片型号.
* 形参: 无
* 返回值: 无
*********************************************************************************************************
*/
void TOUCH_InitHard(void)
{
g_tTP.Enable = 0;

   /* 默认是发给图层1，如果是发给图层2，请修改Layer参数为1 */
   State.Layer = 0;

   switch (g_TouchType)
   {
      case CT_GT811:             /* 电容触摸 7寸 */
            GT811_InitHard();
            break;

      case CT_FT5X06:          /* 电容触摸 4.3寸 */
            FT5X06_InitHard();
            break;

      case CT_STMPE811:    /* 电阻的 */
            //STMPE811_InitHard(); < bsp_DetectLcdType() 内部已经执行初始化
            g_tTP.usMaxAdc = 4095; /* 12位ADC */

            TOUCH_LoadParam(); /* 读取校准参数 */
            g_tTP.Write = g_tTP.Read = 0;
            g_tTP.Enable = 1;
            break;

      default:
            break;
   }
}

注意上面代码中置红的两个语句。
   State是全局的结构体变量，如果设置State.Layer = 0表示给图层1发送触摸坐标信息。如果设置State.Layer = 1表示给图层2发送触摸坐标信息。
   函数TOUCH_LoadParam用于从板载的EEPROM中加载触摸参数。
3. 电容屏GT811的扫描函数。变量g_GT811.Enable的使能是通过用户调用了初始化函数bsp_DetectLcdType()和TOUCH_InitHard()来实现的。其中函数bsp_DetectLcdType用来识别不同的显示屏，函数TOUCH_InitHard根据识别出的显示屏调用GT811的初始化函数GT811_InitHard，在这个函数里面设置变量g_GT811.Enable = 1。
4. 电容屏FT5X06的扫描函数。变量g_tFT5X06.Enable的使能是通过用户调用了初始化函数bsp_DetectLcdType()和TOUCH_InitHard()来实现的。其中函数bsp_DetectLcdType用来识别不同的显示屏，函数TOUCH_InitHard根据识别出的显示屏调用FT5X06的初始化函数FT5X06_InitHard，在这个函数里面设置变量g_tFT5X06.Enable = 1。

lee_st · 2017-1-2 00:19:27

5.7.8 如何将触摸驱动移植到自己的板子

通过前面的讲解，移植触摸驱动到自己的板子上，最简单的办法是将开发板与触摸相关的文件全部移植过来，然后在这些文件的基础上进行修改。下面分两种情况进行说明：
1、电容屏触摸的移植比较简单，如果用户用的触摸IC跟开发板一样，直接拿来用即可，如果不一样，需要先将触摸IC的驱动实现，然后按照开发板提供的GT811或者FT5X06的触摸扫描函数，照葫芦画瓢实现一个即可。
2、电阻屏的移植稍麻烦些，如果用户用的触摸IC跟开发板一样，直接拿来用即可，如果不一样，需要先将触摸IC的驱动实现，然后仿照TOUCH_STMPE811.c文件提供触摸按下状态函数，X轴，Y轴的ADC数值读取函数和清除触摸中断标志函数。最后用重新实现的这几个函数替换bsp_touch.c文件中的原函数即可。另外要注意一点，这种方式实现后，虽然触摸校准依然可以使用，但是开发板的触摸校准参数是保存在EEPROM中的，用户可以根据自己的实际情况选择存储介质。另外，触摸参数的保存和读取在param.c文件实现。
3、如果大家不想用开发板实现的方案，想自己重新实现一个，也是没问题的，注意跟emWin关联的方式，即函数GUI_PID_StoreState的使用。

lee_st · 2017-1-2 00:19:44

5.8  第5步：STemWin底层接口函数和配置

STemWin的底层接口函数和配置的实现在我们第1步中添加的GUIConf.c及其头文件和LCDConf_Lin_Template.c及其头文件里面。下面我们把这四个文件分别做个介绍。

5.8.1  GUIConf.c文件

GUIConf.c文件主要实现系统动态内存的配置，我们在官方代码的基础上做了下修改，添加了一个宏定义，方便用户选择使用内部SRAM还是外部SDRAM作为emWin的动态内存：
复制代码
#include "GUI.h"
#include "bsp.h"
/*********************************************************************
*
*    Defines
*
**********************************************************************
*/
//
// Define the available number of bytes available for the GUI
//
#define EX_SRAM 1/*1 used extern sram, 0 used internal sram */ //--------------（1）
#if EX_SRAM
#define GUI_NUMBYTES  (1024*1024*8)
#else
#define GUI_NUMBYTES  (100*1024)
#endif
/* Define the average block size */
#define GUI_BLOCKSIZE 0x80       //--------------（2）
/*********************************************************************
*
*    Public code
*
**********************************************************************
*/
/*********************************************************************
*
*    GUI_X_Config
*
* Purpose:
* Called during the initialization process in order to set up the
* available memory for the GUI.
*/
void GUI_X_Config(void)
{
#if EX_SRAM                                  //--------------（3）
   static U32 *aMemory;
   aMemory = (U32 *)SDRAM_APP_BUF;

   /*  Assign memory to emWin */
   GUI_ALLOC_AssignMemory(aMemory, GUI_NUMBYTES);
   GUI_ALLOC_SetAvBlockSize(GUI_BLOCKSIZE);
#else                                        //--------------（4）
   /* 32 bit aligned memory area */
   static U32 aMemory[GUI_NUMBYTES / 4];

   /*  Assign memory to emWin */
   GUI_ALLOC_AssignMemory(aMemory, GUI_NUMBYTES);
   GUI_ALLOC_SetAvBlockSize(GUI_BLOCKSIZE);
#endif
}

1.    通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
   #define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小8MB。具体大小是由宏定义#define GUI_NUMBYTES (1024*1024*8)来设置的。
   #define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。具体大小是由宏定义#define GUI_NUMBYTES (100*1024)来设置的。
   默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
2. 配置使用外部SDRAM作为emWin动态内存，其中SDRAM_APP_BUF是emWin动态内存的首地址。通过函数GUI_ALLOC_AssignMemory为emWin分配动态内存，注意第二个参数的单位是字节。
   通过函数GUI_ALLOC_SetAvBlockSize配置内存块大小，官方手册推荐的大小范围是32字节到1024字节，一般情况下取0x80，即128字节即可。
3. 配置使用内部SRAM作为emWin动态内存。其中定义的静态局部变量数组就是emWin动态内存。
   static U32 aMemory[GUI_NUMBYTES / 4];

lee_st · 2017-1-2 00:20:37

5.8.2  GUIConf.h文件

这个文件主要是默认的系统配置，代码如下：
复制代码
#ifndef GUICONF_H
#define GUICONF_H
/*********************************************************************
*
*    Multi layer/display support
*/
#define GUI_NUM_LAYERS          2 // Maximum number of available layers //--------------（1）
/*********************************************************************
*
*    Multi tasking support
*/
#define GUI_OS                   1 // Compile with multitasking support //--------------（2）
/*********************************************************************
*
*    Configuration of touch support
*/
#define GUI_SUPPORT_TOUCH       1 // Support a touch screen (req. win-manager) //--------------（3）
/*********************************************************************
*
*    Default font
*/
#define GUI_DEFAULT_FONT       &GUI_Font6x8
/*********************************************************************
*
*       Configuration of available packages
*/
#define GUI_SUPPORT_MOUSE 1 // Mouse support             //--------------（4）
#define GUI_WINSUPPORT    1 // Use Window Manager       //--------------（5）
#define GUI_SUPPORT_MEMDEV 1 // Use Memory Devices       //--------------（6）
#define GUI_SUPPORT_DEVICES  1 // Enable use of device pointers //--------------（7）
#endif  // Avoid multiple inclusion

1.    设置最大支持的图层数为2。
2.    设置支持OS，因为我们是RTOS移植方式，这里配置为0就表示不支持，配置为1表示支持。
3.    设置支持触摸屏，配置为0表示不支持，配置为1表示支持。
4.    设置支持鼠标，配置为0表示不支持，配置为1表示支持。
5.    设置支持窗口管理器，配置为0表示不支持，配置为1表示支持。
6.    设置支持存储设备，配置为0表示不支持，配置为1表示支持。
7.    设置支持设备指针，配置为0表示不支持，配置为1表示支持。

lee_st · 2017-1-2 00:20:56

5.8.3  LCDConf_Lin_Template.c文件

毫不夸张的说，这个文件是STemWin移植过程中最重要的文件，主要配置了STemWin的显示尺寸，显示驱动，颜色转换以及底层优化都是在这个文件实现的。当前这个驱动文件已经做得比较成熟完善了，为了完善这个驱动耗费了很多精力（这个驱动是由官方的驱动修改而来）。STemWin支持的多缓冲，多图层和STM32F429/439支持的8种颜色格式都可以任意配置。
如果用户要使用这个文件配置自己的显示屏，直接拿去使用即可，唯一要做的就是根据自己的显示屏和项目需求来设置宏定义以及显示屏背光设置函数LCD_SetBackLight（这个函数要自己实现，教程提供的例子是在bsp_tft_lcd.c文件中实现），别的什么都不用修改。
供用户使用的12项宏定义，注释已经非常详细，默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层：
复制代码
/*
**********************************************************************************************************
                                       用户可以配置的选项
**********************************************************************************************************
*/
/* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
#define emWin_Optimize 0
/*
  1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
   这里填写自适应显示屏中的最大分辨率。
*/
#define XSIZE_PHYS    800
#define YSIZE_PHYS    480
/* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
#define NUM_BUFFERS    3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
#define NUM_VSCREENS    1 /* 定义虚拟屏个数 */
/* 3. 没有图层激活时，背景色设置, 暂时未用到 */
#define BK_COLOR       GUI_DARKBLUE
/*
4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
   (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
   (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
         用户需要根据自己的使用情况设置如下两个地方。
         a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
            给图层2发送触摸值。
         b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
*/
#undef  GUI_NUM_LAYERS
#define GUI_NUM_LAYERS 1
/*
5. 设置图层1和图层2对应的显存地址
   (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
   (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
   (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
   (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
         如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
         XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS

         颜色模式 = 24位色RGB888，显存的大小：
         XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS

         颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
         XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
         颜色模式 = 8位色L8，AL44，那么显存的大小就是：
         XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS

   这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
   对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
   图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
      举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
   800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。

   (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
      使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
*/
#define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
#define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
NUM_BUFFERS)
/*
6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
   特别注意如下两个问题：
   (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
         请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
         a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
         b. 480*272分辨率的可以高些，取20MHz左右即可。
   (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
*/
#define _CM_ARGB8888    1
#define _CM_RGB888       2
#define _CM_RGB565       3
#define _CM_ARGB1555    4
#define _CM_ARGB4444    5
#define _CM_L8          6
#define _CM_AL44       7
#define _CM_AL88       8
/* 7. 配置图层1的颜色模式和分辨率大小 */
#define COLOR_MODE_0    _CM_RGB565
#define XSIZE_0          XSIZE_PHYS
#define YSIZE_0          YSIZE_PHYS
/* 8. 配置图层2的的颜色模式和分辨率大小 */
#define COLOR_MODE_1    _CM_RGB565
#define XSIZE_1          XSIZE_PHYS
#define YSIZE_1          YSIZE_PHYS
/* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
#if (COLOR_MODE_0 == _CM_ARGB8888)
  #define COLOR_CONVERSION_0 GUICC_M8888I
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_32
#elif (COLOR_MODE_0 == _CM_RGB888)
  #define COLOR_CONVERSION_0 GUICC_M888
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_24
#elif (COLOR_MODE_0 == _CM_RGB565)
  #define COLOR_CONVERSION_0 GUICC_M565
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_ARGB1555)
  #define COLOR_CONVERSION_0 GUICC_M1555I
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_ARGB4444)
  #define COLOR_CONVERSION_0 GUICC_M4444I
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_16
#elif (COLOR_MODE_0 == _CM_L8)
  #define COLOR_CONVERSION_0 GUICC_8666
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_8
#elif (COLOR_MODE_0 == _CM_AL44)
  #define COLOR_CONVERSION_0 GUICC_1616I
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_8
#elif (COLOR_MODE_0 == _CM_AL88)
  #define COLOR_CONVERSION_0 GUICC_88666I
  #define DISPLAY_DRIVER_0 GUIDRV_LIN_16
#else
  #error Illegal color mode 0!
#endif
/* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
#if (GUI_NUM_LAYERS > 1)
#if (COLOR_MODE_1 == _CM_ARGB8888)
  #define COLOR_CONVERSION_1 GUICC_M8888I
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_32
#elif (COLOR_MODE_1 == _CM_RGB888)
  #define COLOR_CONVERSION_1 GUICC_M888
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_24
#elif (COLOR_MODE_1 == _CM_RGB565)
  #define COLOR_CONVERSION_1 GUICC_M565
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_ARGB1555)
  #define COLOR_CONVERSION_1 GUICC_M1555I
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_ARGB4444)
  #define COLOR_CONVERSION_1 GUICC_M4444I
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_16
#elif (COLOR_MODE_1 == _CM_L8)
  #define COLOR_CONVERSION_1 GUICC_8666
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_8
#elif (COLOR_MODE_1 == _CM_AL44)
  #define COLOR_CONVERSION_1 GUICC_1616I
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_8
#elif (COLOR_MODE_1 == _CM_AL88)
  #define COLOR_CONVERSION_1 GUICC_88666I
  #define DISPLAY_DRIVER_1 GUIDRV_LIN_16
#else
  #error Illegal color mode 1!
#endif
#else
#undef XSIZE_0
#undef YSIZE_0
#define XSIZE_0    XSIZE_PHYS
#define YSIZE_0    YSIZE_PHYS
#endif
/*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
#ifndef XSIZE_PHYS
  #error Physical X size of display is not defined!
#endif
#ifndef YSIZE_PHYS
  #error Physical Y size of display is not defined!
#endif
#ifndef NUM_VSCREENS
  #define NUM_VSCREENS 1
#else
  #if (NUM_VSCREENS <= 0)
#error At least one screeen needs to be defined!
  #endif
#endif
#if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
  #error Virtual screens and multiple buffers are not allowed!
#endif

搜索历史

【emWin实战教程V2.0】第5章 emWin5.xx的带OS方式移植（F429之RGB接口）

相关推荐

53 条评论

评论

精选推荐

热门帖

浏览过的版块

站长推荐 /7