5.7 SD卡文件读写

本节以“保存配方、从SD卡恢复配方”为例，介绍Lua文件读写。示例将温度、转速、批量三个参数保存为CSV文件，重新上电后可从卡中恢复。

核心功能

• 将指定LW参数保存为SD卡中的CSV文件。
• 保存后重新读取校验；恢复时先完整校验，再写入参数。
• 配合原生数值输入、图片按钮和状态文字，实现配方保存与恢复。

本功能适用于具有SD卡接口、固件支持SD文件系统和Lua文件I/O的屏幕。使用前应确认SD卡已被固件识别并挂载到/sdcard。

相关文档： 5.1 系统回调 · 5.2 寄存器读写

1. 文件配置

1.1 路径与格式

示例路径为/sdcard/recipe.csv，对应SD卡根目录下的recipe.csv。文件包含三个以英文逗号分隔的非负十进制整数，末尾为回车换行\r\n。

253,1200,50

上例表示温度25.3℃、转速1200rpm、批量50件。CSV保存的是寄存器原始整数，温度采用“实际值×10”，所以第一项是253，不是25.3。

1.2 地址

下表地址均为十六进制，数据类型均为UINT16。Lua地址类型为VT_LW=1。

2. 读写说明

2.1 文件操作

保存时，Demo读取三个LW参数并生成CSV文本；写入并关闭文件后，再次打开文件核对读回内容。只有读回字节与写入内容一致时，界面才显示“保存成功，回读一致”。关键代码如下，完整错误处理及回调接入见Demo中的scripts/main.lua。

local VT_LW = 1
local text = string.format("%d,%d,%d\r\n",
    get_uint16(VT_LW, 0x1000),
    get_uint16(VT_LW, 0x1001),
    get_uint16(VT_LW, 0x1002))

local f, open_err = io.open("/sdcard/recipe.csv", "wb")
assert(f, open_err)
local ok, write_err = f:write(text)
local closed, close_err = f:close()
assert(ok and closed, write_err or close_err)

恢复时，Demo限制文件不超过64字节，用下面的匹配式读取三个整数，再检查每项是否在0～65535范围内。空文件、字段缺失、小数、负数、多余字段和超范围数值均拒绝恢复。三项全部通过校验后才写入LW参数，文件校验失败不会造成部分参数恢复。

local a, b, c = text:match("^(%d+),(%d+),(%d+)%s*$")

2.2 命令处理

四个普通字设置按钮向LW1010写入命令，由全局周期回调on_run处理。命令被接收后先清零，再执行一次操作；pcall捕获文件错误，并将结果写入LW1011。

不能仅在main.lua顶层写return function(command) ... end就期待自动执行。操作函数需要接到实际回调或控件动作。合并到已有工程时应保留原业务回调，不要重复添加同名功能块；可参考Demo中对原on_init和on_run的保留方式。

3. 应用

3.1 SD配方读写Demo

Demo型号为E028R2432，由ApusTAI 1.0.49生成。界面提供三个数值输入，以及“保存到SD”“从SD恢复”“示例参数”“清零参数”四个图片按钮。按钮通过浅色凸起、深色下沉区分操作状态，图片内仅显示功能名称和图标；命令在松手时执行。

1. 将SD卡插入屏幕，确认已被固件识别。打开Demo工程，编译并下载到对应型号的屏幕。
2. 点击“示例参数”，确认显示25.3℃、1200rpm、50件。也可点击数值自行输入。
3. 点击“保存到SD”，等待“保存成功，回读一致”。卡根目录应生成recipe.csv，内容为253,1200,50。
4. 点击“清零参数”，确认三项均为0；再点击“从SD恢复”，应恢复为25.3℃、1200rpm、50件。
5. 重新上电后，Demo的RAM参数初始化为0。再次点击“从SD恢复”，验证卡内数据是否保留。启动时不会自动覆盖配方文件。

4. 常见问题

4.1 为什么提示打开失败？

检查屏幕是否支持SD卡、卡是否已挂载到/sdcard、路径和文件名是否正确，以及是否具备写入权限。首次使用尚未保存文件时，直接恢复也会因文件不存在而失败。

4.2 为什么25.3℃在文件中是253？

温度寄存器按实际值的10倍保存，数值控件设置1位小数进行显示和输入。转速、批量按整数保存，不做此缩放。

4.3 电脑模拟能否代表实体SD卡？

Windows模拟器不会自动将/sdcard映射为实体SD卡。电脑端出现“打开失败”时，应先检查模拟文件路径，不能据此判定屏端SD卡故障。Demo已完成编译、文件逻辑和原生控件交互验证；实体SD卡的挂载、读写及断电后恢复仍需在实际屏幕上确认。

4.4 保存时是否覆盖旧配方？

会。wb会覆盖同名旧文件，示例采用单文件覆盖方式。写入过程中断电可能留下不完整文件，重要配方应另行备份。不要连续高速发送保存命令或在写入时拔卡。