2018年11月20日 | 菜鸟福利!STM32学习之uCGUI移植详解

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

第一部分：在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，完全有你个人的系统所决定。