Merge branch 'eclipse-threadx:main' into yajunxia/tsn

Author: yajunxiaMS

LICENSE

@@ -1,21 +1,17 @@
-MIT License
+The MIT License (MIT)
+Copyright (c) Microsoft Corporation
 
-Copyright (c) 2024 Azure RTOS
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, 
+including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT 
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

LICENSE-CODE

@@ -91,10 +91,6 @@ Eclipse ThreadX is easy to install, learn, use, debug, verify, certify, and main
 - Comprehensive and advanced feature set.
 - Quality documentation.
 
-### One Simple License
-
-There is no cost to use and test the source code and no cost for production licenses when deployed to pre-licensed devices, all other devices need a license.
-
 ### Full, highest-quality source code
 
 Throughout the years, Eclipse ThreadX source code has set the bar in quality and ease of understanding. In addition, the convention of having one function per file provides for easy source navigation.

README.md

@@ -26,13 +26,6 @@ UINT    fx_media_check(FX_MEDIA *media_ptr, UCHAR *scratch_memory_ptr,
 
 UINT    fx_media_close(FX_MEDIA *media_ptr);
 UINT    fx_media_close_notify_set(FX_MEDIA *media_ptr, VOID (*media_close_notify)(FX_MEDIA *media));
-UINT    fx_media_exFAT_format(FX_MEDIA *media_ptr, VOID (*driver)(FX_MEDIA *media), 
-                              VOID *driver_info_ptr, UCHAR *memory_ptr, 
-                              UINT memory_size, CHAR *volume_name,
-                              UINT number_of_fats, ULONG64 hidden_sectors,
-                              ULONG64 total_sectors, UINT bytes_per_sector,
-                              UINT sectors_per_cluster, UINT volume_serial_number,
-                              UINT boundary_unit);
 UINT    fx_media_extended_space_available(FX_MEDIA *media_ptr, ULONG64 *available_bytes_ptr);
 UINT    fx_media_flush(FX_MEDIA *media_ptr);
 UINT    fx_media_format(FX_MEDIA *media_ptr, VOID (*driver)(FX_MEDIA *media), 

rtos-docs/filex/appendix-a.md

@@ -9,19 +9,6 @@ description: Learn about the FileX constants.
 
 | Constant (by alphabetic)             | Value          |
 |--------------------------------------|----------------|
-|EXFAT_BIT_MAP_FIRST_TABLE             |0|
-|EXFAT_BOOT_REGION_SIZE                |24|
-|EXFAT_DEFAULT_BOUNDARY_UNIT           |28|
-|EXFAT_FAT_BITS                        |2|
-|EXFAT_FAT_BYTES_PER_SECTOR_SHIFT      |0x009|
-|EXFAT_FAT_DRIVE_SELECT                |0x080|
-|EXFAT_FAT_FILE_SYS_REVISION           |0x100|
-|EXFAT_FAT_NUM_OF_FATS                 |0x001|
-|EXFAT_FAT_VOLUME_FLAG                 |0x000|
-|EXFAT_FAT_VOLUME_NAME_FIELD_SIZE      |11|
-|EXFAT_LAST_CLUSTER_MASK               |0xFFFFFFFF|
-|EXFAT_MIN_NUM_OF_RESERVED_SECTORS     |1|
-|EXFAT_NUM_OF_DIR_ENTRIES              |2|
 |FX_12_BIT_FAT_SIZE                    |4086|
 |FX_12BIT_SIZE                         |3|
 |FX_16_BIT_FAT_SIZE                    |65525|
@@ -30,7 +17,6 @@ description: Learn about the FileX constants.
 |FX_ARCHIVE                            |0x20|
 |FX_BAD_CLUSTER                        |0xFFF7|
 |FX_BAD_CLUSTER_32                     |0x0FFFFFF7|
-|FX_BAD_CLUSTER_EXFAT                  |0x0FFFFFF7|
 |FX_BASE_YEAR                          |1980|
 |FX_BIGDOS                             |0x06|
 |FX_BOOT_ERROR                         |0x01|
@@ -83,17 +69,6 @@ description: Learn about the FileX constants.
 |FX_END_OF_FILE                        |0x09|
 |FX_ERROR_FIXED                        |0x92|
 |FX_ERROR_NOT_FIXED                    |0x93|
-|FX_EXFAT                              |0x07|
-|FX_EXFAT_BIT_MAP_NUM_OF_CACHED_SECTORS|1|
-|FX_EXFAT_BITMAP_CLUSTER_FREE          |0|
-|FX_EXFAT_BITMAP_CLUSTER_OCCUPIED      |1|
-|FX_EXFAT_FAT_CHECK_SUM_OFFSET         |11|
-|FX_EXFAT_FAT_MAIN_BOOT_SECTOR_OFFSET  |1|
-|FX_EXFAT_FAT_MAIN_SYSTEM_AREA_SIZE    |12|
-|FX_EXFAT_FAT_NUM_OF_SYSTEM_AREAS      |2|
-|FX_EXFAT_FAT_OEM_PARAM_OFFSET         |9|
-|FX_EXFAT_MAX_DIRECTORY_SIZE           |0x10000000|
-|FX_EXFAT_SIZE_OF_FAT_ELEMENT_SHIFT    |2|
 |FX_FALSE                              |0|
 |FX_FAT_CACHE_DEPTH                    |4|
 |FX_FAT_CACHE_HASH_MASK                |0x3|
@@ -139,7 +114,6 @@ description: Learn about the FileX constants.
 |FX_LAST_CLUSTER_1_32                  |0x0FFFFFF8|
 |FX_LAST_CLUSTER_2                     |0xFFFF|
 |FX_LAST_CLUSTER_2_32                  |0x0FFFFFFF|
-|FX_LAST_CLUSTER_EXFAT                 |0x0FFFFFFF|
 |FX_LONG_NAME                          |0xF|
 |FX_LONG_NAME_ENTRY_LEN                |13|
 |FX_LOST_CLUSTER_ERROR                 |0x04|
@@ -189,10 +163,8 @@ description: Learn about the FileX constants.
 |FX_RESERVED                           |0x025|
 |FX_RESERVED_1                         |0xFFF0|
 |FX_RESERVED_1_32                      |0x0FFFFFF0|
-|FX_RESERVED_1_EXFAT                   |0xFFFFFFF8|
 |FX_RESERVED_2                         |0xFFF6|
 |FX_RESERVED_2_32                      |0x0FFFFFF6|
-|FX_RESERVED_2_EXFAT                   |0xFFFFFFFE|
 |FX_RESERVED_SECTOR                    |0x00E|
 |FX_ROOT_CLUSTER_32                    |0x02C|
 |FX_ROOT_DIR_ENTRIES                   |0x011|
@@ -232,7 +204,6 @@ description: Learn about the FileX constants.
 |FX_DIR_ENTRY_DONE|0x00|
 |FX_DRIVER_READ|0|
 |FX_FALSE|0|
-|EXFAT_BIT_MAP_FIRST_TABLE|0|
 |FX_FREE_CLUSTER|0x0000|
 |FX_INITIAL_TIME|0x0000|
 |FX_JUMP_INSTR|0x000|
@@ -241,9 +212,6 @@ description: Learn about the FileX constants.
 |FX_SEEK_BEGIN|0|
 |FX_SUCCESS|0x00|
 |FX_UNKNOWN_SECTOR|0|
-|FX_EXFAT_FAT_MAIN_BOOT_SECTOR_OFFSET|0|
-|FX_EXFAT_BITMAP_CLUSTER_FREE|0|
-|EXFAT_FAT_VOLUME_FLAG|0x000|
 |FX_BOOT_ERROR|0x01|
 |FX_BOOT_SECTOR|1|
 |FX_DRIVER_WRITE|1|
@@ -252,13 +220,8 @@ description: Learn about the FileX constants.
 |FX_OPEN_FOR_WRITE|1|
 |FX_READ_ONLY|0x01|
 |FX_FAT12|0x01|
-|EXFAT_FAT_NUM_OF_FATS|0x001|
 |FX_SEEK_END|1|
 |FX_TRUE|1|
-|FX_EXFAT_BIT_MAP_NUM_OF_CACHED_SECTORS|1|
-|FX_EXFAT_BITMAP_CLUSTER_OCCUPIED|1|
-|FX_EXFAT_FAT_EXT_BOOT_SECTOR_OFFSET|1|
-EXFAT_MIN_NUM_OF_RESERVED_SECTORS|1|
 |FX_DIRECTORY_ERROR|0x02|
 |FX_HIDDEN|0x02|
 |FX_MEDIA_INVALID|0x02|
@@ -267,9 +230,6 @@ EXFAT_MIN_NUM_OF_RESERVED_SECTORS|1|
 |FX_FAT_SECTOR|2|
 |FX_OPEN_FOR_READ_FAST|2|
 |FX_SEEK_FORWARD|2|
-|FX_EXFAT_SIZE_OF_FAT_ELEMENT_SHIFT|2|
-|FX_EXFAT_FAT_NUM_OF_SYSTEM_AREAS|2|
-EXFAT_NUM_OF_DIR_ENTRIES|2|
 |FX_12BIT_SIZE|3|
 |FX_DIR_EXT_SIZE|3|
 |FX_DIRECTORY_SECTOR|3|
@@ -296,28 +256,22 @@ EXFAT_NUM_OF_DIR_ENTRIES|2|
 |FX_DRIVER_RELEASE_SECTORS|6|
 |FX_DRIVER_BOOT_WRITE|7|
 |FX_NOT_OPEN|0x07|
-|FX_EXFAT|0x07|
 |FX_DIR_NAME_SIZE|8|
 |FX_DIR_RESERVED|8|
 |FX_DRIVER_UNINIT|8|
 |FX_FILE_CORRUPT|0x08|
 |FX_FILE_SIZE_ERROR|0x08|
 |FX_VOLUME|0x08|
 |FX_END_OF_FILE|0x09|
-|EXFAT_FAT_BYTES_PER_SECTOR_SHIFT|0x009|
 |FX_YEAR_SHIFT|9|
-|FX_EXFAT_FAT_OEM_PARAM_OFFSET|9|
 |FX_NO_MORE_SPACE|0x0A|
 |FX_EF_MUST_BE_ZERO|11|
-|EXFAT_FAT_VOLUME_NAME_FIELD_SIZE|11|
 |FX_ALREADY_CREATED|0x0B|
 |FX_FAT32|0x0B|
 |FX_BYTES_SECTOR|0x00B|
 |FX_HOUR_SHIFT|11|
-|FX_EXFAT_FAT_CHECK_SUM_OFFSET|11|
 |FX_INVALID_NAME|0x0C|
 |FX_MAXIMUM_MONTH|12|
-|FX_EXFAT_FAT_MAIN_SYSTEM_AREA_SIZE|12|
 |FX_INVALID_PATH|0x0D|
 |FX_SECTORS_CLUSTER|0x00D|
 |FX_LONG_NAME_ENTRY_LEN|13|
@@ -346,7 +300,6 @@ EXFAT_NUM_OF_DIR_ENTRIES|2|
 |FX_INVALID_SECOND|0x17|
 |FX_MAXIMUM_HOUR|23|
 |FX_PTR_ERROR|0x18|
-|EXFAT_BOOT_REGION_SIZE|24|
 |FX_SECTORS_PER_TRK|0x018|
 |FX_INVALID_ATTR|0x19|
 |FX_HEADS|0x01A|
@@ -357,7 +310,6 @@ EXFAT_NUM_OF_DIR_ENTRIES|2|
 |FX_ARCHIVE|0x20|
 |FX_CALLER_ERROR|0x20|
 |FX_DIR_ENTRY_SIZE|32|
-EXFAT_FAT_BITS|32|
 |FX_HUGE_SECTORS|0x020|
 |FX_BUFFER_ERROR|0x21|
 |FX_MAX_LONG_NAME_LEN|33|
@@ -394,9 +346,7 @@ EXFAT_FAT_BITS|32|
 |FX_EF_RESERVED|113|
 |FX_EF_BOOT_CODE|120|
 |FX_YEAR_MASK|0x7F|
-|EXFAT_FAT_DRIVE_SELECT|0x80|
 |FX_FAT_MAP_SIZE|128|
-EXFAT_DEFAULT_BOUNDARY_UNIT|128|
 |FX_SECTOR_INVALID|0x89|
 |FX_IO_ERROR|0x90|
 |FX_NOT_ENOUGH_MEMORY|0x91|
@@ -409,7 +359,6 @@ EXFAT_DEFAULT_BOUNDARY_UNIT|128|
 |FX_SIG_BYTE_2|0xAA|
 |FX_DIR_ENTRY_FREE|0xE5|
 |FX_NO_FAT|0xFF|
-|EXFAT_FAT_FILE_SYS_REVISION|0x100|
 |FX_MAX_EX_FAT_NAME_LEN|255|
 |FX_MAXIMUM_PATH|256|
 |FX_SIG_OFFSET|0x1FE|
@@ -432,15 +381,9 @@ EXFAT_DEFAULT_BOUNDARY_UNIT|128|
 |FX_BAD_CLUSTER_32|0x0FFFFFF7|
 |FX_LAST_CLUSTER_1_32|0x0FFFFFF8|
 |FX_LAST_CLUSTER_2_32|0x0FFFFFFF|
-|FX_EXFAT_MAX_DIRECTORY_SIZE|0x10000000|
 |FX_FILE_ABORTED_ID|0x46494C41UL|
 |FX_FILE_CLOSED_ID|0x46494C43UL|
 |FX_FILE_ID|0x46494C45UL|
 |FX_MEDIA_ABORTED_ID|0x4D454441UL|
 |FX_MEDIA_CLOSED_ID|0x4D454443UL|
-|FX_MEDIA_ID|0x4D454449UL|
-|FX_RESERVED_1_EXFAT|0xFFFFFFF8|
-|FX_RESERVED_2_EXFAT|0xFFFFFFFE|
-|FX_BAD_CLUSTER_EXFAT|0xFFFFFFF7|
-|FX_LAST_CLUSTER_EXFAT|0xFFFFFFFF|
-EXFAT_LAST_CLUSTER_MASK|0xFFFFFFFF|
+|FX_MEDIA_ID|0x4D454449UL|

rtos-docs/filex/appendix-b.md

@@ -32,12 +32,6 @@ typedef struct FX_DIR_ENTRY_STRUCT
     ULONG       fx_dir_entry_last_search_byte_offset;
     ULONG64     fx_dir_entry_next_log_sector;
 
-    #ifdef FX_ENABLE_EXFAT
-        CHAR        fx_dir_entry_dont_use_fat;
-        UCHAR       fx_dir_entry_type;
-        ULONG64     fx_dir_entry_available_file_size;
-        ULONG       fx_dir_entry_secondary_count;
-    #endif
 
 } FX_DIR_ENTRY;
 ```
@@ -93,23 +87,6 @@ typedef struct        FX_MEDIA_STRUCT
     ULONG64        fx_media_total_sectors;
     ULONG        fx_media_total_clusters;
 
-    #ifdef FX_ENABLE_EXFAT
-        ULONG        fx_media_exfat_volume_serial_number;
-        UINT        fx_media_exfat_file_system_revision;
-        UINT        fx_media_exfat_volume_flag;
-        USHORT        fx_media_exfat_drive_select;
-        USHORT        fx_media_exfat_percent_in_use;
-        UINT        fx_media_exfat_bytes_per_sector_shift;
-        UINT        fx_media_exfat_sector_per_clusters_shift;
-        UCHAR        fx_media_exfat_bitmap_cache[512];
-        ULONG        fx_media_exfat_bitmap_start_sector;
-        ULONG        fx_media_exfat_bitmap_cache_size_in_sectors;
-        ULONG        fx_media_exfat_bitmap_cache_start_cluster;
-        ULONG        fx_media_exfat_bitmap_cache_end_cluster;
-        UINT        fx_media_exfat_bitmap_clusters_per_sector_shift;
-        UINT        fx_media_exfat_bitmap_cache_dirty;
-    #endif
-
     UINT        fx_media_reserved_sectors;
     UINT        fx_media_root_sector_start; 
     UINT        fx_media_root_sectors;

rtos-docs/filex/appendix-c.md

@@ -9,7 +9,7 @@ FileX is a complete FAT format media and file management system for deeply embed
 
 ## FileX Unique Features
 
-FileX supports an unlimited number of media devices at the same time, including RAM disks, FLASH managers, and actual physical devices. It supports 12-, 16-, and 32-bit File Allocation Table (FAT) formats, and also supports Extended File Allocation Table (exFAT), contiguous file allocation, and is highly optimized for both size and performance. FileX also includes fault tolerant support, media open/ close, and file write callback functions.
+FileX supports an unlimited number of media devices at the same time, including RAM disks, FLASH managers, and actual physical devices. It supports 12-, 16-, and 32-bit File Allocation Table (FAT) formats, and also supports contiguous file allocation, and is highly optimized for both size and performance. FileX also includes fault tolerant support, media open/ close, and file write callback functions.
 
 Designed to meet the growing need for FLASH devices, FileX uses the same design and coding methods as ThreadX. Like all Eclipse Foundation products, FileX is distributed with full ANSI C source code, and it has no run-time royalties.
 
@@ -29,7 +29,6 @@ Designed to meet the growing need for FLASH devices, FileX uses the same design
 - Endian neutral
 - Easy-to-implement FileX I/O drivers
 - 12-, 16-, and 32-bit FAT support
-- exFAT support
 - Long filename support
 - Internal FAT entry cache
 - Unicode name support
@@ -91,12 +90,6 @@ FileX provides the very best deeply embedded file system technology in a manner
 
 For a complete list of the FileX Version 5 Services, see [Appendix A](appendix-a.md).
 
-## exFAT Support
-
-exFAT (extended File Allocation Table) is a file system designed by Eclipse Foundation to allow file size to exceed 2GB, a limit imposed by FAT32 file systems. It is the default file system for SD cards with capacity over 32GB. SD cards or flash drives formatted with FileX exFAT format are compatible with Windows. exFAT supports file size up to one Exabyte (EB), which is approximately one billion GB.
-
-Users wishing to use exFAT must recompile the FileX library with the symbol **_FX_ENABLE_EXFAT_** defined. When opening media, FileX detects the media type. If the media is formatted with exFAT, FileX reads and writes the file system following exFAT standard. To format new media with exFAT, use the service **_fx_media_exFAT_format_**. By default exFAT is not enabled.
-
 ## Fault Tolerant Support
 
 The FileX Fault Tolerant Module is designed to prevent file system corruption caused by interruptions during the file or directory update. For example, when appending data to a file, FileX needs to update the content of the file, the directory entry, and possibly the FAT entries. If this sequence of update is interrupted (such as power glitch, or the media is ejected in the middle of the update), the file system is in an inconsistent state, which may affect the integrity of the entire file system, leading towards corruption of other files.
@@ -107,7 +100,7 @@ As FileX updates file or directory, log entries are created. After the update op
 
 In case the file system update operation was interrupted, next time the media is mounted by FileX, the Fault Tolerant Module analyzes the log entries. The information in the log entries allows FileX to back out partial changes already applied to the file system (in case the failure happens during the early stage of the file update operation), or if the log entries contain re-do information, FileX is able to apply the changes required to finish the prior operation.
 
-This fault tolerant feature is available to all FAT file systems supported by FileX, including FAT12, FAT16, FAT32, and exFAT. By default fault tolerant is not enabled in FileX. To enable the fault tolerant feature, FileX must be built with the symbol **FX_ENABLE_FAULT_TOLERANT** and **FX_FAULT_TOLERANT** defined. At run time, the application starts fault tolerant service by calling **_fx_fault_tolerant_enable_**.
+This fault tolerant feature is available to all FAT file systems supported by FileX, including FAT12, FAT16, and FAT32. By default fault tolerant is not enabled in FileX. To enable the fault tolerant feature, FileX must be built with the symbol **FX_ENABLE_FAULT_TOLERANT** and **FX_FAULT_TOLERANT** defined. At run time, the application starts fault tolerant service by calling **_fx_fault_tolerant_enable_**.
 After the service starts, all file and directory write operations go through the Fault Tolerant Module.
 
 As fault tolerant service starts, it first detects whether or not the media is protected under the Fault Tolerant Module. If it is not, FileX assumes integrity of the file system, and starts protection by allocating free blocks from the file system to be used for logging and caching. If the Fault Tolerant Module logs are found on the file system, it analyzes the log entries. FileX reverts the prior operation or redoes the prior operation, depending on the content of the log entries. The file system becomes available after all the prior log entries are processed. This ensures that FIleX starts from a known good state.