关闭

stm32 UCGUI 完美移植

1685人阅读 评论(0) 收藏 举报
分类:
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 LCD  stm32 驱动 触摸屏 两篇文章
 
        UCGUI的文件数量很大,主要用到UCGUI390a/Start/Config 和 UCGUI390a/Start/GUI两个文件夹下文件,不过文件数量也已经很多了 。。。
        相关文件介绍如下:
ucgui files.png
    将Config和GUI下所有文件加入工程,MDK中新建工程需要划分好结构,这是UCGUI官方推荐的结构:
  
ucgui Project.png
        
        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"      /* private modul definitions & 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

........
........

void LCD_L0_SetPixelIndex(int x, int y, int PixelIndex) {
 
  	POINT_COLOR = PixelIndex;      //我的画点函数使用了一个全局变量设定颜色
	LCD_DrawPoint(x,y);                    //画点函数

}

........
........

unsigned int LCD_L0_GetPixelIndex(int x, int y) {

	return LCD_ReadPoint(x,y);     //我的读取像素颜色函数
}
........
........

void LCD_L0_FillRect(int x0, int y0, int x1, int y1) {

  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.h     GUITouchConf.h  
        还需要加入一个GUI_X.c文件,要不然编译的时候会有错误。直接复制UCGUI390a\Sample\GUI_X\GUI_X.c即可。如果打开了触摸功能还需要加入一个UCGUI390a\Sample\GUI_X\GUI_X_Touch.c 。
    这三个文件是UCGUI的上层配置文件,也就是GUI 一些功能的开关。
 
    GUIConf.h:
#ifndef GUICONF_H
#define GUICONF_H

#define GUI_OS                    (0)  /* 操作系统的支持,当用到ucos 时需要打开  Compile with multitasking support */
#define GUI_SUPPORT_TOUCH         (1)  /* 触摸屏的支持		Support a touch screen (req. win-manager) */
#define GUI_SUPPORT_UNICODE       (0)  /* 用汉字库时再打开 Support mixed ASCII/UNICODE strings */

#define GUI_DEFAULT_FONT          &GUI_Font6x8	 	/* 定义字体大小     */
#define GUI_ALLOC_SIZE          12500  	/*分配的动态内存空间  Size of dynamic memory ... For WM and memory devices*/

/*********************************************************************
*
*         Configuration of available packages
*/

#define GUI_WINSUPPORT            1  /* 窗口功能支持  要使用指针图标 必须打开	 Window manager package available */
#define GUI_SUPPORT_MEMDEV        1  /* 内存管理	 Memory devices available */
#define GUI_SUPPORT_AA            1  /* 抗锯齿功能,打开后可以提高显示效果		Anti aliasing available */

#endif  /* Avoid multiple inclusion */
        LCDConf.h
#ifndef LCDCONF_H
#define LCDCONF_H

#define LCD_XSIZE      (240)   /* lcd 的水平分辨率  X-resolution of LCD, Logical coor. */
#define LCD_YSIZE      (320)   /* lcd 的垂直分辨率  Y-resolution of LCD, Logical coor. */

#define LCD_BITSPERPIXEL   (16)	   /* 16位颜色RGB值 颜色深度*/
#define LCD_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)
 */ 
#define LCD_CONTROLLER  -1        //设置为-1\-2,因为UCGUI没有相应LCD 控制IC驱动

#define LCD_INIT_CONTROLLER() LCD_Config();		//绑定相关LCD底层驱动的初始化函数
配置完这两个文件,如果不启用触摸屏的话,UCGUI已经可以正常运行。
 
下面细讲下UCGUI触摸屏的配置,这个折腾了我好几天的“简单”问题。。
 
首先配置GUIToucConf.h
#ifndef GUITOUCH_CONF_H
#define GUITOUCH_CONF_H

/* 正点原子LCD相关参数,不同LCD值不同,需另测 */
#define GUI_TOUCH_AD_LEFT  		120     //最左边x轴的AD值,非坐标值
#define GUI_TOUCH_AD_RIGHT  	       1870    //最右边x轴的AD值
#define GUI_TOUCH_AD_TOP            90      //最上边y轴的AD值
#define GUI_TOUCH_AD_BOTTOM         1850    //最下边y轴的AD值
  
#define GUI_TOUCH_SWAP_XY    0    //不允许翻转
#define GUI_TOUCH_MIRROR_X   0
#define GUI_TOUCH_MIRROR_Y   0

#endif /* GUITOUCH_CONF_H */
UCGUI 触摸屏驱动接口函数文件 GUI_X_Touch.c :
#include "GUI.h"
#include "GUI_X.h"

#include "xpt2046.h"
//#include "stdio.h"

void GUI_TOUCH_X_ActivateX(void) {    //不用配置
}

void GUI_TOUCH_X_ActivateY(void) {  //不用配置
}

int  GUI_TOUCH_X_MeasureX(void) {

	u16 var = ADS_Read_XY(CMD_RDX);  //读取X轴的AD转换值  不是坐标值

	//printf("\r\n MeasureX is %d \r\n",var);

  	return var;		  
}

int  GUI_TOUCH_X_MeasureY(void) {

	u16 var = ADS_Read_XY(CMD_RDY);   //读取Y轴的AD转换值

	
	//printf("\r\n MeasureY is %d \r\n",var);

  	return var;		
}
还有最关键的一点就是,何时触发UCGUI调用这些函数,测量AD值,定位触摸点的坐标。很多文档都没清这个问题,可以使用两种方法来触发:
  •     设定触摸屏的一个引脚为外部触发,触摸点击时,电平变化触发中断,在中断函数中调用GUI_TOUCH_Exec()函数,让UCGUI更新TOUCH时间数据。
  •     设定一个10ms的定时器中断不断查询,在中断函数中调用GUI_TOUCH_Exec()。
其实第一个方案,看似更为合适,不占用CPU,让CPU可以处理其他事情。但是UCGUI的触摸事件,一次触摸只会读取一个轴的AD值,也就是说一次读取X轴AD,下一次在读取Y轴AD值。这样导致获得的数据都是错误的。uCGUI 有处理的抖动的函数_StoreUnstable(x, y),会将误差较大的数据过滤,两次点击事件时间很短的话,也至少会是一次正确坐标,一次错误坐标 ..
    eg.    
       点击事件1:  MeasureY AD is 736  , coordinate is     X = 134261972 ,Y= 134261972 
 
       点击事件2: MeasureX AD is 576   , coordinate is     X = 62 ,Y= 117 
 
而且外部中断的方法,只能获得触摸点击的事件,无法获得触摸移动的事件。所以采用了查询的方法。。使用Stm32的滴答定时器 产生一个10ms的中断,在中断函数中调用UCGUI更新函数。。
 
    stm32f10x_it.c:
#include "stm32f10x_it.h"
#include "GUI.h"

void SysTick_Handler(void)
{	
	GUI_TOUCH_Exec(); 		//调用UCGUI TOUCH相关函数	
	GUI_Exec();	 			//GUI事件更新

}
这里还调用了GUI_Exec()函数,让UCGUI更新,这个函数必须要加上,有文档说还需要修改GUI_TOUCH_DriverAnalog.c 下的一些函数 其实没必要 ...
 
配置完成后,在main.c中初始化GUI,调用相关函数实现显示一个指针鼠标,跟随触摸移动。。
 
main.c:
#include "common.h"
#include "GUI.h"

void Delay(u32 us)
{
    u32 time=100*us/7;    
    while(--time);   
}

int main(void)
{
	//stm32 初始化		
	RCC_Configuration();
	NVIC_Configuration();		
	USART_Configuration();
	SPI_Configuration();
	GPIO_Configuration();

	GUI_Init();

	Delay(100000);

	GUI_SetBkColor(GUI_RED); //设置背景颜色  
	GUI_SetColor(GUI_WHITE); //设置前景颜色,及字体和绘图的颜色
	GUI_Clear(); //按指定颜色清屏
	GUI_DispStringAt("Hello World ..",10,10); //显示字符
	GUI_CURSOR_Show();	   //显示鼠标,测试触摸屏 	必须打开窗口功能 GUI_WINSUPPORT

	Delay(1000000);	   	   //必须稍加延时,否则会白屏	

	SysTick_Config(720000);	//10ms

	while(1);
}
 
编译如果没出错,可能你就成功了。但往往没有那么简单,很可能还有第三步,也很可能是最耗时的一步——调试 。。
 
这里再附上一份整理的UCGUI API函数列表:UCGUI函数表 .pdf
 
UCGUI 指针跟随效果:                                                                 UCGUI Xeye Demo 效果:
 
ucgui point.png
       ucgui xeye.png      
 
1
0
查看评论
发表评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场

手把手教你在STM32下移植UCGUI(基于正点原子的MINI开发板)

准备资料: 1、  到网上下载UCGUI3.90的源码,如果下不到,可以点击以下链接进行下载: http://download.csdn.net/detail/ballack_linux/8122901 下载后解压,可看到如下目录: Sample目录主要包含一些示例代码,S...
  • ballack_linux
  • ballack_linux
  • 2014-11-05 19:59
  • 2297

UCGUI+触摸在STM32上的移植

首先要准备好TFT屏幕的驱动(包括TFT显示以及触摸的驱动),要求在裸机的情况下实现TFT屏幕的正常显示以及触摸。 其中UCGUI的移植需要两个函数:一个是设置某个点颜色的函数 LCD_SetPointColor()。另一个是读取某个点的函数 LCD_GetPointColor()。 当然,这两...
  • zc850463390zc
  • zc850463390zc
  • 2013-11-20 23:25
  • 1450

S3C2416裸机开发系列十四_GCC下UCGUI的移植(1)

GUI(图形用户界面)极大地方便了非专业用户的使用,用户无需记忆大量的命令,取而代之的是可以通过窗口、菜单、按键等方式进行操作。在某些场合,设计一款人机界面丰富友好的嵌入式产品能赢得更多的用户。笔者此处就s3c2416基于UCGUI图形用户界面的使用作一个简单的介绍。
  • huang20083200056
  • huang20083200056
  • 2014-05-05 09:41
  • 2061

UCGUI移植基础篇(1)--Keil5下STM32移植及简单图形绘制

首先声明,本文章所写内容主要参考百度文库翟中康同学《基于STM32的UCGUI移植解析(新手入门)》,根据作者实际操作所得,仅供大家参考。 既然是做移植,开发板和液晶底层驱动大家肯定都是有的,这里不再赘述,但还有一样东西是必须要准备的---ucGUI源代码,这里,我把我用的源码给大家,有需要的可以直...
  • SDU_ZGL
  • SDU_ZGL
  • 2015-03-10 09:22
  • 1258

基于stm32的 ucGUI 12864下的移植

ucGUI是纯C写的的,移植需要定义点阵数,颜色数,和画点函数 以下是ucGUI 12864下的移植 基于ST7920控制的12864液晶用于字符显示很方便的,但网友说用它显示图形并不合适,原因就是它绘图时先要关闭显示,绘完后又要打开,速度会较慢。我没有用过别的液晶,手中只有这一款,摆弄了几天,...
  • dldw8816
  • dldw8816
  • 2015-04-23 16:17
  • 1052

UC/GUI 在 STM32F103VE上的移植过程

第一部分:在UCGUI移植之前 在移植之前,首先要了解在网上下的UCGUI 3.90源码包 1)“tool文件夹”              基本都是字体和模板查看之类的. 2)“sample文件夹”  ...
  • ycdhonker
  • ycdhonker
  • 2013-12-13 20:05
  • 1399

ucGUI 12864下的移植

ucGUI 12864下的移植 引用自:http://www.cnblogs.com/worldsing/p/4010779.html 原始地址:http://worldsing.cnblogs.com/ Worldsing ucGUI 12864 从打点...
  • Airbnb
  • Airbnb
  • 2015-05-02 08:21
  • 1465

在STM32上移植ucGUI之触摸屏

在STM32上移植ucGUI之触摸屏 之前的三篇文章分别介绍了如何在STM32裸机上移植ucGUI,移植ucGUI源例程以及ucGUI的存储设备和抗锯齿。现将STM32裸机上移植ucGUI触摸屏的过程详述如下: 1、  将正点原子的《触摸屏移植实验》中HARDWRAE/T...
  • niepangu
  • niepangu
  • 2014-07-27 09:53
  • 1013

emWin 2天速成实例教程000_如何快速入门ucGUI/emWin

emWin是一个嵌入式GUI图形库,GUI图形库的概念就好像它是一个平台,我们只需要在这个平台上通过其提供的方法写自己的用户界面应用程序就行,非常简单、便捷。如果没有这个GUI图形库,我们的应用程序还需要考虑按键、编辑框、下拉菜单等控件的绘制和实现,还需要管理各个控件、窗口、页面它们之间的相互关系,...
  • neqee
  • neqee
  • 2016-11-25 19:03
  • 9702

STM32学习——uCGUI移植

第一部分:在UCGUI移植之前 在移植之前,首先要了解在网上下的UCGUI 3.98源码的文件结构是。 UCGUI 3.98源码中有三个文件夹: 1)“tool文件夹”是用来使用一些uCgui的上位机程序,基本都是字体和模板查看之类的. 2)“sample文件夹”下面是已经别...
  • TXF1984
  • TXF1984
  • 2015-06-15 10:52
  • 540
    最新评论
    个人资料
    • 访问:66282次
    • 积分:155
    • 等级:
    • 排名:千里之外
    • 原创:6篇
    • 转载:111篇
    • 译文:1篇
    • 评论:3条