Enable and Configure PMECC (Programmable Multibit ECC) in AT91SAM SoC
This page is mainly about how to enable and configure the PMECC in AT91SAM SoCs for different NAND flash devices.
- The PMECC controller is a programmable binary BCH (Bose, Chaudhuri and Hocquenghem) encoder and decoder. It can be used to support both SLC and MLC NAND Flash devices.
- The PMECC module can correct 2, 4, 8, 12 or 24 bits of error per sector of data (512 Bytes or 1024 Bytes).
- According to different correctable ECC bits and sector size, the PMECC encoding data size is different.
- And the settings for different correctable ECC bits are incompatible.
- The following table shows the PMECC encoding data size for different configurations:
|
|
| Correction Capability |
512-Byte Sector |
1024-Byte Sector |
| 2 bits |
4 Bytes |
4 Bytes |
| 4 bits |
7 Bytes |
7 Bytes |
| 8 bits |
13 Bytes |
14 Bytes |
| 12 bits |
20 Bytes |
21 Bytes |
| 24 bits |
39 Bytes |
42 Bytes |
|
|
|
-
- In general, the PMECC encoding data are located at the end of the OOB area in NAND Flash.
As described in the introduction, it's important in your whole system to have the same ECC management. This is why we will detail below all the software components in a Linux based system.
- In AT91SAM SoCs, the SAM9x5 series and SAM9N12 both support PMECC. All newer SoC support PMECC as well (SAMA5D2, SAMA5D3, SAMA5D4, SAM9X60, ...).
- The software versions that support PMECC:
- SAM-BA 2.11 or later versions
- AT91Bootstrap v3.5.0 or later versions
- U-Boot v2012.10 or later versions
- Kernel v3.18 or later versions
Find the minimum required ECC bits of NAND flash
- For ONFI compliant NAND flash:
- In the ONFI parameter structure, the 112th Byte, number of bits of ECC correctability, indicates the minimum required ECC bits in a 512-Byte sector.
- For ONFI 2.1 or later versions, if the number of bits of ECC correctabilty is 0xFF, then the actual correctable ECC bits and sector size should be found in the extended parameter page. The 14th Byte of ONFI parameter indicates the start of the extended parameter page.
- For non-ONFI compliant NAND flash, assume using 1-bit ECC.
Configurations in SAM-BA
The SAM-BA configuration is important as this tool is used to program the external NAND flash. During the NAND flash programming, the ECC needs to bet configured correctly to assure a good coherency of your system content.
If you do not use SAM-BA to program your NAND flash, please update accordingly your NAND flash programmer.
The configuration steps in SAM-BA:
- Choose the NAND flash media tab in the SAM-BA GUI.
- Initialize the media by choosing
Enable NandFlash in the Scripts rolling menu and press Execute.
- Select
Enable OS PMECC parameters in the Scripts rolling menu and press Execute. The default ECC configuration dialog will pop up:
- The detailed information for each item:
Configurations in AT91Bootstrap
- The AT91Bootstrap v3.5.0 or later versions support PMECC and the PMECC parameter can be changed.
- The AT91Bootstrap v3.7.0 or later versions support ONFI ecc parameters auto detection. That means it will detect nandflash's ONFI and set the PMECC paramters automatically.
- Change the correctable PMECC bits & sector size
- For v3.5.0, modify the board head file, which is under AT91Bootstrap board directory.
#define PMECC_ERROR_CORR_BITS 2 /* Correctable ECC bits, can be 2,4,8,12,24 bits */
#define PMECC_SECTOR_SIZE 512 /* Sector size in bytes, can be 512 or 1024 */
- For v3.6.0, run the
make menuconfig to configure PMECC parameters
make sama5d3xeknf_uboot_defconfig # take SAMA5D3 as an example
make menuconfig
In the popup menu, select as following to configure PMECC correctable bits & sector size
Memory selection --->
NAND flash configuration --->
PMECC Configuration --->
PMECC Error Correction Bits (4-bit) --->
PMECC Sector Size (512-byte) --->
- For v3.7.0 or later, you need deselect
Auto-detect ONFI minimum error requirement option before you set your own pmecc configuration. Then the operation is same as v3.6.0.
Memory selection --->
NAND flash configuration --->
PMECC Configuration --->
Auto-detect ONFI minimum error requirement
- Compile the AT91Bootstrap.
Configurations in U-Boot
- Only U-Boot v2012.10 and later versions support PMECC.
- Change the correctable PMECC bits & sector size in board configuration file, which is under directory
include/configs/.
/* PMECC & PMERRLOC */
#define CONFIG_ATMEL_NAND_HWECC 1
#define CONFIG_ATMEL_NAND_HW_PMECC 1
#define CONFIG_PMECC_CAP 2 /* Correctable ECC bits, can be 2,4,8,12,24 bits */
#define CONFIG_PMECC_SECTOR_SIZE 512 /* Sector size in bytes, can be 512 or 1024 */
#define CONFIG_PMECC_INDEX_TABLE_OFFSET 0x8000 /* Different sector size has different Index table. If the sector size is 1024, need to change it to 0x10000 */
- U-Boot v2013.07 and later versions support ONFI ecc parameters auto detection. To enable auto detection, you need remove the definitions of
CONFIG_PMECC_CAP and CONFIG_PMECC_SECTOR_SIZE.
- Compile the U-Boot.
Configurations in Kernel
- Kernel will detect ONFI ecc paramters automatically. That means they won't set
atmel,pmecc-cap and atmel,pmecc-sector-size in the dt node.
- If you want to change the PMECC settings:
- Find the DTS file for the PMECC settings in
arch/arm/boot/dts/
- 9X5:
at91sam9x5cm.dtsi
- 9N12:
at91sam9n12ek.dts
- SAMA5D3:
sama5d3cm.dtsi
- and all other SoCs...
- Here lists the PMECC settings in DTS file:
nand-ecc-mode = "hw";
atmel,has-pmecc; /* Enable PMECC */
atmel,pmecc-cap = <2>; /* Correctable ECC bits, can be 2,4,8,12,24 bits */
atmel,pmecc-sector-size = <512>; /* Sector size in bytes, can be 512, 1024 */
- Compile the DTB file.
Q: How do I know the PMECC is enabled or not when booting?
In the kernel dmesg, if you enable PMECC, you should find the line as below:
atmel_nand 40000000.nand: Initialize PMECC params, cap: 2, sector: 512
In the U-Boot, to see the PMECC information you need enable the MTD debug in the board config file. For example, in SAMA5D3 need to add the following lines in
include/configs/sama5d3xek.h, then rebuild the U-Boot.bin.
#define CONFIG_MTD_DEBUG
#define CONFIG_MTD_DEBUG_VERBOSE 1
.
