351 lines
13 KiB
C
351 lines
13 KiB
C
|
|
||
|
|
/*
|
||
|
|
* Copyright (c) 2007-2017 Allwinnertech Co., Ltd.
|
||
|
|
*
|
||
|
|
* This software is licensed under the terms of the GNU General Public
|
||
|
|
* License version 2, as published by the Free Software Foundation, and
|
||
|
|
* may be copied, distributed, and modified under those terms.
|
||
|
|
*
|
||
|
|
* This program is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
* GNU General Public License for more details.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* eNand
|
||
|
|
* Nand flash driver physical module define
|
||
|
|
*
|
||
|
|
* Copyright(C), 2006-2008, SoftWinners
|
||
|
|
*Microelectronic Co., Ltd.
|
||
|
|
* All Rights Reserved
|
||
|
|
*
|
||
|
|
* File Name : nand_physic.h
|
||
|
|
*
|
||
|
|
* Author : Kevin.z
|
||
|
|
*
|
||
|
|
* Version : v0.1
|
||
|
|
*
|
||
|
|
* Date : 2008.03.25
|
||
|
|
*
|
||
|
|
* Description : This file define the function __s32erface and some data
|
||
|
|
*structure export for
|
||
|
|
* the physical module.
|
||
|
|
*
|
||
|
|
* Others : None at present.
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* History :
|
||
|
|
*
|
||
|
|
* <Author> <time> <version> <description>
|
||
|
|
*
|
||
|
|
* Kevin.z 2008.03.25 0.1 build the file
|
||
|
|
* penggang 2009.09.09 0.2 modify the file
|
||
|
|
*
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
#ifndef __NAND_PHYSIC_H__
|
||
|
|
#define __NAND_PHYSIC_H__
|
||
|
|
|
||
|
|
#include "nand_type_spinand.h"
|
||
|
|
|
||
|
|
//==============================================================================
|
||
|
|
extern struct __NandStorageInfo_t NandStorageInfo;
|
||
|
|
extern struct __NandPageCachePool_t PageCachePool;
|
||
|
|
//==============================================================================
|
||
|
|
|
||
|
|
//==============================================================================
|
||
|
|
// define the physical archictecture export parameter
|
||
|
|
//==============================================================================
|
||
|
|
|
||
|
|
// define the Ecc Mode
|
||
|
|
#define ECC_MODE (NandStorageInfo.EccMode)
|
||
|
|
|
||
|
|
// define the DDR tyep
|
||
|
|
//#define DDR_TYPE (NandStorageInfo.DDRType)
|
||
|
|
|
||
|
|
// define the sector count of a single physical page
|
||
|
|
#define SECTOR_CNT_OF_SINGLE_PAGE (NandStorageInfo.SectorCntPerPage)
|
||
|
|
|
||
|
|
// define the sector count of a super physical page, the super page may be based
|
||
|
|
// on multi-plane
|
||
|
|
#define SECTOR_CNT_OF_SUPER_PAGE \
|
||
|
|
(NandStorageInfo.SectorCntPerPage * NandStorageInfo.PlaneCntPerDie)
|
||
|
|
|
||
|
|
// define the sector bitmap for a single page
|
||
|
|
#define FULL_BITMAP_OF_SINGLE_PAGE \
|
||
|
|
((__u32)(((__u32)1 << (SECTOR_CNT_OF_SINGLE_PAGE - 1)) | \
|
||
|
|
(((__u32)1 << (SECTOR_CNT_OF_SINGLE_PAGE - 1)) - 1)))
|
||
|
|
|
||
|
|
// define the sector bitmap for a super page, the sector count of a super page
|
||
|
|
// may be equal to 32
|
||
|
|
#define FULL_BITMAP_OF_SUPER_PAGE \
|
||
|
|
((__u64)(((__u64)1 << (SECTOR_CNT_OF_SUPER_PAGE - 1)) | \
|
||
|
|
(((__u64)1 << (SECTOR_CNT_OF_SUPER_PAGE - 1)) - 1)))
|
||
|
|
|
||
|
|
// define the block number offset for the multi-plane operation
|
||
|
|
#define MULTI_PLANE_BLOCK_OFFSET (NandStorageInfo.MultiPlaneBlockOffset)
|
||
|
|
|
||
|
|
// define the position of the bad block flag in a physical block
|
||
|
|
#define BAD_BLOCK_FLAG_PST (NandStorageInfo.pagewithbadflag)
|
||
|
|
|
||
|
|
// define if the nand flash can support multi-plane read operation
|
||
|
|
#define SUPPORT_MULTI_READ (SPINAND_MULTI_READ & NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define if the nand flash can support multi-plane program operation
|
||
|
|
#define SUPPORT_MULTI_PROGRAM \
|
||
|
|
(SPINAND_MULTI_PROGRAM & NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define if the nand flash can support page copy-back with command operation
|
||
|
|
//#define SUPPORT_PAGE_COPYBACK (NAND_PAGE_COPYBACK &
|
||
|
|
//NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define if the nand flash system can support external __s32er-leave operation
|
||
|
|
#define SUPPORT_EXT_INTERLEAVE \
|
||
|
|
(SPINAND_EXT_INTERLEAVE & NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
#if 0
|
||
|
|
//define if the nand flash require to skip die addr
|
||
|
|
#define SUPPORT_LOG_BLOCK_MANAGE \
|
||
|
|
(NAND_LOG_BLOCK_MANAGE & NandStorageInfo.OperationOpt)
|
||
|
|
#define LOG_BLOCK_LSB_PAGE_TYPE \
|
||
|
|
((NAND_LOG_BLOCK_LSB_TYPE & NandStorageInfo.OperationOpt) >> 16)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// define if the nand flash require to skip die addr
|
||
|
|
//#define SUPPORT_WRITE_CHECK_SYNC (NAND_FORCE_WRITE_SYNC &
|
||
|
|
//NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define if the nand flash requre to user max block erase cnt
|
||
|
|
#define SUPPORT_USE_MAX_BLK_ERASE_CNT \
|
||
|
|
(SPINAND_MAX_BLK_ERASE_CNT & NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define if the nand flash requre to do read reclaim operation
|
||
|
|
#define SUPPORT_READ_RECLAIM \
|
||
|
|
(SPINAND_READ_RECLAIM & NandStorageInfo.OperationOpt)
|
||
|
|
|
||
|
|
// define the count of the nand flash DIE in a nand flash chip
|
||
|
|
#define DIE_CNT_OF_CHIP (NandStorageInfo.DieCntPerChip)
|
||
|
|
|
||
|
|
// define the count of the nand flash bank in a nand flas hchip
|
||
|
|
#define BNK_CNT_OF_CHIP (NandStorageInfo.BankCntPerChip)
|
||
|
|
|
||
|
|
// define the Rb connect Mode
|
||
|
|
#define CONNECT_MODE (NandStorageInfo.ConnectMode)
|
||
|
|
|
||
|
|
// define the count of the total nand flash bank in the nand flash storage
|
||
|
|
// system
|
||
|
|
#define TOTAL_BANK_CNT \
|
||
|
|
(NandStorageInfo.BankCntPerChip * NandStorageInfo.ChipCnt)
|
||
|
|
|
||
|
|
// define the count of the physical block in a nand flash DIE
|
||
|
|
#define BLOCK_CNT_OF_DIE (NandStorageInfo.BlkCntPerDie)
|
||
|
|
|
||
|
|
// define the count of the nand flash plane in a nand flash DIE
|
||
|
|
#define PLANE_CNT_OF_DIE (NandStorageInfo.PlaneCntPerDie)
|
||
|
|
|
||
|
|
// define the count of the physical page in a physical block
|
||
|
|
#define PAGE_CNT_OF_PHY_BLK (NandStorageInfo.PageCntPerPhyBlk)
|
||
|
|
|
||
|
|
// define the information of the nand chip connect in the nand storage system
|
||
|
|
#define CHIP_CONNECT_INFO (NandStorageInfo.ChipConnectInfo)
|
||
|
|
|
||
|
|
// define the nand flash access frequence parameter
|
||
|
|
#define NAND_ACCESS_FREQUENCE (NandStorageInfo.FrequencePar)
|
||
|
|
|
||
|
|
#define BAD_BLK_FLAG_PST (NandStorageInfo.pagewithbadflag)
|
||
|
|
|
||
|
|
// define the page cache for physical module processing page data
|
||
|
|
#define PHY_TMP_PAGE_CACHE (PageCachePool.PageCache0)
|
||
|
|
|
||
|
|
// define the spare data cache for physical module processing spare area data
|
||
|
|
#define PHY_TMP_SPARE_CACHE (PageCachePool.SpareCache)
|
||
|
|
//==============================================================================
|
||
|
|
// define the functions __s32erface for the physic operation module
|
||
|
|
//==============================================================================
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* INIT NAND FLASH DRIVER PHYSICAL MODULE
|
||
|
|
*
|
||
|
|
* Description: init nand flash driver physical module.
|
||
|
|
*
|
||
|
|
* Aguments : none
|
||
|
|
*
|
||
|
|
* Returns : the resutl of initial.
|
||
|
|
* = 0 initiate successful;
|
||
|
|
* = -1 initiate failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_Init(void);
|
||
|
|
__s32 PHY_ChangeMode(void);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* NAND FLASH DRIVER PHYSICAL MODULE EXIT
|
||
|
|
*
|
||
|
|
* Description: nand flash driver physical module exit.
|
||
|
|
*
|
||
|
|
* Aguments : none
|
||
|
|
*
|
||
|
|
* Returns : the resutl of exit.
|
||
|
|
* = 0 exit successful;
|
||
|
|
* = -1 exit failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_Exit(void);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* RESET ONE NAND FLASH CHIP
|
||
|
|
*
|
||
|
|
*Description: Reset the given nand chip;
|
||
|
|
*
|
||
|
|
*Arguments : nChip the chip select number, which need be reset.
|
||
|
|
*
|
||
|
|
*Return : the result of chip reset;
|
||
|
|
* = 0 reset nand chip successful;
|
||
|
|
* = -1 reset nand chip failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_ResetChip(__u32 nChip);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* READ NAND FLASH ID
|
||
|
|
*
|
||
|
|
*Description: Read nand flash ID from the given nand chip.
|
||
|
|
*
|
||
|
|
*Arguments : nChip the chip number whoes ID need be read;
|
||
|
|
* pChipID the po__s32er to the chip ID buffer.
|
||
|
|
*
|
||
|
|
*Return : read nand chip ID result;
|
||
|
|
* = 0 read chip ID successful, the chip ID has been stored in
|
||
|
|
*given buffer;
|
||
|
|
* = -1 read chip ID failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_ReadNandId_0(__s32 nChip, void *pChipID);
|
||
|
|
__s32 PHY_ReadNandId_1(__s32 nChip, void *pChipID);
|
||
|
|
//__s32 PHY_ReadNandUniqueId(__s32 bank, void *pChipID);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* CHECK WRITE PROTECT STATUS
|
||
|
|
*
|
||
|
|
*Description: check the status of write protect.
|
||
|
|
*
|
||
|
|
*Arguments : nChip the number of chip, which nand chip need be checked.
|
||
|
|
*
|
||
|
|
*Return : the result of status check;
|
||
|
|
* = 0 the nand flash is not write proteced;
|
||
|
|
* = 1 the nand flash is write proteced;
|
||
|
|
* = -1 check status failed.
|
||
|
|
*******************************************************************************
|
||
|
|
*/
|
||
|
|
//__s32 PHY_CheckWp(__u32 nChip);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* PHYSICAL BLOCK ERASE
|
||
|
|
*
|
||
|
|
*Description: Erase one nand flash physical block.
|
||
|
|
*
|
||
|
|
*Arguments : pBlkAdr the parameter of the physical block which need be
|
||
|
|
*erased.
|
||
|
|
*
|
||
|
|
*Return : the result of the block erase;
|
||
|
|
* = 0 erase physical block successful;
|
||
|
|
* = -1 erase physical block failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_BlockErase(struct __PhysicOpPara_t *pBlkAdr);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* READ NAND FLASH PHYSICAL PAGE DATA
|
||
|
|
*
|
||
|
|
*Description: Read a page from a nand flash physical page to buffer.
|
||
|
|
*
|
||
|
|
*Arguments : pPageAdr the po__s32er to the accessed page parameter.
|
||
|
|
*
|
||
|
|
*Return : the result of physical page read;
|
||
|
|
* = 0 read physical page successful;
|
||
|
|
* > 0 read physical page successful, but need do some process;
|
||
|
|
* < 0 read physical page failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_PageRead(struct __PhysicOpPara_t *pPageAdr);
|
||
|
|
|
||
|
|
__s32 PHY_PageReadSpare(struct __PhysicOpPara_t *pPageAdr);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* WRITE NAND FLASH PHYSICAL PAGE DATA
|
||
|
|
*
|
||
|
|
*Description: Write a page from buffer to a nand flash physical page.
|
||
|
|
*
|
||
|
|
*Arguments : pPageAdr the po__s32er to the accessed page parameter.
|
||
|
|
*
|
||
|
|
*Return : The result of the page write;
|
||
|
|
* = 0 page write successful;
|
||
|
|
* > 0 page write successful, but need do some process;
|
||
|
|
* < 0 page write failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_PageWrite(struct __PhysicOpPara_t *pPageAdr);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* PHYSIC PAGE COPY-BACK
|
||
|
|
*
|
||
|
|
*Description: copy one physical page from one physical block to
|
||
|
|
*another physical block.
|
||
|
|
*
|
||
|
|
*Arguments : pSrcPage the parameter of the source page which need be
|
||
|
|
*copied;
|
||
|
|
* pDstPage the parameter of the destination page which copied
|
||
|
|
*to.
|
||
|
|
*
|
||
|
|
*Return : the result of the page copy-back;
|
||
|
|
* = 0 page copy-back successful;
|
||
|
|
* = -1 page copy-back failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_PageCopyback(struct __PhysicOpPara_t *pSrcPage,
|
||
|
|
struct __PhysicOpPara_t *pDstPage);
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* SYNCH NAND FLASH PHYSIC OPERATION
|
||
|
|
*
|
||
|
|
*Description: Synch nand flash operation, check nand flash program/erase
|
||
|
|
*operation status.
|
||
|
|
*
|
||
|
|
*Arguments : nBank the number of the bank which need be synchronized;
|
||
|
|
* bMode the type of synch,
|
||
|
|
* = 0 synch the chip which the bank belonged to,
|
||
|
|
* wait the whole chip
|
||
|
|
* to be ready, and report status. if the chip
|
||
|
|
*support cacheprogram,
|
||
|
|
* need check if the chip is true ready;
|
||
|
|
* = 1 only synch the the bank, wait the bank ready and
|
||
|
|
*report the status,
|
||
|
|
* if the chip support cache program, need not
|
||
|
|
*check if the cache is
|
||
|
|
* true ready.
|
||
|
|
*
|
||
|
|
*Return : the result of synch;
|
||
|
|
* = 0 synch nand flash successful, nand operation ok;
|
||
|
|
* = -1 synch nand flash failed.
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
__s32 PHY_Wait_Status(__u32 chip);
|
||
|
|
|
||
|
|
__s32 PHY_SimpleWrite(struct boot_physical_param *writeop);
|
||
|
|
__s32 PHY_SimpleRead(struct boot_physical_param *readop);
|
||
|
|
|
||
|
|
#endif // ifnedf __NAND_PHYSIC_H__
|