Arduino應用開發(fā)——使用GUI-Guider制作LVGL UI并導入ESP32運行

前言

GUI Guider是一個專門針對LVGL開發(fā)了一個上位機GUI設計工具，可以通過拖放控件的方式設計LVGL GUI頁面，加速GUI的設計。設計完成的UI頁面可以在PC上仿真運行，確認設計完畢之后可以生成C代碼，再整合到MCU項目中。

1 使用GUI-Guider設計UI

1.1 創(chuàng)建工程

打開GUI-Guider，選擇自己要使用的LVGL版本，V7或者V8，兩個版本差別較大，有些控件不兼容，這點需要注意。

注：我使用的GUI-Guider版本是1.6.1。其他版本應該是基本一樣的。

設備模板選擇空白，因為ESP32并不包含在這個軟件的模板里面。

應用模板可以根據自己的需要選擇空白模板或者測試demo。

項目配置根據自己的情況設置。

注：如果你屏幕的尺寸跟測試demo的尺寸不一致，里面的布局可能會被打亂，素材可能也會被拉伸。

空白模板如下：

測試demo如下：

1.2 設計UI

創(chuàng)建項目之后就可以開始設計自己的UI了。

空白模板如下：

測試demo如下：

UI設計好以后，點擊C編譯。編譯成功后會在PC上仿真運行。

仿真結果如下：

2 ESP工程導入UI

2.1 移植LVGL

關于這個，我之前發(fā)過博客，不懂的同學可以先看下。

Arduino應用開發(fā)——esp32 lvgl v8.3環(huán)境搭建

2.2 移植UI文件

打開上面GUI-Guider的工程目錄，custom和generated文件夾里面全部都是UI相關的文件，我們把這些文件移植到ESP32的工程里面即可。

在ESP32工程的src文件夾（也就是main.cpp所在目錄），新建一個文件夾用來存放UI文件，名字隨意（我這里命名為lvgl_ui）。

把上面說的custom和generated文件夾里面的文件全部放到ESP32工程這個新建的文件夾（lvgl_ui）里面。

拷貝完成后，用VScode打開ESP32的工程，編譯。

注意幾個容易出錯的點：

1、根據設計UI的不同，有些文件需要進行修改才能編譯通過，比如一些圖像素材文件，需要將#include "lvgl/lvgl.h"改成#include "lvgl.h"?？梢韵染幾g一下，看看有沒有報錯。

2、制作UI時用到的控件，需要在ESP32工程的lv_conf.h里面打開相應的宏。

3、有些控件在GUI-Guider上面有，但是ESP32工程上移植的LVGL可能沒有，如果出現(xiàn)這種情況，可以把GUI-Guider工程上面對應控件的幾個文件也移植到ESP32工程對應的位置即可。

如果報錯如下：

將#include "lvgl/lvgl.h"改成#include "lvgl.h"，然后重新編譯即可。

2.3 調用UI文件

1）添加頭文件

在main.cpp里面把前面加的UI文件包含進去。

// 前面的lvgl_ui是文件夾名稱，根據自己的文件夾修改
#include "lvgl_uievents_init.h"
#include "lvgl_uigui_guider.h"
#include "lvgl_uicustom.h"

2）創(chuàng)建一個UI

lv_ui guider_ui;

3）初始化UI

setup_ui(&guider_ui);
events_init(&guider_ui);
custom_init(&guider_ui);

完整的示例代碼如下：

#include <Arduino.h>
#include <SPI.h>
#include <TFT_eSPI.h>
#include "lvgl.h"
#include "lvgl_uievents_init.h"
#include "lvgl_uigui_guider.h"
#include "lvgl_uicustom.h"

lv_ui guider_ui;

TFT_eSPI tft = TFT_eSPI(); 

static lv_disp_draw_buf_t draw_buf;


/* Display flushing */
void my_disp_flush(lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p)
{
  uint32_t w = ( area->x2 - area->x1 + 1 );
  uint32_t h = ( area->y2 - area->y1 + 1 );

  tft.startWrite();
  tft.setAddrWindow( area->x1, area->y1, w, h );
  tft.pushColors( ( uint16_t * )&color_p->full, w * h, true );
  tft.endWrite();

  lv_disp_flush_ready( disp_drv );
}

/*Read the touchpad*/
void my_touchpad_read( lv_indev_drv_t * indev_drv, lv_indev_data_t * data )
{
}

void lvgl_user_init(void)
{
  lv_init();
  
  /*Set the touchscreen calibration data,
    the actual data for your display can be acquired using
    the Generic -> Touch_calibrate example from the TFT_eSPI library*/
  // uint16_t calData[5] = { 275, 3620, 264, 3532, 1 };
  // tft.setTouch( calData );
  
  lv_color_t* buf1 = (lv_color_t*) heap_caps_malloc(240 * 240, MALLOC_CAP_SPIRAM);
  // lv_color_t* buf2 = (lv_color_t*) heap_caps_malloc(240 * 240, MALLOC_CAP_SPIRAM);
  lv_disp_draw_buf_init( &draw_buf, buf1, NULL, 240 * 240);

  /*Initialize the display*/
  static lv_disp_drv_t disp_drv;
  lv_disp_drv_init( &disp_drv );
  /*Change the following line to your display resolution*/
  disp_drv.hor_res = 240;
  disp_drv.ver_res = 240;
  disp_drv.flush_cb = my_disp_flush;
  disp_drv.full_refresh = 1;
  disp_drv.draw_buf = &draw_buf;
  lv_disp_drv_register(&disp_drv);

  /*Initialize the (dummy) input device driver*/
  static lv_indev_drv_t indev_drv;
  lv_indev_drv_init(&indev_drv);
  indev_drv.type = LV_INDEV_TYPE_POINTER;
  indev_drv.read_cb = my_touchpad_read;
  lv_indev_drv_register(&indev_drv);

  setup_ui(&guider_ui);
  events_init(&guider_ui);
  custom_init(&guider_ui);
}

void setup() 
{
  Serial.begin(115200);
  tft.begin();
  tft.setRotation(0);
  tft.fillScreen(TFT_BLACK);

  lvgl_user_init();
}

void loop()
{
  lv_timer_handler(); /* let the GUI do its work */
  delay(5);
}

2.4 燒錄測試

運行結果如下，手機拍照有失真，將就著看吧。

結束語

關于使用GUI-Guider工程導入esp32運行就講到這里，我這里只是簡單介紹了一下整個移植的流程，具體的一些細節(jié)和問題，還需要根據實際情況處理，有什么問題的歡迎評論區(qū)留言。

想了解更多Arduino的內容，可以關注一下博主，后續(xù)我還會繼續(xù)分享更多的經驗給大家。
Arduino的開發(fā)教程匯總:
https://blog.csdn.net/ShenZhen_zixian/article/details/121659482

如果這篇文章能夠幫到你，就…你懂得。