4000行代码的开源GuiLite，并移植到STM32

[复制链接]

STMCU小助手发布时间：2023-3-4 20:00

文章
文章封面:
文章简介:	4000行代码的开源GuiLite，并移植到STM32

1 Gui移植结果

一些演示效果：




. S2 V! b# O& T2 G

; M" K0 w; v* }; \4 r
2 GuiLite介绍
GuiLite是一个开源的图形用户界面框架，只依赖于一个单一的头文件库（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…
( G& F/ R# T" D# A& p
/ |5 ^2 v% t K, B7 Z

0 C) X8 C. x2 m

GuiLite 提供一系列辅助开发工具：

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

9 K0 a; x. V* N, r* d G) [3 GuiLite移植2.1 所需硬件

7 t5 a. }, ^" P- ~, y. C

* n8 H- _) U. n) {
STM32F407开发板

OLED屏幕

0 V* v# N U, y9 t* j
2.2 驱动准备
这里我使用STM32CubeMX 对开发板进行外设配置，开启STM32的硬件IIC，这里我用CubeMX开启后如下：

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

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

微信图片_20230302201518.png

在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)
@) N! ^5 I/ R0 Z v
{ ' F" |& ]/ Q6 Q. t3 g* ]9 R: u
if(cmd)
, _4 L* C; g% _$ }$ s2 R4 h
HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x40,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100);0 K3 T8 M2 Z0 Z" K/ {$ R
else
# X* J5 u% S) ]1 H
HAL_I2C_Mem_Write(&hi2c1 ,0x78,0x00,I2C_MEMADD_SIZE_8BIT,&dat,1,0x100);
- N$ |$ i B P7 I) j. V
}

复制代码

OLED_Init：

//初始化SSD1306 5 V. @5 U1 K+ c- M, K- E9 T
void OLED_Init(void)' ?/ [" T" ^ Q f: i& h
{
5 e. m7 l; j/ \! Y
OLED_WR_Byte(0xAE,OLED_CMD); //关闭显示& f: h' k/ j7 k# e' X4 c
OLED_WR_Byte(0xD5,OLED_CMD); //设置时钟分频因子,震荡频率" a. j2 l0 k% Q2 x0 |; E' x7 V
OLED_WR_Byte(80,OLED_CMD); //[3:0],分频因子;[7:4],震荡频率
4 T& A( {# @/ K' e# l+ r, ~$ Y3 r6 n
OLED_WR_Byte(0xA8,OLED_CMD); //设置驱动路数0 r' H' h# j, Q. ?
OLED_WR_Byte(0X3F,OLED_CMD); //默认0X3F(1/64)
/ _7 q/ v6 ~0 E; }' h B
OLED_WR_Byte(0xD3,OLED_CMD); //设置显示偏移
2 _# a) f9 P- u
OLED_WR_Byte(0X00,OLED_CMD); //默认为0
, m6 a; B6 n/ g* k! L6 r1 B
* h8 X& ?, ?4 W7 ?
OLED_WR_Byte(0x40,OLED_CMD); //设置显示开始行 [5:0],行数.
9 M% ^; Y8 `: a2 g
( M3 Z) s* u6 i& x/ z, Z
OLED_WR_Byte(0x8D,OLED_CMD); //电荷泵设置
5 U* c9 f; L- n! i1 [' u
OLED_WR_Byte(0x14,OLED_CMD); //bit2，开启/关闭: i. O+ ~! k( l) }4 R
OLED_WR_Byte(0x20,OLED_CMD); //设置内存地址模式
7 R' L9 n% N. \3 P o+ }2 ^
OLED_WR_Byte(0x02,OLED_CMD); //[1:0],00，列地址模式;01，行地址模式;10,页地址模式;默认10;$ @: {* a, r" n1 h: f9 y c
OLED_WR_Byte(0xA1,OLED_CMD); //段重定义设置,bit0:0,0->0;1,0->127;
+ ~* i0 Q6 }3 e5 A1 ~- s
OLED_WR_Byte(0xC0,OLED_CMD); //设置COM扫描方向;bit3:0,普通模式;1,重定义模式 COM[N-1]->COM0;N:驱动路数4 l: E5 o5 e" [7 k m8 H
OLED_WR_Byte(0xDA,OLED_CMD); //设置COM硬件引脚配置
9 m' n! ^+ @# \+ B: w8 x9 k3 O
OLED_WR_Byte(0x12,OLED_CMD); //[5:4]配置) }+ k* _1 o) {8 p$ P. |& Y6 l, H
" x0 ~) v+ p9 @$ N1 R, ?9 v, ~0 ]
OLED_WR_Byte(0x81,OLED_CMD); //对比度设置* I5 J7 X" |4 D
OLED_WR_Byte(0xEF,OLED_CMD); //1~255;默认0X7F (亮度设置,越大越亮)
' Q, z9 _9 K2 z7 W+ j8 y
OLED_WR_Byte(0xD9,OLED_CMD); //设置预充电周期% \3 D; K5 k) x) \
OLED_WR_Byte(0xf1,OLED_CMD); //[3:0],PHASE 1;[7:4],PHASE 2;: J* [7 m- j6 l2 D7 c: [9 b) N
OLED_WR_Byte(0xDB,OLED_CMD); //设置VCOMH 电压倍率
% a- M0 C8 F' B
OLED_WR_Byte(0x30,OLED_CMD); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;' K5 @0 a" ^" a& X
7 u( D7 r/ e* d, K* i& _
OLED_WR_Byte(0xA4,OLED_CMD); //全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)
" F+ x2 z# E* R& l9 ^
OLED_WR_Byte(0xA6,OLED_CMD); //设置显示方式;bit0:1,反相显示;0,正常显示 - L2 |. O+ P: @+ a6 d6 e
OLED_WR_Byte(0xAF,OLED_CMD); //开启显示 3 v0 D# k5 t* ~/ t6 B/ {
OLED_Clear();/ m1 a$ n5 ~4 E( Y& t! w- N
}

复制代码

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

下载程序，观看现象：

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

. p5 |% ~1 Z) w! ^
2.3 例程移植
首先，我们上GuiLite的例程展示官网：GuiLiteDemo，选择Hello例程，将其中的 UI_Code文件夹复制到 Hardware 下：

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

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

//画点函数接口
# y1 L) D) ] {/ C \
void gfx_draw_pixel(int x, int y, unsigned int rgb)
$ Q1 j/ j' B' ^3 z7 G0 ^; K9 J
{7 w) d' g; U+ ?. W% |
OLED_DrawPoint(x,y,rgb);
% }- I* Q% K- l7 W
}; f0 S1 B. n/ \& D3 _
//画面函数(未使用)
/ Q+ e& ^3 q! d3 @1 P0 Q1 `& X
void gfx_draw_fill(int x, int y,int w, int q, unsigned int rgb)4 q; S, R2 ? p* G
{ 4 d2 O$ Z d, L8 j- {
}- Z! N. D6 z* j' I9 o
//创建一个函数指针结构体% C, ~* f+ d+ Z N! }1 E
struct EXTERNAL_GFX_OP1 e* n j' s! o: [6 h, p
{
! o+ |' b2 V2 c! a$ \
void (*draw_pixel)(int x, int y, unsigned int rgb);
4 C, z& u. J2 M5 m2 A7 {
void (*fill_rect)(int x0, int y0, int x1, int y1, unsigned int rgb);
. J, o3 c! _- ^ _3 ^
} my_gfx_op;
: V5 U2 x! ^- X ^- L$ F
extern void startHelloCircle(void* phy_fb, int width, int height, int color_bytes, struct EXTERNAL_GFX_OP* gfx_op);
2 Y5 E' v* |! } H( y% P/ C
! @# j4 z0 K) T
//设定延时函数接口' X( A8 D }& ~: d: j0 j
void delay_ms(int milli_seconds)5 r/ B- o# J. [' v9 g5 H1 @
{. H0 T# }5 Y# |' q- y
HAL_Delay(milli_seconds);3 d5 k" I+ d7 L8 ?5 C8 ?& i/ O
}