STM32学习——uCGUI移植

以下内容大多是网上资源，我只做一些修改和结合，为的是能够方便更多的和我一样的菜鸟们搞懂GUI的移植。

                                                                                                                                                                                                      ----kxr

第一部分：在UCGUI移植之前

在移植之前，首先要了解在网上下的UCGUI 3.98源码的文件结构是。

UCGUI 3.98源码中有三个文件夹：

1）“tool文件夹”是用来使用一些uCgui的上位机程序,基本都是字体和模板查看之类的.

2）“sample文件夹”下面是已经别人帮你写好了很多有用的东西,像跟操作系统有关的GUI_X或者一些模板(后面我们会用到的自己定义的Demo),或者是gui配置.后面再一一详细叙说这个文件夹的功能.

3）“Start文件夹”里面,这是我们最主要的文件夹.里面就包含了uCGUI的源代码,uCGUI的作者把源代码放进vc里面进行编译了(当然,这是用标准C语言写的程序,所以我们可以放在任何C语言平台下编译而不会担心兼容性问题,这个uCGUI在这方面做的算是完美了),所以,我们可以在vc平台下写界面,然后再把代码拷进我们的下位机编译器进行编译,这样子效率就会非常高了。

Start文件夹”目录内容：

Config,配置文件;
GUI/AntiAlias,抗锯齿支持;
GUI/ConvertMono,用于B/W（黑白两色）及灰度显示的色彩转换程序; 
GUI/ConvertColor,用于彩色显示的色彩转换的程序; 
GUI/Core µC/GUI,内核文件; 
GUI/Font,字体文件; 
GUI/LCDDriver,LCD 驱动; 
GUI/Mendev,存储器件支持; 
GUI/Touch,触摸屏支持; 
GUI/Widget,视窗控件库; 
GUI/WM,视窗管理器; 

 

移植uC/GUI主要集中在修改三个头文件和两个C文件:
三个头文件都在\Config下，分别是GUICon.h ,GUITouchConf.h,LCDConf.h ；
两个C文件一个是GUI_X.C(Sample\GUI_X.C),另外一个在GUI\LCDDriver目录下（LCDWin.c）。

第二部分：修改配置文件GUICon.h ,GUITouchConf.h,LCDConf.h

在“Start文件夹”里有两个文件夹里的内容，使我们移植所关心的。一个是CONFIG  ,   另一个是\GUI\LCDDriver。

 

在CONFIG文件夹中有三个.h文件，GUIConf.h、

CONFIG：

  配置LCDConf.h文件如下：
         #ifndef LCDCONF_H
#define LCDCONF_H
#define LCD_XSIZE           (160)    //配置TFT的水平分辨率
#define LCD_YSIZE           (128)    //配置TFT的垂直分辨率
#define LCD_CONTROLLER      (54124) //TFT控制器的名称
#define LCD_BITSPERPIXEL    (16)     //每个像素的位数
#define LCD_FIXEDPALETTE    (565)    //调色板格式
#define LCD_SWAP_RB         (0)      //红蓝反色交换
#define LCD_INIT_CONTROLLER()    TFT_Init() ;         //此处需要定义的是你的TFT初始化函数
         #endif /* LCDCONF_H */ 

配置GUIConf.h文件如下：
         #ifndef GUICONF_H
         #define GUICONF_H

#define GUI_OS                  (1)   //多任务
#define GUI_SUPPORT_TOUCH       (0)   //触摸
                      #define GUI_SUPPORT_UNICODE     （1)   //Unicode支持
#define GUI_DEFAULT_FONT         &GUI_Font6x8   //GUI默认字体
#define GUI_ALLOC_SIZE           5000   //动态内存的大小
#define GUI_WINSUPPORT           1   //窗口控件支持
#define GUI_SUPPORT_MEMDEV       1   //支持内存设备
#define GUI_SUPPORT_AA           1   /* Anti aliasing available */

         #endif   /* Avoid multiple inclusion */

配置GUITouchConf.h文件如下：
#ifndef __GUITOUCH_CONF_H
#define __GUITOUCH_CONF_H

#define GUI_TOUCH_SWAP_XY       0
#define GUI_TOUCH_MIRROR_X      0
#define GUI_TOUCH_MIRROR_Y      0

#define GUI_TOUCH_AD_LEFT       3601
#define GUI_TOUCH_AD_RIGHT      393
#define GUI_TOUCH_AD_TOP        273
#define GUI_TOUCH_AD_BOTTOM     3671

#endif /* GUITOUCH_CONF_H */

 

第三部分：修改LCDWin.c

LCDDriver这个文件夹中一共有三个文件分别是：LCDWin、LCDNull.c、LCDDummy.c 。

在LCD的最基本操作就是在某一个坐标上画点，其他的操作都是画点操作延伸出来的。必须要把画点这个函数连接到uC/GUI的代码里面。连接的函数就在LCDDriver下，我选用LCDWin.c（还有两个文件是LCDNULL.c和LCDDUMMY.c，这三个文件选一个作为驱动程序就可以，都是些模板）

修改这个文件的时候要注意，首先要屏蔽掉第一行的条件编译语句 #if defined(WIN32) && !defined(LCD_SIMCONTROLLER) 和文件的最后一行的#endif  顺便把#endif头上的#else 也干掉。这个文件是针对PC仿真的，不注释掉这几个地方，整个文件都不会被编译的。

分别根据自己的硬件板重写如下函数：
void LCD_L0_DrawPixel(int x, int y) 
void LCD_L0_DrawHLine(int x0, int y,  int x1) 
void LCD_L0_DrawVLine(int x, int y0,  int y1) 
void LCD_L0_FillRect(int x0, int y0, int x1, int y1) 
void LCD_L0_DrawBitmap(int x0, int y0,
                       int xsize, int ysize,
                       int BitsPerPixel, 
                       int BytesPerLine,
                       const U8* pData, int Diff,
                       const LCD_PIXELINDEX* pTrans)
void LCD_L0_SetOrg(int x, int y)
int  LCD_GetErrStat(void) 
void LCD_ClrErrStat(void) 
int  LCD_GetErrCnt (void) 
void LCD_Off(void) {}
void LCD_On(void) {}
int  LCD_L0_Init(void) 
int  LCD_L0_CheckInit(void) 
void LCD_L0_ReInit(void)
unsigned LCD_L0_GetPixelIndex(int x, int y)
void LCD_L0_XorPixel(int x, int y) 
void LCD_L0_SetPixelIndex(int x, int y, int ColorIndex)
void * LCD_L0_GetDevFunc(int Index)

说明：有的函数可以不用修改，可以用它软件的实现，有的则要重写，有的则可以直接返回0，完全有你个人的硬件板所决定。

    
5、修改GUI_X.C(Sample\GUI_X.C)文件，这主要是系统级的函数。
在GUI_X这个文件夹下有3个GUI_X*文件。分别为：GUI_X.c、GUI_X_embOS.c、GUI_X_ucOS.c这3个文件分别对应无操作系统、embOS和ucOS。
分别根据自己的硬件板重写如下函数：
void GUI_X_Init(void) 
void GUI_X_InitOS()
void GUI_X_Unlock()
void GUI_X_Lock()
int GUI_X_GetTime(void)
void GUI_X_Delay(int ms) 
int GUI_X_GetTaskID()
void GUI_X_ExecIdle(void)
void GUI_X_UpdateScreen()
void GUI_X_Log     (const char *s) { GUI_USE_PARA(s); }
void GUI_X_Warn    (const char *s) { GUI_USE_PARA(s); }
void GUI_X_ErrorOut(const char *s) { GUI_USE_PARA(s); }
    
说明：有的函数可以不用修改，可以用它软件的实现，有的则要重写，有的则可以直接返回0，完全有你个人的系统所决定。