前言
瑞佑科技RA8889ML3N是一款功能強(qiáng)大的彩色液晶顯示控制器，內(nèi)置128Mb SDRAM, 支持1366x2048高分辨率液晶顯示屏，單片機(jī)MCU端支持8080/6800 8/16-bit接口，以及?線SPI 或IIC接口。 RA8889支持多圖層應(yīng)用、畫幾何圖形引擎、2D圖形加速引擎（BTE）、畫中畫（PIP 實(shí)現(xiàn)彈窗利器）、支持BMP、JPEG格式圖片顯示，并內(nèi)置了視頻解碼功能。

如何將RA8889強(qiáng)大的顯示控制功能移植到emWin平臺(tái)，以求做出流暢、炫酷的UI操作界面，接下來就說明我們?nèi)绾螌A8889的應(yīng)用驅(qū)動(dòng)移植到emWin GUI Library里，實(shí)現(xiàn)在emWin平臺(tái)上使用RA8889內(nèi)置的液晶顯示控制功能。

以下范例是基于使用瑞?？萍嫉腞A8889 EV Board開發(fā)板，使用STM32F103VET6 MCU，和使用Keil MDK 編譯。

詳細(xì)步驟如下：

一、 獲得 emWin Graphic Library
1. 安裝 Keil MDK，在 C:Keil_v5ARMSeggeremWin 路徑下獲得 emWin library

2. 在 C:Keil_v5ARMSeggeremWinDoc 獲得 emWin User&Reference Guide

3. 與瑞佑科技的深圳分公司（深圳瑞福科技-Q2851189731）聯(lián)絡(luò)，以獲得最新版的RA8889_API_Demo_Vxx范例。
二、開始移植

RA8889_API_emwin546_stm32f103_8080IF 范例是由 RA8889_API_Demo_Vxx 加入emWin Library 產(chǎn)生的，以下修改說明請(qǐng)參考范例程序項(xiàng)目。
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. 打開 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 如下圖。

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è)問題，為了讓編譯可以正常進(jìn)行，我們?cè)?GUI_X.c 內(nèi)加入這幾個(gè)函數(shù)，如下圖。

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ù)去遞增變量來實(shí)現(xiàn)，而本文范例采用MCU TIMER中斷來提供1ms的tick，在stm32f10x_it.c內(nèi)TIM3_IRQHandler()中斷函數(shù)實(shí)現(xiàn)tick遞增。
5 分配內(nèi)存給emWin系統(tǒng)

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

6. GUIDRV_Template.c修改

使用GUIDRV_Template.c 作為新增一個(gè)GUI設(shè)備的驅(qū)動(dòng)文件，emWin實(shí)現(xiàn)屏幕的驅(qū)動(dòng)主要在于寫一個(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ù)來自 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)， 如下圖:

7. 修改LCDconf.c 如下圖：

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

運(yùn)行效果圖如下:

三、在emWin平臺(tái)上移植RA8889顯示控制功能的優(yōu)勢(shì)

1）顯示效果優(yōu)化

利用RA8889內(nèi)建DRAM與BTE功能取代emWin Memory Device功能，可實(shí)現(xiàn)刷新顯示時(shí)不閃屏，具體如何應(yīng)用，可與瑞福科技聯(lián)系-Q2851189731；

2) 多緩存應(yīng)用

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

總結(jié)：在emWin平臺(tái)上配合使用瑞佑科技的液晶顯示控制器芯片RA8889ML3N，即使低端的MCU，也可驅(qū)動(dòng)高分辨率(1366*2048)液晶顯示屏, 可做出流暢、炫酷的UI操作界面。