
屬性 | 類型 | 說明 |
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 | 無 | 保存配置 |
從模板創建項目,將 hmi/template_app 拷貝 hmi/settings 即可。
最好不要放到其它目錄,因為放到其它目錄需要修改配置文件中的路徑,等熟悉之后再考慮放到其它目錄。路徑中也不要中文和空格,避免不必要的麻煩。
里面有一個空的窗口,在上面加入下面的控件,并調節位置和大小,做出類似下面的界面。



需要給編輯器設置輸入類型、最大值和最小值。實際項目可能會用文本選擇控件代替編輯器,不過綁定方法是一樣的。
3.1?主界面?(home_page)
將?基本設置?按鈕的?點擊?事件綁定到?navigate?命令。添加自定義的屬性?v-on:click,將值設置為?{navigate, Args=basic}。
綁定屬性 | 綁定規則 | 說明 |
v-on:click | {navigate, Args=basic} | navigate 命令是導航命令,用于打開窗口,Args=后面跟目標窗口的名稱。 |
綁定屬性 | 綁定規則 | 說明 |
v-on:click | {navigate, Args=rtc} | navigate 命令是導航命令,用于打開窗口,Args=后面跟目標窗口的名稱。 |
命令和參數要用英文大括號括起來。
將?背光滑動條?綁定到?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 不需要用大括號括起來。 |
將?年 編輯器?綁定到?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 不需要用大括號括起來。 |
{?"ui_feedback":true,?"audio_volume":60,?"backlight":60}
{? ?"name": "hmi_settings",? ?"persistent": {? ? ? ?"ui_feedback": true,? ? ? ?"audio_volume": true,? ? ? ?"backlight": true? ?}}
如果有多個數據需要持久化,將它們加入到 settings 對象中即可。為了避免不同串口屏應用程序之間,持久化數據覆蓋,這里的 name 需要取一個唯一的名字。

程序退出時會自動保存需要保存的數據。
??產品推薦
??技術交流群
更多往期文章,請點擊“?閱讀原文?”。






