【emWin实战教程V2.0】第62章 STemWin键盘输入（实体按键操

席萌0209

完整65章+12章附件教程下载地址：
http://www.armbbs.cn/forum.php?mod=viewthread&tid=19834




第62章    STemWin键盘输入（实体按键操作控件）


        本章节为大家讲解键盘输入设备或者类似键盘的外部输入设备来控制emWin。实际项目中，很多时候需要使用外部
小键盘来操作emWin界面，那么学好本章节的内容就尤其重要了，望初学者务必要掌握。
        62.1 初学者重要提示
        62.2 键盘编码基础知识
        62.3 键盘相关的API函数
        62.4 实体按键操作控件说明
        62.5 实验例程说明（RTOS）
        62.6 实验例程说明（裸机）
        62.7 总结

席萌0209

62.1  初学者重要提示

1、初学者爱问的问题简单汇总：
        问题1：为什么使用函数GUI_SendKeyMsg发送消息后，控件没有反应？
        答：首先要保证控件被聚焦，还有就是查看此控件是否支持键盘消息。
2、 键盘输入的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数位置：

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

席萌0209

62.2 键盘编码基础知识


        键盘输入设备或者类似键盘的外部输入设备使用ASCII字符编码，以便区分不同的字符。STemWin 同时定义了其他虚拟键盘操作的字符编码，这些编码如下表所示：

通过上面的编码可以看出，基本与我们在电脑端使用的键盘编码是一样的。GUI.h文件中具体定义的键值编码如下：

1. /*********************************************************************
2. *
3. *       GUI_KEY_...
4. *
5. * These ID values are basically meant to be used with widgets
6. * Note that we have chosen the values to be close to existing
7. * "standards", so do not change them unless forced to.
8. *
9. */
10. #define GUI_KEY_BACKSPACE         8         /* ASCII: BACKSPACE Crtl-H */
11. #define GUI_KEY_TAB               9         /* ASCII: TAB       Crtl-I */
12. #define GUI_KEY_BACKTAB           10
13. #define GUI_KEY_ENTER             13        /* ASCII: ENTER     Crtl-M */
14. #define GUI_KEY_LEFT              16
15. #define GUI_KEY_UP                17
16. #define GUI_KEY_RIGHT             18
17. #define GUI_KEY_DOWN              19
18. #define GUI_KEY_HOME              23
19. #define GUI_KEY_END               24
20. #define GUI_KEY_SHIFT             25
21. #define GUI_KEY_CONTROL           26
22. #define GUI_KEY_ESCAPE            27        /* ASCII: ESCAPE    0x1b   */
23. #define GUI_KEY_INSERT            29
24. #define GUI_KEY_DELETE            30
25. #define GUI_KEY_SPACE             32
26. #define GUI_KEY_PGUP              33
27. #define GUI_KEY_PGDOWN            34
29. #define GUI_KEY_F1                40
30. #define GUI_KEY_F2                41

复制代码

这些编码就是我们在前面所有的控件章节都有跟大家讲解的：控件支持的键盘反应。

席萌0209

62.3 键盘相关的API函数


        驱动层，键盘消息处理函数有以下两个：

u  voidGUI_StoreKeyMsg(int Key, int Pressed)
        Key可以是任意扩展ASCII字符 （范围为0x20至0xFF）或者任意预定义的emWin虚拟键盘编码，PressedCnt = 0表示松开或者未按下的状态，PressedCnt > 0表示按下。
        该函数支持从中断服务程序调用。另外，STemWin的键盘输入管理器含有一个FIFO缓冲，默认情况下最多可以保存10个键盘事件，如果需要修改为其它大小，可以在GUIConf.h文件中设置宏定义：
                 #define  GUI_KEY_BUFFER_SIZE   10
注意一点，如果大家使用的emWin库没有将这个宏定义开放出来，即使配置了也是无效的，具体是否有效，需要大家去做实验验证。
u  voidGUI_SendKeyMsg(int Key, int Pressed)
        该函数把消息发送给聚焦的控件，如果没有控件被聚焦，此消息会被存储到键盘缓冲区。另外，该函数不支持从中断服务程序调用，其它方面与函数GUI_StoreKeyMsg是一样的。
-----------------------------------------
应用层有以下四个函数，这个几个函数都比较易学易用，大家参看官方手册即可（如果大家有印象的话，前面几个章节讲解官方的例子时，多次用到函数GUI_GetKey，其它三个很少用到）：

席萌0209

62.4 实体按键操作控件说明


        有了前面两个小节的说明，实体按键操作控件比较容易，用户想要操作哪个控件，设置聚焦到那个控件即可，然后通过函数GUI_StoreKeyMsg或者GUI_SendKeyMsg发消息，此处使用的是函数GUI_SendKeyMsg。
        我们这里是利用开发板上面的实体按键来发消息：

检测到哪个按键被按下了，就在相应的按键消息里面通过函数GUI_SendKeyMsg发送键盘消息，具体实现代码如下：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskUserIF
4. *    功能说明: 按键消息处理
5. *    形    参: p_arg 是在创建该任务时传递的形参
6. *    返 回 值: 无
7.      优 先 级: 4
8. *********************************************************************************************************
9. */
10. static void AppTaskUserIF(void *p_arg)
11. {
12.      OS_ERR      err;
13.      uint8_t  ucKeyCode;
14.    
15.      (void)p_arg;             /* 避免编译器报警 */
16.    
18.      while (1)
19.      {      
20.           ucKeyCode = bsp_GetKey();
21.         
22.          if(ucKeyCode != KEY_NONE)
23.          {
24.               switch (ucKeyCode)
25.               {
26.                    case KEY_DOWN_K1:           /* K1键按下 串口打印任务执行情况 */
27.                        DispTaskInfo();
28.                        break;
30.                    case KEY_DOWN_K2:             /* K2键按下，向消息队列发送数据 */
31.                        OSSemPost((OS_SEM *)&SEM_SYNCH,
32.                                   (OS_OPT  )OS_OPT_POST_1,
33.                                   (OS_ERR *)&err);
34.                        break;
35.                   
36.                    case KEY_DOWN_K3:           /* K3键按下，实现TAB按键的功能*/
37.                        GUI_SendKeyMsg(GUI_KEY_TAB, 1);
38.                        break;
40.                    case JOY_DOWN_U:            /* 摇杆UP键按下，实现删除光标后的字符 */
41.                        GUI_SendKeyMsg(GUI_KEY_DELETE, 1);
42.                        break;
44.                    case JOY_DOWN_D:            /* 摇杆DOWN键按下，实现删除光标前的字符 */
45.                        GUI_SendKeyMsg(GUI_KEY_BACKSPACE, 1);
46.                        break;
48.                    case JOY_DOWN_L:            /* 摇杆LEFT键按下，实现光标左移 */
49.                        GUI_SendKeyMsg(GUI_KEY_LEFT, 1);
50.                        break;
52.                    case JOY_DOWN_R:            /* 摇杆RIGHT键按下，实现光标右移 */
53.                        GUI_SendKeyMsg(GUI_KEY_RIGHT, 1);
54.                        break;
56.                    case JOY_DOWN_OK:           /* 摇杆OK键按下，主要给本工程界面的按钮发送此消息 */
57.                        GUI_SendKeyMsg(GUI_KEY_ENTER, 1);
58.                        break;
60.                    default:
61.                        /* 其它的键值不处理 */
62.                        break;
63.               }
64.                   
65.          }
66.         
67.          OSTimeDly(20, OS_OPT_TIME_DLY, &err);
68.      }
69. }

复制代码

如果大家使用的是其它类型的键盘输入设备，方法是一样的。对于emWin的界面，只要有被聚焦的控件，就可以发送相应的键盘消息给此控件。当然，不同的控件支持的键盘消息有所不同，比如本章节配套例子的部分代码：

1. /*
2. *********************************************************************************************************
3. *                                         宏定义
4. *********************************************************************************************************
5. */
6. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
7. #define ID_EDIT_0   (GUI_ID_USER + 0x01)
8. #define ID_EDIT_1   (GUI_ID_USER + 0x03)
11. /*
12. *********************************************************************************************************
13. *                           GUI_WIDGET_CREATE_INFO类型数组
14. *********************************************************************************************************
15. */
16. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
17. {
18.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 320, 240, 0, 0x64, 0 },
19.      { EDIT_CreateIndirect, "Edit", ID_EDIT_0, 88, 27, 159, 29, 0, 0x64, 0 },
20.      { EDIT_CreateIndirect, "Edit", ID_EDIT_1, 87, 73, 159, 30, 0, 0x64, 0 },
21.      { BUTTON_CreateIndirect, "Button", GUI_ID_OK, 26, 139, 97, 31, 0, 0x0, 0 },
22.      { BUTTON_CreateIndirect, "Button", GUI_ID_CANCEL, 179, 139, 100, 31, 0, 0x0, 0 },
23. };
25. /*
26. *********************************************************************************************************
27. *    函 数 名: _cbDialog
28. *    功能说明: 对话框的回调函数
29. *    形    参: pMsg 消息指针
30. *    返 回 值: 无
31. *********************************************************************************************************
32. */
33. static void _cbDialog(WM_MESSAGE * pMsg)
34. {
35.      int     NCode;
36.      int     Id;
37.      WM_HWIN hDlg;
38.      WM_HWIN hItem;
40.      hDlg = pMsg->hWin;
41.      switch (pMsg->MsgId)
42.      {
43.          case WM_INIT_DIALOG:
44.         
45.              //
46.               // 初始化框架窗口
47.               //
48.               hItem = pMsg->hWin;
49.               FRAMEWIN_SetFont(hItem, GUI_FONT_24_ASCII);
50.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
51.               FRAMEWIN_SetText(hItem, "armfly");
52.         
53.               //
54.               // 初始化编辑框控件
55.               //
56.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
57.               EDIT_SetText(hItem, "www.armfly.com");
58.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
59.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
60.               EDIT_SetSel(hItem, 0, -1);
61.             
62.               //
63.               // 初始化边框控件
64.               //
65.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_1);
66.               EDIT_SetText(hItem, "www.baidu.com");
67.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
68.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
69.               EDIT_SetSel(hItem, 0, -1);
70.             
71.               //
72.               // 初始化按钮控件
73.               //
74.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_OK);
75.               BUTTON_SetText(hItem, "OK");
76.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
77.             
78.               //
79.               // 初始化按钮控件
80.               //
81.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_CANCEL);
82.               BUTTON_SetText(hItem, "Cancel");
83.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
84.               break;
85.             
86.           case WM_KEY:
87.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
88.             {
89.                    case GUI_KEY_ESCAPE:
90.                     GUI_EndDialog(hDlg, 1);
91.                     break;
92.                   
93.                 case GUI_KEY_ENTER:
94.                     GUI_EndDialog(hDlg, 0);
95.                     break;
96.             }
97.             break;
98.             
99.          case WM_NOTIFY_PARENT:
100.               Id    = WM_GetId(pMsg->hWinSrc);
101.               NCode = pMsg->Data.v;
102.               switch(Id)
103.               {
104.                    /* 点击OK按钮，关闭对话框 */
105.                    case GUI_ID_OK:
106.                        switch(NCode)
107.                        {
108.                             case WM_NOTIFICATION_CLICKED:
109.                                  break;
110.                            
111.                             case WM_NOTIFICATION_RELEASED:
112.                                  GUI_EndDialog(hDlg, 0);
113.                                  break;
114.                        }
115.                        break;
116.    
117.                    /* 点击CANCEL按钮，关闭对话框 */                     
118.                    case GUI_ID_CANCEL:
119.                        switch(NCode)
120.                        {
121.                             case WM_NOTIFICATION_CLICKED:
122.                                  break;
123.                            
124.                             case WM_NOTIFICATION_RELEASED:
125.                                  GUI_EndDialog(hDlg, 1);
126.                                  break;
127.                        }
128.                        break;               
129.               }
130.               break;
132.          default:
133.               WM_DefaultProc(pMsg);
134.      }
135. }

复制代码

创建此对话框后的首次显示效果如下：

默认情况下，对话框创建后，系统会聚焦到对话框资源列表里面第一个支持聚焦的控件上（这点要特别注意）。具体到给每个控件发送键盘消息，大家可以使用本章节配套的例子在开发板上面实际操作下，另外，通过我们前面设置的按键K3发送GUI_KEY_TAB消息，按下K3按键后会切换聚焦到对话框资源列表中下一个支持聚焦的控件。

席萌0209

62.5 实验例程说明（RTOS）


配套例子：
        V6-599_STemWin实验_键盘输入，实体按键操作控件（RTOS）
实验目的：
        1.     本实验主要学习实体按键操作控件的使用。
        2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
        2.     K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
        3.     针对本例子创建的界面，其余按键操作实现的功能如下，第4条到第9条。
        4.     K3按钮按下，实现控件聚焦的切换。
        5.     摇杆向上按，实现删除编辑框控件光标后的字符。
        6.     摇杆向下按，实现删除编辑框控件光标前的字符。
        7.     摇杆向左按，实现光标左移。
        8.     摇杆向右按，实现光标右移。
        9.     摇杆按下OK键，发送按键消息GUI_KEY_ENTER，如果当前聚焦到按钮控件上，发送此消息会关闭对话框。如果未聚焦到按钮控件上，发送消息GUI_KEY_ENTER会被对话框回调函数中WM_KEY消息所接受，同样也是实现关闭对话框功能。
        10.  各个任务实现的功能如下：
              App Task Start   任务：实现按键和触摸扫描。
              App Task MspPro任务 ：实现截图功能，将图片以BMP格式保存到SD卡中。
              App Task UserIF  任务：按键消息处理。
              App Task COM   任务：暂未使用。
             App Task GUI    任务：GUI任务。
μCOS-III任务调试信息（按K1按键，串口打印）：

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

STemWin动态内存配置：
        GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

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

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

        对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
任务栈大小分配：
        μCOS-III任务栈大小在os_cfg.h文件中配置：
#define  APP_CFG_TASK_START_STK_SIZE                     512u
#define  APP_CFG_TASK_MsgPro_STK_SIZE                    512u
#define  APP_CFG_TASK_COM_STK_SIZE                       512u
#define  APP_CFG_TASK_USER_IF_STK_SIZE                    512u
#define  APP_CFG_TASK_GUI_STK_SIZE                        1024u
        任务栈大小的单位是4字节，那么每个任务的栈大小如下：
    App Task Start   任务：2048字节。
       App Task MspPro任务 ：2048字节。
       App Task UserIF  任务：2048字节。
       App Task COM   任务：2048字节。
    App Task GUI    任务：4096字节。
系统栈大小分配：
        μCOS-III的系统栈大小在os_cfg_app.h文件中配置：
        #define  OS_CFG_ISR_STK_SIZE                      512u      
        系统栈大小的单位是4字节，那么这里就是配置系统栈大小为2KB。
μCOS-III初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main(void)
10. {
11.     OS_ERR  err;
12.    
13.      /* 初始化uC/OS-III 内核 */
14.     OSInit(&err);
16.      /* 创建一个启动任务（也就是主任务）。启动任务会创建所有的应用程序任务 */
17.      OSTaskCreate((OS_TCB       *)&AppTaskStartTCB,  /* 任务控制块地址 */           
18.                  (CPU_CHAR     *)"App Task Start",  /* 任务名 */
19.                  (OS_TASK_PTR   )AppTaskStart,      /* 启动任务函数地址 */
20.                  (void         *)0,                 /* 传递给任务的参数 */
21.                  (OS_PRIO       )APP_CFG_TASK_START_PRIO, /* 任务优先级 */
22.                  (CPU_STK      *)&AppTaskStartStk[0],     /* 堆栈基地址 */
23.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE / 10, /* 堆栈监测区，这里表示后10%作为监测区 */
24.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE,      /* 堆栈空间大小 */
25.                  (OS_MSG_QTY    )0,  /* 本任务支持接受的最大消息数 */
26.                  (OS_TICK       )0,  /* 设置时间片 */
27.                  (void         *)0,  /* 堆栈空间大小 */
28.                  (OS_OPT        )(OS_OPT_TASK_STK_CHK | OS_OPT_TASK_STK_CLR),
29.         
30.                     /*  定义如下：
31.                        OS_OPT_TASK_STK_CHK      使能检测任务栈，统计任务栈已用的和未用的
32.                        OS_OPT_TASK_STK_CLR      在创建任务时，清零任务栈
33.                        OS_OPT_TASK_SAVE_FP      如果CPU有浮点寄存器，则在任务切换时保存浮点寄存器的内容
34.                     */
35.                  (OS_ERR       *)&err);
37.      /* 启动多任务系统，控制权交给uC/OS-III */
38.     OSStart(&err);                                             
39.    
40.     (void)&err;
41.    
42.     return (0);
43. }

复制代码

硬件外设初始化
        硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

五个μCOS-III任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskStart
4. *    功能说明: 这是一个启动任务，在多任务系统启动后，必须初始化滴答计数器。本任务主要实现按键和触摸检测。
5. *    形    参: p_arg 是在创建该任务时传递的形参
6. *    返 回 值: 无
7.      优 先 级: 2
8. *********************************************************************************************************
9. */
10. static  void  AppTaskStart (void *p_arg)
11. {
12.      OS_ERR      err;
13.      uint8_t  ucCount = 0;
14.      uint8_t  ucCount1 = 0;
15.    
16.     /* 仅用于避免编译器告警，编译器不会产生任何目标代码 */  
17.     (void)p_arg;
18.    
19.      /* BSP 初始化。 BSP = Board Support Package 板级支持包，可以理解为底层驱动。*/
20.      CPU_Init();  /* 此函数要优先调用，因为外设驱动中使用的us和ms延迟是基于此函数的 */
21.      bsp_Init();      
22.      BSP_Tick_Init();
23.    
24. #if OS_CFG_STAT_TASK_EN > 0u
25.      OSStatTaskCPUUsageInit(&err);  
26. #endif
28. #ifdef CPU_CFG_INT_DIS_MEAS_EN
29.     CPU_IntDisMeasMaxCurReset();
30. #endif
31.         
32.      /* 创建应用程序的任务 */
33.      AppTaskCreate();
34.    
35.      /* 创建任务通信 */
36.      AppObjCreate();
37.    
38.     while(1)
39.     {
40.          /* 1ms一次触摸扫描，电阻触摸屏 */
41.          if(g_tTP.Enable == 1)
42.          {
43.               TOUCH_Scan();
44.             
45.               /* 按键扫描 */
46.               ucCount++;
47.               if(ucCount == 10)
48.               {
49.                    ucCount = 0;
50.                    bsp_KeyScan();
51.               }
52.              OSTimeDly(1, OS_OPT_TIME_DLY, &err);         
53.          }
54.         
55.          /* 20ms一次触摸扫描，电容触摸屏GT811
56.              GT811取20ms比较稳定，取10ms偶尔会有跳动。
57.          */
58.          if(g_GT811.Enable == 1)
59.          {
60.               bsp_KeyScan();
61.               ucCount1++;
62.               if(ucCount1 == 2)
63.               {
64.                    ucCount1 = 0;
65.                    GT811_OnePiontScan();
66.               }
67.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);     
68.          }
69.         
70.          /* 10ms一次触摸扫描，电容触摸屏FT5X06 */
71.          if(g_tFT5X06.Enable == 1)
72.          {
73.               bsp_KeyScan();
74.               FT5X06_OnePiontScan();
75.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);
76.          }
77.     }   
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: AppTaskMsgPro
83. *    功能说明: 实现截图功能，将图片以BMP格式保存到SD卡中
84. *    形    参: p_arg 是在创建该任务时传递的形参
85. *    返 回 值: 无
86.      优 先 级: 3
87. *********************************************************************************************************
88. */
89. static void AppTaskMsgPro(void *p_arg)
90. {
91.      uint32_t ulStart, ulEnd;
92.      OS_ERR      err;
93.      uint8_t       Pic_Name = 0;
94.      char buf[20];
96.      (void)p_arg;
97.          
98.      while(1)
99.      {   
100.           /* 等待获取信号量同步消息，接收到后执行串口打印 */
101.          OSSemPend((OS_SEM *)&SEM_SYNCH,
102.                      (OS_TICK )0,
103.                      (OS_OPT  )OS_OPT_PEND_BLOCKING,
104.                      (CPU_TS  )0,
105.                      (OS_ERR *)&err);
106.         
107.          if(err == OS_ERR_NONE)
108.          {   
109.               sprintf(buf,"0:/PicSave/%d.bmp",Pic_Name);
110.             
111.               /* 记录截图前起始时间 */
112.               ulStart = OSTimeGet(&err);
113.             
114.               /* 开启调度锁 */
115.               OSSchedLock(&err);
116.             
117.               /* 如果SD卡中没有PicSave文件，会进行创建 */
118.               result = f_mkdir("0:/PicSave");
119.             
120.               /* 创建截图 */
121.               result = f_open(&file,buf, FA_WRITE|FA_CREATE_ALWAYS);
122.             
123.               /* 向SD卡绘制BMP图片 */
124.               GUI_BMP_Serialize(_WriteByte2File, &file);
125.             
126.               /* 创建完成后关闭file */
127.              result = f_close(&file);
128.             
129.               /* 开启调度锁 */
130.               OSSchedUnlock(&err);
131.             
132.               /* 记录截图后时间并获取截图过程耗时 */
133.               ulEnd = OSTimeGet(&err);
134.               ulEnd -= ulStart;
135.             
136.               App_Printf("截图完成，耗时 = %dms\\r\\n", ulEnd);
137.               Pic_Name++;      
138.          }                                                                                                                  
139.      }  
140. }
142. /*
143. *********************************************************************************************************
144. *    函 数 名: AppTaskUserIF
145. *    功能说明: 按键消息处理
146. *    形    参: p_arg 是在创建该任务时传递的形参
147. *    返 回 值: 无
148.      优 先 级: 4
149. *********************************************************************************************************
150. */
151. static void AppTaskUserIF(void *p_arg)
152. {
153.      OS_ERR      err;
154.      uint8_t  ucKeyCode;
155.    
156.      (void)p_arg;             /* 避免编译器报警 */
157.    
159.      while (1)
160.      {      
161.          ucKeyCode = bsp_GetKey();
162.         
163.          if(ucKeyCode != KEY_NONE)
164.          {
165.               switch (ucKeyCode)
166.               {
167.                    case KEY_DOWN_K1:           /* K1键按下 串口打印任务执行情况 */
168.                        DispTaskInfo();
169.                        break;
171.                    case KEY_DOWN_K2:             /* K2键按下，向消息队列发送数据 */
172.                        OSSemPost((OS_SEM *)&SEM_SYNCH,
173.                                   (OS_OPT  )OS_OPT_POST_1,
174.                                   (OS_ERR *)&err);
175.                        break;
176.                   
177.                    case KEY_DOWN_K3:           /* K3键按下，实现TAB按键的功能*/
178.                        GUI_SendKeyMsg(GUI_KEY_TAB, 1);
179.                        break;
181.                    case JOY_DOWN_U:            /* 摇杆UP键按下，实现删除光标后的字符 */
182.                        GUI_SendKeyMsg(GUI_KEY_DELETE, 1);
183.                        break;
185.                    case JOY_DOWN_D:            /* 摇杆DOWN键按下，实现删除光标前的字符 */
186.                        GUI_SendKeyMsg(GUI_KEY_BACKSPACE, 1);
187.                        break;
189.                    case JOY_DOWN_L:            /* 摇杆LEFT键按下，实现光标左移 */
190.                        GUI_SendKeyMsg(GUI_KEY_LEFT, 1);
191.                        break;
193.                    case JOY_DOWN_R:            /* 摇杆RIGHT键按下，实现光标右移 */
194.                        GUI_SendKeyMsg(GUI_KEY_RIGHT, 1);
195.                        break;
197.                    case JOY_DOWN_OK:           /* 摇杆OK键按下，发送GUI_KEY_ENTER消息，会被聚焦的按钮或者
198.                                                   WM_KEY消息所接受并处理，功能都是关闭对话框。*/
199.                        GUI_SendKeyMsg(GUI_KEY_ENTER, 1);
200.                        break;
202.                    default:
203.                        /* 其它的键值不处理 */
204.                        break;
205.               }
206.                   
207.          }
208.         
209.          OSTimeDly(20, OS_OPT_TIME_DLY, &err);
210.      }
211. }
213. /*
214. *********************************************************************************************************
215. *    函 数 名: AppTaskCom
216. *    功能说明: 暂未使用
217. *    形    参: p_arg 是在创建该任务时传递的形参
218. *    返 回 值: 无
219.      优 先 级: 5
220. *********************************************************************************************************
221. */
222. static void AppTaskCOM(void *p_arg)
223. {
224.      OS_ERR  err;      
225.    
226.      (void)p_arg;
227.    
228.      while(1)
229.      {   
230.          OSTimeDly(500, OS_OPT_TIME_DLY, &err);
231.      }                                                                                                
232. }
234. /*
235. *********************************************************************************************************
236. *    函 数 名: AppTaskGUI
237. *    功能说明: GUI任务，最低优先级                        
238. *    形    参：p_arg 是在创建该任务时传递的形参
239. *    返 回 值: 无
240. *   优 先 级：OS_CFG_PRIO_MAX - 4u
241. *********************************************************************************************************
242. */
243. static void AppTaskGUI(void *p_arg)
244. {
245.     (void)p_arg;       /* 避免编译器告警 */
246.         
247.      while (1)
248.      {
249.          MainTask();
250.      }
251. }

复制代码

emWin任务的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "includes.h"
6. /*
7. *********************************************************************************************************
8. *                                         宏定义
9. *********************************************************************************************************
10. */
11. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
12. #define ID_LISTVIEW_0 (GUI_ID_USER + 0x01)
15. /*
16. *********************************************************************************************************
17. *                           GUI_WIDGET_CREATE_INFO类型数组
18. *********************************************************************************************************
19. */
20. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
21. {
22.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 800, 480, 0, 0x64, 0 },
23.      { LISTVIEW_CreateIndirect, "Listview", ID_LISTVIEW_0, 30, 20, 350, 160, 0, 0x0, 0 },
24. };
26. /*
27. *********************************************************************************************************
28. *    函 数 名: _cbDialog
29. *    功能说明: 对话框回调函数        
30. *    形    参: pMsg  回调参数
31. *    返 回 值: 无
32. *********************************************************************************************************
33. */
34. static void _cbDialog(WM_MESSAGE * pMsg)
35. {
36.      WM_HWIN hItem;
37.      int     NCode;
38.      int     Id;
39.      HEADER_Handle hHeader;
40.      char    buf[10];
41.      static char  Value = 0;
43.      switch (pMsg->MsgId)
44.      {
45.          case WM_INIT_DIALOG:
46.             
47.               //
48.               // 初始化框架窗口
49.               //
50.               hItem = pMsg->hWin;
51.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
52.               FRAMEWIN_SetFont(hItem, GUI_FONT_32B_ASCII);
53.               FRAMEWIN_SetText(hItem, "armfly");
54.         
55.               //
56.               // 初始列表控件
57.               //
58.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
59.               /* 设置列表控件中header控件的所显示文本的字体 */
60.               hHeader = LISTVIEW_GetHeader(hItem);
61.               HEADER_SetFont(hHeader, GUI_FONT_16_ASCII);
63.               /* 添加四列表，调用一次函数LISTVIEW_AddColumn添加一列 */
64.               LISTVIEW_AddColumn(hItem, 80, "STM32-V3", GUI_TA_HCENTER | GUI_TA_VCENTER);
65.               LISTVIEW_AddColumn(hItem, 80, "STM32-V4", GUI_TA_HCENTER | GUI_TA_VCENTER);
66.               LISTVIEW_AddColumn(hItem, 80, "STM32-V5", GUI_TA_HCENTER | GUI_TA_VCENTER);
67.               LISTVIEW_AddColumn(hItem, 80, "STM32-V6", GUI_TA_HCENTER | GUI_TA_VCENTER);
68.             
69.               /* 添加三行，调用一次函数LISTVIEW_AddRow添加一行 */
70.               LISTVIEW_AddRow(hItem, NULL);
71.               LISTVIEW_AddRow(hItem, NULL);
72.               LISTVIEW_AddRow(hItem, NULL);
73.         
74.               /* 为列表控件三行四列共12个选项全部添加文本 */
75.               LISTVIEW_SetItemText(hItem, 0, 0, "A00");
76.               LISTVIEW_SetItemText(hItem, 1, 0, "A01");
77.               LISTVIEW_SetItemText(hItem, 2, 0, "A02");
78.               LISTVIEW_SetItemText(hItem, 3, 0, "A03");
79.               LISTVIEW_SetItemText(hItem, 0, 1, "B10");
80.               LISTVIEW_SetItemText(hItem, 1, 1, "B11");
81.               LISTVIEW_SetItemText(hItem, 2, 1, "B12");
82.               LISTVIEW_SetItemText(hItem, 3, 1, "B13");
83.               LISTVIEW_SetItemText(hItem, 0, 2, "C20");
84.               LISTVIEW_SetItemText(hItem, 1, 2, "C21");
85.               LISTVIEW_SetItemText(hItem, 2, 2, "C22");
86.               LISTVIEW_SetItemText(hItem, 3, 2, "C23");
87.             
88.               /* 设置列表控件选项中所显示文本的字体 */
89.               LISTVIEW_SetFont(hItem, GUI_FONT_16_ASCII);
90.               /* 设置列表控件表格可见 */
91.               LISTVIEW_SetGridVis(hItem, 1);
92.               break;
93.         
94.          case WM_NOTIFY_PARENT:
95.               Id    = WM_GetId(pMsg->hWinSrc);
96.               NCode = pMsg->Data.v;
97.               switch(Id)
98.               {
99.                    case ID_LISTVIEW_0:
100.                        switch(NCode)
101.                        {
102.                             case WM_NOTIFICATION_CLICKED:
103.                                  break;
104.                            
105.                             case WM_NOTIFICATION_RELEASED:
106.                                  break;
107.                            
108.                             case WM_NOTIFICATION_SEL_CHANGED:
109.                                  break;
110.                        }
111.               }
112.               break;
113.             
114.          case WM_TIMER:
115.               /* 每100ms更新一次列表控件中第一个选项和最后一个选项所显示的文本，这里是做了一个简单的计数 */
116.               hItem = WM_GetDialogItem(pMsg->hWin, ID_LISTVIEW_0);
117.               sprintf(buf, "%d", Value++);
118.               LISTVIEW_SetItemText(hItem, 0, 0, buf);
119.               LISTVIEW_SetItemText(hItem, 3, 2, buf);
120.             
121.               WM_RestartTimer(pMsg->Data.v, 100);
122.             
123.          default:
124.               WM_DefaultProc(pMsg);
125.               break;
126.      }
127. }
129. /*
130. *********************************************************************************************************
131. *    函 数 名: CreateFramewin
132. *    功能说明: 创建对话框      
133. *    形    参: 无
134. *    返 回 值: 返回对话框句柄
135. *********************************************************************************************************
136. */
137. WM_HWIN CreateFramewin(void)
138. {
139.      WM_HWIN hWin;
141.      hWin = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), _cbDialog, WM_HBKWIN, 0, 0);
142.      return hWin;
143. }
145. /*
146. *********************************************************************************************************
147. *    函 数 名: MainTask
148. *    功能说明: GUI主函数
149. *    形    参: 无
150. *    返 回 值: 无
151. *********************************************************************************************************
152. */
153. void MainTask(void)
154. {
155.      WM_HWIN hDlg;
156.    
157.      /* 初始化 */
158.      GUI_Init();
159.    
160.      /*
161.       关于多缓冲和窗口内存设备的设置说明
162.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
163.            WM_MULTIBUF_Enable(1);
164.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
165.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
166.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
167.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
168.         4. 所有emWin例子默认是开启三缓冲。
169.      */
170.      WM_MULTIBUF_Enable(1);
171.    
172.      /*
173.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
174.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
175.      */
176.     //TOUCH_Calibration();
177.    
178.      /* 创建对话框 */
179.      hDlg = CreateFramewin();
180.    
181.      /* 为对话框创建一个溢出时间是100ms的定时器 */
182.      WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
183.         
184.      while(1)
185.      {
186.          GUI_Delay(50);
187.      }
188. }
190. /*
191. *********************************************************************************************************
192. *                                         宏定义
193. *********************************************************************************************************
194. */
195. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
196. #define ID_EDIT_0   (GUI_ID_USER + 0x01)
197. #define ID_EDIT_1   (GUI_ID_USER + 0x03)
200. /*
201. *********************************************************************************************************
202. *                           GUI_WIDGET_CREATE_INFO类型数组
203. *********************************************************************************************************
204. */
205. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
206. {
207.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 320, 240, 0, 0x64, 0 },
208.      { EDIT_CreateIndirect, "Edit", ID_EDIT_0, 88, 27, 159, 29, 0, 0x64, 0 },
209.      { EDIT_CreateIndirect, "Edit", ID_EDIT_1, 87, 73, 159, 30, 0, 0x64, 0 },
210.      { BUTTON_CreateIndirect, "Button", GUI_ID_OK, 26, 139, 97, 31, 0, 0x0, 0 },
211.      { BUTTON_CreateIndirect, "Button", GUI_ID_CANCEL, 179, 139, 100, 31, 0, 0x0, 0 },
212. };
214. /*
215. *********************************************************************************************************
216. *    函 数 名: _cbDialog
217. *    功能说明: 对话框的回调函数
218. *    形    参: pMsg 消息指针
219. *    返 回 值: 无
220. *********************************************************************************************************
221. */
222. static void _cbDialog(WM_MESSAGE * pMsg)
223. {
224.      int     NCode;
225.      int     Id;
226.      WM_HWIN hDlg;
227.      WM_HWIN hItem;
229.      hDlg = pMsg->hWin;
230.      switch (pMsg->MsgId)
231.      {
232.          case WM_INIT_DIALOG:
233.         
234.              //
235.               // 初始化框架窗口
236.               //
237.               hItem = pMsg->hWin;
238.               FRAMEWIN_SetFont(hItem, GUI_FONT_24_ASCII);
239.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
240.               FRAMEWIN_SetText(hItem, "armfly");
241.         
242.               //
243.               // 初始化编辑框控件
244.               //
245.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
246.               EDIT_SetText(hItem, "www.armfly.com");
247.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
248.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
249.               EDIT_SetSel(hItem, 0, -1);  /* 设置选中编辑框中所有文本 */
250.             
251.               //
252.               // 初始化边框控件
253.               //
254.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_1);
255.               EDIT_SetText(hItem, "www.baidu.com");
256.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
257.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
258.               EDIT_SetSel(hItem, 0, -1);  /* 设置选中编辑框中所有文本 */
259.             
260.               //
261.               // 初始化按钮控件
262.               //
263.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_OK);
264.               BUTTON_SetText(hItem, "OK");
265.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
266.             
267.               //
268.               // 初始化按钮控件
269.               //
270.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_CANCEL);
271.               BUTTON_SetText(hItem, "Cancel");
272.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
273.               break;
274.             
275.           case WM_KEY:
276.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
277.             {
278.                    case GUI_KEY_ESCAPE:
279.                     GUI_EndDialog(hDlg, 1);
280.                     break;
281.                   
282.                 case GUI_KEY_ENTER:
283.                     GUI_EndDialog(hDlg, 0);
284.                     break;
285.             }
286.             break;
287.             
288.          case WM_NOTIFY_PARENT:
289.               Id    = WM_GetId(pMsg->hWinSrc);
290.               NCode = pMsg->Data.v;
291.               switch(Id)
292.               {
293.                    /* 点击OK按钮，关闭对话框 */
294.                    case GUI_ID_OK:
295.                        switch(NCode)
296.                        {
297.                             case WM_NOTIFICATION_CLICKED:
298.                                  break;
299.                            
300.                             case WM_NOTIFICATION_RELEASED:
301.                                  GUI_EndDialog(hDlg, 0);
302.                                  break;
303.                        }
304.                        break;
305.    
306.                    /* 点击CANCEL按钮，关闭对话框 */                     
307.                    case GUI_ID_CANCEL:
308.                        switch(NCode)
309.                        {
310.                             case WM_NOTIFICATION_CLICKED:
311.                                  break;
312.                            
313.                             case WM_NOTIFICATION_RELEASED:
314.                                  GUI_EndDialog(hDlg, 1);
315.                                  break;
316.                        }
317.                        break;               
318.               }
319.               break;
321.          default:
322.               WM_DefaultProc(pMsg);
323.      }
324. }
326. /*
327. *********************************************************************************************************
328. *    函 数 名: _cbDesktop
329. *    功能说明: 桌面窗口的回调函数
330. *    形    参: pMsg 消息指针
331. *    返 回 值: 无
332. *********************************************************************************************************
333. */
334. static void _cbDesktop(WM_MESSAGE * pMsg)
335. {
336.      switch (pMsg->MsgId)
337.      {
338.          /* 重绘 */
339.          case WM_PAINT:
340.               GUI_SetBkColor(GUI_RED);
341.               GUI_Clear();
342.               GUI_SetFont(&GUI_Font24_ASCII);
343.               GUI_DispStringHCenterAt("WIDGET_EditWinmode", 160, 5);
344.               GUI_DispNextLine();
345.               GUI_SetFont(GUI_DEFAULT_FONT);
346.               GUI_DispNextLine();
347.               break;
348.         
349.          default:
350.               WM_DefaultProc(pMsg);
351.      }
352. }
354. /*
355. *********************************************************************************************************
356. *    函 数 名: MainTask
357. *    功能说明: GUI主函数
358. *    形    参: 无
359. *    返 回 值: 无
360. *********************************************************************************************************
361. */
362. void MainTask(void)
363. {
364.    
365.      /* 初始化 */
366.      GUI_Init();
367.    
368.      /*
369.       关于多缓冲和窗口内存设备的设置说明
370.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
371.            WM_MULTIBUF_Enable(1);
372.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
373.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
374.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
375.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
376.         4. 所有emWin例子默认是开启三缓冲。
377.      */
378.      WM_MULTIBUF_Enable(1);
379.    
380.      /*
381.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
382.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
383.      */
384.     //TOUCH_Calibration();
385.    
386.      WM_SetCallback(WM_HBKWIN, _cbDesktop);
387.    
388.      while(1)
389.      {
390.          /* 创建阻塞式对话框 */
391.          GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbDialog, 0, 0, 0);
392.          GUI_Delay(500);
393.      }
394. }

复制代码

席萌0209

62.6 实验例程说明（裸机）


配套例子：
        V6-600_STemWin实验_键盘输入，实体按键操作控件（裸机）
实验目的：
         1.     本实验主要学习实体按键操作控件的使用。
         2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
        1.     针对本例子创建的界面，其余按键操作实现的功能如下，第2条到第7条。
        2.     K3按钮按下，实现控件聚焦的切换。
        3.     摇杆向上按，实现删除编辑框控件光标后的字符。
        4.     摇杆向下按，实现删除编辑框控件光标前的字符。
        5.     摇杆向左按，实现光标左移。
        6.     摇杆向右按，实现光标右移。
        7.     摇杆按下OK键，发送按键消息GUI_KEY_ENTER，如果当前聚焦到按钮控件上，发送此消息会关闭对话框。如果未聚焦到按钮控件上，发送消息GUI_KEY_ENTER会被对话框回调函数中WM_KEY消息所接受，同样也是实现关闭对话框功能。
STemWin界面显示效果：
        800*480分辨率界面效果。

STemWin动态内存配置：
        GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

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

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

        对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
栈大小分配：
        系统栈大小在startup_stm32f429_439xx.s文件中配置：

        栈大小的单位是字节，那么这里配置系统栈大小为8192字节。
主函数初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
14.      /* 进入emWin主函数 */
15.      MainTask();
16. }

复制代码

硬件外设初始化
         硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

emWin功能的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "bsp.h"
6. /*
7. *********************************************************************************************************
8. *                                         宏定义
9. *********************************************************************************************************
10. */
11. #define ID_FRAMEWIN_0 (GUI_ID_USER + 0x00)
12. #define ID_EDIT_0   (GUI_ID_USER + 0x01)
13. #define ID_EDIT_1   (GUI_ID_USER + 0x03)
16. /*
17. *********************************************************************************************************
18. *                           GUI_WIDGET_CREATE_INFO类型数组
19. *********************************************************************************************************
20. */
21. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] =
22. {
23.      { FRAMEWIN_CreateIndirect, "Framewin", ID_FRAMEWIN_0, 0, 0, 320, 240, 0, 0x64, 0 },
24.      { EDIT_CreateIndirect, "Edit", ID_EDIT_0, 88, 27, 159, 29, 0, 0x64, 0 },
25.      { EDIT_CreateIndirect, "Edit", ID_EDIT_1, 87, 73, 159, 30, 0, 0x64, 0 },
26.      { BUTTON_CreateIndirect, "Button", GUI_ID_OK, 26, 139, 97, 31, 0, 0x0, 0 },
27.      { BUTTON_CreateIndirect, "Button", GUI_ID_CANCEL, 179, 139, 100, 31, 0, 0x0, 0 },
28. };
30. /*
31. *********************************************************************************************************
32. *    函 数 名: _cbDialog
33. *    功能说明: 对话框的回调函数
34. *    形    参: pMsg 消息指针
35. *    返 回 值: 无
36. *********************************************************************************************************
37. */
38. static void _cbDialog(WM_MESSAGE * pMsg)
39. {
40.      int     NCode;
41.      int     Id;
42.      WM_HWIN hDlg;
43.      WM_HWIN hItem;
45.      hDlg = pMsg->hWin;
46.      switch (pMsg->MsgId)
47.      {
48.          case WM_INIT_DIALOG:
49.         
50.              //
51.               // 初始化框架窗口
52.               //
53.               hItem = pMsg->hWin;
54.               FRAMEWIN_SetFont(hItem, GUI_FONT_24_ASCII);
55.               FRAMEWIN_SetTextAlign(hItem, GUI_TA_HCENTER | GUI_TA_VCENTER);
56.               FRAMEWIN_SetText(hItem, "armfly");
57.         
58.               //
59.               // 初始化编辑框控件
60.               //
61.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_0);
62.               EDIT_SetText(hItem, "www.armfly.com");
63.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
64.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
65.               EDIT_SetSel(hItem, 0, -1);  /* 设置选中编辑框中所有文本 */
66.             
67.               //
68.               // 初始化边框控件
69.               //
70.               hItem = WM_GetDialogItem(pMsg->hWin, ID_EDIT_1);
71.               EDIT_SetText(hItem, "www.baidu.com");
72.               EDIT_SetFont(hItem, GUI_FONT_16_ASCII);
73.               EDIT_SetTextAlign(hItem, GUI_TA_LEFT | GUI_TA_VCENTER);
74.               EDIT_SetSel(hItem, 0, -1);  /* 设置选中编辑框中所有文本 */
75.             
76.               //
77.               // 初始化按钮控件
78.               //
79.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_OK);
80.               BUTTON_SetText(hItem, "OK");
81.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
82.             
83.               //
84.               // 初始化按钮控件
85.               //
86.               hItem = WM_GetDialogItem(pMsg->hWin, GUI_ID_CANCEL);
87.               BUTTON_SetText(hItem, "Cancel");
88.               BUTTON_SetFont(hItem, GUI_FONT_16_ASCII);
89.               break;
90.             
91.           case WM_KEY:
92.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
93.             {
94.                    case GUI_KEY_ESCAPE:
95.                     GUI_EndDialog(hDlg, 1);
96.                     break;
97.                   
98.                 case GUI_KEY_ENTER:
99.                     GUI_EndDialog(hDlg, 0);
100.                     break;
101.             }
102.             break;
103.             
104.          case WM_NOTIFY_PARENT:
105.               Id    = WM_GetId(pMsg->hWinSrc);
106.               NCode = pMsg->Data.v;
107.               switch(Id)
108.               {
109.                    /* 点击OK按钮，关闭对话框 */
110.                    case GUI_ID_OK:
111.                        switch(NCode)
112.                        {
113.                             case WM_NOTIFICATION_CLICKED:
114.                                  break;
115.                            
116.                             case WM_NOTIFICATION_RELEASED:
117.                                  GUI_EndDialog(hDlg, 0);
118.                                  break;
119.                         }
120.                        break;
121.    
122.                    /* 点击CANCEL按钮，关闭对话框 */                     
123.                   case GUI_ID_CANCEL:
124.                        switch(NCode)
125.                        {
126.                             case WM_NOTIFICATION_CLICKED:
127.                                  break;
128.                            
129.                             case WM_NOTIFICATION_RELEASED:
130.                                  GUI_EndDialog(hDlg, 1);
131.                                  break;
132.                        }
133.                        break;               
134.               }
135.               break;
137.          default:
138.               WM_DefaultProc(pMsg);
139.      }
140. }
142. /*
143. *********************************************************************************************************
144. *    函 数 名: _cbDesktop
145. *    功能说明: 桌面窗口的回调函数
146. *    形    参: pMsg 消息指针
147. *    返 回 值: 无
148. *********************************************************************************************************
149. */
150. static void _cbDesktop(WM_MESSAGE * pMsg)
151. {
152.      switch (pMsg->MsgId)
153.      {
154.          /* 重绘 */
155.          case WM_PAINT:
156.               GUI_SetBkColor(GUI_RED);
157.               GUI_Clear();
158.               GUI_SetFont(&GUI_Font24_ASCII);
159.               GUI_DispStringHCenterAt("WIDGET_EditWinmode", 160, 5);
160.               GUI_DispNextLine();
161.               GUI_SetFont(GUI_DEFAULT_FONT);
162.               GUI_DispNextLine();
163.               break;
164.         
165.          default:
166.               WM_DefaultProc(pMsg);
167.      }
168. }
170. /*
171. *********************************************************************************************************
172. *    函 数 名: _cbTimer
173. *    功能说明: 创建对话框      
174. *    形    参: pTM 消息指针
175. *    返 回 值: 无
176. *********************************************************************************************************
177. */
178. void _cbTimer(GUI_TIMER_MESSAGE * pTM)
179. {
180.      uint8_t  ucKeyCode;
181.    
182.      switch (pTM->Context)
183.      {
184.          case 0x01:
185.               ucKeyCode = bsp_GetKey();
186.             
187.               if(ucKeyCode != KEY_NONE)
188.               {
189.                    switch (ucKeyCode)
190.                    {
191.                      
192.                        case KEY_DOWN_K3:           /* K3键按下，实现TAB按键的功能*/
193.                             GUI_SendKeyMsg(GUI_KEY_TAB, 1);
194.                             break;
196.                        case JOY_DOWN_U:            /* 摇杆UP键按下，实现删除光标后的字符 */
197.                             GUI_SendKeyMsg(GUI_KEY_DELETE, 1);
198.                             break;
200.                        case JOY_DOWN_D:            /* 摇杆DOWN键按下，实现删除光标前的字符 */
201.                             GUI_SendKeyMsg(GUI_KEY_BACKSPACE, 1);
202.                             break;
204.                        case JOY_DOWN_L:            /* 摇杆LEFT键按下，实现光标左移 */
205.                             GUI_SendKeyMsg(GUI_KEY_LEFT, 1);
206.                             break;
208.                        case JOY_DOWN_R:            /* 摇杆RIGHT键按下，实现光标右移 */
209.                             GUI_SendKeyMsg(GUI_KEY_RIGHT, 1);
210.                             break;
212.                        case JOY_DOWN_OK:           /* 摇杆OK键按下，发送GUI_KEY_ENTER消息，会被聚焦的按钮
213. 或者WM_KEY消息所接受并处理，功能都是关闭对话框。*/
214.                             GUI_SendKeyMsg(GUI_KEY_ENTER, 1);
215.                             break;
217.                        default:
218.                             /* 其它的键值不处理 */
219.                             break;
220.                    }
221.                      
222.               }
223.             
224.               /* 此函数一定要调用，设置重新启动，要不仅执行一次 */
225.               GUI_TIMER_Restart(pTM->hTimer);
226.               break;
227.          default:
228.               break;
229.      }
231. }
233. /*
234. *********************************************************************************************************
235. *    函 数 名: MainTask
236. *    功能说明: GUI主函数
237. *    形    参: 无
238. *    返 回 值: 无
239. *********************************************************************************************************
240. */
241. void MainTask(void)
242. {
243.      GUI_TIMER_HANDLE hTimer;
244.    
245.      /* 初始化 */
246.      GUI_Init();
247.    
248.      /*
249.       关于多缓冲和窗口内存设备的设置说明
250.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
251.            WM_MULTIBUF_Enable(1);
252.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
253.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
254.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
255.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
256.         4. 所有emWin例子默认是开启三缓冲。
257.      */
258.      WM_MULTIBUF_Enable(1);
259.    
260.      /*
261.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
262.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
263.      */
264.     //TOUCH_Calibration();
265.    
266.      WM_SetCallback(WM_HBKWIN, _cbDesktop);
267.    
268.      /* 创建定时器 */
269.      hTimer = GUI_TIMER_Create(_cbTimer, /* 回调函数 */
270.                              1000,/* 绝对时间，设置系统上电后1s作为溢出时间 */
271.                              0x01, /* 可以任务此参数是区分不同定时器的ID，方便多个定时使用同一个回调函数 */
272.                              0);   /* 保留，暂时未用到 */
273.                         
274.      /* 设置定时器周期为20ms */
275.      GUI_TIMER_SetPeriod(hTimer, 20);
276.         
277.      while(1)
278.      {
279.           /* 创建阻塞式对话框 */
280.          GUI_ExecDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbDialog, 0, 0, 0);
281.          GUI_Delay(500);
282.      }
283. }

复制代码

席萌0209

62.7 总结


        本章节就为大家讲解这么多，掌握了本章节配套的例子后，务必要自行创建一个界面进行实战演练，只有这样才能真正掌握此功能，此功能在实际项目中用到的地方很多。