【emWin实战教程V2.0】第27章 任意大小全字库生成和使用方法（GBK编码）

席萌0209

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



第27章      任意大小全字库生成和使用方法（GBK编码）


     本章节为大家讲解GBK编码全字库的生成和使用实现，相比GB2312编码，支持的字符更加完善，不过生成的全字库文件要大，如果项目中GB2312编码字符无法满足要求时，可以采用这种方式。
    有了本章节的知识，大家就可以生成项目所需的点阵大小，不过仅支持等宽字体，非等宽字体显示效果不够好。另外，这里说成任意大小是方便大家理解，生成点阵的大小是受限于用户所使用字体生成软件是否支持生成任意大小点阵字体，如果支持的话且芯片资源够用，那么使用本章节提供的方法是没有问题的。
    学习本章节前，务必保证已经学习了第25章和第26章，如此一来，学习本章节将事半功倍。
    27.1  初学者重要提示
    27.2 GBK编码全字库的生成方法
    27.3 GBK编码全字库的地址计算
    27.4 GBK全字库的移植方法
    27.5 移植文件简易说明
    27.6 GBK字库使用方法
    27.7 实验例程说明（RTOS）
    27.8 实验例程说明（裸机）
    27.9 总结

席萌0209

27.1   初学者重要提示

1、GBK向下完全兼容GB2312，但比GB2312支持的字符更加完善，不过生成的全字库文件要大，如果项目中GB2312编码字符无法满足要求时，可以采用GBK编码字库。

2、对于不习惯前面章节讲解的XBF格式和SIF格式的Unicode编码全字库的用户来说，使用GBK编码是很好的选择，很适合初学者，汉字操作方式与大家裸机代码（没有使用GUI）时是一样的。

3、GBK编码的全字库文件可以存到任何外部存储介质中。本章节配套例子是将其存到SPI Flash里面了。

4、使用GBK编码也是有缺点的，相比前面章节使用FontCvt生成的XBF格式和SIF格式全字库，GBK编码全字库不支持抗锯齿效果，且仅支持等宽字体（仅支持等宽是因为当前新字体的创建方法不支持非等宽字体）。

席萌0209

27.2GBK编码全字库的生成方法


    第25章，为大家讲解了12点阵，16点阵，24点阵和32点阵的GB2312编码汉字和ASCII字符。本章节我们同样生成12点阵，16点阵，24点阵和32点阵的GBK编码汉字和ASCII字符。这里以宋体，16点阵为例给大家说明如何生成自己所需的点阵字体。
第1步：下载多国语言点阵字库生成器，http://www.armbbs.cn/forum.php?mod=viewthread&tid=21469 。
第2步：打开此软件，打开后的效果如下：

    默认已经是宋体，如果要选择其它字体可以点击左上角的“选择字体”，弹出下界面：

    特别注意，这个软件在上面的界面里设置字体大小，没有任何效果，应该是软件的bug，不过不影响使用，因为有别的地方可以设置。
第3步：生成6*12点阵，8*16点阵，12*24点阵和16*32点阵的ASCII字符。
    这里以宋体，8*16点阵为例进行说明。由于这个软件不支持生成ASCII字符，生成ISO 8859-1字符也是可以的，关于8859-1字符在前面第21章的21.4.2小节进行了讲解。

    （注意，左上角的字体大小设置和下面宽和高的点阵大小设置是有区别的，这里字体大小12对应的实际点阵大小是8*16，这两个选项都是要用户进行设置的）
    点击创建后：

    点击选项创建字库，弹出如下窗口：

点击保存后，此软件会有一个生成进度：

生成完毕后，就可以在桌面上看到生成的文件ascii16.dzk。同样的方法再生成12点阵,24点阵和32点阵的ASCII字符，12点阵的配置如下：

生成的字库文件命名为ascii12.dzk，24点阵的配置如下：

生成的字库文件命名为ascii24.dzk，32点阵的配置如下：

生成的字库文件命名为ascii32.dzk，这样12点阵，16点阵，24点阵和32点阵的ASCII字符就都生成了：

第4步：生成12*12点阵，16*16点阵，24*24点阵和32*32点阵的GBK编码字符。
    这里以宋体，16*16点阵为例进行说明。点阵字库生成器的配置如下：

（注意，那个等宽等高的对勾选上或者不选上均可，选上的话，其中一个设置了，另一个也跟着相同的变化，如果不选上，两个可以分别进行设置。另外，左上角的字体大小设置和下面宽和高的点阵大小设置是有区别的，这里字体大小12对应的实际点阵大小是16*16，这两个选项都是要用户进行设置的）

点击保存后，此软件会有一个生成进度，由于字符较多，此过程比较慢，需要耐心等待。

生成完毕后，就在桌面上看到生成的文件hanzi16.dzk。同样的方法再生成12点阵,24点阵和32点阵的GBK字符，12点阵的配置如下：

生成的字库文件命名为hanzi12.dzk，24点阵的配置如下：

生成的字库文件命名为hanzi24.dzk，32点阵的配置如下：

生成的字库文件命名为hanzi32.dzk，这样12点阵，16点阵，24点阵和32点阵的GBK字符就都生成了：

第5步：合并生成的8个文件

    打开文件合并助手（在第23章的23.3小节已经提供下载地址），将这8个文件全部加载进来。

添加字库后，效果如下：

输出窗口已经自动生成了对应字体的首地址。这个地址要保存好，后面要用到。
第3步：点击右下角的合并，会弹出一个窗口

点击保存后，桌面后生成一个font.bin的文件：

注意，合并后的这个文件不要超过8MB，因为本教程配套板子的SPI Flash大小是8MB。这个文件的实际大小大约是5.87MB，没有超过8MB。

席萌0209

27.3GBK编码全字库的地址计算


   GBK编码也需要两个字节来表示，第一个字节是区号，范围是81到FE，第二个字节是位号，位号是该字在该区中的位置，范围是40到7E和80到FE，其中7F部分是没有编码的，这点要特别注意。下面是GBK的编码范围表。

从上面表格可以看出，GBK区间是8140~FEFE，其中XX7F部分是要删除的， GBK 里有FE-81+1=126个区，每个区有FE-40-1+1=190个字符，因此一共有126*190=23940个字符，与上面的表格编码数是一致的。
1、汉字点阵GB2312编码字库地址计算
     所有点阵字体的计算公式是一样的，仅首地址和每个点阵字符需要的字节数不一样，这里配置的首地址是前面27.2小节通过文件合并助手获取的。
      GBCod：表示汉字内码。
      MSB：表示汉字内码GBCode的高8bits，
      LSB：表示汉字内码GBCode的低8bits。
      Address 表示汉字或ASCII字符点阵在芯片中的字节地址。
      BaseAdd：说明点阵数据在字库中的起始地址。
      BytesPerFont：一个字符需要的字节数
        12*12点阵字体的首地址：
           BaseAdd=0x00008C00;
           BytesPerFont = 24字节
        16*16点阵字体的首地址：
           BaseAdd=0x00095060;
           BytesPerFont = 32字节
        24*24点阵字体的首地址：
           BaseAdd=0x001500E0;
           BytesPerFont = 72字节
         32*32点阵字体的首地址：
           BaseAdd=0x002F4E00;
           BytesPerFont = 148字节
          这四种点阵全部是采用下面的计算公式：
                                  Address = ((MSB - 0x81) * 190 + (LSB - 0x40)- (LSB / 128))* BytesPerFont + BaseAdd;
2、ASCII字符地址计算
    所有点阵字体的计算公式是一样的，仅首地址和每个点阵字符需要的字节数不一样。这里配置的首地址是前面27.2小节通过文件合并助手获取的。
      ASCIICode：表示ASCII 码（ 8bits）
      BaseAdd：说明该套字库在芯片中的起始地址。
      Address： ASCII字符点阵在芯片中的字节地址。
      BytesPerFont：一个字符需要的字节数
        6*12点阵字体的首地址：
          BaseAdd=0x00000000;
          BytesPerFont = 12字节
       8*16点阵字体的首地址：
          BaseAdd=0x00000C00;
          BytesPerFont = 16字节
         12*24点阵字体的首地址：
          BaseAdd=0x00001C00;
          BytesPerFont = 48字节
         16*32点阵字体的首地址：
            BaseAdd=0x00004C00;
            BytesPerFont = 64字节
           这四种点阵全部是采用下面的计算公式：  
                              Address = ASCIICode * BytesPerFont + BaseAdd
（虽然前面是采用8859-1编码生成的，但计算公式依然是这个，因为8859-1的256个编码的前128个字符就是ASCII，后128是扩展ASCII部分）

席萌0209

27.4GBK全字库的移植方法


    移植方法在第25章的25.3小节已经详细讲解，这里不再赘述。

席萌0209

27.5 移植文件简易说明


    移植文件已经在第25章的25.4小节已经详细讲解，这里主要为大家讲解如何修改这些文件来支持新生成的GBK编码字符，如果大家新生成了其它字体，方法是类似的。

27.5.1   文件GUICharPEx.c要修改的内容

    对于这个文件，用户仅需修改函数：

static voidGUI_GetDataFromMemory(const GUI_FONT_PROP GUI_UNI_PTR *pProp, U16P c)

这里依然是从SPIFlash里面读取点阵数据：

1. /* 点阵数据缓存, 必须大于等于单个字模需要的存储空间*/
2. #define BYTES_PER_FONT      512
3. static U8 GUI_FontDataBuf[BYTES_PER_FONT];
5. /*
6. *********************************************************************************************************
7. *    函 数 名: GUI_GetDataFromMemory
8. *    功能说明: 读取点阵数据
9. *    形    参: pProp  GUI_FONT_PROP类型结构
10. *             c      字符
11. *    返 回 值: 无
12. *********************************************************************************************************
13. */
14. static void GUI_GetDataFromMemory(const GUI_FONT_PROP GUI_UNI_PTR *pProp, U16P c)
15. {
16.     U16 BytesPerFont;
17.     U32 oft = 0, BaseAdd;
18.      U8 code1,code2;
19.    
20.      char *font = (char *)pProp->paCharInfo->pData;
22.      /* 每个字模的数据字节数 */
23.     BytesPerFont = GUI_pContext->pAFont->YSize * pProp->paCharInfo->BytesPerLine;
24.     if (BytesPerFont > BYTES_PER_FONT)
25.      {
26.          BytesPerFont = BYTES_PER_FONT;
27.      }
29.      /* 英文字符地址偏移计算 */
30.     if (c < 0x80)                                                               
31.     {
32.          if(strncmp("A12", font, 3) == 0)     /* 6*12 ASCII字符 */
33.          {
34.               BaseAdd = 0x00000000;
35.          }
36.          else if(strncmp("A16", font, 3) == 0) /* 8*16 ASCII字符 */
37.          {
38.               BaseAdd = 0x00000C00;
39.          }
40.          else if(strncmp("A24", font, 3) == 0) /* 12*24 ASCII字符 */
41.          {
42.               BaseAdd = 0x00001C00;
43.          }
44.          else if(strncmp("A32", font, 3) == 0) /* 24*48 ASCII字符 */
45.          {
46.               BaseAdd = 0x00004C00;
47.          }
48.         
49.          oft = c* BytesPerFont + BaseAdd;
50.     }
51.      /* 汉字和全角字符的偏移地址计算 */
52.     else                                                                          
53.     {
54.          if(strncmp("H12", font, 3) == 0)      /* 12*12 字符 */
55.          {
56.               BaseAdd = 0x00008C00;
57.          }
58.          else if(strncmp("H16", font, 3) == 0)  /* 16*16 字符 */
59.          {
60.               BaseAdd = 0x00095060;
61.          }
62.          else if(strncmp("H24", font, 3) == 0)  /* 24*24 字符 */
63.          {
64.               BaseAdd = 0x001500E0;
65.          }
66.          else if(strncmp("H32", font, 3) == 0)  /* 32*32 字符 */
67.          {
68.               BaseAdd = 0x002F4E00;
69.          }
70.         
71.          /* 根据汉字内码的计算公式锁定起始地址 */
72.          code2 = c >> 8;
73.          code1 = c & 0xFF;
74.         
75.          /* 由于字符编码是按顺序存储的，先存储到高位（区号），然后是低位（位号）。而我们用的是小端格式，
76.             一个汉字两个字节，获取的16位变量，正好相反，16位变量的高位是位号，低位是区号。
77.          */
78.          oft = ((code1 - 0x81) * 190 + (code2- 0x40) - (code2 / 128))* BytesPerFont + BaseAdd;
79.     }
80.    
81.      /* 读取点阵数据 */
82.      sf_ReadBuffer(GUI_FontDataBuf, oft, BytesPerFont);
83. }

复制代码

红色字体部分都是要修改的。
1、首先是ASCII字符和GBK字符的首地址全部修改，按照27.3小节的地址来配置。
2、其次是ASCII字符和GBK字符的计算公式都被修改了，也是按照27.3小节的公式来写。
    其中ASCII的地址，这里再简单的补充点知识，第25章中ASCII的计算公式是:
                     oft = (c – 0x20)*BytesPerFont + BaseAdd;
      减去0x20是因为ASCII点阵库就是从0x20开始到0x7F，前0x20个没有使用，而本章节是将0x00到0x7F都生成了，所以不再需要减去0x20了。

27.5.2   文件GUI_UC_EncodeNone.c 要修改的内容


    相比第25章的25.4.2小节，下面红色字体的地方是要修改的，以适应GBK编码字符。

1. #include "GUI_Private.h"
3. /*********************************************************************
4. *
5. *       Static code
6. *
7. **********************************************************************
8. */
9. /*********************************************************************
10. *
11. *       _GetCharCode
12. *
13. * Purpose:
14. *   Return the UNICODE character code of the current character.
15. */
16. static U16 _GetCharCode(const char GUI_UNI_PTR * s) {
17.   if((*s) > 0x7f) /* ASCII字符编码是00-7F，返回一个字节数据即可，GBK编码是8041到FEFE，需要返回两个字节
18. 数据，这里以第一个字节作为判断即可 */
19.   {
20.     return *(const U16 GUI_UNI_PTR *)s;
21.   }
22.   return *(const U8 GUI_UNI_PTR *)s;
23. }
25. /*********************************************************************
26. *
27. *       _GetCharSize
28. *
29. * Purpose:
30. *   Return the number of bytes of the current character.
31. */
32. static int _GetCharSize(const char GUI_UNI_PTR * s) {
33.   GUI_USE_PARA(s);
34. if((*s) > 0x7f) /* ASCII字符编码是00-7F，返回一个字节大小，GBK编码是8041到FEFE，需要返回两个字节大小，
35. 这里以第一个字节作为判断即可 */
37.   {
38.     return 2;
39.   }
40.   return 1;
41. }
43. /*********************************************************************
44. *
45. *       _CalcSizeOfChar
46. *
47. * Purpose:
48. *   Return the number of bytes needed for the given character.
49. */
50. static int _CalcSizeOfChar(U16 Char) {
51.   GUI_USE_PARA(Char);
52.   if(Char >= 0x4081) /* ASCII字符编码是00-7F，返回一个字节大小，GBK编码是8041到FEFE，需要返回两个字节大
53. 小，这里以0x4081(小端格式)作为判断 */
54.   {
55.     return 2;
56.   }
57.   return 1;
58. }
60. /*********************************************************************
61. *
62. *       _Encode
63. *
64. * Purpose:
65. *   Encode character into 1/2/3 bytes.
66. */
67. static int _Encode(char *s, U16 Char) {
68.   if(Char >= 0x4081) /* ASCII字符编码是00-7F，返回一个字节大小，GBK编码是8041到FEFE，需要返回两个字节大
69. 小，这里以0x4081(小端格式)作为判断 */
70.   {
71.     *((U16 *)s) = (U16)(Char);
72.     return 2;
73.   }
74.   *s = (U8)(Char);
75.   return 1;
76. }
78. /*********************************************************************
79. *
80. *       Static data
81. *
82. **********************************************************************
83. */
84. /*********************************************************************
85. *
86. *       _API_Table
87. */
88. const GUI_UC_ENC_APILIST GUI__API_TableNone = {
89.   _GetCharCode,     /*  return character code as U16 */
90.   _GetCharSize,     /*  return size of character: 1 */
91.   _CalcSizeOfChar,  /*  return size of character: 1 */
92.   _Encode           /*  Encode character */
93. };
95. const GUI_UC_ENC_APILIST GUI_UC_None = {
96.   _GetCharCode,     /*  return character code as U16 */
97.   _GetCharSize,     /*  return size of character: 1 */
98.   _CalcSizeOfChar,  /*  return size of character: 1 */
99.   _Encode           /*  Encode character */
100. };

复制代码

27.5.3   文件GUI_Font12.c，GUI_Font16.c等要修改的内容

    与第25章的25.4.3小节中使用的文件GUI_Font12.c，GUI_Font16.c，GUI_Font24.c和GUI_Font32.c相比，仅需修改GBK和ASCII的编码范围，这四个文件要修改的内容都是一样的，这里以GUI_Font16.c为例进行说明。

1. #include "GUI.h"
2. #include "GUI_Type.h"
5. GUI_CONST_STORAGE GUI_CHARINFO GUI_FontHZ16_CharInfo[2] =
6. {   
7.     {  8,    8,  1, (void *)"A16"},     
8.     {  16,  16,  2, (void *)"H16"},         
9. };
11. GUI_CONST_STORAGE GUI_FONT_PROP GUI_FontHZ16_PropHZ= {
12.       0x4081,
13.       0xFEFE,
14.       &GUI_FontHZ16_CharInfo[1],
15.       (void *)0,
16. };
18. GUI_CONST_STORAGE  GUI_FONT_PROP GUI_FontHZ16_PropASC= {
19.       0x0000,
20.       0x007F,
21.       &GUI_FontHZ16_CharInfo[0],
22.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropHZ,
23. };
25. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16 =
26. {
27.        GUI_FONTTYPE_USER,
28.       16,
29.       16,
30.       1,  
31.       1,  
32.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropASC,
33. };
34. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16x2 =
35. {
36.        GUI_FONTTYPE_USER,
37.       16,
38.       16,
39.       2,  
40.       2,  
41.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropASC
42. };

复制代码

上面代码中标注为红色字体的部分都是需要用户进行修改的。
1、GBK的范围修改为0x4081到0xFEFE，为什么范围是这个，而不是0x8140到0xFEFE，在第25章的25.2小节末尾进行讲解了。
2、ASCII的范围修改为0x0000到0x007F。

席萌0209

27.6    GBK字库使用方法


    移植好之后，使用就比较容易了，下面分3步进行说明：
第1步：声明12点阵，16点阵，24点阵和32点阵的字体，放在了MainTask.h文件里面，方便调用，程序代码中只需包含这个头文件就可以了。

1. /*
2. *********************************************************************************************************
3. *                                         字体声明
4. *********************************************************************************************************
5. */
6. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ32;
7. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ24;
8. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16;
9. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ12;

复制代码

有几种点阵字库就通过extern声明几个，方便外部文件调用。
第2步：将字库文件font.bin存储到SPI Flash中，我们这里在电脑端将font.bin文件存储到SD卡中（字库文件font.bin已经放在本章节配例子的Doc文件夹），然后开发板上电后将其从SD卡中加载到SPI Flash里面，加载代码如下：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: LoadFontLib()
4. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
5. *    形    参: 无      
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void LoadFontLib(void)
10. {
11.      float FinishPecent;
12.     uint32_t Count = 0;
13.      uint16_t y, i;
14.      uint8_t ucState;
15.      char cDispBuf[80];
17.    
18.      /* 清屏 */
19.      GUI_SetBkColor(GUI_BLUE);
20.      GUI_Clear();
21.    
22.      /* 设置字体 */
23.      GUI_SetFont(GUI_FONT_20_1);
25.     y = 0;
26.      /* 第1步：显示操作说明 ***************************************************************/
27.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
28.      y += 20;
29.    
30.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
31.      y += 20;
32.    
33.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
34.      y += 20;
35.    
36.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
37.      for(i = 0; i < 11; i++)
38.      {
39.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
40.          GUI_DispStringAt(cDispBuf, 0, y);
41.          GUI_Delay(1000);
42.      }
43.      y += 20;
44.    
45.    
46.      /* 第2步：打开文件 ***************************************************************/
47.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
48.      if (result !=  FR_OK)
49.      {
50.          GUI_DispStringAt("font.bin open failed", 0, y);
51.          y += 20;
52.      }
54.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
55.      for(;;)
56.      {
57.          /* 读取一个扇区的数据到buf */
58.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
59.         
60.          /* 读取出错或者读取完毕，退出 */
61.          if ((result != FR_OK)||bw == 0)
62.          {
63.               break;
64.          }
65.         
66.          /* 写数据到SPI FLASH */
67.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
68.         
69.          /* 如果返回0，表示复制失败 */
70.          if(ucState == 0)
71.          {
72.               GUI_DispStringAt("copy failed                  ", 0, y);
73.               break;
74.          }
75.         
76.          /* 显示复制进度 */
77.          Count = Count + 1;
78.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
79.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
80.          GUI_DispStringAt(cDispBuf, 0, y);
81.      }
82.    
83.      /* 等待1秒后开始进去emWin主界面 */
84.      GUI_Delay(1000);
85. }

复制代码

第3步：加载到SPI Flash后，使用就很方便了。
    比如设置按钮的字体使用16点阵，调用如下设置函数即可。
      BUTTON_SetFont(hWin, &GUI_FontHZ16);  /* hWin是按钮的句柄 */
    设置其它控件是一样的。另外注意，使用GB编码没有烦人的文件编码设置问题了，从这一点来说，比使用前面章节讲的XBF格式和SIF格式的Unicode编码方便很多了。

席萌0209

27.7 实验例程说明（RTOS）


配套例子：
    V6-536_STemWin实验_任意大小全字库的生成和使用方法，GBK编码（RTOS）
实验目的：
    1.     学习emWin的GBK编码全字库的的创建和使用方法。
    2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
    1.     K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
    2.     K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
    3.     各个任务实现的功能如下：
              App Task Start   任务：实现按键和触摸扫描。
              App Task MspPro任务 ：实现截图功能，将图片以BMP格式保存到SD卡中。
              App Task UserIF  任务：按键消息处理。
              App Task COM   任务：暂未使用。
                App Task GUI    任务：GUI任务。
支持点阵：
    1.     支持12点阵，16点阵，24点阵以及32点阵汉字。
    2.     6X12点阵的ASCII，8X16点阵的ASCII，12X24点阵的ASCII，16X32点阵的ASCII。
字库存储方式：
    1.     字库存储到SPI FLASH里面。
实验步骤：
    1.     将字库文件font.bin放到SD卡根目录中，系统上电后会将其加载到SPI FLASH里面。
    2.     板子上电后会有一个加载进度指示，存储到SPI FLASH成功后会显示一个对话框。
实验注意：
    1.     实验所需的字库文件font.bin已经存储到本工程的Doc文件夹下，使用此例子前，请务必将这个文件存储到SD卡根目录中，并将SD卡插到开发板上面。
μ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;
170.                   
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.                    default:                     /* 其他的键值不处理 */
178.                        break;
179.               }
180.          }
181.         
182.          OSTimeDly(20, OS_OPT_TIME_DLY, &err);
183.      }
184. }
186. /*
187. *********************************************************************************************************
188. *    函 数 名: AppTaskCom
189. *    功能说明: 暂未使用
190. *    形    参: p_arg 是在创建该任务时传递的形参
191. *    返 回 值: 无
192.      优 先 级: 5
193. *********************************************************************************************************
194. */
195. static void AppTaskCOM(void *p_arg)
196. {
197.      OS_ERR  err;      
198.    
199.      (void)p_arg;
200.    
201.      while(1)
202.      {   
203.          OSTimeDly(500, OS_OPT_TIME_DLY, &err);
204.      }                                                                                                
205. }
207. /*
208. *********************************************************************************************************
209. *    函 数 名: AppTaskGUI
210. *    功能说明: GUI任务，最低优先级                        
211. *    形    参：p_arg 是在创建该任务时传递的形参
212. *    返 回 值: 无
213. *   优 先 级：OS_CFG_PRIO_MAX - 4u
214. *********************************************************************************************************
215. */
216. static void AppTaskGUI(void *p_arg)
217. {
218.     (void)p_arg;       /* 避免编译器告警 */
219.         
220.      while (1)
221.      {
222.          MainTask();
223.      }
224. }

复制代码

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

1. #include "MainTask.h"
2. #include "includes.h"
5. /*
6. *********************************************************************************************************
7. *                                             变量
8. *********************************************************************************************************
9. */
10. uint8_t tempbuf[4096];  /* 从SD卡读取数据的缓冲 */
13. /*
14. *********************************************************************************************************
15. *                                               对话框信息
16. *********************************************************************************************************
17. */
18. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
19. { FRAMEWIN_CreateIndirect,  "安富莱电子",     0,    0,  0,  480, 272,FRAMEWIN_CF_MOVEABLE, 0},
20. { BUTTON_CreateIndirect, "安富莱电子",     GUI_ID_BUTTON0,  10, 150, 400, 50, 0, 0},
21. { TEXT_CreateIndirect, "安富莱电子嬅枅炗犣鰻AaＡａ-12点阵半角全角，GBK测试", GUI_ID_TEXT0,0,10, 480, 33, 0,0},
22. { TEXT_CreateIndirect, "安富莱电子嬅枅炗犣鰻AaＡａ-16点阵半角全角，GBK测试",GUI_ID_TEXT1, 0,40, 480, 33, 0,0},
23. { TEXT_CreateIndirect, "安富莱电子嬅枅炗AaＡａ-24点阵半角全角",   GUI_ID_TEXT2,   0, 70, 480, 72, 0,0},
24. { TEXT_CreateIndirect, "安富莱电子AaＡａ-32点阵半全角",     GUI_ID_TEXT3,   0, 100, 480, 72, 0,0},
25. };
27. /*
28. *********************************************************************************************************
29. *    函 数 名: PaintDialog
30. *    功能说明: 重绘
31. *    形    参：pMsg  消息指针
32. *    返 回 值: 无
33. *********************************************************************************************************
34. */
35. void PaintDialog(WM_MESSAGE * pMsg)
36. {
37. //    WM_HWIN hWin = pMsg->hWin;
38.    
39. }
41. /*
42. *********************************************************************************************************
43. *    函 数 名: InitDialog
44. *    功能说明: 对话框初始化
45. *    形    参：pMsg  消息指针
46. *    返 回 值: 无
47. *********************************************************************************************************
48. */
49. void InitDialog(WM_MESSAGE * pMsg)
50. {
51.     WM_HWIN hWin = pMsg->hWin;
52.     //
53.     //FRAMEWIN
54.     //
55.     FRAMEWIN_SetFont(hWin,&GUI_FontHZ24);
56.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
57.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
58.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
59.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
60.     FRAMEWIN_SetTitleHeight(hWin,35);
61.    
62.     //
63.     //GUI_ID_BUTTON0
64.     //
65.     BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON0),&GUI_FontHZ32);
66.    
67.     //
68.     //GUI_ID_TEXT0
69.     //
70.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT0), GUI_RED);
71.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontHZ12);
72.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT1), GUI_BLUE);
73.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_FontHZ16);
74.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT2), GUI_MAGENTA);
75.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_FontHZ24);
76.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT3), GUI_ORANGE);
77.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_FontHZ32);
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: _cbCallback
83. *    功能说明: 对话框回调函数
84. *    形    参: pMsg  消息指针
85. *    返 回 值: 无
86. *********************************************************************************************************
87. */
88. static void _cbCallback(WM_MESSAGE * pMsg)
89. {
90.     int NCode, Id;
91.     WM_HWIN hWin = pMsg->hWin;
92.     switch (pMsg->MsgId)
93.     {
94.         case WM_PAINT:
95.             PaintDialog(pMsg);
96.             break;
97.         
98.         case WM_INIT_DIALOG:
99.             InitDialog(pMsg);
100.             break;
101.         
102.         case WM_KEY:
103.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
104.             {
105.                 case GUI_KEY_ESCAPE:
106.                     GUI_EndDialog(hWin, 1);
107.                     break;
108.                   
109.                 case GUI_KEY_ENTER:
110.                     GUI_EndDialog(hWin, 0);
111.                     break;
112.             }
113.             break;
114.             
115.         case WM_NOTIFY_PARENT:
116.             Id = WM_GetId(pMsg->hWinSrc);
117.             NCode = pMsg->Data.v;      
118.             switch (Id)
119.             {
120.                 case GUI_ID_OK:
121.                     if(NCode==WM_NOTIFICATION_RELEASED)
122.                         GUI_EndDialog(hWin, 0);
123.                     break;
124.                      
125.                 case GUI_ID_CANCEL:
126.                     if(NCode==WM_NOTIFICATION_RELEASED)
127.                         GUI_EndDialog(hWin, 0);
128.                     break;
129.             }
130.             break;
131.             
132.         default:
133.             WM_DefaultProc(pMsg);
134.     }
135. }
137. /*
138. *********************************************************************************************************
139. *    函 数 名: LoadFontLib()
140. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
141. *    形    参: 无      
142. *    返 回 值: 无
143. *********************************************************************************************************
144. */
145. void LoadFontLib(void)
146. {
147.      float FinishPecent;
148.     uint32_t Count = 0;
149.      uint16_t y, i;
150.      uint8_t ucState;
151.      char cDispBuf[80];
153.    
154.      /* 清屏 */
155.      GUI_SetBkColor(GUI_BLUE);
156.      GUI_Clear();
157.    
158.      /* 设置字体 */
159.      GUI_SetFont(GUI_FONT_20_1);
161.     y = 0;
162.      /* 第1步：显示操作说明 ***************************************************************/
163.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
164.      y += 20;
165.    
166.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
167.      y += 20;
168.    
169.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
170.      y += 20;
171.    
172.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
173.      for(i = 0; i < 11; i++)
174.      {
175.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
176.          GUI_DispStringAt(cDispBuf, 0, y);
177.          GUI_Delay(1000);
178.      }
179.      y += 20;
180.    
181.    
182.      /* 第2步：打开文件 ***************************************************************/
183.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
184.      if (result !=  FR_OK)
185.      {
186.          GUI_DispStringAt("font.bin open failed", 0, y);
187.          y += 20;
188.      }
190.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
191.      for(;;)
192.      {
193.          /* 读取一个扇区的数据到buf */
194.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
195.         
196.           /* 读取出错或者读取完毕，退出 */
197.          if ((result != FR_OK)||bw == 0)
198.          {
199.               break;
200.          }
201.         
202.           /* 写数据到SPI FLASH */
203.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
204.         
205.           /* 如果返回0，表示复制失败 */
206.          if(ucState == 0)
207.          {
208.               GUI_DispStringAt("copy failed                  ", 0, y);
209.               break;
210.          }
211.         
212.           /* 显示复制进度 */
213.          Count = Count + 1;
214.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
215.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
216.          GUI_DispStringAt(cDispBuf, 0, y);
217.      }
218.    
219.      /* 等待1秒后开始进去emWin主界面 */
220.      GUI_Delay(1000);
221. }
223. /*
224. *********************************************************************************************************
225. *    函 数 名: MainTask
226. *    功能说明: GUI主函数
227. *    形    参: 无
228. *    返 回 值: 无
229. *********************************************************************************************************
230. */
231. void MainTask(void)
232. {
233.      /* 初始化 */
234.      GUI_Init();
235.       
236.      /*
237.       关于多缓冲和窗口内存设备的设置说明
238.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
239.            WM_MULTIBUF_Enable(1);
240.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
241.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
242.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
243.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
244.         4. 所有emWin例子默认是开启三缓冲。
245.      */
246.      WM_MULTIBUF_Enable(1);
248.      /*
249.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
250.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
251.      */
252.     //TOUCH_Calibration();
253.    
254.      /* 初始化使用GUI以前，先将字库从SD卡中加载到SP FLASH里面，加载一次即可，以后使用无需重复加载*/
255.      LoadFontLib();
256.    
257.      /* 调用此函数会自动的刷新桌面窗口 */
258.      WM_SetDesktopColor(GUI_BLUE);
260.      /* 创建对话框 */
261.      GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
262.    
263.      while(1)
264.      {
265.          GUI_Delay(10);
266.      }
267. }

复制代码

席萌0209

27.8 实验例程说明（裸机）


配套例子：
    V6-537_STemWin实验_任意大小全字库的生成和使用方法，GBK编码（裸机）
实验目的：
     1.     学习emWin的GBK编码全字库的的创建和使用方法。
     2.     emWin功能的实现在MainTask.c文件里面。
支持点阵：
    1.     支持12点阵，16点阵，24点阵以及32点阵汉字。
    2.     6X12点阵的ASCII，8X16点阵的ASCII，12X24点阵的ASCII，16X32点阵的ASCII。
字库存储方式：
    1.     字库存储到SPI FLASH里面。
实验步骤：
    1.     将字库文件font.bin放到SD卡根目录中，系统上电后会将其加载到SPI FLASH里面。
    2.     板子上电后会有一个加载进度指示，存储到SPI FLASH成功后会显示一个对话框。
实验注意：
    1.     实验所需的字库文件font.bin已经存储到本工程的Doc文件夹下，使用此例子前，请务必将这个文件存储到SD卡根目录中，并将SD卡插到开发板上面。
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. uint8_t tempbuf[4096];  /* 从SD卡读取数据的缓冲 */
14. /*
15. *********************************************************************************************************
16. *                                               对话框信息
17. *********************************************************************************************************
18. */
19. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
20. { FRAMEWIN_CreateIndirect,  "安富莱电子",     0,    0,  0,  480, 272,FRAMEWIN_CF_MOVEABLE, 0},
21. { BUTTON_CreateIndirect, "安富莱电子",     GUI_ID_BUTTON0,  10, 150, 400, 50, 0, 0},
22. { TEXT_CreateIndirect, "安富莱电子嬅枅炗犣鰻AaＡａ-12点阵半角全角，GBK测试", GUI_ID_TEXT0,0,10, 480, 33, 0,0},
23. { TEXT_CreateIndirect, "安富莱电子嬅枅炗犣鰻AaＡａ-16点阵半角全角，GBK测试",GUI_ID_TEXT1, 0,40, 480, 33, 0,0},
24. { TEXT_CreateIndirect, "安富莱电子嬅枅炗AaＡａ-24点阵半角全角",   GUI_ID_TEXT2,   0, 70, 480, 72, 0,0},
25. { TEXT_CreateIndirect, "安富莱电子AaＡａ-32点阵半全角",     GUI_ID_TEXT3,   0, 100, 480, 72, 0,0},
26. };
28. /*
29. *********************************************************************************************************
30. *    函 数 名: PaintDialog
31. *    功能说明: 重绘
32. *    形    参：pMsg  消息指针
33. *    返 回 值: 无
34. *********************************************************************************************************
35. */
36. void PaintDialog(WM_MESSAGE * pMsg)
37. {
38. //    WM_HWIN hWin = pMsg->hWin;
39.    
40. }
42. /*
43. *********************************************************************************************************
44. *    函 数 名: InitDialog
45. *    功能说明: 对话框初始化
46. *    形    参：pMsg  消息指针
47. *    返 回 值: 无
48. *********************************************************************************************************
49. */
50. void InitDialog(WM_MESSAGE * pMsg)
51. {
52.     WM_HWIN hWin = pMsg->hWin;
53.     //
54.     //FRAMEWIN
55.     //
56.     FRAMEWIN_SetFont(hWin,&GUI_FontHZ24);
57.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
58.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
59.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
60.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
61.     FRAMEWIN_SetTitleHeight(hWin,35);
62.    
63.     //
64.     //GUI_ID_BUTTON0
65.     //
66.     BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON0),&GUI_FontHZ32);
67.    
68.     //
69.     //GUI_ID_TEXT0
70.     //
71.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT0), GUI_RED);
72.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontHZ12);
73.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT1), GUI_BLUE);
74.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_FontHZ16);
75.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT2), GUI_MAGENTA);
76.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_FontHZ24);
77.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT3), GUI_ORANGE);
78.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_FontHZ32);
79. }
81. /*
82. *********************************************************************************************************
83. *    函 数 名: _cbCallback
84. *    功能说明: 对话框回调函数
85. *    形    参: pMsg  消息指针
86. *    返 回 值: 无
87. *********************************************************************************************************
88. */
89. static void _cbCallback(WM_MESSAGE * pMsg)
90. {
91.     int NCode, Id;
92.     WM_HWIN hWin = pMsg->hWin;
93.     switch (pMsg->MsgId)
94.     {
95.         case WM_PAINT:
96.             PaintDialog(pMsg);
97.             break;
98.         
99.         case WM_INIT_DIALOG:
100.             InitDialog(pMsg);
101.             break;
102.         
103.         case WM_KEY:
104.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
105.             {
106.                 case GUI_KEY_ESCAPE:
107.                     GUI_EndDialog(hWin, 1);
108.                     break;
109.                   
110.                 case GUI_KEY_ENTER:
111.                     GUI_EndDialog(hWin, 0);
112.                     break;
113.             }
114.             break;
115.             
116.         case WM_NOTIFY_PARENT:
117.             Id = WM_GetId(pMsg->hWinSrc);
118.             NCode = pMsg->Data.v;      
119.             switch (Id)
120.             {
121.                 case GUI_ID_OK:
122.                     if(NCode==WM_NOTIFICATION_RELEASED)
123.                         GUI_EndDialog(hWin, 0);
124.                     break;
125.                      
126.                 case GUI_ID_CANCEL:
127.                     if(NCode==WM_NOTIFICATION_RELEASED)
128.                         GUI_EndDialog(hWin, 0);
129.                     break;
130.             }
131.             break;
132.             
133.         default:
134.             WM_DefaultProc(pMsg);
135.     }
136. }
138. /*
139. *********************************************************************************************************
140. *    函 数 名: LoadFontLib()
141. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
142. *    形    参: 无      
143. *    返 回 值: 无
144. *********************************************************************************************************
145. */
146. void LoadFontLib(void)
147. {
148.      float FinishPecent;
149.     uint32_t Count = 0;
150.      uint16_t y, i;
151.      uint8_t ucState;
152.      char cDispBuf[80];
154.    
155.      /* 清屏 */
156.      GUI_SetBkColor(GUI_BLUE);
157.      GUI_Clear();
158.    
159.      /* 设置字体 */
160.      GUI_SetFont(GUI_FONT_20_1);
162.     y = 0;
163.      /* 第1步：显示操作说明 ***************************************************************/
164.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
165.      y += 20;
166.    
167.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
168.      y += 20;
169.    
170.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
171.      y += 20;
172.    
173.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
174.      for(i = 0; i < 11; i++)
175.      {
176.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
177.          GUI_DispStringAt(cDispBuf, 0, y);
178.          GUI_Delay(1000);
179.      }
180.      y += 20;
181.    
182.    
183.      /* 第2步：打开文件 ***************************************************************/
184.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
185.      if (result !=  FR_OK)
186.      {
187.          GUI_DispStringAt("font.bin open failed", 0, y);
188.          y += 20;
189.      }
191.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
192.      for(;;)
193.      {
194.          /* 读取一个扇区的数据到buf */
195.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
196.         
197.           /* 读取出错或者读取完毕，退出 */
198.          if ((result != FR_OK)||bw == 0)
199.          {
200.               break;
201.          }
202.         
203.           /* 写数据到SPI FLASH */
204.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
205.         
206.           /* 如果返回0，表示复制失败 */
207.          if(ucState == 0)
208.          {
209.               GUI_DispStringAt("copy failed                  ", 0, y);
210.               break;
211.          }
212.         
213.           /* 显示复制进度 */
214.          Count = Count + 1;
215.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
216.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
217.          GUI_DispStringAt(cDispBuf, 0, y);
218.      }
219.    
220.      /* 等待1秒后开始进去emWin主界面 */
221.      GUI_Delay(1000);
222. }
224. /*
225. *********************************************************************************************************
226. *    函 数 名: MainTask
227. *    功能说明: GUI主函数
228. *    形    参: 无
229. *    返 回 值: 无
230. *********************************************************************************************************
231. */
232. void MainTask(void)
233. {
234.      /* 初始化 */
235.      GUI_Init();
236.       
237.      /*
238.       关于多缓冲和窗口内存设备的设置说明
239.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
240.            WM_MULTIBUF_Enable(1);
241.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
242.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
243.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
244.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
245.         4. 所有emWin例子默认是开启三缓冲。
246.      */
247.      WM_MULTIBUF_Enable(1);
249.      /*
250.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
251.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
252.      */
253.     //TOUCH_Calibration();
254.    
255.      /* 初始化使用GUI以前，先将字库从SD卡中加载到SP FLASH里面，加载一次即可，以后使用无需重复加载*/
256.      LoadFontLib();
257.    
258.      /* 调用此函数会自动的刷新桌面窗口 */
259.      WM_SetDesktopColor(GUI_BLUE);
261.      /* 创建对话框 */
262.      GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
263.    
264.      while(1)
265.      {
266.          GUI_Delay(10);
267.      }
268. }

复制代码

席萌0209

27.9总结


    本章节为大家讲解的GBK编码格式字体是可以用于项目实战的，对于习惯了GBK编码的用户来说是个很好的选择。这种方式的字体可以存储到任何外部存储介质中。