文章目錄

RA8889與emWin驅(qū)動(dòng)移植指南及顯示優(yōu)化

在RA8889上使用emWin的優(yōu)勢(shì)

前言

一、獲得emWin Graphic Library

1.1 安裝Keil MDK，在C:Keil_v5ARMSeggeremWin 路徑下獲得emWin library

1.2 在C:Keil_v5ARMSeggeremWinDoc 獲得emWin User&Reference Guide

1.3 獲得RA8889 API 范例程序

二、開(kāi)始移植

2.1. 新增3個(gè)文件夾 emwin_config，emwin_inc，emwin_lib

2.2 建立emwin_config 、 emwin_lib 、 emwin_demo 3個(gè)Groups

2.3 以上設(shè)定完后，我們編譯時(shí)應(yīng)該會(huì)產(chǎn)生以下錯(cuò)誤：

2.4 emWin GUI 時(shí)基源

2.5 分配內(nèi)存給emWin系統(tǒng)

2.6. GUIDRV_Template.c 修改

2.7 修改LCDConf.c如下圖:

三、在RA8889上使用emWin的優(yōu)勢(shì)

3.1 顯示效果優(yōu)化

3.2 多緩存應(yīng)用

總結(jié)

RA8889 + emWin Demo 視頻

在RA8889上使用emWin的優(yōu)勢(shì)

為了更好能實(shí)現(xiàn)RA8889的功能，如多緩存的應(yīng)用（內(nèi)置有128Mbit SDRAM），畫(huà)幾何圖形引擎，2D圖形加速引擎（BTE），畫(huà)中畫(huà)（PIP 實(shí)現(xiàn)彈窗利器）、顯示圖片（BMP、JPEG），視頻播放等等功能，我們已在emWin平臺(tái)上加入了以上的功能，提高實(shí)現(xiàn)顯示效率。

前言

本文在說(shuō)明如何將瑞佑科技的RA8889（液晶屏控制器TFT LCD Controller）的驅(qū)動(dòng)移植到emWin GUI Library里，實(shí)現(xiàn)在emWin平臺(tái)上使用RA8889內(nèi)置的液晶顯示控制功能，以下說(shuō)明請(qǐng)對(duì)照RA8889_API_emwin546_stm32f103_8080IF 范例程序，此范例基于使用RA8889 EV Board板上使用STM32F103VET6 MCU，使用Keil MDK 編譯。

一、獲得emWin Graphic Library

1.1 安裝Keil MDK，在C:Keil_v5ARMSeggeremWin 路徑下獲得emWin library

1.2 在C:Keil_v5ARMSeggeremWinDoc 獲得emWin User&Reference Guide

1.3 獲得RA8889 API 范例程序

獲得RA8889 API 范例程序/RA8889_API_emwin546_stm32f103_8080IF ，請(qǐng)與瑞佑科技深圳分公司瑞?？萍嫉臉I(yè)務(wù)員聯(lián)系，獲取最新的RA8889_API_Demo_Vxx與RA8889_API_emwin546_stm32f103_8080IF范例。

二、開(kāi)始移植

RA8889_API_emwin546_stm32f103_8080IF 是由RA8889_API_Demo_Vxx加入emWin Library產(chǎn)生的，以下修改說(shuō)明請(qǐng)參考RA8889_API_emwin546_stm32f103_8080IF范例程序項(xiàng)目。

2.1. 新增3個(gè)文件夾 emwin_config，emwin_inc，emwin_lib

(1) 在 C:Keil_v5ARMSeggeremWinSampleConfig，復(fù)制GUIConf.c 、GUIConf.h 、LCDConf.c 、LCDConf.h 4個(gè)文件到emwin_config文件夾內(nèi)。
(2) 在 C:Keil_v5ARMSeggeremWinSampleDisplayDriver，復(fù)制GUIDRV_Template.c 文件到emwin_config文件夾內(nèi)。
(3) 在 C:Keil_v5ARMSeggeremWinSampleGUI_X，復(fù)制GUI_X.c文件到emwin_config文件夾內(nèi)。
(4) 在C:Keil_v5ARMSeggeremWinInclude，復(fù)制所有的.h文件到emwin_inc文件夾內(nèi)。
(5) 在C:Keil_v5ARMSeggeremWinLib，復(fù)制GUI_CM3.lib文件到emwin_lib文件夾內(nèi)。(由于我們的STM32F103是CM3核心，所以選用CM3)。
(6) 在C:Keil_v5ARMSeggeremWinSampleApplicationGUIDemo內(nèi)，復(fù)制全部的文件夾到emwin_demo文件夾內(nèi)。

2.2 建立emwin_config 、 emwin_lib 、 emwin_demo 3個(gè)Groups

打開(kāi)Keil項(xiàng)目，在Manage Project Items 內(nèi)建立emwin_config 、 emwin_lib 、 emwin_demo 3個(gè)Groups并加入文件，如下圖。

在Option for Target里面的Include Paths 新增3個(gè)include paths如下圖。
2.3 以上設(shè)定完后，我們編譯時(shí)應(yīng)該會(huì)產(chǎn)生以下錯(cuò)誤：

Error: L6218E: Undefined symbol GUI_X_GetTaskId (referred from gui_task.o).
Error: L6218E: Undefined symbol GUI_X_InitOS (referred from gui_task.o).
Error: L6218E: Undefined symbol GUI_X_Lock (referred from gui_task.o).
Error: L6218E: Undefined symbol GUI_X_Unlock (referred from gui_task.o).

由于本范例不使用OS操作系統(tǒng)，所以我們先忽略這個(gè)問(wèn)題，為了讓編譯可以正常，我們?cè)贕UI_X.c內(nèi)加入這幾個(gè)函數(shù)，如下圖。
2.4 emWin GUI 時(shí)基源

emWin GUI 需要一個(gè)時(shí)基源并須1ms遞增，即OS_TimeMS變數(shù)在GUI_X.c文件內(nèi)聲明，MCU必須先提供一個(gè)1ms的timer tick，通常在Cortex-M由SysTick的設(shè)定由SysTick_Handler{}中斷函數(shù)去遞增變量來(lái)實(shí)現(xiàn)，而本文范例采用MCU TIMER中斷來(lái)提供1ms的tick，在stm32f10x_it.c內(nèi)TIM3_IRQHandler()中斷函數(shù)實(shí)現(xiàn)tick遞增。

2.5 分配內(nèi)存給emWin系統(tǒng)

在GUIConf.c文件內(nèi)設(shè)定，內(nèi)存大小會(huì)影響效能，須根據(jù)MCU的內(nèi)存大小去配置。
2.6. GUIDRV_Template.c 修改

使用GUIDRV_Template.c 作為新增一個(gè)GUI設(shè)備的驅(qū)動(dòng)文件，emWin實(shí)現(xiàn)屏幕的驅(qū)動(dòng)主要在于寫(xiě)一個(gè)點(diǎn)與讀一個(gè)點(diǎn)，我們必須修改static void _SetPixelIndex(GUI_DEVICE * pDevice, int x, int y, LCD_PIXELINDEX PixelIndex)與static LCD_PIXELINDEX _GetPixelIndex(GUI_DEVICE * pDevice, int x, int y)兩個(gè)主要函數(shù)，如下圖。
引入的putPixel()與getPixel()函數(shù)來(lái)自RA8889_API.h，在這個(gè)范例選用16bit RGB565 或
24bit RGB888 數(shù)據(jù)格式，參考UserDef.h 選用如下設(shè)定:

代碼如下（示例）：
支持16bit RGB565 (使用emWin GUICC_M565)
#define Parallel_8080
#define MCU_16bit_ColorDepth_16bpp
代碼如下（示例）：
支持 24bit RGB888 (使用emWin GUICC_M888)
#define Parallel_8080
#define MCU_16bit_ColorDepth_24bpp_Mode_2

另外為了優(yōu)化填充效率，在GUIDRV_Template.c文件新增定義Add2D_Optimize，使用RA8889內(nèi)建2D繪圖加速功能并增加到_FillRect()、_DrawHLine()、_DrawVLine()函數(shù)內(nèi)，如下圖:

2.7 修改LCDConf.c如下圖:

上述設(shè)定完成后，在main.c 加入以下內(nèi)容，開(kāi)始運(yùn)行GUIDEMO。

三、在RA8889上使用emWin的優(yōu)勢(shì)

為了更好能實(shí)現(xiàn)RA8889的功能，如多緩存的應(yīng)用（內(nèi)置有128Mbit SDRAM），畫(huà)幾何圖形引擎，2D圖形加速引擎（BTE），畫(huà)中畫(huà)（PIP 實(shí)現(xiàn)彈窗利器）、顯示圖片（BMP、JPEG），視頻播放等等功能，我們已在emWin平臺(tái)上加入了以上的功能，提高實(shí)現(xiàn)顯示效率。

3.1 顯示效果優(yōu)化

利用RA8889內(nèi)建DRAM與BTE功能取代emWin Memory Device功能，為了更新顯示不閃屏，具體應(yīng)用可與瑞佑科技聯(lián)系；

3.2 多緩存應(yīng)用

利用RA8889內(nèi)建 128Mbit DRAM ，分配內(nèi)存給emWin在RA8889的顯存上操作，即可實(shí)現(xiàn)：緩存1用于液晶屏的顯示（即顯示區(qū)）、緩存2 用于emWin的讀寫(xiě)操作內(nèi)存、另外可分配緩存3、緩存4…等等，比如緩存3可用于顯示掛在RA8889上的Flash的圖片，當(dāng)需要顯示時(shí)，即可用BTE的復(fù)制粘貼到顯示區(qū)顯示，比如緩存4用作視頻的緩存紐帶，可完美實(shí)現(xiàn)emWin窗口+視頻播放的搭配；以上實(shí)現(xiàn)具體原理，以及代碼例程，可與瑞佑科技聯(lián)系，

總結(jié)

使用瑞佑科技的 RA8889 液晶控制器芯片，搭配低端MCU，在emWin平臺(tái)上，接高分辨率屏（1366*2048），也可接低分辨率屏，即可做出流暢、酷炫的UI操作界面。

審核編輯：湯梓紅