【GuiLite】移植GUI例程到STM32

最近在做 Github 找到一個有趣的開源 Gui 框架：GuiLite，按照說明移植了 GuiLite 到 STM32F4 OLED 螢屏上，分析一下自己的移植經驗

一、GuiLite介紹

GuiLite 是一個開源的 Gui 框架，只依賴于一個單一的頭檔案庫（GuiLite.h），不需要很復雜的檔案管理，代碼量平易近人，GuiLite 由4千行C++代碼撰寫，單片機上也能流暢運行，其最低的硬體運行要求如下：

同時 GuiLite 具有很強的跨平臺特性：

• 支持的作業系統：iOS/macOS/WatchOS，Android，Linux（ARM/x86-64），Windows（包含VR），RTOS… 甚至無作業系統的單片機
• 支持的開發語言： C/C++, Swift, Java, Javascript, C#, Golang…
• 支持的第3方庫：Qt, MFC, Winforms, CoCoa…

除此之外，GuiLite 提供一系列輔助開發工具：

• ??完美的“云” + “物聯網”解決方案：讓你輕松駕馭全球IoT業務
• 🔣支持多語言,采用 UTF-8 編碼；📀支持視頻播放
• 🔨資源制作工具為你定制自己的字體/圖片資源
• 📐所見即所得的GUI布局工具
• 📊編譯活躍度統計，及實時分析
• 📦支持3D & Web
• 🐋支持Docker，一條命令啟動Docker: sudo docker run -it --privileged -v /dev:/dev-share idea4good/gui-lite:latest bash /run.sh

GuiLite 的官網鏈接：GuiLite

二、GuiLite移植

2.1 硬體準備

STM32F407 開發板

OLED 螢屏

2.2 驅動準備

這里我使用 STM32CubeMX 對開發板進行外設配置，開啟 STM32 的硬體IIC，關于硬體 IIC 的開啟可以看我的這一篇文章：STM32CubeMX-硬體IIC讀取AT24C02，這里我用 CubeMX 開啟后如下：

配置完成生成代碼，同時將分配的堆空間增大：

代碼生成后，我們復制正點原子的 OLED 驅動工程代碼到 Hardware 硬體目錄下（自己創建一個該目錄）

在 MDK 里面添加檔案，然后我們進行修改，注釋掉頭檔案里面關于埠的定義，同時添加三個型別宏定義

然后我們進入 oled.c 檔案，將 void OLED_WR_Byte(u8 dat,u8 cmd) 和 void OLED_Init(void) 函式分別替換為下面的內容：

OLED_WR_Byte：

void OLED_WR_Byte(u8 dat,u8 cmd)
{	
	if(cmd)
		HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x40,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100);
	else
		HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x00,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100); 
} 

OLED_Init：

//初始化SSD1306					    
void OLED_Init(void)
{ 					  
	OLED_WR_Byte(0xAE,OLED_CMD); //關閉顯示
	OLED_WR_Byte(0xD5,OLED_CMD); //設定時鐘分頻因子,震蕩頻率
	OLED_WR_Byte(80,OLED_CMD);   //[3:0],分頻因子;[7:4],震蕩頻率
	OLED_WR_Byte(0xA8,OLED_CMD); //設定驅動路數
	OLED_WR_Byte(0X3F,OLED_CMD); //默認0X3F(1/64) 
	OLED_WR_Byte(0xD3,OLED_CMD); //設定顯示偏移
	OLED_WR_Byte(0X00,OLED_CMD); //默認為0

	OLED_WR_Byte(0x40,OLED_CMD); //設定顯示開始行 [5:0],行數.
													    
	OLED_WR_Byte(0x8D,OLED_CMD); //電荷泵設定
	OLED_WR_Byte(0x14,OLED_CMD); //bit2，開啟/關閉
	OLED_WR_Byte(0x20,OLED_CMD); //設定記憶體地址模式
	OLED_WR_Byte(0x02,OLED_CMD); //[1:0],00，列地址模式;01，行地址模式;10,頁地址模式;默認10;
	OLED_WR_Byte(0xA1,OLED_CMD); //段重定義設定,bit0:0,0->0;1,0->127;
	OLED_WR_Byte(0xC0,OLED_CMD); //設定COM掃描方向;bit3:0,普通模式;1,重定義模式 COM[N-1]->COM0;N:驅動路數
	OLED_WR_Byte(0xDA,OLED_CMD); //設定COM硬體引腳配置
	OLED_WR_Byte(0x12,OLED_CMD); //[5:4]配置
		 
	OLED_WR_Byte(0x81,OLED_CMD); //對比度設定
	OLED_WR_Byte(0xEF,OLED_CMD); //1~255;默認0X7F (亮度設定,越大越亮)
	OLED_WR_Byte(0xD9,OLED_CMD); //設定預充電周期
	OLED_WR_Byte(0xf1,OLED_CMD); //[3:0],PHASE 1;[7:4],PHASE 2;
	OLED_WR_Byte(0xDB,OLED_CMD); //設定VCOMH 電壓倍率
	OLED_WR_Byte(0x30,OLED_CMD); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;

	OLED_WR_Byte(0xA4,OLED_CMD); //全域顯示開啟;bit0:1,開啟;0,關閉;(白屏/黑屏)
	OLED_WR_Byte(0xA6,OLED_CMD); //設定顯示方式;bit0:1,反相顯示;0,正常顯示	    						   
	OLED_WR_Byte(0xAF,OLED_CMD); //開啟顯示	 
	OLED_Clear();
}  

然后在 main.c 檔案如下位置添加 oled測驗代碼（記得添加頭檔案和頭檔案路徑）

下載程式，觀看現象

到此 OLED 驅動的準備已經完成，下一步就是移植 GuiLite

2.3 例程移植

首先，我們上 GuiLite 的例程展示官網：GuiLiteDemo，選擇 Hello例程，將其中的 UI_Code 檔案夾復制到 Hardware 下：

在 MDK 工程里面匯入 UICode 下的 GuiLite.h 和 UIcode.cpp 檔案

我們在 main.c 檔案開頭添加 GuiLite 介面代碼，介面代碼如下：

//畫點函式介面
void gfx_draw_pixel(int x, int y, unsigned int rgb)
{
    OLED_DrawPoint(x,y,rgb);
}
//畫面函式(未使用)
void gfx_draw_fill(int x, int y,int w, int q, unsigned int rgb)
{	
}
//創建一個函式指標結構體
struct EXTERNAL_GFX_OP
{
	void (*draw_pixel)(int x, int y, unsigned int rgb);
	void (*fill_rect)(int x0, int y0, int x1, int y1, unsigned int rgb);
} my_gfx_op;
extern void startHelloCircle(void* phy_fb, int width, int height, int color_bytes, struct EXTERNAL_GFX_OP* gfx_op);

//設定延時函式介面
void delay_ms(int milli_seconds)
{
	HAL_Delay(milli_seconds);
}

之后在main函式中添加如下代碼

//傳遞函式指標
my_gfx_op.draw_pixel = gfx_draw_pixel;
my_gfx_op.fill_rect = NULL;//gfx_fill_rect;
//啟影片圓
startHelloCircle(NULL, 128, 64, 1, &my_gfx_op);

然后我們修改 UIcode.cpp 檔案中的代碼，添加 OLED頭檔案，以及在UI執行函式界面處添加OLED重繪函式

之后在 UIcode 的第8行修改3D圓的引數，因為 OLED 大小 128*64 ，所以我的配置如下：

配置完成后，我們關閉 Use MicroLIB 選項，編譯代碼

編譯成功，下載代碼

三、Gui移植結果

下載完成后程式復位，可以在 OLED 上看到 Demo 的示例影片