File Management

Overview

The file management page provides visual viewing of the device LittleFS file system. All configuration files (peripherals.json, periph_exec.json, etc.) are stored in LittleFS. Configuration import/export has been moved to the Advanced Configuration page in Device Configuration.

File Management Page

Before importing configuration, it's recommended to download the current file as backup first; if the page shows parsing failure after editing JSON, restore the backup first and locate the error field by field.

Field changes are recommended to follow the order of "export backup, offline edit, syntax check, upload reload, abnormal rollback" to avoid directly overwriting complete configuration packages from unknown sources.

Usage

Browse Files

1. Enter File Management page
2. File list shows current directory contents
3. Click folder to enter subdirectory

Upload Files

1. Click Upload button
2. Select local file
3. Confirm upload path

Edit Files

1. Click JSON/text file
2. Modify content in editor
3. Save changes

Import/Export Configuration

• Export: Download peripherals.json or periph_exec.json to local
• Import: Upload modified configuration file to overwrite existing configuration

Parameters

File System Structure

/
├── config/
│   ├── device.json         # Device configuration
│   ├── network.json        # Network configuration
│   ├── protocol.json       # Protocol configuration (MQTT, Modbus RTU, TCP, HTTP, CoAP)
│   ├── peripherals.json    # Peripheral configuration
│   ├── periph_exec.json    # Execution rules
│   ├── rule_scripts.json   # Rule scripts
│   └── users.json          # User authentication config
├── web/                    # Web interface files
│   ├── index.html
│   └── ...
└── log/                    # Log files

Storage Capacity

Chip	Flash	LittleFS Available
ESP32	4MB	~1.5MB
ESP32-S3	8MB/16MB	~4MB/12MB

Troubleshooting

Issue	Possible Cause	Solution
Upload failed	Insufficient space	Delete unnecessary files
File corrupted	Unexpected power loss	Re-upload or format file system
Configuration not effective	JSON format error	Verify JSON syntax and re-upload
Cannot delete	System file protection	Some system files cannot be deleted