最近在做Github找到一个有趣的开源Gui框架：GuiLite，按照说明移植了GuiLite到STM32F4OLED屏幕上，分析一下自己的移植经验。
; K( P2 N: L, a# {

01 GuiLite介绍

GuiLite是一个开源的Gui框架，只依赖于一个单一的头文件库（GuiLite.h），不需要很复杂的文件管理，代码量平易近人。

GuiLite由4千行C++代码编写，单片机上也能流畅运行，其最低的硬件运行要求如下：
$ |  d8 Y: [, {, n. F2 C% i

" `. Z9 H2 w4 `2 A3 F

! X7 h! F: B9 D0 S& K

同时GuiLite具有很强的跨平台特性：

• 支持的操作系统：iOS/macOS/WatchOS，Android，Linux（ARM/x86-64），Windows（包含VR），RTOS… 甚至无操作系统的单片机
• 支持的开发语言：C/C++, Swift, Java, Javascript, C#, Golang…
• 支持的第3方库：Qt, MFC, Winforms, CoCoa…
  
  0 b. k, {+ ]% t! N

除此之外，GuiLite 提供一系列辅助开发工具：

• ☁️完美的“云” + “物联网”解决方案：让你轻松驾驭全球IoT业务
• 支持多语言,采用 UTF-8 编码；支持视频播放
• 资源制作工具为你定制自己的字体/图片资源
• 所见即所得的GUI布局工具
• 编译活跃度统计，及实时分析
• 支持3D & Web
• 支持Docker，一条命令启动。
  
  
  

02 GuiLite移植

2.1 硬件准备

9 n8 r$ O: t, r( j

7 L* I; u* f7 O. }

STM32F407开发板

OLED屏幕

2.2 驱动准备

这里我使用STM32CubeMX 对开发板进行外设配置，开启STM32的硬件IIC，这里我用CubeMX开启后如下：

, ]% |1 X5 j5 z" u+ ?0 _

. {0 C9 y' \4 p& y/ p( d

配置完成生成代码，同时将分配的堆空间增大：

代码生成后，我们复制正点原子的OLED驱动工程代码到Hardware硬件目录下（自己创建一个该目录）

; D" H, G( f7 |8 Y$ V

在MDK里面添加文件，然后我们进行修改，注释掉头文件里面关于端口的定义，同时添加三个类型宏定义

1 A: W' [8 C  f4 j' G

然后我们进入oled.c文件，将void OLED_WR_Byte(u8 dat,u8 cmd)和 void OLED_Init(void)函数分别替换为下面的内容：

" l+ o, \3 ~% ?6 n! m; M& @

OLED_WR_Byte：

1. void OLED_WR_Byte(u8 dat,u8 cmd)
   + w4 p4 [/ ?5 E3 U% v% E
2. {
   
3. if(cmd)
   
4.   HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x40,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100);
   ! U1 i) K1 E5 l
5. else
   
6.   HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x00,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100);
   ; D- O4 v4 l' i( h, y0 ?( Q  A
7. }

复制代码

6 F4 A1 v- u# C

OLED_Init：

1. <i>//初始化SSD1306         </i>
   
2. void OLED_Init(void)
   
3. {        
   2 e: E9 r" r/ w7 G4 D
4. OLED_WR_Byte(0xAE,OLED_CMD); <i>//关闭显示</i>
   ( b0 s$ ~2 H1 Z$ u
5. OLED_WR_Byte(0xD5,OLED_CMD); <i>//设置时钟分频因子,震荡频率</i>
   1 |- G+ a: q6 r* Y7 V( {* B
6. OLED_WR_Byte(80,OLED_CMD);   <i>//[3:0],分频因子;[7:4],震荡频率</i>
   ) v, B' @% g" n/ d' r
7. OLED_WR_Byte(0xA8,OLED_CMD); <i>//设置驱动路数</i>
   
8. OLED_WR_Byte(0X3F,OLED_CMD); <i>//默认0X3F(1/64) </i>
   & T, j$ c; v( F" e
9. OLED_WR_Byte(0xD3,OLED_CMD); <i>//设置显示偏移</i>
   
10. OLED_WR_Byte(0X00,OLED_CMD); <i>//默认为0</i>
    
11. 
    
12. OLED_WR_Byte(0x40,OLED_CMD); <i>//设置显示开始行 [5:0],行数.</i>
    
13.                  
    
14. OLED_WR_Byte(0x8D,OLED_CMD); <i>//电荷泵设置</i>
    
15. OLED_WR_Byte(0x14,OLED_CMD); <i>//bit2，开启/关闭</i>
    % q+ P  }2 L) U5 j
16. OLED_WR_Byte(0x20,OLED_CMD); <i>//设置内存地址模式</i>
    ' F. _7 r5 S4 Q! O6 l. i1 P8 q6 V% ?
17. OLED_WR_Byte(0x02,OLED_CMD); <i>//[1:0],00，列地址模式;01，行地址模式;10,页地址模式;默认10;</i>
    
18. OLED_WR_Byte(0xA1,OLED_CMD); <i>//段重定义设置,bit0:0,0->0;1,0->127;</i>
    
19. OLED_WR_Byte(0xC0,OLED_CMD); <i>//设置COM扫描方向;bit3:0,普通模式;1,重定义模式 COM[N-1]->COM0;N:驱动路数</i>
    * X0 o* x% K4 g9 A0 ?4 m
20. OLED_WR_Byte(0xDA,OLED_CMD); <i>//设置COM硬件引脚配置</i>
    
21. OLED_WR_Byte(0x12,OLED_CMD); <i>//[5:4]配置</i>
    ! o$ [4 J( p$ n* E8 @/ ]. P( M7 i
22.    
    4 a% x) B% L! [* m7 H$ r! k- I
23. OLED_WR_Byte(0x81,OLED_CMD); <i>//对比度设置</i>
    
24. OLED_WR_Byte(0xEF,OLED_CMD); <i>//1~255;默认0X7F (亮度设置,越大越亮)</i>
    
25. OLED_WR_Byte(0xD9,OLED_CMD); <i>//设置预充电周期</i>
    
26. OLED_WR_Byte(0xf1,OLED_CMD); <i>//[3:0],PHASE 1;[7:4],PHASE 2;</i>
    
27. OLED_WR_Byte(0xDB,OLED_CMD); <i>//设置VCOMH 电压倍率</i>
    
28. OLED_WR_Byte(0x30,OLED_CMD); <i>//[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;</i>
    
29. 
    . ]; y6 n0 L8 x- F! Q' d) J
30. OLED_WR_Byte(0xA4,OLED_CMD); <i>//全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)</i>
    " e2 c) q5 {. r1 T6 ]' Y6 h1 o9 \
31. OLED_WR_Byte(0xA6,OLED_CMD); <i>//设置显示方式;bit0:1,反相显示;0,正常显示              </i>
    
32. OLED_WR_Byte(0xAF,OLED_CMD); <i>//开启显示  </i>
    6 E+ t$ A' v  R  a9 ?( K
33. OLED_Clear();
    % w. e+ }, E! ~& P6 A
34. }  

复制代码

然后在main.c文件如下位置添加oled测试代码（记得添加头文件和头文件路径）

- V+ E6 ~: R3 [. k: J! q( r+ r

下载程序，观看现象

9 u7 |$ N) f0 C8 d0 C4 a$ p

此 OLED 驱动的准备已经完成，下一步就是移植 GuiLite

2.3 例程移植

首先，我们上GuiLite的例程展示官网：GuiLiteDemo，选择Hello例程，将其中的 UI_Code文件夹复制到 Hardware 下：

/ Q% W5 Q3 j, R* Z7 _

在 MDK 工程里面导入UICode下的GuiLite.h和UIcode.cpp文件

我们在 main.c 文件开头添加 GuiLite 接口代码，接口代码如下：

1. <i>//画点函数接口</i>
   4 x# \& N1 p8 @! m
2. void gfx_draw_pixel(int x, int y, unsigned int rgb)
   ; |$ R; `  ?( D2 a: x- s+ r
3. {
   5 S$ j, L+ i7 c  X1 K
4.     OLED_DrawPoint(x,y,rgb);
   
5. }
   4 ]/ z$ f; K( U+ v' V8 z2 k" l
6. <i>//画面函数(未使用)</i>
   4 g) ?+ F. F6 Y3 ?- z* s
7. void gfx_draw_fill(int x, int y,int w, int q, unsigned int rgb)
   
8. {
   
9. }
   $ P% T, D; c/ y
10. <i>//创建一个函数指针结构体</i>
    1 m$ N9 _; p; x! t: X+ F1 R# R' o' I
11. struct EXTERNAL_GFX_OP
    
12. {
    
13. void (*draw_pixel)(int x, int y, unsigned int rgb);
    
14. void (*fill_rect)(int x0, int y0, int x1, int y1, unsigned int rgb);
    
15. } my_gfx_op;
    
16. extern void startHelloCircle(void* phy_fb, int width, int height, int color_bytes, struct EXTERNAL_GFX_OP* gfx_op);
    
17. 
    
18. <i>//设定延时函数接口</i>
    
19. void delay_ms(int milli_seconds)
    
20. {
    
21. HAL_Delay(milli_seconds);
    7 N- |% |0 n0 M9 \; o5 Q
22. }

复制代码

3 `7 I( j/ P/ ~8 e9 o

之后在main函数中添加如下代码

1. <i>//传递函数指针</i>
   
2. my_gfx_op.draw_pixel = gfx_draw_pixel;
   
3. my_gfx_op.fill_rect = NULL;<i>//gfx_fill_rect;</i>
   ( ]' e& K9 G* Z) x2 A" I
4. <i>//启动画圆</i>
   ! E5 {4 Y8 A: ~1 D6 S
5. startHelloCircle(NULL, 128, 64, 1, &my_gfx_op);

复制代码

$ H, g3 r% Z  m( L% D# b

然后我们修改UIcode.cpp文件中的代码，添加OLED头文件，以及在UI执行函数界面处添加OLED刷新函数

$ `$ e6 h) J: a

; U- G6 p& A& M
. [( l8 s0 E3 T$ X4 z# l7 v% F0 r

之后在UIcode的第8行修改3D圆的参数，因为OLED大小128x64 ，所以我的配置如下：

0 {, P  W7 |! B6 f* d" V9 o/ e

配置完成后，我们关闭Use MicroLIB选项，编译代码

. R$ E$ i. i, g/ ]' C1 _2 n! L" k

( }! v/ Y! @4 ]! f) H, |% n9 A

编译成功，下载代码

03 Gui移植结果

下载完成后程序复位，可以在OLED上看到Demo的示例动画。

& x4 F/ [( n, \% n: Y$ L一些其他的演示效果



( b& m! I( X) W6 [) R" ~



; L5 C! G# v' c9 q


转载自：大鱼机器人