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

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

以下范例是基于使用瑞福科技的RA8889 EV Board開發(fā)板，使用STM32F103VET6 MCU，和使用Keil MDK 編譯。

詳細步驟如下：

一、 獲得 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)生的，以下修改說明請參考范例程序項目。
1. 首先新增 3 個文件夾 emwin_config， emwin_inc， emwin_lib

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

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

在 Option for Target 里面的 Include Paths 新增 3 個 include paths 如下圖。

3. 以上設(shè)定完后，我們編譯時應(yīng)該會產(chǎn)生以下錯誤：
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)，所以我們先忽略這個問題，為了讓編譯可以正常進行，我們在 GUI_X.c 內(nèi)加入這幾個函數(shù)，如下圖。

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

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

6. GUIDRV_Template.c修改

使用GUIDRV_Template.c 作為新增一個GUI設(shè)備的驅(qū)動文件，emWin實現(xiàn)屏幕的驅(qū)動主要在于寫一個點與讀一個點，我們必須修改static void _SetPixelIndex(GUI_DEVICE * pDevice, int x, int y, LCD_PIXELINDEX PixelIndex)與static LCD_PIXELINDEX_GetPixelIndex(GUI_DEVICE * pDevice, int x, int y)兩個主要函數(shù)，如下圖。

引入的 putPixel()與 getPixel()函數(shù)來自 RA8889_API.h，在這個范例選用 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)容，開始運行 GUIDEMO。

運行效果圖如下:

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

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

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

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

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

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