Merge changes ahead of the v6.5.0.202601 release

common/inc/lx_user_sample.h

@@ -1,10 +1,11 @@
 /***************************************************************************
- * Copyright (c) 2024 Microsoft Corporation 
- * 
+ * Copyright (c) 2024 Microsoft Corporation
+ * Copyright (c) 2026-present Eclipse ThreadX contributors
+ *
  * This program and the accompanying materials are made available under the
  * terms of the MIT License which is available at
  * https://opensource.org/licenses/MIT.
- * 
+ *
  * SPDX-License-Identifier: MIT
  **************************************************************************/
 
@@ -39,46 +40,29 @@
 /*    Note that all the defines in this file may also be made on the      */
 /*    command line when building LevelX library and application objects.  */
 /*                                                                        */
-/*  RELEASE HISTORY                                                       */
-/*                                                                        */
-/*    DATE              NAME                      DESCRIPTION             */
-/*                                                                        */
-/*  11-09-2020     William E. Lamie         Initial Version 6.1.2         */
-/*  06-02-2021     Bhupendra Naphade        Modified comment(s), and      */
-/*                                            added standalone support,   */
-/*                                            resulting in version 6.1.7  */
-/*  03-08-2023     Xiuwen Cai               Modified comment(s), and      */
-/*                                            added new NAND options,     */
-/*                                            resulting in version 6.2.1  */
-/*  10-31-2023     Xiuwen Cai               Modified comment(s),          */
-/*                                            added options for mapping , */
-/*                                            bitmap cache and obsolete   */
-/*                                            count cache,                */
-/*                                            resulting in version 6.3.0  */
-/*                                                                        */
 /**************************************************************************/
 
 #ifndef LX_USER_H
 #define LX_USER_H
 
 
 
-/* Defined, this option bypasses the NOR flash driver read routine in favor or reading 
-   the NOR memory directly, resulting in a significant performance increase. 
+/* Defined, this option bypasses the NOR flash driver read routine in favor or reading
+   the NOR memory directly, resulting in a significant performance increase.
 */
 /*
 #define LX_DIRECT_READ
 */
 
 
-/* Defined, this causes the LevelX NOR instance open logic to verify free NOR 
+/* Defined, this causes the LevelX NOR instance open logic to verify free NOR
    sectors are all ones.
 */
 /*
-#define LX_FREE_SECTOR_DATA_VERIFY 
+#define LX_FREE_SECTOR_DATA_VERIFY
 */
 
-/* By default this value is 4, which represents a maximum of 4 blocks that 
+/* By default this value is 4, which represents a maximum of 4 blocks that
    can be allocated for metadata.
 */
 /*
@@ -90,23 +74,23 @@
 #define LX_NOR_DISABLE_EXTENDED_CACHE
 */
 
-/* By default this value is 8, which represents a maximum of 8 sectors that 
+/* By default this value is 8, which represents a maximum of 8 sectors that
    can be cached in a NOR instance.
 */
 /*
-#define LX_NOR_EXTENDED_CACHE_SIZE   8 
+#define LX_NOR_EXTENDED_CACHE_SIZE   8
 */
 
 
-/* By default this value is 16 and defines the logical sector mapping cache size. 
-   Large values improve performance, but cost memory. The minimum size is 8 and all 
+/* By default this value is 16 and defines the logical sector mapping cache size.
+   Large values improve performance, but cost memory. The minimum size is 8 and all
    values must be a power of 2.
 */
 /*
 #define LX_NOR_SECTOR_MAPPING_CACHE_SIZE   16
 */
 
-/* Defined, this makes LevelX thread-safe by using a ThreadX mutex object 
+/* Defined, this makes LevelX thread-safe by using a ThreadX mutex object
    throughout the API.
 */
 /*
@@ -118,34 +102,34 @@
 /* #define LX_STANDALONE_ENABLE */
 
 /* Define user extension for NOR flash control block. User extension is placed at the end of flash control block and it is not cleared on opening flash. */
-/* 
+/*
 #define LX_NOR_FLASH_USER_EXTENSION    ????
 */
 
 /* Define user extension for NAND flash control block. User extension is placed at the end of flash control block and it is not cleared on opening flash.  */
-/* 
+/*
 #define LX_NAND_FLASH_USER_EXTENSION   ????
 */
 
-/* Determine if logical sector mapping bitmap should be enabled in extended cache. 
+/* Determine if logical sector mapping bitmap should be enabled in extended cache.
    Cache memory will be allocated to sector mapping bitmap first. One bit can be allocated for each physical sector.  */
-/* 
+/*
 #define LX_NOR_ENABLE_MAPPING_BITMAP
 */
 
-/* Determine if obsolete count cache should be enabled in extended cache.  
-   Cache memory will be allocated to obsolete count cache after the mapping bitmap if enabled, 
+/* Determine if obsolete count cache should be enabled in extended cache.
+   Cache memory will be allocated to obsolete count cache after the mapping bitmap if enabled,
    and the rest of the cache memory is allocated to sector cache.  */
-/* 
+/*
 #define LX_NOR_ENABLE_OBSOLETE_COUNT_CACHE
 */
 
 /* Defines obsolete count cache element size. If number of sectors per block is greater than 256, use USHORT instead of UCHAR.  */
-/* 
+/*
 #define LX_NOR_OBSOLETE_COUNT_CACHE_TYPE            UCHAR
 */
 
-/* Define the logical sector size for NOR flash. The sector size is in units of 32-bit words. 
+/* Define the logical sector size for NOR flash. The sector size is in units of 32-bit words.
    This sector size should match the sector size used in file system.  */
 /*
 #define LX_NOR_SECTOR_SIZE                          (512/sizeof(ULONG))