AWTK 开源串口屏开发 - 系统设置

系统设置只是一个普通应用程序，不过它会用 默认模型 中一些内置的属性和命令，所以这里专门来介绍一下。

1. 功能

在这个例子会用到 默认模型 中一些下列内置的属性和命令：

• 内置属性

属性	类型	说明
rtc_year	int	RTC 年
rtc_month	int	RTC 月
rtc_day	int	RTC 日
rtc_hour	int	RTC 时
rtc_minute	int	RTC 分
rtc_second	int	RTC 秒
rtc_ymd	string	RTC 年月日，格式为 YYYY-MM-DD 或 YYYY/MM/DD
rtc_hms	string	RTC 时分秒，格式为 HH:MM:SS
backlight	int	背光亮度 (0-100)
audio_volume	int	音量 (0-100)
ui_feedback	bool	UI 反馈。true 启用反馈 (beep), false 禁用反馈

• 内置命令

命令	参数	说明
set_rtc	无	将属性 rtc_year, rtc_month, rtc_day, rtc_hour, rtc_minute, rtc_second 设置为系统 RTC 时间
get_rtc	无	获取系统 RTC 时间，并设置到属性 rtc_year, rtc_month, rtc_day, rtc_hour, rtc_minute, rtc_second, rtc_wday
save	无	保存配置

2. 创建项目

从模板创建项目，将 hmi/template_app 拷贝 hmi/settings 即可。

最好不要放到其它目录，因为放到其它目录需要修改配置文件中的路径，等熟悉之后再考虑放到其它目录。路径中也不要中文和空格，避免不必要的麻烦。

3. 制作界面

用 AWStudio 打开上面 settings 目录下的 project.json 文件。

里面有一个空的窗口，在上面加入下面的控件，并调节位置和大小，做出类似下面的界面。

再创建一个新窗口，命名为 basic，并加入下面的控件，并调节位置和大小，做出类似下面的界面。

再创建一个新窗口，命名为 rtc，并加入下面的控件，并调节位置和大小，做出类似下面的界面。

需要给编辑器设置输入类型、最大值和最小值。实际项目可能会用文本选择控件代替编辑器，不过绑定方法是一样的。

3. 添加绑定规则

3.1 主界面 (home_page)

• 将 基本设置 按钮的 点击 事件绑定到 navigate 命令。添加自定义的属性 v-on:click，将值设置为 {navigate, Args=basic}。

绑定属性	绑定规则	说明
v-on:click	{navigate, Args=basic}	navigate 命令是导航命令，用于打开窗口，Args=后面跟目标窗口的名称。

• 将 时间设置 按钮的 点击 事件绑定到 navigate 命令。添加自定义的属性 v-on:click，将值设置为 {navigate, Args=rtc}。

绑定属性	绑定规则	说明
v-on:click	{navigate, Args=rtc}	navigate 命令是导航命令，用于打开窗口，Args=后面跟目标窗口的名称。

命令和参数要用英文大括号括起来。

3.2 基本设置 (basic)

• 将 背光 滑动条 绑定到 backlight 变量。添加自定义的属性 v-data:value，将值设置为 {backlight}。

绑定属性	绑定规则	说明
v-data:value	{backlight}	变量要用英文大括号括起来。

• 将 音量 滑动条 绑定到 audio_volume 变量。添加自定义的属性 v-data:value，将值设置为 {audio_volume}。

绑定属性	绑定规则	说明
v-data:value	{audio_volume}	变量要用英文大括号括起来。

• 将 开启屏幕音 绑定到 ui_feedback 变量。添加自定义的属性 v-data:value，将值设置为 {ui_feedback}。

绑定属性	绑定规则	说明
v-data:value	{ui_feedback}	变量要用英文大括号括起来。

• 让 确定 按钮的 点击 事件执行命令 “{save}”。添加自定义的属性 v-on:click，将值设置为：

{save, CloseWindow=true}

CloseWindow=true，表示执行命令并关闭当前窗口。

命令和参数要用英文大括号括起来。

• 同样指定窗口的模型为 default。

绑定属性	绑定规则	说明
v-model	default	default 不需要用大括号括起来。

3.3 时间设置 (rtc)

• 将 年 编辑器 绑定到 rtc_year 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_year}。

绑定属性	绑定规则	说明
v-data:value	{rtc_year}	变量要用英文大括号括起来。

• 将 月 编辑器 绑定到 rtc_month 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_month}。

绑定属性	绑定规则	说明
v-data:value	{rtc_month}	变量要用英文大括号括起来。

• 将 日 编辑器 绑定到 rtc_day 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_day}。

绑定属性	绑定规则	说明
v-data:value	{rtc_day}	变量要用英文大括号括起来。

• 将 时 编辑器 绑定到 rtc_hour 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_hour}。

绑定属性	绑定规则	说明
v-data:value	{rtc_hour}	变量要用英文大括号括起来。

• 将 时 编辑器 绑定到 rtc_minute 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_minute}。

绑定属性	绑定规则	说明
v-data:value	{rtc_minute}	变量要用英文大括号括起来。

• 将 秒 编辑器 绑定到 rtc_second 变量。添加自定义的属性 v-data:value，将值设置为 {rtc_second}。

绑定属性	绑定规则	说明
v-data:value	{rtc_second}	变量要用英文大括号括起来。

• 让 获取时间 按钮的 点击 事件执行命令 “{get_rtc}”。添加自定义的属性 v-on:click，将值设置为：

{get_rtc}

命令和参数要用英文大括号括起来。

• 让 设置时间 按钮的 点击 事件执行命令 “{set_rtc}”。添加自定义的属性 v-on:click，将值设置为：

{set_rtc}

命令和参数要用英文大括号括起来。

• 让 返回 按钮的 点击 事件执行命令 “{nothing}”。添加自定义的属性 v-on:click，将值设置为：

{nothing, CloseWindow=true}

nothing 是一个特殊命令，表示什么也不做。

CloseWindow=true，表示执行命令并关闭当前窗口。

命令和参数要用英文大括号括起来。

• 同样指定窗口的模型为 default。

绑定属性	绑定规则	说明
v-model	default	default 不需要用大括号括起来。

4. 初始化数据

修改资源文件 design/default/data/default_model.json, 将其内容改为：

{
  "ui_feedback":true,
  "audio_volume":60,
  "backlight":60
}

注意：

• 如果文件内容有中文（非 ASCII 字符），一定要保存为 UTF-8 格式。

• 重新打包资源才能生效。

5. 描述需要持久化的数据

修改资源文件 design/default/data/settings.json, 将其内容改为：

{
    "name": "hmi_settings",
    "persistent": {
        "ui_feedback": true,
        "audio_volume": true,
        "backlight": true
    }
}

如果有多个数据需要持久化，将它们加入到 settings 对象中即可。为了避免不同串口屏应用程序之间，持久化数据覆盖，这里的 name 需要取一个唯一的名字。

注意：

• 如果文件内容有中文（非 ASCII 字符），一定要保存为 UTF-8 格式。

• 重新打包资源才能生效。

5. 编译运行

运行 bin 目录下的 demo 程序。

程序退出时会自动保存需要保存的数据。

7. 注意

本项目并没有编写界面相关的代码，AWStudio 在 src/pages 目录下生成了一些代码框架，这些代码并没有用到，可以删除也可以不用管它，但是不能加入编译。