SD 卡下载是量产和现场升级最常用的方式:不用电脑连着屏,把资源包拷进 SD 卡,插卡上电自动烧录。这篇把全流程和「增量升级」讲清楚。
1. 编辑 / 编译
在工程里改好画面和逻辑,点【工程】→【编译】。编译结果正常会显示成功提示;有错误的话编辑区会列出错误信息,先修完再继续。

2. 生成资源包(量产向导)
编译通过后,菜单【工程】→【量产向导】,弹出对话框点【SD卡下载】,生成下载资源包。

生成的结果里:
- private:真正的下载资源包,需要拷到 SD 卡
- 两个 TXT 文件(《!!!Copy [private] directory to the root directory of SD Card.txt》《!!!直接复制private文件夹到SD卡根目录.txt》):纯提示用,没有实际意义,不影响升级
- ota.bin:OTA 打包文件,需要配合脚本做 OTA 升级时才用(见 LUA 教程「OTA 升级」)


把 private 文件夹整个拷到 SD 卡根目录,不能嵌套子文件夹。拷成 SD/private 而不是 SD/xxx/private,否则屏找不到包。
3. 下载(插卡上电)
屏幕断电 → 插入含资源包的 SD 卡 → 上电,屏幕自动进入升级界面,显示下载进度。显示「updata finished!」表示下载完成,屏会自动加载工程进入 UI 画面,此时可以拔掉 SD 卡。


不同工程下载显示的信息不一样:比如工程里有 1.mp3 音频,下载过程会显示 “write 3:/sound/1.mp3 (100%) …”,这是正常的,别以为卡住了。
4. 增量升级(只更新改动的部分)
上面生成的是全量下载(整个工程重新烧)。调试阶段每次都全量太慢,VisualHMI 支持增量升级——只下载修改的部分。
点【量产向导】,按你改了什么勾选:
- 改了工程配置(如挪动控件位置、改工程属性)→ 勾选工程配置
- 改了 LUA 脚本 → 勾选脚本文件
点【SD卡生成包】,这次会多出一个 noformat.txt 文件——它的作用是告诉屏「不要格式化,只替换 private 里打包的文件」。这个文件要一并复制到 SD 卡根目录,下载流程和全量一致。


增量升级三连问:勾对了选项吗?(改配置勾工程配置,改脚本勾脚本文件);noformat.txt 拷了吗?(漏拷会变成全量格式化,虽不影响功能但慢);SD 卡根目录吗?(嵌套路径不识别)。
整理自 广州大彩科技 VisualHMI 开发文档(hmi-doc.gz-dc.com)快速入门「SD卡下载工程」,版权归大彩科技所有。
发表回复