Page Comparison

...

Anchor10300261030026 Generic Controller Layer Implementation Anchor10278601027860The generic controller layer driver is an implementation of the controller layer that is compatible with most parallel NAND devices and most simple memory controllers. It has the following features: Anchor10283951028395

...

The generic controller driver imposes a specific page layout: the sectors are stored sequentially in the main page area and OOS metadata zones are stored sequentially in the spare area, packed in the free spare zones specified by the .FreeSpareMap field of the associated FS_PART_DATA data structure. An example layout is shown below for a device with 2048 octets pages, using 512 bytes sectors. Anchor10297911029791 Image Removed

...

Image Added

Figure 15-2 Example generic controller driver page layout

Anchor10298091029809To determine if the generic controller driver is compatible with your hardware, you can study its BSP interface, described in section 1315-8-1 “BSP Development Guide - Generic Controller” on page 190. Anchor10296741029674

Generic Controller Extension Layer

...

10348281034828The generic controller extension layer extends the functionality of the generic controller, mostly with regards to ECC. It allows for the reuse of the generic controller code, enabling easy customizations of the controller layer. The NAND driver ships with two generic controller extensions: Anchor10453851045385
...
...
Extension API
...
Files
...
...
Description
...
`FS_NAND_CtrlrGen_SoftECC`
...
...
fs_dev_nand_ctrlr_gen_soft_ecc.* in /Micrium/Software/uC-FS/Dev/NAND/Ctrlr
...
...
Supports software ECC calculation and correction through µC/CRC ECC modules.
...
`FS_NAND_CtrlrGen_MicronECC`
...
...
fs_dev_nand_ctrlr_gen_micron_ecc. in /Micrium/Software/uC-FS/Dev/NAND/Ctrlr*
...
Supports on-chip ECC hardware for some Micron parts (ex: MT29F01G08ABADA).
...
Table 15-2 Generic controller layer extensions provided
...
anchor10383671038367
The software ECC generic controller extension (`FS_NAND_CtrlrGen_SoftECC`) uses µC/CRC’s ECC modules for the ECC codewords calculation and data correction. The extension is configurable through a `FS_NAND_CTRLR_GEN_SOFT_ECC_CFG` type structure. It should be initialized to the value `FS_NAND_CtrlrGen_SoftEcc_DfltCfg` before its fields are overridden to the appropriate values for your application. Anchor10392021039202
...
rowspan 6
...
Listing 15-4 NAND translation layer configuration structure
...
L15-4(1) Pointer to an `ECC_CALC` API structure that will be used to provide software ECC calculation and correction. Refer to section
...
15-8-3 “ECC Module Development Guide”
...
and µC/CRC’s user manual for more information on ECC modules.
...
Anchor10395711039571
The Micron ECC generic controller extension (`FS_NAND_CtrlrGen_MicronECC`) allows the use of internal on-chip hardware ECC engines for some Micron NAND flash parts. The extension has been designed as an example for the Micron MT29F1G08ABADA, but should function properly with other similar Micron devices with internal ECC hardware modules. This module doesn’t have any configuration options, you should use `DEF_NULL` as the generic controller extension configuration pointer (`.CtrlrExtCfg` field of the `FS_NAND_CTRLR_GEN_CFG` structure).

Versions Compared

Old Version 1

New Version 2

Key

Generic Controller Extension Layer