Creating and Uploading a Custom Filesystem to ESP32-C3

[pablogventura]

Hello MicroPython Community!

I’m currently working with an ESP32-C3 module and am facing an issue while trying to prepare a binary file for the filesystem pre-loaded with specific files for production use.

I've successfully downloaded the default filesystem created by MicroPython and accessed it on a Linux system using the littlefs-tools Python package, with a block size of 4096 and block count of 512.

However, when I attempt to create a new filesystem partition on Linux to upload to the ESP32-C3, MicroPython reports a corrupted filesystem with the following message:

The filesystem appears to be corrupted. If you had important data there, you
may want to make a flash snapshot to try to recover it. Otherwise, perform
factory reprogramming of MicroPython firmware (completely erase flash, followed
by firmware programming).

The command I’m using to generate the littlefs image file is:

littlefs_create -b 4096 -c 512 -s fs_content/ -i fs.bin

And for uploading the created partition to the device, I use:

esptool.py -p /dev/ttyUSB0 -b 460800 write_flash 2097152 fs.bin

Could someone please guide me on the correct procedure to create and upload a filesystem that MicroPython will recognize without errors?

Thank you in advance for your assistance!

[bixb922]

PR #8381 seems to have that as a goal. But until that is ready, perhaps this will help:

https://github.com/bixb922/freezefs

It saves a file structure with subfolders and builds self-mountable archive in a .py file, optionally with compression, to be frozen as bytecode

You import the frozen py module and the files appear mounted as a read only file system

For read write files, there is an extract option too

[pablogventura]

Thank you for your response! But it is not what I need. My intention is to create a littlefs image that can be written directly to the ESP32 in production and then can be modified during execution, so frizzing the files is not a solution in my case either.

[Josverl]

I have the code for that ready, I'll put it somewhere public and share here

[pablogventura]

I would really appreciate that, thank you very much!

[Josverl]

Hi Pablo,
take a look here : https://github.com/Josverl/vfs_merge

to be transparant - I've not yet tested it with an Esp32 C3.
See vfs_merge/portboard_disk.md for the how and where to get the address details for the littlefs partition.

[pablogventura]

Thanks you a lot!