==About==
-The main goal of the lwext4 project is to provide ext2/3/4 filesystem
-library for microcontrolers with SD/MMC card support.
+The main goal of the lwext4 project is to provide ext2/3/4 filesystem for microcontrollers. It may be an interesting alternative for traditional MCU filesystem libraries (mostly based on FAT32).
+Lwext4 may be used with SD/MMC card, USB flash drive or other block based memory device. However it is not good for flash memory–based storage devices.
+
+Code is also available on github:
+https://github.com/gkostka/lwext4
+
+Feel free to contact me:
kostka.grzegorz@gmail.com
==Minimum memory requirements==
-* .text: 20KB - 30KB (dependent of feature set chosen)
-* .data: 8KB
+* .text: 20KB - 40KB (dependent of feature set chosen)
+* .data: 8KB (minimum 8 x 1KB block cache)
* .stack: 2KB
* dir_prealloc: no
* imagic_inodes: no
* has_journal: no
-* ext_attr: no
+* ext_attr: no (work in progress)
* resize_inode: no
* dir_index: yes
;Features read-only (mount in RO mode when NOT supported):
* extra_isize: yes
* quota: no
* bigalloc: no
-* metadata_csum: no
+* metadata_csum: no (to be done ...)
==Supported filetypes:==
* FIFO: no
* CHARDEV: no
* DIRECTORY: yes
* BLOCKDEV: no
-* FILE: yes
-* SOFTLINK: no
+* FILE: yes (hardlinks supported)
+* SOFTLINK: yes
* SOCKET: no
==Other==
Linux block devices:
cd build_generic
- generic --in /dev/your_block_device
-
-Usage:
- --i - input file (default = ext2)
- --rws - single R/W size (default = 1024 * 1024)
- --rwc - R/W count (default = 10)
- --cache - 0 static, 1 dynamic (default = 1)
- --dirs - directory test count (default = 0)
- --clean - clean up after test
- --bstat - block device stats
- --sbstat - superblock stats
- --wpart - windows partition mode
+ generic -i /dev/your_block_device
==Build and run automatic tests==
Build and run automatic tests
make server_ext3
make server_ext4
Run tests:
- make all_tests
+ make test
==Cross-Compile standalone library==
Build bf518 library:
cd build_cortex-m4
make lwext4
-==Demos==
-* STM32F429-DISCO USB flash drive Demo
-* ChibiOS demo applications
-
-Build STM32F429 Demo:
- make cortex-m4
- cd build_cortex-m4
- make all