摘要:最近在做Github找到一個有趣的開源Gui框架:GuiLite,按照說明移植了GuiLite到STM32F4OLED屏幕上,分析一下自己的移植經(jīng)驗。
GuiLite是一個開源的Gui框架,只依賴于一個單一的頭文件庫(GuiLite.h),不需要很復(fù)雜的文件管理,代碼量平易近人,GuiLite由4千行C++代碼編寫,單片機上也能流暢運行,其最低的硬件運行要求如下:
| CPU主頻 | ROM大小 | RAM大小 |
|---|---|---|
| 24 MHZ | 29KB | 9KB |
同時GuiLite具有很強的跨平臺特性:
除此之外,GuiLite 提供一系列輔助開發(fā)工具:


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

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

代碼生成后,我們復(fù)制正點原子的OLED驅(qū)動工程代碼到Hardware硬件目錄下(自己創(chuàng)建一個該目錄)

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

然后我們進(jìn)入oled.c文件,將void OLED_WR_Byte(u8 dat,u8 cmd)和 void OLED_Init(void)函數(shù)分別替換為下面的內(nèi)容:
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);?//關(guān)閉顯示
?OLED_WR_Byte(0xD5,OLED_CMD);?//設(shè)置時鐘分頻因子,震蕩頻率
?OLED_WR_Byte(80,OLED_CMD);???//[3:0],分頻因子;[7:4],震蕩頻率
?OLED_WR_Byte(0xA8,OLED_CMD);?//設(shè)置驅(qū)動路數(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,頁地址模式;默認(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ū)動路數(shù)
?OLED_WR_Byte(0xDA,OLED_CMD);?//設(shè)置COM硬件引腳配置
?OLED_WR_Byte(0x12,OLED_CMD);?//[5:4]配置
???
?OLED_WR_Byte(0x81,OLED_CMD);?//對比度設(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],PHASE?1;[7:4],PHASE?2;
?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測試代碼(記得添加頭文件和頭文件路徑)

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

此 OLED 驅(qū)動的準(zhǔn)備已經(jīng)完成,下一步就是移植 GuiLite
首先,我們上GuiLite的例程展示官網(wǎng):GuiLiteDemo,選擇Hello例程,將其中的 UI_Code文件夾復(fù)制到 Hardware 下:

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

我們在 main.c 文件開頭添加 GuiLite 接口代碼,接口代碼如下:
//畫點函數(shù)接口
void?gfx_draw_pixel(int?x,?int?y,?unsigned?int?rgb)
{
????OLED_DrawPoint(x,y,rgb);
}
//畫面函數(shù)(未使用)
void?gfx_draw_fill(int?x,?int?y,int?w,?int?q,?unsigned?int?rgb)
{?
}
//創(chuàng)建一個函數(shù)指針結(jié)構(gòu)體
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);
//設(shè)定延時函數(shù)接口
void?delay_ms(int?milli_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;
//啟動畫圓
startHelloCircle(NULL,?128,?64,?1,?&my_gfx_op);
然后我們修改UIcode.cpp文件中的代碼,添加OLED頭文件,以及在UI執(zhí)行函數(shù)界面處添加OLED刷新函數(shù)

之后在UIcode的第8行修改3D圓的參數(shù),因為OLED大小128x64 ,所以我的配置如下:

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

編譯成功,下載代碼

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

<<< 左右滑動見更多 >>>
<<< 左右滑動見更多 >>>
<<< 左右滑動見更多 >>>