File Management

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Web console page purpose and related device-side configuration model.
• Available fields, operational workflow, and safety checks.
• Validation steps, logs, and maintenance recommendations.

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

文件管理

功能说明

文件管理页面提供对设备 LittleFS 文件系统的可视化操作，包括查看、上传、下载、编辑和删除文件。所有配置文件（peripherals.json, periph_exec.json 等）都存储在 LittleFS 中。

文件管理页面

导入配置前建议先下载当前文件备份；编辑 JSON 后若页面提示解析失败，应先恢复备份再逐段定位错误字段。

配置文件生命周期流程图

现场变更建议按“导出备份、离线编辑、语法校验、上传重载、异常回滚”的顺序执行，避免直接覆盖未知来源的完整配置包。

操作指南

浏览文件

1. 进入 文件管理 页面
2. 文件列表显示当前目录内容
3. 点击文件夹进入子目录

上传文件

1. 点击 上传 按钮
2. 选择本地文件
3. 确认上传路径

编辑文件

1. 点击 JSON/文本文件
2. 在编辑器中修改内容
3. 保存更改

导入/导出配置

• 导出：下载 peripherals.json 或 periph_exec.json 到本地
• 导入：上传修改后的配置文件覆盖现有配置

参数说明

文件系统结构

/
├── config/
│   ├── peripherals.json    # 外设配置
│   ├── periph_exec.json    # 执行规则
│   ├── network.json        # 网络配置
│   ├── mqtt.json           # MQTT配置
│   └── device.json         # 设备配置
├── web/                    # Web 界面文件
│   ├── index.html
│   └── ...
└── log/                    # 日志文件

存储容量

芯片	Flash	LittleFS 可用
ESP32	4MB	~1.5MB
ESP32-S3	8MB/16MB	~4MB/12MB

故障排除

问题	可能原因	解决方案
上传失败	空间不足	删除不需要的文件
文件损坏	意外断电	重新上传或格式化文件系统
配置不生效	JSON 格式错误	验证 JSON 语法后重新上传
无法删除	系统文件保护	部分系统文件不允许删除