STM3移植uCGUI3.9详细教程

STM32 平台移植uCGUI 3.90详细教程v1.0

硬件平台：stm32f103zet6

软件平台：RVMDK_v4.20 + StmLib_v3.5 + uCGUI_v3.9

TFTLCD型号： 3.2寸9320控制器

文档作者：祥龙电子——liky luo

时间：2013-11-19

uCGUI是一种嵌入式应用中的图形支持系统.它设计用于为任何使用LCD图形显示的应用提供高效的独立于处理器及LCD控制器的图形用户接口,它适用单任务或是多任务系统环境, 并适用于任意LCD控制器和CPU下任何尺寸的真实显示或虚拟显示。它的设计架构是模块化的, 由不同的模块中的不同层组成, 由一个LCD驱动层来包含所有对LCD的具体图形操作, uCGUI可以在任何的CPU上运行, 因为它是 100%的标准C代码编写的。uCGUI能够适应大多数的使用黑白或彩色LCD的应用, 它提供非常好的允许处理灰度的颜色管理.还提供一个可扩展的2D图形库及占用极少RAM的窗口管理体系。

移植教程

一、准备工作：

(一)工程文件：准备一个工程模板文件，例如笔者的工程文件如下图所示：

(二)源码：准备 3.90 版本的UCGUI 源码注：如果需要跑GUIDEMO，那么还需准备

GUIDEMO 源码。解压笔者整理的官方源码如下图所示：

其源代码主要在start文件夹下，Sample是官方制作的一个Demo例程，我们一会再移植的过程中，需要用到里面的文件，这儿跳过，以下是对start作出简介：

注：官方的3.90版本的ucgui源码包少了一个文件夹，以致于很多网友在移植编译的时候出现错误，因此笔者经过整理，已经将整理好的代码上传到新浪爱问，大家直接搜索“UCGUI3.9.rar”第一个即是笔者上传的。把下载的源码解压可得到四个文件夹，前三个英文名的则是官方源码，最后一个名为“移植所需文件”则是笔者整理官方源码出来移植所需的文件。移植时，只需将“移植所需文件”文件夹里的所有文件copy到工程文件夹下ucgui 文件夹下即可。

(三)LCD 底层驱动：准备 LCD 屏的底层驱动，接口函数如下：

1、设置坐标点；

static void ili9320_SetCursor(u16 x,u16 y);

2、在指定点画指定颜色的点；

void ili9320_SetPoint(u16 x,u16 y,u16 point);

3、读取某个点的颜色值；

u16 ili9320_GetPoint(u16 x,u16 y);

4、在指定区域填充颜色（开窗口的方式，速度更快）；

void ili9320_window_fill(u16 sx, u16 sy, u16 ex, u16 ey, u16 color);

5、LCD 屏初始化（主要是出厂初始化代码）；

void ili9320_Init(void);

注：这里列出了和 UCGUI 的接口函数，这些函数的具体实现需要根据自己的 LCD 屏具体实现这些函数。需要注意的是，LCD驱动函数最好不要以LCD开头命名，否则容易与ucgui官方源码中一些函数相冲突，导致编译报错。同时，LCD的驱动文件（一般是.c 和.h文件）也不要以LCD命名，最好以LCD驱动型号命名，例如笔者使用的是ili9320的驱动，则有关的文件以及函数则以ili9320开头命名。这一点十分重要，否则编译通不过。

二、移植过程

(一)首先在工程文件夹中建立一个文件夹，并命名为 UCGUI ，然后将官方源码中部分文

件 copy 到自己的工程中UCGUI 文件夹下面，方便管理。这里针对需要拷贝的代码

文件，笔者已经上传，大家下载后只需将“移植所需文件”文件夹里的所有文件

copy到工程文件夹下ucgui文件夹下即可；

(二)在MDK中打开工程文件，并在已有的分组中添加以下分组，如图红色方框所围分

组：

文件与组的添加方法在此不再重复，只需右击项目名称，选择Manage Components即可，其中用红色方框框出的那部分是需要新创建的，在进行了一系列的创建以后，需给每个组添加文件，具体添加如下：

?GUI_X组中添加uCGUI移植\uCGUI\GUI_X_uCOS.c文件

?GUI_Config组中添加uCGUI移植\uCGUI\Config中的C文件

?GUI_LCDDriver组中添加uCGUI移植\uCGUI\LCDDriver\GLCD.c文件

?GUI_Demo组中添加uCGUI移植\uCGUI\GUIDemo中的C文件

?GUI_Antialias组中添加uCGUI移植\uCGUI\AntiAlias中的C文件

?GUI_ ConvertColor组中添加uCGUI移植\uCGUI\ConvertColor中的C文件

?GUI_ ConvertMono组中添加uCGUI移植\uCGUI\ConvertMono中的C文件

?GUI_ Core组中添加uCGUI移植\uCGUI\Core中的C文件

?GUI_ Font组中添加uCGUI移植\uCGUI\Font中的C文件

?GUI_ JPEG组中添加uCGUI移植\uCGUI\JPEG中的C文件

?GUI_ LCDDriver组中添加uCGUI移植\uCGUI\LCDDriver中的C文件

?GUI_ MemDev组中添加uCGUI移植\uCGUI\MemDev中的C文件

?GUI_ MultiLayer组中添加uCGUI移植\uCGUI\MultiLayer中的C文件

?GUI_ Widget组中添加uCGUI移植\uCGUI\Widget中的C文件

?GUI_ WM组中添加uCGUI移植\uCGUI\WM中的C文件

注：在往GUI_Config分组里添加文件时，文件类型选择All，以便添加.h类型的文件。同时，如图所示的最后三个分组文件夹里，可以暂时不需要添加文件，如果添加了文件，则会导致编译的时间过长，一般达到5分钟左右，因此，为了节省编译时间，我们这里就不往此三个组里添加文件了。不过添加不添加也不影响我们后续操作。

(三)添加头文件路径，如图：

(四)打开 GUI_Config 文件夹，编辑 GUIConf.h 文件，将一些参数修改如下图所示：

(五)打开 GUI_Config 文件夹，编辑 LCDConf.h 文件，内容如下：

同时将此文件下面的语句全部删除，具体可参见笔者代码。

(六)打开 GUI_LCDDriver 文件夹，编辑 LCDDummy.c 文件，内容如下：

1、先添加 LCD 驱动文件的头文件，以便下面函数调用；

如：#include "ili9320.h"

2、确保#if (LCD_CONTROLLER == -1) \

&& (!defined(WIN32) | defined(LCD_SIMCONTROLLER)) 中的LCD_CONTROLLER == -1 ，和LCDConf.h 中的宏定义对应

3、在void LCD_L0_SetPixelIndex(int x, int y, int PixelIndex)函数最后一行添加

如下语句：

ili9320_SetPoint( x, y, PixelIndex);

4、在unsigned int LCD_L0_GetPixelIndex(int x, int y)函数 return 语句之前添

加如下语句：

PixelIndex = ili9320_GetPoint(x, y);

5、现在回到 main 函数

1)添加头文

#include "GUI.h"

#include "GUIDEMO.h"

2)在 main 函数中先调用必要的初始化函数后，再调用 GUI_Init(); 函数，这

个函数会调用 LCD 屏的初始化函数

3)为了测试 UCGUI 是否初始化成功，我们先调用几个函数试试，在 GUI_Init();

下面接着调用如下函数：

GUI_SetBkColor(GUI_BLACK);

GUI_SetColor(GUI_RED);

GUI_Clear();

GUI_SetFont(&GUI_Font24_1);

GUI_DispStringAt("- - uCGUI disp Function sample - -",4,10);

// 延时 3s，方便观看结果

delay_ms(1000);

delay_ms(1000);

delay_ms(1000);

看看是否把 LCD 刷成黑色，是否显示红色字符串图片效果：

声明：

本教程是笔者在学习uCGUI移植到stm32过程中的笔记，最后整理出来，献给初学者，旨在带领初学者入门uCGUI，仅供学习之用，不得用于商业。如需转载，请注明出处。

平台：stm32f103zet6

TFTLCD型号：3.2寸9320控制器

ucgui源码： 3.90版本

触屏：不带触屏（后续更新）

操作系统：不支持

作者：liky luo

时间：2013-11-19

版本：V1.0