Skip to content

SquareLine Studio

SquareLine Studio 是一款 LVGL (Light and Versatile Embedded Graphics Library) 官方推出的图形化配置工具,用户可在 SquareLine Studio 中绘制好需要的UI界面后将驱动库和UI文件导出,配合单片机环境继续开发。

软件安装

进入官网下载即可。注意,最新版的仅支持30天的免费试用,最好是下载低于最新版一个版本的,可以一直免费使用。

安装好后使用邮箱注册账号并且登录,即可开始使用。

新建工程

点击弹出来的小窗顶栏中间的 Create ,开始新建工程。

SquareLine Studio 提供了一些可选择的驱动库,比较常用的是 Arduino with TFT_eSPI ,适用于arduino开发和esp-arduino开发。以下均以使用 TFT_eSPI 驱动的 esp-arduino 开发为例子演示操作过程。

右下角可以设置项目的一些初始化参数,比较重要的是 ResolutionColor depth 两项。

Color depth 需要根据自己选择的屏幕参数来定,比如最经典的SPI电阻屏,像素色彩为RGB565格式,色深度是16,这里就填16。

新建成功后的界面大致如下:

左边有可以选择放置的控件,右边可以配置控件以及屏幕的相关参数。

UI示例

读者可以自己研究一下样式,根据自己的使用需求做出好看的UI。以下举几个例子做演示。

按钮边界模糊化

参数设定与出来的效果:

按钮回调函数

我们可以在 SquareLine Studio 中对控件添加回调函数,便于后续结合单片机进一步开发。

如下图,我将按钮的回调函数名称设为I_AM_A_BUTTON,触发方式为 RELEASED

导出后的回调函数会在 ui_events.c 文件中,会在后面进一步阐述。

屏幕跳转

SquareLine Studio 做屏幕跳转逻辑非常方便。

与按钮回调函数一样,选择一个按钮,添加屏幕跳转事件。比较重要的是既要添加 CHANGE SCREEN 跳转到目标屏幕,也要添加 DELETE SCREEN 删除当前所在屏幕。

工程仿真

SquareLine Studio 自带了仿真器,在界面设计的右上角,有一个播放型的按键。开始仿真后可以验证设计的屏幕逻辑与控件效果。

工程导出

设计好的项目可以通过两种方式导出:仅导出UI文件和导出整个工程模板。我一般使用导出整个工程文件,结构完整,在其中取出需要的文件使用相对清晰。

Arduino with TFT_eSPI 的驱动库下,导出的工程模板主文件为ino文件。整个导出文件夹的结构如下

其中, TFT_eSPI 包括的是底层的SPI驱动代码,可以在其中定义驱动引脚,屏幕驱动芯片型号等。 lvgl 包括了所有与lvgl的底层文件文件, UI 包括了所有UI相关的文件,包括控件的定义,回调函数的定义等。

工程使用

使用时只需要把 libraries 目录下的文件全拷贝到自己的库里,应用示例可参考 ui.ino 。后续若对UI有改动,重新导出了一次工程,只需要替换 ui 文件夹中的内容即可。

TFT_eSPI 相关内容在外设库的TFTLCD下做了解释,可结合起来阅读,这里就不赘述了。

UI 文件夹下的内容最重要,也是后续与单片机开发最紧密相关的。

回调函数定义在 ui_events.c 文件下,在库中引用代码会显示找不到路径,不能在这里添加功能代码。

最简单的解决办法是在 ui_events.c 下定义一个变量表示按钮值,然后在自己的代码头文件中声明这个变量作为外部变量。在回调函数中改变这个按钮值,自己的函数中若检测到这个按钮值发生改变,即可判定为按钮按下,进而执行功能代码。

优秀教学视频链接

Create and Export Stunning UI with SquareLine Studio for ESP32 Display | LVGL Tutorial