History: media_drv_ftl_base
This page describes all changes made to the media_drv_ftl_base package, SafeFTL, since its release.
Version
5.27 (2020-11-03, 14:49):
The value of MDRIVER_FTL_COPY_LAST_PAGE is only feasible if it is less than the number of pages within a flash block. FTL initialization might have failed with MDRIVER_FTL_COPY_LAST_PAGE set to a value bigger than that. This version introduces a fix for this, maximizing the effective setting in (Nr. of pages per block) - 1. Consider a flash with, say, 64 pages per block: 64 or any value bigger than that will be considered 63.
5.26 (2020-07-16, 10:11):
- MDRIVER_FTL_COPY_LAST_PAGE feature improvement: the flash page to be re-written at FTL initialization (the page written last during the previous power cycle) might have been read more than once from the flash, with possibly different outcomes (reading a weakly programmed page might fail or succeed, and it is not possible that the behaviour changes during FTL's initialization process). This phenomenon has been eliminated, resulting in a more robust initialization if there is no proper brown-out detection in the system but MDRIVER_FTL_COPY_LAST_PAGE is enabled.
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.