stm32 UCGUI 完美移植

UCGUI是一种嵌入式应用中的图形支持系统。它设计用于为任何使用LCD图形显示的应用提供高效的独立于处理器及LCD控制器的图形用户接口，它适用单任务或是多任务系统环境, 并适用于任意LCD控制器和CPU下任何尺寸的真实显示或虚拟显示。

它的设计架构是模块化的，由不同的模块中的不同层组成，由一个LCD驱动层来包含所有对LCD的具体图形操作。UCGUI可以在任何的CPU上运行，因为它是100%的标准C代码编写的。

类似程序还有国产的一个MINIGUI （http://www.minigui.com/zhcn/），MiniGUI 是一个自由软件项目。其目标是提供一个快速、稳定、跨操作系统的图形用户界面（GUI）支持系统，尤其是基于 Linux/uClinux、eCos 以及其他传统 RTOS（如 VxWorks、ThreadX、uC/OS-II、Nucleus 等）的实时嵌入式操作系统。有机会尝试下，支持下国产，毕竟国内这样的公司不多。。

这里移植的UCGUI3.90a版本，虽然已经有更新的版本，比如UCGUI3.98、甚至4.04版本。但是目前来说只有这个版本的代码是最全的，包括了JPEG , MULTILAYER , MEMDEV ,AntiAlias等模块。一直想尝试做一个数码相册，JEPG模块自然少不了，所以移植了这个版本。

UCGUI390a 下载

整个移植过程，让LCD显示图案倒是没花多少时间，资料也比较多，但是在移植触摸屏的时候卡了好几天，然后又是 UCGUI 指针图标 移动有重影(LCD读取像素颜色函数有问题)。。。总之移植是个累人的活

首先需要保证你的LCD驱动和触摸屏驱动是有效的，如果你的LCD也是ili93xx 控制器 XPT2046控制器的触摸屏可以参考stm32 驱动 TFT LCDstm32 驱动 触摸屏两篇文章

UCGUI的文件数量很大，主要用到UCGUI390a/Start/Config 和 UCGUI390a/Start/GUI两个文件夹下文件，不过文件数量也已经很多了 。。。

相关文件介绍如下：

将Config和GUI下所有文件加入工程，MDK中新建工程需要划分好结构，这是UCGUI官方推荐的结构：

JPEG, MemDev , MultiLayer ,Widget , Wm 这5 个文件夹的内容可以暂时不加入MDK工程。

因为这些文件起到的是扩展功能，在移植阶段可以先不添加，等到以后用到其中的功能时再选择添加。但是建议都添加进去，避免遇到各种无解问题。。

当然前提是在配置时要把相应的功能开关关掉，在下面的步骤中会提到。

ConverMono , ConverColor ,Core ,Font 这四个目录下的文件是不用修改的。

要修改的文件在LCDDriver ，Config 这两个目录下。

LCDDriver 是LCD的驱动接口函数文件，需要将自己的LCD驱动函数提供给UCGUI调用。

需要提供3个LCD底层驱动函数：

void LCD_L0_SetPixelIndex(int x, int y, int PixelIndex) LCD画点函数,用指定颜色填充一个像素

unsigned int LCD_L0_GetPixelIndex(int x, int y) LCD读取定点颜色函数，读取一个像素点的16位RGB颜色值

void LCD_L0_FillRect(int x0, int y0, int x1, int y1) 矩形填充函数，用指定颜色填充一个矩形 。这个函数也可以不改 使用UCGUI的函数，用一个一个的像素点填充成一个矩形。也可以在底层驱动根据像素个数直接往GRAM 中写数据，封装成函数，供这个函数调用。速度会快很多。

其他的画线画图形函数，也可以同样优化。

LCDDriver下有三个文件，LCDDummy.c 、 LCDNull.c 和LCDWin.c。 这三个都是UCGUI LCD接口模板文件。功能一样，只是移植时修改的细节不一样。我们可以选用其中一个，稍作修改作为接口文件。以LCDDummy.c为例：

#include"LCD_Private.h"/*privatemoduldefinitions&config*/#include"GUI_Private.h"#include"GUIDebug.h"/*#if(LCD_CONTROLLER==-1)&&(!defined(WIN32)|defined(LCD_SIMCONTROLLER))*///必须注释，否则不会编译#include"ili93xx.h"//包含你的LCD驱动函数声明#if(LCD_CONTROLLER==-1)//这句对应Config/LCDConf.h................voidLCD_L0_SetPixelIndex(intx,inty,intPixelIndex){POINT_COLOR=PixelIndex;//我的画点函数使用了一个全局变量设定颜色LCD_DrawPoint(x,y);//画点函数}................unsignedintLCD_L0_GetPixelIndex(intx,inty){returnLCD_ReadPoint(x,y);//我的读取像素颜色函数}................voidLCD_L0_FillRect(intx0,inty0,intx1,inty1){LCD_Fill(x0,y0,x1,y1,LCD_COLORINDEX);//填充矩形函数/*for(;y0<=y1;y0++){LCD_L0_DrawHLine(x0,y0,x1);}*/}

UCGUI提供了一些LCD控制器的驱动函数，但是这种配置方法，可以适用于任何控制IC。

到这就算完成三分之一了，接下来修改Config文件夹下文件，Config下有三个文件：

GUIConf.h LCDConf.hGUITouchConf.h

还需要加入一个GUI_X.c文件，要不然编译的时候会有错误。直接复制UCGUI390aSampleGUI_XGUI_X.c即可。如果打开了触摸功能还需要加入一个UCGUI390aSampleGUI_XGUI_X_Touch.c 。

这三个文件是UCGUI的上层配置文件，也就是GUI 一些功能的开关。

GUIConf.h:

#ifndefGUICONF_H#defineGUICONF_H#defineGUI_OS(0)/*操作系统的支持，当用到ucos时需要打开Compilewithmultitaskingsupport*/#defineGUI_SUPPORT_TOUCH(1)/*触摸屏的支持Supportatouchscreen(req.win-manager)*/#defineGUI_SUPPORT_UNICODE(0)/*用汉字库时再打开SupportmixedASCII/UNICODEstrings*/#defineGUI_DEFAULT_FONT&GUI_Font6x8/*定义字体大小*/#defineGUI_ALLOC_SIZE12500/*分配的动态内存空间Sizeofdynamicmemory...ForWMandmemorydevices*//***********************************************************************Configurationofavailablepackages*/#defineGUI_WINSUPPORT1/*窗口功能支持要使用指针图标必须打开Windowmanagerpackageavailable*/#defineGUI_SUPPORT_MEMDEV1/*内存管理Memorydevicesavailable*/#defineGUI_SUPPORT_AA1/*抗锯齿功能，打开后可以提高显示效果Antialiasingavailable*/#endif/*Avoidmultipleinclusion*/

LCDConf.h

#ifndefLCDCONF_H#defineLCDCONF_H#defineLCD_XSIZE(240)/*lcd的水平分辨率X-resolutionofLCD,Logicalcoor.*/#defineLCD_YSIZE(320)/*lcd的垂直分辨率Y-resolutionofLCD,Logicalcoor.*/#defineLCD_BITSPERPIXEL(16)/*16位颜色RGB值颜色深度*/#defineLCD_SWAP_RB(1)/*红蓝反色交换*//*lcd控制器的具体型号**设置为-1时会编译LCDDriver下LCDDummy.c*设置为-2时会编译LCDDriver下LCDNull.c**还需要修改LCDDriver下文件的宏定义才可以被编译*eg.LCDDummy.c：**#if(LCD_CONTROLLER==-1)&&(!defined(WIN32)|defined(LCD_SIMCONTROLLER))*改为*#if(LCD_CONTROLLER==-1)*/#defineLCD_CONTROLLER-1//设置为-1-2，因为UCGUI没有相应LCD控制IC驱动#defineLCD_INIT_CONTROLLER()LCD_Config();//绑定相关LCD底层驱动的初始化函数