Add the Labs projects provided in the V10.2.1_191129 zip file.

[freertos] / FreeRTOS-Labs / Source / FreeRTOS-Plus-FAT / History2.txt

diff --git a/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/History2.txt b/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/History2.txt
new file mode 100644 (file)
index 0000000..17fdd98
--- /dev/null
+++ b/FreeRTOS-Labs/Source/FreeRTOS-Plus-FAT/History2.txt
@@ -0,0 +1,66 @@
+> is there a repository I should be aware of when it comes to FreeRTOS Labs? \r
+\r
+Unfortunately there isn't. FreeRTOS+FAT has become a bit of an orphan. All time and energy goes to the products in the [AWS/FreeRTOS release](https://github.com/aws/amazon-freertos)\r
+But I am still actively maintaining FreeRTOS+FAT: implementing requests and fixes.\r
+\r
+Please comment your findings with the above +FAT release.\r
+\r
+Here is a complete list of all changes since the 160919 Labs release:\r
+\r
+● `ff_dir.c : FF_MkDir()`\r
+refuse to create a directory with an empty name\r
+\r
+● `ff_fat.c : FF_GetFreeSize()`\r
+in case of an error, return 0\r
+\r
+● `ff_file.c : FF_FileSize()`\r
+This function returns the size of a file, or a negative number in case of an error.\r
+Hence, the maximum size returned was returned is 2 GB.\r
+We've added a new function:\r
+`FF_Error_t FF_GetFileSize( FF_FILE *pxFile, uint32_t *pulSize );`\r
+which separates the length from the error code.\r
+\r
+● `ff_file.c : FF_ExtendFile()`\r
+Sometimes while building up a file, it may be more efficient not to flush the changes immediately. When defining `ffconfigFILE_EXTEND_FLUSHES_BUFFERS` as `0`, there is no immediate flushing.\r
+\r
+● `ff_file.c : FF_Seek()`\r
+Seeking didn't work for sizes larger than 2 GB. Although the parameter `int32_t lOffset` is signed, it will now be casted to 32-bits unsigned:\r
+`ulPosition = ( uint32_t )lOffset;`\r
+All options (`SET`, `CUR`, and `END` ) re-tested.\r
+\r
+● `ff_file.c : FF_Close()`\r
+`FF_FlushCache()` is now called at the end of the function in order to also write the last changes.\r
+\r
+● `ff_format.c : FF_Format()`\r
+A variable `lRemaining` should have been declared unsigned: `uint32_t`.\r
+Also: a small optimisation for large SD-cards:\r
+"Putting the FAT-table into the second 4MB erase block gives a higher performance and a longer life-time"\r
+\r
+● `ff_format.c : FF_Partition()`\r
+`ulHiddenSectors` must be at least `1`\r
+( see [this post](https://sourceforge.net/p/freertos/discussion/382005/thread/d2b6524a/?limit=250#e1ea) )\r
+\r
+● `ff_ioman.c : FF_CreateIOManger()`\r
+`FF_CreateEvents` shall only be called in case an `pxIOManager` was successfully created.\r
+\r
+● `ff_ioman.c : FF_DeleteIOManager()`\r
+Added a call to `FF_DeleteEvents()`, which will delete the event group belonging to the I/O manager.\r
+\r
+● `ff_ioman.c : FF_FlushCache()`\r
+Added a user application hook per disk: `fnFlushApplicationHook()`. This is useful for e.g. NAND-drivers.\r
+\r
+● `ff_ioman.c : FF_Mount()`\r
+Make sure that `pcVolumeLabel` is null-terminated.\r
+\r
+● `ff_ioman.c : FF_IncreaseFreeClusters()`\r
+A lock is needed before `ulLastFreeCluster` can be changed. But before taking this lock, check if has already been taken to avoid a dead lock.\r
+\r
+● `ff_locking.c : FF_DeleteEvents`\r
+This is a new function which deletes ( frees up ) the event group belonging to an I/O manager.\r
+\r
+● `ff_stdio.c : ff_filelength()`\r
+This function will now call `FF_GetFileSize()` in order to get the `unsigned` length of a file, increasing the maximum reported size from 2 to 4 GB.\r
+\r
+● `ff_sys.c : *`\r
+This module combines several I/O managers ( = disks ) into a single file system that starts with a root `"/"`.\r
+All code has been re-written ( re-styled ) and re-tested.\r