目前micrium官网ucgui版本是v5.26Trial版本,无源代码,只有lib文件,现在网上流传最多的源码是ucgui3.90或3.98版本的,这些源码没有完整官方版本。emWin是segger公司的,segger与ST等公司都有合作,使用ST的芯片可以免费使用emWin,STemWin:http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1743/LN1734/PF259225?s_searchtype=partnumber,目前版本是5.22。
移植环境:
- 芯片STM32F103ZET6
- TFTLCD驱动芯片ILI9341,带有电阻触屏
- 编译环境Keil uVision5
- 不带OS
在移植之前,我们应该要有LCD的基本驱动函数,包括初始化、点亮一个像素等(这些驱动文件不能和emWin中的文件重名,即不能命名为LCD.h、LCD.c)。在文件夹STemWin_Library_V1.1.2中,有以下几个文件:
其中Libraries中就有emWin:
Config是emWin配置文件
Documentation是Segger公司的用户手册
inc是头文件
Lib是将源码封装成的lib
OS是带OS和不带OS的GUI文件
Software里有一些跟图片、字体相关的实用小工具
我们可以将整个STemWin_Library_V1.1.2放入我们的Keil工程中,然后加入以下4个文件:
- GUI_X.C:STemWinLibrary522\OS
- GUIConf.c,LCDConf_FlexColor_Template.c:STemWinLibrary522\Config
- STemWin522_CM3_Keil.lib :STemWinLibrary522\Lib
接着我们开始修改文件
- GUIConf.c:
#define GUI_NUMBYTES 1024*50
这个宏定义的含义在于向系统申请一个静态空间 aMemory ,接着调用 emWin的库函数GUI_ALLOC_AssignMemory 把该空间分配给 emWin,“1024*50”是50KB的意思。
- LCDConf_FlexColor_Template.c
static void LcdWriteReg(U16 Data) {
// ... TBD by user
MYLCD->LCD_REG=Data;
}
static void LcdWriteData(U16 Data) {
// ... TBD by user
MYLCD->LCD_RAM=Data;
}
static void LcdWriteDataMultiple(U16 * pData, int NumItems) {
while (NumItems--) {
// ... TBD by user
MYLCD->LCD_RAM = *pData++;
}
}
static void LcdReadDataMultiple(U16 * pData, int NumItems) {
while (NumItems--) {
// ... TBD by user
*pData++ = MYLCD->LCD_RAM;
}
}
这里需要填写4个函数,分别是写单个寄存器、写单个数据、写多个数据、读多个数据。这里利用了FSMC驱动ILI9341。MYLCD是一个类型定义。
typedef struct
{
u16 LCD_REG;
u16 LCD_RAM;
} LCD_TypeDef;
//0x6C000000 | 0x000007FE 就是相应的FSMC的地址
#define LCD_BASE ((u32)(0x6C000000 | 0x000007FE))
#define MYLCD ((LCD_TypeDef *) LCD_BASE)
接下去来到函数LCD_X_Config()
void LCD_X_Config(void) {
……
// Orientation
// 这里可以利用GUI_SWAP_XY,GUI_MIRROR_Y,GUI_MIRROR_X来改变方向
Config.Orientation = GUI_SWAP_XY | GUI_MIRROR_Y;
// Set controller and operation mode
//不同的LCD驱动IC,F66709这个编号也会不一样具体查看手册1002页
//M16C0B16代表16bpp, no cache, 16 bit bus
……
GUIDRV_FlexColor_SetFunc(pDevice, &PortAPI, GUIDRV_FLEXCOLOR_F66709, GUIDRV_FLEXCOLOR_M16C0B16);
}
接下去来到
int LCD_X_DisplayDriver(unsigned LayerIndex, unsigned Cmd, void * pData) {
……
switch (Cmd) {
case LCD_X_INITCONTROLLER: {
MYLCD_Init();//在这里加入自己的LCD初始化程序
return 0;
}
default:
r = -1;
}
return r;
}
emWin在运行过程中会调用延时之类的函数,为了实现精确定时,我们还需要为emWin开一路定时器,这里我们选用SysTick。在mian()函数中加入SysTick_Config(),来初始化SysTick定时器,而在SysTick_Handler中断函数中,我们需要进行这样的修改:
extern __IO int32_t OS_TimeMS; //OS_Time 已在GUI_X.C中声明。
void SysTick_Handler(void)
{
OS_TimeMS++;
}
OS_TimeMS已经在GUI_X.c中定义。
这些工作完成后我们再回到main()中,在main()中我们需要添加
RCC_AHBPeriphClockCmd(RCC_AHBPeriph_CRC,ENABLE);函数,注意如果不添加将无法使用emWin。然后进行GUI初始化,记得先包含“GUI.h”。如我的程序是这样子的:
#include "stm32f10x.h"
#include "GUI.h"
#include "core_cm3.h"
#define TICKS_PER_SEC 1000
int OS_CPU_SysTickClkFreq(void)
{
return 72000000;
}
int main(void)
{
SysTick_Config(OS_CPU_SysTickClkFreq()/TICKS_PER_SEC-1);
RCC_AHBPeriphClockCmd(RCC_AHBPeriph_CRC, ENABLE);
GUI_Init();
GUI_DispString("Hello emWin!");
while(1)
{
}
}
接下来我们加入触摸的部分,这部分我们需要写4个函数:
GUI_TOUCH_X_ActivateX(), GUI_TOUCH_X_ActivateY()
GUI_TOUCH_X_MeasureX(), GUI_TOUCH_X_MeasureY()
//这里返回的y值是AD采样的值
int GUI_TOUCH_X_MeasureX(void) {
u16 x,y;
TP_Read_XY(&x,&y);
return y;
}
//这个写个空函数就可以了
void GUI_TOUCH_X_ActivateX(void){}
然后我们需在LCDConf_FlexColor_Template.c文件中加入对触摸屏的校准
//这4个宏定义是屏幕的四个角的AD值
#define TOUCH_AD_TOP 221
#define TOUCH_AD_BOTTOM 3900
#define TOUCH_AD_LEFT 160
#define TOUCH_AD_RIGHT 3883
GUI_TOUCH_Calibrate(GUI_COORD_X, 0, 240, TOUCH_AD_TOP, TOUCH_AD_BOTTOM);
GUI_TOUCH_Calibrate(GUI_COORD_Y, 0, 320, TOUCH_AD_LEFT, TOUCH_AD_RIGHT);
【Reference】
1.http://bbs.eeworld.com.cn/forum.php?mod=viewthread&tid=462311