mirror of
https://github.com/IoTManagerProject/IoTManager.git
synced 2026-03-27 22:52:19 +03:00
95 lines
4.6 KiB
Markdown
95 lines
4.6 KiB
Markdown
# LittleFS_esp32
|
|
|
|
## LittleFS library for arduino-esp32
|
|
|
|
- A LittleFS wrapper for Arduino ESP32 of [ARMmbed LittleFS](https://github.com/ARMmbed/littlefs)
|
|
- Based on [ESP-IDF port of joltwallet/esp_littlefs](https://github.com/joltwallet/esp_littlefs) , thank you Brian!
|
|
- As a reference, see [LillteFS library for ESP8266 core](https://github.com/esp8266/Arduino/tree/master/libraries/LittleFS)
|
|
- [PR at esp32 core development](https://github.com/espressif/arduino-esp32/pull/4096)
|
|
- [PR at esp-idf development](https://github.com/espressif/esp-idf/pull/5469)
|
|
- The functionality is similar to SPIFFS
|
|
|
|
### Installation
|
|
|
|
- Use **Arduino Library Manager**
|
|
- Or download / use **git** to have latest repository of **LITTLEFS** added to Arduino IDE **/libraries** folder
|
|
(File > Preferences > Sketchbook location).
|
|
- See ``` #define CONFIG_LITTLEFS_FOR_IDF_3_2 ``` in **esp_littlefs.c**.
|
|
When defined, code builds with any IDF 3.2 - 4.x.
|
|
On IDF newer than 3.2, it **can** be commented to enable file timestamp feature.
|
|
See LITTLEFS_time example.
|
|
- The other ``` #define CONFIG_LITTLEFS_xxxxx ``` are set to optimal default values.
|
|
Read [here](https://github.com/joltwallet/esp_littlefs/blob/master/Kconfig) and [here](https://github.com/ARMmbed/littlefs/blob/master/README.md) if you want to modify.
|
|
|
|
### Usage
|
|
|
|
- Use LITTLEFS same way as SPIFFS
|
|
- A quick startup based on your existing code you can re-define SPIFFS
|
|
```
|
|
#define USE_LittleFS
|
|
|
|
#include <FS.h>
|
|
#ifdef USE_LittleFS
|
|
#define SPIFFS LITTLEFS
|
|
#include <LITTLEFS.h>
|
|
#else
|
|
#include <SPIFFS.h>
|
|
#endif
|
|
```
|
|
- Note, this may not work if your sketch uses other libraries that use SPIFFS themselves.
|
|
|
|
### Differences with SPIFFS
|
|
|
|
- LittleFS has folders, you need to iterate files in folders. See **To Do** below.
|
|
- At root a "/folder" = "folder"
|
|
- Requires a label for mount point, NULL will not work
|
|
- maxOpenFiles parameter is unused, kept for compatibility
|
|
- LITTLEFS.mkdir(path) and LITTLEFS.rmdir(path) work as expected for folders
|
|
- Speed comparison based on **LittleFS_test.ino** sketch (for a file 1048576 bytes):
|
|
|
|
|Filesystem|Read time [ms]|Write time [ms]|
|
|
|----|----|----|
|
|
|FAT|276|14493|
|
|
|LITTLEFS|446*|16387|
|
|
|SPIFFS|767|65622|
|
|
|
|
*The read speed improved by changing ```#define CONFIG_LITTLEFS_CACHE_SIZE``` from 128 to 512
|
|
|
|
|
|
### Arduino ESP32 LittleFS filesystem upload tool
|
|
|
|
- Use (replace if exists) [arduino-esp32fs-plugin](https://github.com/me-no-dev/arduino-esp32fs-plugin/pull/23 ) with [this variant](https://github.com/lorol/arduino-esp32fs-plugin), which supports SPIFFS, LittleFS and FatFS
|
|
- Requires [mklittlefs executable](https://github.com/earlephilhower/mklittlefs) which is available [in releases section here](https://github.com/lorol/arduino-esp32fs-plugin ) or download the zipped binary [here](https://github.com/earlephilhower/mklittlefs/releases) or from **esp-quick-toolchain** releases [here](https://github.com/earlephilhower/esp-quick-toolchain/releases)
|
|
- Copy it to **/tools** folder of esp32 platform where **espota** and **esptool** (.py or.exe) tools are located
|
|
- Restart Arduino IDE.
|
|
|
|
### PlatformIO
|
|
|
|
- See [LITTLEFS_PlatformIO example here](https://github.com/lorol/LITTLEFS/tree/master/examples/LITTLEFS_PlatformIO)
|
|
( based on notes below from [BlueAndi](https://github.com/BlueAndi) )
|
|
- Add to _platformio.ini_:
|
|
`extra_scripts = replace_fs.py`
|
|
|
|
- Add _replace_fs.py_ to project root directory (where platformio.ini is located):
|
|
|
|
```python
|
|
Import("env")
|
|
print("Replace MKSPIFFSTOOL with mklittlefs.exe")
|
|
env.Replace (MKSPIFFSTOOL = "mklittlefs.exe")
|
|
```
|
|
|
|
- Add _mklittlefs.exe_ to project root directory as well.
|
|
|
|
## Credits and license
|
|
|
|
- This work is based on [ARMmbed LittleFS](https://github.com/ARMmbed/littlefs) , [ESP-IDF port of joltwallet/esp_littlefs](https://github.com/joltwallet/esp_littlefs) , [Espressif Arduino core for the ESP32, the ESP-IDF - SPIFFS Library](https://github.com/espressif/arduino-esp32/tree/master/libraries/SPIFFS)
|
|
- Licensed under GPL v2 ([text](LICENSE))
|
|
|
|
## To Do
|
|
- [x] Submit to be added to Arduino Library Manager
|
|
- [ ] Decide on more compatibility (or not) with SPIFFS' lack of folders, similar to esp8266' way:
|
|
- [recursive folders auto creation](https://github.com/esp8266/Arduino/blob/master/libraries/LittleFS/src/LittleFS.cpp#L60) when a new file is created at non-existing path
|
|
- [recursive folders auto deletion](https://github.com/esp8266/Arduino/blob/master/libraries/LittleFS/src/LittleFS.h#L149) on "last file" deletion (SPIFFS cannot have "folder w/o file")
|
|
- review other differences: opendir(), rmdir(), unlink()
|
|
- [ ] Follow-up / eventually retire this library if LittleFS gets implemented through IDF / esp32 Arduino core.
|