【emWin实战教程V2.0】第39章窗口管理器之定时器使用

转最新版本教程

转最新版本教程
本期教程为大家讲解窗口管理器之定时器使用方法，这个定时器使用起来比较简单，而且很实用，以后的项目工程中很多时候要用到，不过使用时有些小问题要特别注意，如果不注意的话，定时器将无法正确启动。
      39.1  初学者重要提示
      39.2 定时器功能介绍
      39.3 桌面窗口上使用定时器实例
      39.4 对话框上使用定时器实例
      39.5 实验例程说明（RTOS）
      39.6 实验例程说明（裸机）
      39.7 总结

lee_st · 2017-2-20 18:42:24

39.1  初学者重要提示

u  特别注意定时器使用时的注意事项，在本章39.2小节详细讲解了，要不定时器无法正确启动。然后再结合本章教程给出的实例进行学习。
u  窗口管理器这块的API函数应该是emWin手册所有章节中函数最多的，定时器的API函数也属于这部分。下图是中文版手册里面API函数位置：

lee_st · 2017-2-20 18:42:36

下图是英文版手册里面API函数的位置：

lee_st · 2017-2-20 18:42:50

39.2定时器功能介绍

STemWin中有四个定时器相关的API函数供用户调用。

这四个函数都是简单易用，不过使用时有些问题还是要注意下，要不无法正确启动，初学者也是经常在这几个点犯错误，导致配置了定时器，却没有效果。

lee_st · 2017-2-20 18:43:01

1、WM_HTIMERWM_CreateTimer(WM_HWIN hWin, int UserId, int Period, int Mode)
      此函数用于创建定时器，注意，这个函数创建的定时器是单次的，也是说定时器时间到后定时器就不再工作了，如果还想继续使用，务必要在窗口回调函数的定时器消息WM_TIMER里面调用函数WM_RestartTimer重启此定时器。
      第1个参数 hWin填写窗口的句柄，即给那个窗口创建定时器。这个参数比较关键，很多初学者经常在这个参数上犯错误。如果是给对话框创建定时器，且对话框的主体是框架窗口FrameWin或者直接给框架窗口FrameWin创建定时器，此参数必须要使用函数WM_GetClientWindow获得框架窗口的客户区，这一点非常重要。如果对话框的主体是Windows或者直接给Windows窗口创建定时器，无需使用函数WM_GetClientWindow了，直接填句柄就可以了。
      第2个参数UserId填写此定时器的ID，设置ID的目的是方便同一个窗口创建了多个定时器的话，可以用来区分是哪个定时器。
      第3个参数Period是定时器周期，确切的说是溢出时间更贴切，因为此定时器不是自动重启的，仅执行一次，时间到后会给定时器所在窗口的回调函数发送WM_TIMER消息，如果要重新启动需要在此消息里面调用函数WM_RestartTimer重新启动。
      第4个参数暂时保留，未被使用。

lee_st · 2017-2-20 18:43:12

2、void WM_DeleteTimer(WM_HTIMERhTimer)
此函数用于定时器删除，参数是定时器句柄（即调用函数WM_CreateTimer的返回值）。

lee_st · 2017-2-20 18:43:20

3、intWM_GetTimerId(WM_HTIMER hTimer);
此函数用于获得定时器ID，参数是定时器句柄（即调用函数WM_CreateTimer的返回值）。

lee_st · 2017-2-20 18:43:33

4、voidWM_RestartTimer(WM_HTIMER hTimer, int Period)
      此函数用于重启定时器。
      第1个参数是定时器句柄，即调用函数WM_CreateTimer的返回值。
      第2个参数是重新配置定时器的溢出时间。
-----------------
讲解完这些，也许初学者还有些模糊，没有关系，且看下面举的几个例子，看完后基本就都理解了。

lee_st · 2017-2-20 18:43:53

39.3桌面窗口上使用定时器实例

      这个Demo主要是实现每隔1000ms改变一次桌面窗口的颜色，源代码如下（可以将其直接的复制到开发板或者模拟器上面运行）。
#include "DIALOG.h"

/*
*********************************************************************************************************
*                                       变量
*********************************************************************************************************
*/
GUI_COLOR _acColor[3] = {GUI_BLUE,GUI_RED,GUI_YELLOW};  //--------------（1）
static  char ucBackColor;

/*
*********************************************************************************************************
*    函数名: _cbBkWindow
*    功能说明: 桌面窗口回调函数
*    形    参: 无
*    返回值: 返回对话框句柄
*********************************************************************************************************
*/
static void _cbBkWindow(WM_MESSAGE * pMsg)
{
    WM_HWIN hWin = pMsg->hWin;

    switch (pMsg->MsgId)
    {
         /* 重绘消息 */
         case WM_PAINT:  //--------------（2）
              ucBackColor++;
              if (ucBackColor == 3)
              {
                   ucBackColor = 0;
              }
              GUI_SetBkColor(_acColor[ucBackColor]);
              GUI_Clear();
            break;

         /* 定时器消息 */
         case WM_TIMER: //--------------（3）
              WM_InvalidateWindow(hWin);
              WM_RestartTimer(pMsg->Data.v, 1000);
            break;

        default:
            WM_DefaultProc(pMsg);
    }
}

/*
*********************************************************************************************************
*    函数名: MainTask
*    功能说明: GUI主函数
*    形    参: 无
*    返回值: 无
*********************************************************************************************************
*/
void MainTask(void)
{
     WM_HTIMER hTimer;

     /* 初始emWin */
     GUI_Init();

     /* 设置桌面窗口回调函数 */
     WM_SetCallback(WM_HBKWIN, _cbBkWindow); //--------------（4）

     /* 为桌面窗口创建定时器，定时器溢出时间1000ms */
     hTimer = WM_CreateTimer(WM_HBKWIN, 0, 1000, 0); //--------------（5）

     while (1)
     {
         GUI_Delay(10);
     }
}

lee_st · 2017-2-20 18:44:05

1.    定义一个数组，里面有三种颜色，再定义一个变量，用于三种颜色的切换。
2.    桌面窗口回调函数的重绘消息，每执行一次更新一次背景色。
3.    定时器消息，这里要特别注意，如果想要定时器周期性执行，而不是只执行一次，必须得调用重启定时器函数WM_RestartTimer()。在这个消息里面将桌面窗口无效，从而会触发窗口管理器去执行WM_PAINT消息，这样就实现了定时修改桌面窗口背景色。
4.    设置桌面窗口的回调函数。
5.    创建定时器函数，溢出时间是1000ms。

lee_st · 2017-2-20 18:44:17

这个Demo的实际显示效果如下：

lee_st · 2017-2-20 18:44:41

39.4 对话框上使用定时器实例

      这个Demo的主要功能是在对话框上面实现一个计数功能，每100ms更新一次，下面是源码（可以将其直接的复制到开发板或者模拟器上面运行）
#include "DIALOG.h"
#include "stdio.h"

/*
*********************************************************************************************************
*                                        变量
*********************************************************************************************************
*/
static int Count = 0;

/*
*********************************************************************************************************
*                           GUI_WIDGET_CREATE_INFO类型数组
*********************************************************************************************************
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    { FRAMEWIN_CreateIndirect,  "armfly",   0,               0,  0,  320,240,0,0},
     { TEXT_CreateIndirect,      "0000",     GUI_ID_TEXT0,    30,30,300,48, 0,0}
};

/*
*********************************************************************************************************
*    函数名: _cbCallback
*    功能说明: 对话框回调函数
*    形    参: pMsg  回调参数
*    返回值: 无
*********************************************************************************************************
*/
static void _cbCallback(WM_MESSAGE * pMsg)
{
    int NCode, Id;
     char buf[10];
    WM_HWIN hWin = pMsg->hWin;

    switch (pMsg->MsgId)
    {
        case WM_INIT_DIALOG:

              //
              //初始化框架窗口
              //
              FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
              FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
              FRAMEWIN_SetTitleHeight(hWin,30);

              //
              //初始化文本控件
              //
              TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0), &GUI_FontD36x48);
            break;

         /* 定时器消息 */
         case WM_TIMER:   //--------------（1）
             Count++;
             sprintf(buf, "%04d", Count);
              TEXT_SetText(WM_GetDialogItem(hWin,GUI_ID_TEXT0), (const char *)buf);
              WM_RestartTimer(pMsg->Data.v, 100);
              break;

        case WM_KEY:
            switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
            {
                case GUI_KEY_ESCAPE:
                    GUI_EndDialog(hWin, 1);
                    break;
                case GUI_KEY_ENTER:
                    GUI_EndDialog(hWin, 0);
                    break;
            }
            break;

        case WM_NOTIFY_PARENT:
            Id = WM_GetId(pMsg->hWinSrc);
            NCode = pMsg->Data.v;
            switch (Id)
            {
                case GUI_ID_OK:
                    if(NCode==WM_NOTIFICATION_RELEASED)
                        GUI_EndDialog(hWin, 0);
                    break;
                case GUI_ID_CANCEL:
                    if(NCode==WM_NOTIFICATION_RELEASED)
                        GUI_EndDialog(hWin, 0);
                    break;
            }
            break;

        default:
            WM_DefaultProc(pMsg);
    }
}

/*
*********************************************************************************************************
*    函数名: MainTask
*    功能说明: GUI主函数
*    形    参: 无
*    返回值: 无
*********************************************************************************************************
*/
void MainTask(void)
{
    WM_HWIN hDlg;
     WM_HTIMER hTimer;


     /* 初始emWin */
     GUI_Init();

     /* 窗口使能使用内存设备，防止闪烁 */
     WM_SetCreateFlags(WM_CF_MEMDEV);

   /* 创建一个对话框 */
    hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);

     /* 给对话框hDlg创建定时器，溢出时间是100ms */
     hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0); //--------------（2）

     while (1)
     {
         GUI_Delay(10);
     }
}

lee_st · 2017-2-20 18:44:55

1. 定时器消息，在定时器消息中实现文件控件计数值的更新，每次计数值加1。
2. 给对话框创建一个定时器，特别注意，这里需要获取对话框中客户区窗口的句柄才可以使用。

lee_st · 2017-2-20 18:45:04

这个例子的实际显示效果如下：

lee_st · 2017-2-20 18:45:23

39.5 实验例程说明（RTOS）
实验目的：
      1.    本实验主要学习窗口管理器之定时器使用方法。
      2.    emWin功能的实现在MainTask.c文件里面。
实验内容：
      1.    K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
      2.    K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
      3.    GUI任务主要是给对话框创建了一个定时器，每100ms更新一次文件控件的计数值。
      4.    各个任务实现的功能如下：
            App Task Start 任务：实现按键和触摸扫描。
            App Task MspPro任务：实现截图功能，将图片以BMP格式保存到SD卡中。
            App Task UserIF  任务：按键消息处理。
            App Task COM 任务：暂未使用。
            App Task GUI 任务：GUI任务。

lee_st · 2017-2-20 18:45:33

μCOS-III任务调试信息（按K1按键，串口打印）：

lee_st · 2017-2-20 18:45:46

STemWin界面显示效果：
800*480分辨率界面效果。

lee_st · 2017-2-20 18:46:03

STemWin动态内存配置：
GUIConf.c文件中的配置如下：
#define EX_SRAM   1/*1 used extern sram, 0 used internal sram */

#if EX_SRAM
#define GUI_NUMBYTES  (1024*1024*8)
#else
#define GUI_NUMBYTES  (100*1024)
#endif

lee_st · 2017-2-20 18:46:11

通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。

lee_st · 2017-2-20 18:46:26

STemWin底层接口配置：
   LCDConf_Lin_Template.c文件中共12项emWin配置：
/*
**********************************************************************************************************
                                          用户可以配置的选项
**********************************************************************************************************
*/
/* 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