UCGUI移植教程

ucGUI移植详细设计及总结序本文档阐述了将ucGUI移植到IM12上的过程。

ucGUI版本为3.9，移植到IM12上，触摸屏及按键能够正常使用。

在ucGUI源码包的基础上，添加了一些接口函数以适应IM12，在使用时应该根据情况使用这些接口，这些新增加的函数的接口将在后面章节中详细讲述。

此外，适应IM12的ucGUI在Wind River Workbench 3.0环境下被编译成两个静态库文件libNoWindow.a和libWindow.a，编译程序时应该连接这两个库。

文档篇章安排如下：第一章，ucGUI源码包简介。

主要介绍了所使用的ucGUI图形库中各文件夹的内容及功能，并对IM12中与ucGUI移植相关的部分，包括触摸屏、LCD、按键板等进行了简单的介绍。

第二章，图形库移植。

阐述如何对ucGUI进行配置、编译，以在IM12的LCD上显示图形，此部分还未实现触摸屏及按键功能，只是纯粹的显示而已第三章，触摸屏移植。

第四章，按键移植。

第五章，带触摸屏及按键功能的ucGUI应用程序模板。

第一章ucGUI源码包简介ucGUI要移植到im12上，实际上就是根据im12的情况修改ucGUI中的一些配置项，或增加、删减一些程序以适应im12，同时要保持ucGUI的特性。

要做好移植工作，需对ucGUI 及IM12相关部分有足够的了解。

1.1ucGUI简介移植所采用的ucGUI版本为3.9，主要包含的文件夹如图1所示图1 ucGUI源码结构图各文件夹的主要内容如下：Config ----------- 配置文件GUI ----------- 源代码GUI_X ---------- 操作系统接口函数定义文件GUI 源代码文件：1）AntiAlias: 抗锯齿显示效果支持。

2）ConvertColor: 彩色显示的色彩转换支持。

3）ConvertMono: (b/w)和灰度显示的色彩转换支持。

4）Core: 核心文件，提供了GUI基本的功能。

移植UCGUI只需要修改3个文件：GUIConf.h，LCDConf.h，LCDDummy.c，并从源代码的Sample/GUI_X文件夹下复制GUI_X.c文件到工程的GUILib/Config目录下1、GUIConf.h刚开始移植的时候是没有RTOS的，LCD也不是触摸屏，所以GUI_OS和GUI_SUPPORT_TOUCH都定义为0，其他宏不需要修改2、LCDConf.hLCD_XSIZE、LCD_YSIZE和LCD_BITSPERPIXEL根据开发板LCD的配置定义，我用的屏的分辨率是480*272的，16位RGB；LCD_CONTROLLER必须定义成-1，表示使用自己定义的LCD驱动，这个LCD驱动是通过修改LCDDummy.c模板来实现的，因为LCDDummy.c中开始部分要判断宏LCD_CONTROLLER是否等于-1，如果不等于-1，LCDDummy.c中的内容不会被编译，当然LCD_CONTROLLER也可以定义成其他植，但和LCDDummy.c中一定要对应起来，而且不能等于UCGUI自带的LCD驱动号LCD_ON和LCD_OFF一定要定义，因为LCDDummy.c中的LCD_On()和LCD_Off()函数先判断相应的宏是否被定义，如果没定义则不会执行函数体中的内容UCGUI的初始化过程中的LCD部分是通过GUI_Init()(GUICore.c)->LCD_Init()(LCD.c)->LCD_L0_Init()(LCD_Dummy.c)实现的，因为LCDDummy.c中的LCD初始化函数LCD_L0_Init()调用LCD_INIT_CONTROLLER()宏来调用自定义的LCD初始化函数，所以要将宏LCD_INIT_CONTROLLER()定义成自定义的LCD 初始化函数GLCD_Init()。

也可以在不用修改LCD_INIT_CONTROLLER()宏，而是在LCD_L0_Init()直接调用GLCD_Init()3、LCDDummy.cLCDDummy.c文件中需要修改的函数有：1)、void LCD_L0_SetPixelIndex(int x, int y, int PixelIndex)2)、void LCD_L0_GetPixelIndex(int x, int y)3)、void LCD_On(void)4)、void LCD_Off(void)5)、int LCD_L0_Init(void)修改如下：其中395行的SetPixelIndex函数，422行的GetPixelIndex函数，536行的GLCD_On函数，542行GLCD_Off函数都是自己在LCD驱动文件中定义的函数，LCD_INIT_CONTROLLER()也被定义成LCD驱动文件中的LCD初始化函数4、LCD驱动文件1)、头文件drv_glcd.h：#include "lpc_types.h"#include "sdram_mt48lc2m32lfb5.h"#ifndef __GLCD_DRV_H#define __GLCD_DRV_H#define C_GLCD_PIX_CLK 9000000#define C_GLCD_REFRESH_FREQ (50HZ)#define C_GLCD_H_SIZE 480#define C_GLCD_H_PULSE 41#define C_GLCD_H_FRONT_PORCH 2#define C_GLCD_H_BACK_PORCH 2#define C_GLCD_V_SIZE 272#define C_GLCD_V_PULSE 10#define C_GLCD_V_FRONT_PORCH 2#define C_GLCD_V_BACK_PORCH 2#define LCD_RED 0xf800 /* red color */#define LCD_GREEN 0x07e0 /* green color */#define LCD_BLUE 0x001f /* blue color */#define LCD_BLACK 0x0000 /* black color */#define LCD_WHITE 0xffff /* white color */#define C_GLCD_PWR_ENA_DIS_DL Y 10000#define C_GLCD_ENA_DIS_DL Y 10000extern uint16_t LCD_Frame_Buffer[C_GLCD_H_SIZE * C_GLCD_V_SIZE];void GLCD_Init(void);void GLCD_Ctrl(BOOLEAN bEna);void SetPixelIndex(int x, int y, int PixelIndex);uint16_t GetPixelIndex(int x, int y);void GLCD_On(void);void GLCD_Off(void);#endif // __GLCD_DRV_H2)、drv_glcd.c文件#include <stdio.h>#include <stdlib.h>#include <assert.h>#include "board.h"#include "sdram_mt48lc2m32lfb5.h"#include "drv_glcd.h"#include "lpc177x_8x_clkpwr.h"#include "lpc177x_8x_pinsel.h"uint16_t LCD_Frame_Buffer[C_GLCD_H_SIZE * C_GLCD_V_SIZE];/************************************************************************** Function Name: GLCD_Init* Parameters: const uint32_t *pPain, const uint32_t * pPallete** Return: none** Description: GLCD controller init**************************************************************************/ void GLCD_Init(void){uint32_t i;//uint32_t *pDst = (uint32_t *)LCD_Frame_Buffer;//uint32_t p0,p1,p2,p3;/*Back light enable*///Turn on LCD clockCLKPWR_ConfigPPWR(CLKPWR_PCONP_PCLCD, ENABLE);// Disable cursorLPC_LCD->CRSR_CTRL &=~(1<<0);// disable GLCD controllerLPC_LCD->CTRL = 0;// 16 bppLPC_LCD->CTRL &= ~(0x07 <<1);LPC_LCD->CTRL |=(6<<1);// TFT panelLPC_LCD->CTRL |= (1<<5);// single panelLPC_LCD->CTRL &= ~(1<<7);// notmal output// LPC_LCD->CTRL &= ~(1<<8);LPC_LCD->CTRL |= (1<<8);// little endian byte orderLPC_LCD->CTRL &= ~(1<<9);// little endian pix orderLPC_LCD->CTRL &= ~(1<<10);// disable powerLPC_LCD->CTRL &= ~(1<<11);// init pixel clockLPC_SC->LCD_CFG = 1;//CLKPWR_GetCLK(CLKPWR_CLKTYPE_PER) / ((uint32_t)C_GLCD_PIX_CLK);// bypass inrenal clk dividerLPC_LCD->POL |=(1<<26);// clock source for the LCD block is HCLKLPC_LCD->POL &= ~(1<<5);// LCDFP pin is active LOW and inactive HIGHLPC_LCD->POL |= (1<<11);// LCDLP pin is active LOW and inactive HIGH// LPC_LCD->POL |= (1<<12);LPC_LCD->POL &= ~(1<<12);// data is driven out into the LCD on the falling edge// LPC_LCD->POL |= (1<<13);LPC_LCD->POL &= ~(1<<13);// active highLPC_LCD->POL &= ~(1<<14);LPC_LCD->POL &= ~(0x3FF <<16);LPC_LCD->POL |= (C_GLCD_H_SIZE-1)<<16;// init Horizontal TimingLPC_LCD->TIMH = 0; //reset TIMH before set valueLPC_LCD->TIMH |= (C_GLCD_H_BACK_PORCH - 1)<<24;LPC_LCD->TIMH |= (C_GLCD_H_FRONT_PORCH - 1)<<16;LPC_LCD->TIMH |= (C_GLCD_H_PULSE - 1)<<8;LPC_LCD->TIMH |= ((C_GLCD_H_SIZE/16) - 1)<<2;// init Vertical TimingLPC_LCD->TIMV = 0; //reset TIMV value before settingLPC_LCD->TIMV |= (C_GLCD_V_BACK_PORCH)<<24;LPC_LCD->TIMV |= (C_GLCD_V_FRONT_PORCH)<<16;LPC_LCD->TIMV |= (C_GLCD_V_PULSE - 1)<<10;LPC_LCD->TIMV |= C_GLCD_V_SIZE - 1;// Frame Base Address doubleword alignedLPC_LCD->UPBASE = (uint32_t)LCD_Frame_Buffer & ~7UL ;LPC_LCD->LPBASE = (uint32_t)LCD_Frame_Buffer & ~7UL ;for(i = C_GLCD_ENA_DIS_DL Y; i; i--);return ;}/************************************************************************* * Function Name: GLCD_Ctrl* Parameters: Bool bEna** Return: none** Description: GLCD enable disabe sequence**************************************************************************/void GLCD_Ctrl (BOOLEAN bEna){volatile uint32_t i;if (bEna){// LCD_CTRL_bit.LcdEn = 1;LPC_LCD->CTRL |= (1<<0);for(i = C_GLCD_PWR_ENA_DIS_DL Y; i; i--);// LCD_CTRL_bit.LcdPwr= 1; // enable powerLPC_LCD->CTRL |= (1<<11);}else{// LCD_CTRL_bit.LcdPwr= 0; // disable powerLPC_LCD->CTRL &= ~(1<<11);for(i = C_GLCD_PWR_ENA_DIS_DL Y; i; i--);// LCD_CTRL_bit.LcdEn = 0;LPC_LCD->CTRL &= ~(1<<0);}}void SetPixelIndex(int x, int y, int PixelIndex){if ((x < C_GLCD_H_SIZE) && (y < C_GLCD_V_SIZE)) {LCD_Frame_Buffer[x + y * C_GLCD_H_SIZE] = (uint16_t)PixelIndex;}}uint16_t GetPixelIndex(int x, int y){if ((x < C_GLCD_H_SIZE) && (y < C_GLCD_V_SIZE)) {return LCD_Frame_Buffer[x + y * C_GLCD_H_SIZE];}return 0;}void GLCD_On(void){uint32_t i;// LCD_CTRL_bit.LcdEn = 1;LPC_LCD->CTRL |= (1<<0);for(i = C_GLCD_PWR_ENA_DIS_DL Y; i; i--);// LCD_CTRL_bit.LcdPwr= 1; // enable powerLPC_LCD->CTRL |= (1<<11);}void GLCD_Off(void){uint32_t i;// LCD_CTRL_bit.LcdPwr= 0; // disable power LPC_LCD->CTRL &= ~(1<<11);for(i = C_GLCD_PWR_ENA_DIS_DL Y; i; i--); // LCD_CTRL_bit.LcdEn = 0;LPC_LCD->CTRL &= ~(1<<0);}。

在STM32上移植ucGUI之触摸屏之前的三篇文章分别介绍了如何在STM32 裸机上移植ucGUI，移植ucGUI 源例程以及ucGUI 的存储设备和抗锯齿。

现将STM32 裸机上移植ucGUI 触摸屏的过程详述如下：1、将正点原子的《触摸屏移植实验》中HARDWRAE/TOUCH 目录复制到已经建立好的ucGUI 工程目录的HARDWARE 文件夹下，并添加touch.c 文件和头文件路径。

2、打开ucGUI 工程中的GUIConf.h 文件，将其中的GUI_SUPPORT_TOUCH 和GUI_WINSUPPORT 总开关打开。

如下所示：1#define GUI_SUPPORT_TOUCH 1 /* Support a touch screen (req. win-manager) */2#define GUI_WINSUPPORT 1 /* Window manager package available */此时编译程序，会出现四个函数未定义的错误。

3、在GUI_X 中添加文件GUI_X_Touch.c，此时编译工程错误消失。

4、在GUI_X_Touch.c 中添加预处理命令#include “touch.h”。

然后将其中的GUI_TOUCH_X_MeasureX 和GUI_TOUCH_X_MeasureY 两个函数改为如下所示的形式：01intGUI_TOUCH_X_MeasureX(void) {02u16x,y;03Read_ADS2(&x,&y);04returnx;05}0607intGUI_TOUCH_X_MeasureY(void) {08u16 x,y;09Read_ADS2(&x,&y);10returny;11}5、由于是在裸机上运行ucGUI程序，对话框程序会阻塞当前进程的执行。

所以需要在定时器中断中不断的去扫描触摸屏的状态。

设置定时器10ms 中断一次，在定时器中断处理函数中加入GUI_TOUCH_Exec()语句。

嵌入式图形用户界面uc/gui在nios II上的移植uc/gui是一个优秀的嵌入式图形用户界面，这几天的工作就是将它移植到nios II系统上。

前人也做了一些工作，不过大部分都是针对其他硬核处理器，针对nios II软核处理器的移植资料那简直是凤毛麟角。

在阅读了相关文档后，我决定自己亲自动手实践，这下面的很多过程都是自己摸索出来的，并通过了实验的验证。

这只是一个初步的移植，也许在以后的更复杂的应用中，还需要对其进行调整。

但对目前我的应用而言，应该足够了。

写这篇文章的目的一是由于自己记性不好，所以需要给自己留个备忘，免得以后忘的一干二净；二是给有需要的朋友提供一些参考，也好相互交流，共同进步。

请大家多提宝贵意见。

一、源码和文档下载/上有很多不同版本的源码下载，目前能下到的最新版本是3.98，不过还有一些组件不是很完整，但作基础开发已经够用了。

ucgui3.98源码下载地址：uC-GUI-V3-98.zip。

ucgui最新版用户手册下载地址：uC-GUI-user.rar。

开发软件：quartus II 6.0, Nios II IDE 6.0。

二、移植过程先来看看解压后都有些什么东西：如图，核心的东西包括Config和GUI两个文件夹，这里面是ucgui的所有源码和配置文件。

ConvertColor包含彩色转换函数，ConvertMono包含灰度到彩色转换的函数，Core包含核心程序，Font是字体文件，LCDDriver包含多种控制器驱动，Widget是窗口控件库，WM是窗口库，提供复杂的功能。

其他文件夹包含一些应用范例以及一些有用的工具，留待慢慢探索。

1、config文件的移植：Config文件夹是ucgui的配置文件夹，里面有3个文件：GUIConf.h：gui的基本属性配置文件，有很多开关可以配置，具体可以参考ucgui的用户手册，这里只需配置几个必要的参数如下：#ifndef GUICONF_H#define GUICONF_H#define GUI_OS (1) /* 支持操作系统，nios系统自带了ucosII，所以我们选择此项，使gui支持该操作系统*/#define GUI_SUPPORT_TOUCH (0) /* 支持触摸屏，由于暂时没有用触摸屏，所以关掉这个开关*/#define GUI_SUPPORT_MOUSE (0) /* 支持鼠标，暂时关闭*/#define GUI_SUPPORT_UNICODE (1) /* Unicode字符串支持*/#define GUI_DEFAULT_FONT &GUI_Font6x8/* 默认字体*/#define GUI_ALLOC_SIZE 12500/* WM和memery device分配的内存*/ #define GUI_WINSUPPORT 1 /* Window manager available */#define GUI_SUPPORT_MEMDEV 0 /* Memory devices available，由于下载到的源代码中缺少memery device组件的源码，所以关闭此项*/#define GUI_SUPPORT_AA 1 /* Anti aliasing available */#endif /* Avoid multiple inclusion */LCDConf.h：LCD控制器的硬件配置文件，这个文件与硬件直接相关，一般是根据你所使用的LCD的类型和所用的LCD控制器的类型来配置。

uCGUI（emWin）的应用与移植uC/GUI（emWin）的应用与移植 2006-11-19 01:38当你开始使用emWin进行编程时，通常遵循以下的步骤：第1步：配置emWin第一步通常是通过修改头文件LCDConf.h来配置emWin。

LCDConf.h中的宏定义描述了LCD显示部分硬件特性；根据你的具体情况修改这些宏定义（例如显示屏的长、宽，每像素点用几位表示，LCD控制器的类型等参数）。

第2步：定义LCD的底层驱动函数底层函数包括对LCD（控制器）的初始化函数，LCD显示缓冲区的读写函数等，完成对LCD显示硬件的直接操作。

对于映射在系统存储器上的LCD，对显示缓冲区的操作仅需要在LCDConf.h中进行定义就可以了。

但对于采用I/O端口/缓冲区操作的LCD，就必须定义相应的接口函数了。

第3步：编译，链接和测试例子代码emWin对于单任务和多任务环境下的应用都提供了例子代码。

在编程之前，对这些例子代码进行编译、链接和测试，使你能够初步了解这些代码的使用。

第4步：修改例子程序对例子代码作少量的修改。

逐步添加一些额外的指令，例如显示不同大小的文字，显示多行等等，从而进一步理解代码的应用。

第5步：emWin的多任务应用,加入到你的操作系统中如果你的系统有可能多个任务同时对显示进行操作，这时就要用到GUITask.C文件中的GUI_MAXTASK和GUI_OS宏。

第6步：采用emWin编写你自己的应用到这一步你应该对怎样使用emWin有一个清楚的了解了。

考虑如何采用emWin提供的函数来构建你的应用，并通过阅读手册来获得各函数更详细的功能和使用上的信息。

emWin的移植移植是指对emWin进行配置和修改，使它能够在你的目标系统上运行。

参考第3.4节中的第一步和第二步，移植工作主要是针对配置头文件中的宏定义进行修改。

这些宏包括：1. LCD宏，定义了显示的尺寸和一些可选择的特性（例如镜像，等等）2.LCD控制器宏，定义了怎样对控制器进行操作。

emWin 5.22 (uCGUI) 图形用户接口移植实例——STM32作者：Ach日期：2013年12月29日联系方式：ox000008@1.概要移植图形用户接口的好处是不言而喻的。

本文图文并茂地介绍了一个emWin 5.22（uCGUI）的移植实例。

文章具体分为emWin简介，硬件平台简介，开发环境及项目简介，移植过程以及总结几个部分。

2.emWin简介emWin是一种高效的而图形用户界面，是我们能够摆脱处理器和显示控制器而更专注于GUI的设计。

这里借用STemWin的一幅图来说明emWin的作用和结构。

它通过LCD及GUI的配置来驱动底层硬件，而应用程序又是通过调用emWin来实现各种GUI。

5.22版的emWin带有许多常用的显示控制器的驱动（在参考手册Display Driver一章中有详细介绍），因此为我们移植带来了诸多方便。

emWin的更详细的内容可参照它的参考手册。

图1. emWin在项目中的结构3.硬件平台简介笔者使用的是一块以STM32F103VET6为核心的ARM开发板，没有外部的SRAM及Flash。

显示屏为2.8”320*240的彩色液晶屏，屏的驱动芯片为ILI9341（emWin 5.22带有它的驱动）。

屏与CPU 的连接方式为该ARM核心所特有的FSMC_SRAM方式，访问LCD内容时操作就如同读写SRAM一样方便。

如果你想使用其它硬件平台来移植emWin，本文亦有一定的参考价值。

希望本文能助你成功移植emWin。

图2. 硬件平台4.开发环境简介笔者所使用的开发软件为MDK-ARM 4.70。

项目模板使用的是STemWin库中的（可从ST官方下载）。

图3. 项目截图如图，项目下面有3个文件夹，其中Appli存放的是应用层的程序，第二个文件夹就如文件名，存放了emWin5.22所有部件，第三个文件夹存放了一些STM32及其它的库。

具体见附件。

5.移植过程有了MDK-ARM以及STemWin库，整个移植过程应该比较简单。

μc/GUI一般移植过程移植的版本为3.90a，主要包含的文件夹如下图所示，主要涉及到：1.Config：配置文件2.GUI：源代码3.GUI_X：操作系统接口函数GUI源代码文件：1)AntiAlias：9个C文件，主要用于抗锯齿的显示效果。

2)ConvertColor：彩色显示的色彩转换支持。

3)ConvertMono：（b/w）和灰度显示的色彩转换支持。

4)Core：核心文件，提供了GUI基本的功能。

5)Font：字库。

6)JPEG：图片操作函数。

7)LCDDriver：LCD驱动程序8)MenDev：Memory device支持。

这个东西可用在很多情况下，但最主要的功能是防止在项目重叠时，防止屏幕的闪烁。

9)Widget：窗体控件库。

10)WM：窗口管理库。

注意：JPEG、MenDev、Widget、WM都可以裁减掉，若要支持Widget(窗体控件)，需要WM（窗口管理器）的支持；使用控件时，需要将相应的头文件包含进去，比如我们要使用按钮button,那么我们需要先包含button.h头文件，否则控件即使支持也不可用！一、Config文件夹配置文件修改1.LCDConfig.h#define LCD_XSIZE(240)//X-resolution of LCD,Logical coor.#define LCD_YSIZE(320)//Y-resolution of LCD,Logical coor.#define LCD_BITSPERPIXEL(16)//总线宽度#define LCD_FIXEDPALETTE(565)//TFT格式#define LCD_CONTROLLER(9325)//控制器型号（-1即可）#define LCD_SWAP_RB(1)//是否红蓝交换注意：LCD_SWAP_RB会影响到颜色的正确性，倘若发现颜色是反向的，那么不如改变LCD_SWAP_RB的值。