你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

STM32CubeIDE GuiLite图形库移植经验分享

[复制链接]
攻城狮Melo 发布时间:2023-4-6 16:38
一、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
77b7c5fa691448e28c500c6f201140a5.png 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
  1. volatile uint8_t one_frame_done;4 Y9 `. ]+ s( I, K8 y! ~# y/ {2 W
  2. void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)$ @- S) L0 D2 V; J" Z" N7 M
  3. {& B3 V; ^4 F0 X& ^" }3 O& }
  4.         one_frame_done = 1;  I( _1 L" C8 b, w
  5. }
复制代码

# E- x) x# G* z1 M) O" R
1605f3e1bd77401e93684107453c004c.png , ~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
  1. #ifndef DELAY_DELAY_H_7 {1 S' ]1 F0 p+ t9 a3 V
  2. #define DELAY_DELAY_H_
    7 h9 j( J7 O  D" ]- Q2 _4 r# X: Z8 f
  3. #ifdef __cplusplus
    # a0 D- Z2 }, o/ ]+ E! E& X
  4. extern "C" {9 P; Y9 e) Q  a- S9 p
  5. #endif$ H/ ?# T  t6 R

  6. 2 z1 @1 e0 v3 n$ N) ^2 p$ n
  7. #include "stm32l4xx_hal.h" //HAL库文件声明
    + w" |0 Q2 b+ z! ]  v
  8. void delay_us(uint32_t us); //C文件中的函数声明) ^1 W. ?8 f8 o2 s& U% G& L( a

  9. 5 }3 L- ^* t6 r% R& ?1 }% `' ]
  10. #ifdef __cplusplus
    8 ]8 M4 Y/ V+ d# P$ F
  11. }
    6 O+ Z) f- U6 }" K- B5 o: D. d* `
  12. #endif) s7 w! P& ?* R6 N0 y: O
  13. #endif /* DELAY_DELAY_H_ */
复制代码

; c! c0 N+ W% p3 O# a3 X

4 T  E4 ~. h+ e- {: c1 u; d        delay.c
7 \' R. S. Q2 y8 h5 Y
  1. #include "delay.h"
    + h/ ]% ?3 H3 t! |$ M' e, t

  2. 5 Y4 I4 W  L" F7 `# x% l
  3. void delay_us(uint32_t us) //利用CPU循环实现的非精准应用的微秒延时函数+ l: L' [+ @- {1 Q; X8 E: }
  4. {
    , u8 L' [5 T! h9 _: _$ k
  5.     uint32_t delay = (HAL_RCC_GetHCLKFreq() / 8000000 * us); //使用HAL_RCC_GetHCLKFreq()函数获取主频值,经算法得到1微秒的循环次数
    / {1 {4 [! x4 z- f% K3 z! k$ A5 W
  6.     while (delay--); //循环delay次,达到1微秒延时% T* [/ ?) d/ d- |  ]
  7. }
复制代码

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
  1. #ifdef __cplusplus
    & e, N  C# Q( m. g- v
  2. extern "C" {9 d' ^- `/ l( m2 ?' ]+ M
  3. #endif8 a9 E3 p2 M4 I  t! a
  4. , U5 |" [. `( l; g6 }
  5. //you code
    % Y& R- `  {% @6 T) r0 B

  6. $ U$ z1 s: v5 p+ y! \
  7. #ifdef __cplusplus2 w/ f% z0 O; S/ g& g% Y; I4 p
  8. }
复制代码
# @8 n. L" q# \, N3 G
        【2】调整文件GuiLite.h,首先,同样的在文件前面增加了delay.h头文件的引用,以及为了统一,将其宏定义#pragma once进行了替换,结果如下! S1 k/ h6 r; f/ [4 n! F" ^
  1. #ifndef GUILITE_H_
    ( b4 S4 M0 J/ H7 J4 f
  2. #define GUILITE_H_( o. S% ^' K8 ?4 \
  3. #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
  1. extern "C" void delay_ms(unsigned short nms);* b; u% s' Z. U# v# f/ J4 H8 c
  2. void thread_sleep(unsigned int milli_seconds)
    3 V: _! b. g5 R6 Z/ m1 Y5 y- F9 b( U( B
  3. {//MCU alway implemnet driver code in APP.
    ' S+ Z1 B+ B+ `! q: S5 U3 ?, C4 t# s0 X
  4.                 delay_ms(milli_seconds);
    % ~9 A2 _2 n1 e
  5. }
复制代码

' O+ \9 H" r7 u        调整为& g7 j- D4 u; J, ?( k( z
  1. //extern "C" void delay_ms(unsigned short nms);
    # }# \8 y1 R. r
  2. void thread_sleep(unsigned int milli_seconds)
    ! {2 v/ i, ^; |& |- Q. L
  3. {//MCU alway implemnet driver code in APP.
    , q8 [; y1 Y. z6 L
  4.         uint32_t tt = ((uint32_t)milli_seconds)*1000;0 Y% u- B8 ?5 `: A' i, L6 i9 \$ j
  5.         delay_us(tt);; C" \) |( g+ l2 E  P4 B. \1 O  v# a
  6. }
复制代码

- s+ I- C# O9 j! F! ^        【3】在main.c文件,引用各外设驱动头文件
. [! E. o% B2 ~+ I$ F. Q
  1. /* USER CODE BEGIN Includes */
    % m- |* P3 P' v" G& z
  2. #include "../../ICore/key/key.h"2 d- q5 j. D  x# ~
  3. #include "../../ICore/led/led.h"5 d6 y+ Y1 ]0 D* n6 m* q
  4. #include "../../ICore/print/print.h"/ x# Z0 t/ r) S, y
  5. #include "../../ICore/usart/usart.h"
    7 R  Z2 i( z8 m: t+ @
  6. #include "../../ICore/oled/oled.h"
    8 A0 }* o6 Z# p5 Z* ^
  7. /* 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
  1. /* USER CODE BEGIN 0 */
    1 m% ~1 O9 {  E
  2. //Transfer GuiLite 32 bits color to your LCD color
    " C$ ]6 v6 E( V% x( b. O' V  V
  3. #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
  4. //Encapsulate your LCD driver:
    . W+ A. ]/ i. H9 e- e
  5. void gfx_draw_pixel(int x, int y, unsigned int rgb)* t4 f# s4 N+ j. J- }+ \
  6. {8 O8 `% }# s+ i) c# ~/ ^; _2 d  {: B
  7.     //LCD_Fast_DrawPoint(x, y, GL_RGB_32_to_16(rgb));//注释参考样例的
    " C3 L( s7 A) E8 V! W' W
  8.         OLED_WritePixel(x, y, GL_RGB_32_to_16(rgb));//新增本工程支持绘制点函数调用(oled.h)
    6 C* W" |4 |+ Q6 _% y: Y$ k
  9. }6 Y3 _" T/ P! ^1 J! k/ T/ X
  10. //Implement it, if you have more fast solution than drawing pixels one by one.6 N" x# @3 z0 o
  11. //void gfx_fill_rect(int x0, int y0, int x1, int y1, unsigned int rgb){}
      c4 U1 g- w7 e9 K0 P8 H

  12. 1 c( t7 q- p( Z$ Q& v8 R  p' M
  13. //UI entry1 \: @3 A- E2 r
  14. struct DISPLAY_DRIVER
    1 }' {; i; g- X( v; Q$ }& f$ q0 t
  15. {
    $ O% G0 ^  q. [* V& ^; O
  16.         void (*draw_pixel)(int x, int y, unsigned int rgb);
    ) U- a3 l, X2 ~, j6 [( R6 h" z
  17.         void (*fill_rect)(int x0, int y0, int x1, int y1, unsigned int rgb);
    : L3 b& `; k2 o9 [- t( v
  18. } my_driver;+ I% S( s# d% n) P  f2 F
  19. 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
  20. /* 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
  1. delay_init();# w' ?+ [$ N" |+ [) q
  2.         NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
    1 u1 ~& O* C' Z1 K' P
  3.         LCD_Init();1 L' \0 T. s$ q3 s) r; V1 _; v& b

  4.   j5 b7 v+ f' f( q
  5.         //Link your LCD driver & start UI:; C3 D4 K: K1 E4 f3 K9 A
  6.         my_driver.draw_pixel = gfx_draw_pixel;( k. e$ L5 S3 z( U- ^* r
  7.         my_driver.fill_rect = NULL;//gfx_fill_rect;
    ( h! E2 I% i) N1 H6 ^% G
  8.         startHello3D(NULL, 240, 320, 2, &my_driver);- |5 r9 A6 h. e, ~! ^
  9.         while(1);
复制代码
0 Z" c! z/ v/ z. u
        在本博文移植中,在main函数内进行外设初始设置,例如lpuart1中断接收开启、lcd初始化,主要是LCD初始化。2 `# ?# p6 U8 Y+ d8 ~8 U  ?' f0 C
  1.   /* USER CODE BEGIN 2 */6 m7 b6 S& n6 c/ b$ W
  2.   ResetPrintInit(&hlpuart1);# W4 O9 _- W: r( p: S% m
  3.   HAL_UART_Receive_IT(&hlpuart1,(uint8_t *)&HLPUSART_NewData, 1); //再开启接收中断' P" [" Y# z# c3 @" B  h# S# U/ q! E
  4.   HLPUSART_RX_STA = 0;
    0 f7 A  R6 O9 s( \: k6 R
  5.   //
      L4 E- R- j3 o. V# J- ]7 K
  6.   OLED_init();
    3 j( j& ?, d5 A5 Q/ f& L
  7.   //设置OLED蓝色背景显示
    0 _0 R7 y. C. R; z/ Q: D
  8.   BSP_LCD_Clear_DMA(LCD_DISP_BLUE);1 @" Z& _7 N9 E. q0 |! c; g; O
  9.   printf("OLED_Clear_DMA\r\n");% n; z' n: K, C6 J. ]) ]
  10.   /* 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
  1.   /* USER CODE BEGIN WHILE */' E" K: ~3 F; J( j
  2.   while (1), X$ f. t  @0 }8 |) q
  3.   {
    , B8 N# T: ~) G. `
  4.           if(HLPUSART_RX_STA&0xC000){//溢出或换行,重新开始
    3 D4 r4 A& W( d: E) d
  5.                   //printf("%.*s\r\n",HLPUSART_RX_STA&0X0FFF, HLPUSART_RX_BUF);! e5 V7 x) S7 ^) [& P2 X$ R
  6.                   OLED_printf(10,10,"%.*s",HLPUSART_RX_STA&0X0FFF, HLPUSART_RX_BUF);
    " o8 R$ {- \' t
  7.                   HLPUSART_RX_STA=0;//接收错误,重新开始
    & j8 L& x6 y& A7 L, _8 r7 d; d9 L2 ]
  8.                   HAL_Delay(100);//等待, X# O! U0 W' z+ D5 g* J
  9.           }% G) H' f1 U' j
  10.           if(KEY_0())1 ?4 d) g0 C9 B) X' y* P! E( h
  11.           {4 n+ I8 x! H% O0 z
  12.                   BSP_LCD_login(24,108);8 n, E5 x" M4 B% d: Z0 X7 T( j
  13.           }
    . W, P% D6 r& U# M* P$ d! w0 E- \
  14.           if(KEY_1())% J3 ]9 A/ j7 ^8 i# Z4 k
  15.             {6 B0 h3 D, q8 E; R) n
  16.                   BSP_LCD_img_DMA();
    $ f9 T( z, {9 p- U
  17.             }: `( Q, @0 |& L
  18.           if(KEY_2())
    1 Y* S4 e( Z4 t" ]. J: Q
  19.             {; G4 a$ S+ A/ O- s3 I$ M
  20.                   my_driver.draw_pixel = gfx_draw_pixel;
    ' p+ w" z& _6 W0 R/ K; D
  21.                   my_driver.fill_rect = NULL;//gfx_fill_rect;
    : A' {5 ~: E: D+ n8 k
  22.                   startHello3D(NULL, 240, 240, 2, &my_driver);
    ' X- z, ]7 c6 w6 ^0 N: O* X
  23.             }
    4 }, L5 |7 R& m& _: @, l
  24.     /* 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
2f01fdf679234e349c31a2a72f836efa.png
: ^, 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
722f590bf3e54cb2bc457cca2ee1d67e.png : R) O: U% n5 _- d4 w  Z

& o# D; ?5 a$ \( [# m
366b7d4b58f54925bde9496b94657fa6.png # 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 _
赞 收藏 评论4 发布时间:2023-4-6 16:38

举报

4个回答
shenxiaolin_mai 回答时间:2023-8-10 10:14:10
不知道c++库可以用在keil上么?还是非常开心的。
shenxiaolin_mai 回答时间:2023-8-10 10:14:39
感谢分享,更详细一点就好了
lospring 回答时间:2023-8-10 10:15:03

内容很详细,谢谢分享

STMWoodData 回答时间:2023-8-10 10:21:30

这个GUI效果真不错,有空可以尝试移植一下看看。

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版