History: media_drv_ftl_base

This page describes all changes made to the media_drv_ftl_base package, SafeFTL, since its release.

Version

5.25 (2020-04-27, 19:00):

• Added ftl_idle_erase() API to manually schedule background erase in idle time. API is available if MDRIVER_FTL_IDLE_ERASE configuration option is set and MDRIVER_FTL_IDLE_ERASE_USE_TASK is cleared.

5.24 (2020-04-03, 11:05):

• Compiler warnings were eliminated.

5.23 (2020-02-21, 13:51):

• Added MDRIVER_FTL_HLAYER_NONSTD_PAGE_SIZE option: allows handling non-power of two size pages.

5.22 (2019-12-11, 11:42):

• Errors from the low-level driver were not handled properly and as a result the error could not be detected at the media driver layer. If an error occurs during the merge of log block, the media becomes read-only.
• Eliminated  compiler error that occurred when MDRIVER_FTL_IDLE_ERASE was enabled.

5.21 (2019-11-26, 16:22):

• Low-level driver was not released when the media driver was released. This left the low-level driver uninitialized after the media driver was released then re-initialized.

5.20 (2019-10-18, 17:04):

• Static analysis issue eliminated.

5.19 (2019-04-10, 17:18):

• Superfluous low level driver initialization calls are eliminated.

5.18 (2018-02-26, 16:22):

• Storage class of get_mapblock() fixed.
• Prototypes for static functions added.

5.17 (2018-02-23, 12:28):

• calc_alloc_mem() was refactored to avoid NULL-pointer de-reference when high optimization is used in IAR 7.80.4.

5.16 (2017-10-20, 13:16):

• ml_format() function updated to support pre-programmed images.

5.15:

• MDRIVER_FTL_COPY_LAST_PAGE configuration option added; when this is enabled FTL will search for the last written page during initialization and make a copy of it.

5.14:

• Include path of psp_types.h fixed.
• Supports 64 bit environments.

5.13:

• Static analyzer (CodeSonar) warnings were eliminated.
• psp_types.h is included instead of stdint.h.

5.12:

• Compiler warnings eliminated.

5.11:

• FTL_SSD: MDRIVER_FTL_FAST_INIT (psp_ftl_nvram interface) supports multiple volumes.

5.10:

• FTL_SSD: background merge feature and MDRIVER_FTL_BACKGROUND_MERGE config option added.

5.9:

• Internal data structure reorganized to eliminate compiler warnings.

5.8:

• FTL_SSD: FTL_ALLOW_NVRAM_FORMAT init option added.  When MDRIVER_FTL_FAST_INIT is set and ftl_initfunc() is called with this init option it will start without valid NVRAM content and format NVRAM at the end of the initialization.

5.7:

• ftl_initfunc() works when read-only flag is used.
• MDRIVER_FTL_FAST_INIT config option added to allow FTL to store map block locations into dedicated non-volatile memory which may be used later by ftl_initfunc() to speed up FTL volume initialization.
• Maximum map block count limited to 8, previously higher number was accepted from the low level driver causing incorrect operation.

5.6:

• Inline code eliminated.

5.5:

• FTL failed to work correctly if a driver returned LL_REWRITE from ll_read (triggers rewrite of a block if required by the driver) when MDRIVER_FTL_REWRITE wasn't enabled.
• MDRIVER_FTL_DATABLOCK_LOGGING option added - extra LOG pages will be allocated at the end of data blocks to speed up random write.
• MDRIVER_FTL_CACHE_WRITE option added - contiguous write will be speeded up if the NAND and the driver support the "PROGRAM PAGE CACHE" command.
• MDRIVER_FTL_MULTILUN option added - if MDRIVER_FTL_CACHE_WRITE is set FTL will use "PROGRAM PAGE CACHE" during merge if the destination block is on a different LUN/chip.

5.4:

• issue fixed in ftldrv.c when compiling without HLAYER.

5.3:

• block rewrite feature introduced. If the physical layer driver reports LL_REWRITE after a read the affected block will be scheduled for rewrite. The frequency of rewrite operations may be limited by the newly introduced t_ftl_phy.rewrite_interval parameter on a per-volume basis.

5.2:

• ml_lowinit() sets t_ftl_phy.wear_static_limit and .wear_static_count fields to default values before calling low-level driver's getphy() function - this helps make old NAND drivers compatible with

FTL v5.x.

5.1:

• ftl_erase() added: it erases all blocks on a given media which aren't marked as bad.
• ftl_stats() function added for retrieving statistics about mounted FTL volumes.
• ftl_get_blockinfo() function added for retreiving wear and address info   of selected blocks.
• wear_static_limit and wear_static_count fields added to t_ftl_phy; these values are now independently configurable for different low-level drivers.

4.5:

• FTL handles all FLASH read and write errors: it reports all errors to the application, in some critical cases it also makes the volume read-only to prevent more errors to cause data corruption.

4.4:

• Format failed for NAND flashes with factory bad blocks, as it incorrectly became read-only.

4.3:

• drive becomes and remains read-only when flash media reaches end-of-life.
• ftldrive_getmem() and ftldrive_setmem() functions reorganized.

4.2:

• ftldrive_setmem() returns error code if the physical layer driver initialization failed.
• "variable might be used uninitialized" warning removed from ftldrive_setmem().

4.1:

• MDRIVER_FTL_IDLE_ERASE config option added.
• When MDRIVER_FTL_IDLE_ERASE is set, FTL will create a low-priority background task which will do the erase operations. The underlying physical layer driver must handle the situation when an erase operation is still in progress and a read/write request arrives.

3.2:

• Compiler warnings were eliminated (warnings occurred in 16-bit environment).

3.1 r2:

• documentation updated to v1.03.

3.1:

• ftl_format() automatically erases the media and retries the format if the first attempt failed.  
• ftl_initfunc() can be instructed to automatically format an unformatted media by setting the FTL_ALLOW_FORMAT bit in the driver_param argument.

3.0 r3:

• documentation updated to v1.02.

3.0:

• api_mdriver_ftl.h: t_ftl_phy simplified, drivers don't need to report n_fragpermap and n_max_frag anymore.
• ml_types.h: redundantly used fields removed from t_ml_volume and t_ll_data structures.

2.5:

• MDRIVER_FTL_DELETE_CONTENT works again.

2.4:

• ftldrive_getmem() fixed, other cosmetic changes.

2.3:

• Memory allocation for FTL drives now goes through ftldrive_getmem() and ftldrive_setmem() calls. config_mdriver_ftl_init.c and config_mdriver_ftlnor_init.c contain drive number and driver assignment.

2.2:

•  FTL now supports more than 254 free blocks.
•  MDRIVER_FTL_MAX_FREE_BLOCKS config value introduced.

2.1:

• ftl_release warnings fixed.

2.0:

• Initial release in new source tree with support for multiple FTL volumes and big blocks.