我將GuiLite移植到了STM32F4開發(fā)板上

摘要：最近在做Github找到一個(gè)有趣的開源Gui框架：GuiLite，按照說(shuō)明移植了GuiLite到STM32F4OLED屏幕上，分析一下自己的移植經(jīng)驗(yàn)。

一、GuiLite介紹

GuiLite是一個(gè)開源的Gui框架，只依賴于一個(gè)單一的頭文件庫(kù)（GuiLite.h），不需要很復(fù)雜的文件管理，代碼量平易近人，GuiLite由4千行C++代碼編寫，單片機(jī)上也能流暢運(yùn)行，其最低的硬件運(yùn)行要求如下：

同時(shí)GuiLite具有很強(qiáng)的跨平臺(tái)特性：

支持的操作系統(tǒng)：iOS/macOS/WatchOS，Android，Linux（ARM/x86-64），Windows（包含VR），RTOS… 甚至無(wú)操作系統(tǒng)的單片機(jī)

支持的開發(fā)語(yǔ)言：C/C++, Swift, Java, Javascript, C#, Golang…

支持的第3方庫(kù)：Qt, MFC, Winforms, CoCoa…

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

完美的“云” + “物聯(lián)網(wǎng)”解決方案：讓你輕松駕馭全球IoT業(yè)務(wù)

支持多語(yǔ)言,采用 UTF-8 編碼；支持視頻播放

資源制作工具為你定制自己的字體/圖片資源

所見即所得的GUI布局工具

編譯活躍度統(tǒng)計(jì)，及實(shí)時(shí)分析

支持3D & Web

支持Docker，一條命令啟動(dòng)。

二、GuiLite移植

2.1 硬件準(zhǔn)備

STM32F407開發(fā)板 OLED屏幕

2.2 驅(qū)動(dòng)準(zhǔn)備

這里我使用STM32CubeMX 對(duì)開發(fā)板進(jìn)行外設(shè)配置，開啟STM32的硬件IIC，這里我用CubeMX開啟后如下：

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

代碼生成后，我們復(fù)制正點(diǎn)原子的OLED驅(qū)動(dòng)工程代碼到Hardware硬件目錄下（自己創(chuàng)建一個(gè)該目錄）

在MDK里面添加文件，然后我們進(jìn)行修改，注釋掉頭文件里面關(guān)于端口的定義，同時(shí)添加三個(gè)類型宏定義

然后我們進(jìn)入oled.c文件，將void OLED_WR_Byte(u8 dat,u8 cmd)和 void OLED_Init(void)函數(shù)分別替換為下面的內(nèi)容：

OLED_WR_Byte：

voidOLED_WR_Byte(u8dat,u8cmd)
{
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
voidOLED_Init(void)
{
OLED_WR_Byte(0xAE,OLED_CMD);//關(guān)閉顯示
OLED_WR_Byte(0xD5,OLED_CMD);//設(shè)置時(shí)鐘分頻因子,震蕩頻率
OLED_WR_Byte(80,OLED_CMD);//[3:0],分頻因子;[7:4],震蕩頻率
OLED_WR_Byte(0xA8,OLED_CMD);//設(shè)置驅(qū)動(dòng)路數(shù)
OLED_WR_Byte(0X3F,OLED_CMD);//默認(rèn)0X3F(1/64)
OLED_WR_Byte(0xD3,OLED_CMD);//設(shè)置顯示偏移
OLED_WR_Byte(0X00,OLED_CMD);//默認(rèn)為0

OLED_WR_Byte(0x40,OLED_CMD);//設(shè)置顯示開始行[5:0],行數(shù).

OLED_WR_Byte(0x8D,OLED_CMD);//電荷泵設(shè)置
OLED_WR_Byte(0x14,OLED_CMD);//bit2，開啟/關(guān)閉
OLED_WR_Byte(0x20,OLED_CMD);//設(shè)置內(nèi)存地址模式
OLED_WR_Byte(0x02,OLED_CMD);//[1:0],00，列地址模式;01，行地址模式;10,頁(yè)地址模式;默認(rèn)10;
OLED_WR_Byte(0xA1,OLED_CMD);//段重定義設(shè)置,bit0:0,0->0;1,0->127;
OLED_WR_Byte(0xC0,OLED_CMD);//設(shè)置COM掃描方向;bit3:0,普通模式;1,重定義模式COM[N-1]->COM0;N:驅(qū)動(dòng)路數(shù)
OLED_WR_Byte(0xDA,OLED_CMD);//設(shè)置COM硬件引腳配置
OLED_WR_Byte(0x12,OLED_CMD);//[5:4]配置

OLED_WR_Byte(0x81,OLED_CMD);//對(duì)比度設(shè)置
OLED_WR_Byte(0xEF,OLED_CMD);//1~255;默認(rèn)0X7F(亮度設(shè)置,越大越亮)
OLED_WR_Byte(0xD9,OLED_CMD);//設(shè)置預(yù)充電周期
OLED_WR_Byte(0xf1,OLED_CMD);//[3:0],PHASE1;[7:4],PHASE2;
OLED_WR_Byte(0xDB,OLED_CMD);//設(shè)置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,關(guān)閉;(白屏/黑屏)
OLED_WR_Byte(0xA6,OLED_CMD);//設(shè)置顯示方式;bit0:1,反相顯示;0,正常顯示
OLED_WR_Byte(0xAF,OLED_CMD);//開啟顯示
OLED_Clear();
}

然后在main.c文件如下位置添加oled測(cè)試代碼（記得添加頭文件和頭文件路徑）

下載程序，觀看現(xiàn)象

此 OLED 驅(qū)動(dòng)的準(zhǔn)備已經(jīng)完成，下一步就是移植 GuiLite

2.3 例程移植

首先，我們上GuiLite的例程展示官網(wǎng)：GuiLiteDemo，選擇Hello例程，將其中的 UI_Code文件夾復(fù)制到 Hardware 下：

在 MDK 工程里面導(dǎo)入U(xiǎn)ICode下的GuiLite.h和UIcode.cpp文件

我們?cè)?main.c 文件開頭添加 GuiLite 接口代碼，接口代碼如下：

//畫點(diǎn)函數(shù)接口
voidgfx_draw_pixel(intx,inty,unsignedintrgb)
{
OLED_DrawPoint(x,y,rgb);
}
//畫面函數(shù)(未使用)
voidgfx_draw_fill(intx,inty,intw,intq,unsignedintrgb)
{
}
//創(chuàng)建一個(gè)函數(shù)指針結(jié)構(gòu)體
structEXTERNAL_GFX_OP
{
void(*draw_pixel)(intx,inty,unsignedintrgb);
void(*fill_rect)(intx0,inty0,intx1,inty1,unsignedintrgb);
}my_gfx_op;
externvoidstartHelloCircle(void*phy_fb,intwidth,intheight,intcolor_bytes,structEXTERNAL_GFX_OP*gfx_op);

//設(shè)定延時(shí)函數(shù)接口
voiddelay_ms(intmilli_seconds)
{
HAL_Delay(milli_seconds);
}

之后在main函數(shù)中添加如下代碼

//傳遞函數(shù)指針
my_gfx_op.draw_pixel=gfx_draw_pixel;
my_gfx_op.fill_rect=NULL;//gfx_fill_rect;
//啟動(dòng)畫圓
startHelloCircle(NULL,128,64,1,&my_gfx_op);

然后我們修改UIcode.cpp文件中的代碼，添加OLED頭文件，以及在UI執(zhí)行函數(shù)界面處添加OLED刷新函數(shù)

之后在UIcode的第8行修改3D圓的參數(shù)，因?yàn)镺LED大小128x64 ，所以我的配置如下：

配置完成后，我們關(guān)閉Use MicroLIB選項(xiàng)，編譯代碼

編譯成功，下載代碼

三、Gui移植結(jié)果

下載完成后程序復(fù)位，可以在OLED上看到Demo的示例動(dòng)畫。