一、GuiLite
5 X& i& ? v4 ?. H GuiLite图形库,仅4千行C++代码,0依赖,单一头文件库(GuiLite.h)的跨平台开源GUI库,支持支持的操作系统有iOS/macOS/WatchOS,Android,Linux(ARM/x86-64),Windows(包含VR),RTOS等,甚至无操作系统的单片机上也能流畅运行。4 A, c8 Q2 q. _0 V% z
, v( ?, b% |% E二、创建工程
m! f3 l$ j) G$ Z1 v
H6 T% D1 Y; F1 `8 T, ]( F2 G 实现了LCD屏幕点亮功能。# m% A- O6 X5 f- J/ q; }
; M4 P0 _5 n. K) B/ g' H 【2】现在CubeIDE工作空间创建一个名为stm32L496VGTx_GUI的文件目录,并将前面工程的stm32L496VGTx_lcm.ioc文件拷贝到该目录下,修改该文件名为stm32L496VGTx_GUI.ioc。
1 ?4 L4 t, B! r: p* J
6 `- \8 D2 l/ b# n' j8 I8 a 在CubeIDE中,在菜单栏的“新建-> Create a New STM32 Project from an Existing STM32CubeMX Configuration files(.ioc)”,进入创建,基于已有ioc创建一个新工程,如下图所示,特别注意,选择C++支持,因为GuiLite库是C++库。
' j, Y+ o/ i8 D4 x' P! o: l, `+ B
9 u; z1 x+ a2 @" c
0 y, u) b- C( S" L# `: B% {: U4 `) ` 【3】完成工程创建后,禁用syscalls.c文件,在工程目录下创建源目录ICore,并移植前面工程的源文件,实现lpuart1串口驱动、按键及LED灯驱动、LCD屏幕驱动,如下图所示;由于前面博文中实现LCD的DMA刷新数据时,使用了SPI回调及全局变量,需要到Core/Src/spi.c文件增加如下内容:) l5 J! L' l% @+ S9 j
- volatile uint8_t one_frame_done;4 Y9 `. ]+ s( I, K8 y! ~# y/ {2 W
- void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)$ @- S) L0 D2 V; J" Z" N7 M
- {& B3 V; ^4 F0 X& ^" }3 O& }
- one_frame_done = 1; I( _1 L" C8 b, w
- }
复制代码
# E- x) x# G* z1 M) O" R
, ~3 ~& r' g! o0 n$ I
7 T5 ]) n' m+ P% E/ Y4 \1 Z5 P3 h+ ?
( f, H9 H: w4 i' |, H# ?: e; W三、GuiLite库及Hello3D样例移植
; h' b+ ^0 h9 } q; b6 Y. u+ ~# P& p 在ICore目录下创建guilite文件夹,将GuiLite库即GuiLite.h文件拷贝到该文件目录,将Hello3D样例的UIcode.cpp源文件拷贝到该文件目录。* M! G5 v& d" ]+ \" Z0 S+ k/ V
8 P, R8 W0 O* T3 j p d: r2 E" i 【1】由于GuiLite.h内的thread_sleep函数调用了延时函数,而样例给出的延时函数过于复杂,本文另外设置了新的延时函数,在ICore目录下新建delay目录,并在该目录下创建了delay.h和delay.c源码。
# n' {7 ?) k2 B" c
& e2 y% @, l1 |$ m1 J L delay.h
6 i) d+ c0 Q% W: P9 U- m- #ifndef DELAY_DELAY_H_7 {1 S' ]1 F0 p+ t9 a3 V
- #define DELAY_DELAY_H_
7 h9 j( J7 O D" ]- Q2 _4 r# X: Z8 f - #ifdef __cplusplus
# a0 D- Z2 }, o/ ]+ E! E& X - extern "C" {9 P; Y9 e) Q a- S9 p
- #endif$ H/ ?# T t6 R
-
2 z1 @1 e0 v3 n$ N) ^2 p$ n - #include "stm32l4xx_hal.h" //HAL库文件声明
+ w" |0 Q2 b+ z! ] v - void delay_us(uint32_t us); //C文件中的函数声明) ^1 W. ?8 f8 o2 s& U% G& L( a
-
5 }3 L- ^* t6 r% R& ?1 }% `' ] - #ifdef __cplusplus
8 ]8 M4 Y/ V+ d# P$ F - }
6 O+ Z) f- U6 }" K- B5 o: D. d* ` - #endif) s7 w! P& ?* R6 N0 y: O
- #endif /* DELAY_DELAY_H_ */
复制代码
; c! c0 N+ W% p3 O# a3 X
4 T E4 ~. h+ e- {: c1 u; d delay.c7 \' R. S. Q2 y8 h5 Y
- #include "delay.h"
+ h/ ]% ?3 H3 t! |$ M' e, t -
5 Y4 I4 W L" F7 `# x% l - void delay_us(uint32_t us) //利用CPU循环实现的非精准应用的微秒延时函数+ l: L' [+ @- {1 Q; X8 E: }
- {
, u8 L' [5 T! h9 _: _$ k - uint32_t delay = (HAL_RCC_GetHCLKFreq() / 8000000 * us); //使用HAL_RCC_GetHCLKFreq()函数获取主频值,经算法得到1微秒的循环次数
/ {1 {4 [! x4 z- f% K3 z! k$ A5 W - while (delay--); //循环delay次,达到1微秒延时% T* [/ ?) d/ d- | ]
- }
复制代码
8 @/ m6 V/ ]& ]4 s# y. F6 u 由于现在采用的是C++编译语言,因此可以看到 delay.h文件中,和以前不一样的是,增加了extern "C"声明,为了严禁,移植过来的print.h、usart.h、key.h、led.h、oled.h本文都增加了extern "C"声明。
+ @# h4 J! N+ _, ~/ E- #ifdef __cplusplus
& e, N C# Q( m. g- v - extern "C" {9 d' ^- `/ l( m2 ?' ]+ M
- #endif8 a9 E3 p2 M4 I t! a
- , U5 |" [. `( l; g6 }
- //you code
% Y& R- ` {% @6 T) r0 B -
$ U$ z1 s: v5 p+ y! \ - #ifdef __cplusplus2 w/ f% z0 O; S/ g& g% Y; I4 p
- }
复制代码 # @8 n. L" q# \, N3 G
【2】调整文件GuiLite.h,首先,同样的在文件前面增加了delay.h头文件的引用,以及为了统一,将其宏定义#pragma once进行了替换,结果如下! S1 k/ h6 r; f/ [4 n! F" ^
- #ifndef GUILITE_H_
( b4 S4 M0 J/ H7 J4 f - #define GUILITE_H_( o. S% ^' K8 ?4 \
- #include "../delay/delay.h"
复制代码
: `5 o8 e! i. s* M& m6 V7 R 在GuiLite.h文件中找到thread_sleep函数,该函数有几处,需要条件编译的地方暂时不用管找到STM32需要的,如下。
8 m" W0 N: b8 Z) I5 l- ^: d- extern "C" void delay_ms(unsigned short nms);* b; u% s' Z. U# v# f/ J4 H8 c
- void thread_sleep(unsigned int milli_seconds)
3 V: _! b. g5 R6 Z/ m1 Y5 y- F9 b( U( B - {//MCU alway implemnet driver code in APP.
' S+ Z1 B+ B+ `! q: S5 U3 ?, C4 t# s0 X - delay_ms(milli_seconds);
% ~9 A2 _2 n1 e - }
复制代码
' O+ \9 H" r7 u 调整为& g7 j- D4 u; J, ?( k( z
- //extern "C" void delay_ms(unsigned short nms);
# }# \8 y1 R. r - void thread_sleep(unsigned int milli_seconds)
! {2 v/ i, ^; |& |- Q. L - {//MCU alway implemnet driver code in APP.
, q8 [; y1 Y. z6 L - uint32_t tt = ((uint32_t)milli_seconds)*1000;0 Y% u- B8 ?5 `: A' i, L6 i9 \$ j
- delay_us(tt);; C" \) |( g+ l2 E P4 B. \1 O v# a
- }
复制代码
- s+ I- C# O9 j! F! ^ 【3】在main.c文件,引用各外设驱动头文件
. [! E. o% B2 ~+ I$ F. Q- /* USER CODE BEGIN Includes */
% m- |* P3 P' v" G& z - #include "../../ICore/key/key.h"2 d- q5 j. D x# ~
- #include "../../ICore/led/led.h"5 d6 y+ Y1 ]0 D* n6 m* q
- #include "../../ICore/print/print.h"/ x# Z0 t/ r) S, y
- #include "../../ICore/usart/usart.h"
7 R Z2 i( z8 m: t+ @ - #include "../../ICore/oled/oled.h"
8 A0 }* o6 Z# p5 Z* ^ - /* USER CODE END Includes */
复制代码
; P' ?1 O0 ]" A+ a( \4 d8 h 在main.c文件中参考Hello3D样例的main.c源文件(Hello3D/BuildSTM32F103-Keil/USER/main.c · idea4good/GuiLiteSamples - Gitee.com)进行声明GuiLite库调用前置声明如下,主要就是需要改写调用本文LCD屏幕支持依据坐标值及颜色值,进行点绘制功能函数。
% z; u& u& m$ v* @0 g% b% u$ s4 v- /* USER CODE BEGIN 0 */
1 m% ~1 O9 { E - //Transfer GuiLite 32 bits color to your LCD color
" C$ ]6 v6 E( V% x( b. O' V V - #define GL_RGB_32_to_16(rgb) (((((unsigned int)(rgb)) & 0xFF) >> 3) | ((((unsigned int)(rgb)) & 0xFC00) >> 5) | ((((unsigned int)(rgb)) & 0xF80000) >> 8))
( [5 K! t! f' ~' A0 B3 ?$ {6 x - //Encapsulate your LCD driver:
. W+ A. ]/ i. H9 e- e - void gfx_draw_pixel(int x, int y, unsigned int rgb)* t4 f# s4 N+ j. J- }+ \
- {8 O8 `% }# s+ i) c# ~/ ^; _2 d {: B
- //LCD_Fast_DrawPoint(x, y, GL_RGB_32_to_16(rgb));//注释参考样例的
" C3 L( s7 A) E8 V! W' W - OLED_WritePixel(x, y, GL_RGB_32_to_16(rgb));//新增本工程支持绘制点函数调用(oled.h)
6 C* W" |4 |+ Q6 _% y: Y$ k - }6 Y3 _" T/ P! ^1 J! k/ T/ X
- //Implement it, if you have more fast solution than drawing pixels one by one.6 N" x# @3 z0 o
- //void gfx_fill_rect(int x0, int y0, int x1, int y1, unsigned int rgb){}
c4 U1 g- w7 e9 K0 P8 H -
1 c( t7 q- p( Z$ Q& v8 R p' M - //UI entry1 \: @3 A- E2 r
- struct DISPLAY_DRIVER
1 }' {; i; g- X( v; Q$ }& f$ q0 t - {
$ O% G0 ^ q. [* V& ^; O - void (*draw_pixel)(int x, int y, unsigned int rgb);
) U- a3 l, X2 ~, j6 [( R6 h" z - void (*fill_rect)(int x0, int y0, int x1, int y1, unsigned int rgb);
: L3 b& `; k2 o9 [- t( v - } my_driver;+ I% S( s# d% n) P f2 F
- extern void startHello3D(void* phy_fb, int width, int height, int color_bytes, struct DISPLAY_DRIVER* driver);7 Q: G% Z$ e% p0 x6 w
- /* USER CODE END 0 */
复制代码
" a: I& \& Z2 r- |
- V+ |; ]" H2 {! e7 S& A 在Hello3D样例的main主函数中,先初始化延时函数、在配置中断和LCD屏幕初始化,然后进行3D效果绘制渲染输出。# E/ i' s, S- P4 |9 g" v4 P: Y/ y( t1 }( h
- delay_init();# w' ?+ [$ N" |+ [) q
- NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
1 u1 ~& O* C' Z1 K' P - LCD_Init();1 L' \0 T. s$ q3 s) r; V1 _; v& b
-
j5 b7 v+ f' f( q - //Link your LCD driver & start UI:; C3 D4 K: K1 E4 f3 K9 A
- my_driver.draw_pixel = gfx_draw_pixel;( k. e$ L5 S3 z( U- ^* r
- my_driver.fill_rect = NULL;//gfx_fill_rect;
( h! E2 I% i) N1 H6 ^% G - startHello3D(NULL, 240, 320, 2, &my_driver);- |5 r9 A6 h. e, ~! ^
- while(1);
复制代码 0 Z" c! z/ v/ z. u
在本博文移植中,在main函数内进行外设初始设置,例如lpuart1中断接收开启、lcd初始化,主要是LCD初始化。2 `# ?# p6 U8 Y+ d8 ~8 U ?' f0 C
- /* USER CODE BEGIN 2 */6 m7 b6 S& n6 c/ b$ W
- ResetPrintInit(&hlpuart1);# W4 O9 _- W: r( p: S% m
- HAL_UART_Receive_IT(&hlpuart1,(uint8_t *)&HLPUSART_NewData, 1); //再开启接收中断' P" [" Y# z# c3 @" B h# S# U/ q! E
- HLPUSART_RX_STA = 0;
0 f7 A R6 O9 s( \: k6 R - //
L4 E- R- j3 o. V# J- ]7 K - OLED_init();
3 j( j& ?, d5 A5 Q/ f& L - //设置OLED蓝色背景显示
0 _0 R7 y. C. R; z/ Q: D - BSP_LCD_Clear_DMA(LCD_DISP_BLUE);1 @" Z& _7 N9 E. q0 |! c; g; O
- printf("OLED_Clear_DMA\r\n");% n; z' n: K, C6 J. ]) ]
- /* USER CODE END 2 */
复制代码
6 J) ~, R9 _1 v4 P1 j6 v 然后在main函数主循环中,通过按键KEY2按键进入3D效果绘制渲染输出,读者可以屏蔽串口接收功能、按键KEY0、KEY1的亮屏功能,直接进入KEY2下的3D效果绘制渲染功能是OK的。注意startHello3D调用需要根据自身屏幕宽、高设值,本文开发板支持240*240像素显示。
! L, R; A6 ~5 _6 ~3 f% p- /* USER CODE BEGIN WHILE */' E" K: ~3 F; J( j
- while (1), X$ f. t @0 }8 |) q
- {
, B8 N# T: ~) G. ` - if(HLPUSART_RX_STA&0xC000){//溢出或换行,重新开始
3 D4 r4 A& W( d: E) d - //printf("%.*s\r\n",HLPUSART_RX_STA&0X0FFF, HLPUSART_RX_BUF);! e5 V7 x) S7 ^) [& P2 X$ R
- OLED_printf(10,10,"%.*s",HLPUSART_RX_STA&0X0FFF, HLPUSART_RX_BUF);
" o8 R$ {- \' t - HLPUSART_RX_STA=0;//接收错误,重新开始
& j8 L& x6 y& A7 L, _8 r7 d; d9 L2 ] - HAL_Delay(100);//等待, X# O! U0 W' z+ D5 g* J
- }% G) H' f1 U' j
- if(KEY_0())1 ?4 d) g0 C9 B) X' y* P! E( h
- {4 n+ I8 x! H% O0 z
- BSP_LCD_login(24,108);8 n, E5 x" M4 B% d: Z0 X7 T( j
- }
. W, P% D6 r& U# M* P$ d! w0 E- \ - if(KEY_1())% J3 ]9 A/ j7 ^8 i# Z4 k
- {6 B0 h3 D, q8 E; R) n
- BSP_LCD_img_DMA();
$ f9 T( z, {9 p- U - }: `( Q, @0 |& L
- if(KEY_2())
1 Y* S4 e( Z4 t" ]. J: Q - {; G4 a$ S+ A/ O- s3 I$ M
- my_driver.draw_pixel = gfx_draw_pixel;
' p+ w" z& _6 W0 R/ K; D - my_driver.fill_rect = NULL;//gfx_fill_rect;
: A' {5 ~: E: D+ n8 k - startHello3D(NULL, 240, 240, 2, &my_driver);
' X- z, ]7 c6 w6 ^0 N: O* X - }
4 }, L5 |7 R& m& _: @, l - /* USER CODE END WHILE */
复制代码
; \" Y' `/ c+ `' K3 O四、编译及测试* f$ C5 S6 H8 ~9 W1 ^# Q) P
完成代码移植及改写后,进行运行配置设置,点击编辑及运行按钮,将程序下载到开发板上。/ `6 g0 |, C& c1 d% H0 W/ `6 ~1 ]
N" o4 P! G( W3 u9 d" j* z
: ^, G2 _/ f1 r) \4 L! q/ l2 R* r" D6 ] Z& ^6 K7 f' I
按键KEY2进入GuiLite库的3D绘制效果,按键KEY2按下时,屏幕会较慢地进行背景色(黑色)逐点绘制,因此较慢。最终处理的是一个3D立方体缓慢旋转刷新显示的动态画面,效果如下图(手指是拍摄时屏幕镜面映射效果,哈哈)。
( b" F0 T2 X) X2 p7 _1 |3 [7 H3 u. D% r
: R) O: U% n5 _- d4 w Z
& o# D; ?5 a$ \( [# m
# a/ ^& Q; N# v/ k& h9 E/ t# @
————————————————8 N# X9 \& g/ Y4 q* e$ _ Y
版权声明:py_free-物联智能
/ e( c# m% i% E4 r4 d( U如有侵权请联系删除
+ B8 ^: h8 _7 c D1 o Q+ j2 k4 S+ V5 _ |
内容很详细,谢谢分享
这个GUI效果真不错,有空可以尝试移植一下看看。