/* SPDX-License-Identifier: GPL-2.0-only */ /* * linux/include/linux/mtd/onenand.h * * Copyright © 2005-2009 Samsung Electronics * Kyungmin Park <[email protected]> */ #ifndef __LINUX_MTD_ONENAND_H #define __LINUX_MTD_ONENAND_H #include <linux/spinlock.h> #include <linux/completion.h> #include <linux/mtd/flashchip.h> #include <linux/mtd/onenand_regs.h> #include <linux/mtd/bbm.h> #define MAX_DIES … #define MAX_BUFFERRAM … /* Scan and identify a OneNAND device */ extern int onenand_scan(struct mtd_info *mtd, int max_chips); /* Free resources held by the OneNAND device */ extern void onenand_release(struct mtd_info *mtd); /** * struct onenand_bufferram - OneNAND BufferRAM Data * @blockpage: block & page address in BufferRAM */ struct onenand_bufferram { … }; /** * struct onenand_chip - OneNAND Private Flash Chip Data * @base: [BOARDSPECIFIC] address to access OneNAND * @dies: [INTERN][FLEX-ONENAND] number of dies on chip * @boundary: [INTERN][FLEX-ONENAND] Boundary of the dies * @diesize: [INTERN][FLEX-ONENAND] Size of the dies * @chipsize: [INTERN] the size of one chip for multichip arrays * FIXME For Flex-OneNAND, chipsize holds maximum possible * device size ie when all blocks are considered MLC * @device_id: [INTERN] device ID * @density_mask: chip density, used for DDP devices * @verstion_id: [INTERN] version ID * @options: [BOARDSPECIFIC] various chip options. They can * partly be set to inform onenand_scan about * @erase_shift: [INTERN] number of address bits in a block * @page_shift: [INTERN] number of address bits in a page * @page_mask: [INTERN] a page per block mask * @writesize: [INTERN] a real page size * @bufferram_index: [INTERN] BufferRAM index * @bufferram: [INTERN] BufferRAM info * @readw: [REPLACEABLE] hardware specific function for read short * @writew: [REPLACEABLE] hardware specific function for write short * @command: [REPLACEABLE] hardware specific function for writing * commands to the chip * @wait: [REPLACEABLE] hardware specific function for wait on ready * @bbt_wait: [REPLACEABLE] hardware specific function for bbt wait on ready * @unlock_all: [REPLACEABLE] hardware specific function for unlock all * @read_bufferram: [REPLACEABLE] hardware specific function for BufferRAM Area * @write_bufferram: [REPLACEABLE] hardware specific function for BufferRAM Area * @read_word: [REPLACEABLE] hardware specific function for read * register of OneNAND * @write_word: [REPLACEABLE] hardware specific function for write * register of OneNAND * @mmcontrol: sync burst read function * @chip_probe: [REPLACEABLE] hardware specific function for chip probe * @block_markbad: function to mark a block as bad * @scan_bbt: [REPLACEALBE] hardware specific function for scanning * Bad block Table * @chip_lock: [INTERN] spinlock used to protect access to this * structure and the chip * @wq: [INTERN] wait queue to sleep on if a OneNAND * operation is in progress * @state: [INTERN] the current state of the OneNAND device * @page_buf: [INTERN] page main data buffer * @oob_buf: [INTERN] page oob data buffer * @subpagesize: [INTERN] holds the subpagesize * @bbm: [REPLACEABLE] pointer to Bad Block Management * @priv: [OPTIONAL] pointer to private chip date */ struct onenand_chip { … }; /* * Helper macros */ #define ONENAND_PAGES_PER_BLOCK … #define ONENAND_CURRENT_BUFFERRAM(this) … #define ONENAND_NEXT_BUFFERRAM(this) … #define ONENAND_SET_NEXT_BUFFERRAM(this) … #define ONENAND_SET_PREV_BUFFERRAM(this) … #define ONENAND_SET_BUFFERRAM0(this) … #define ONENAND_SET_BUFFERRAM1(this) … #define FLEXONENAND(this) … #define ONENAND_GET_SYS_CFG1(this) … #define ONENAND_SET_SYS_CFG1(v, this) … #define ONENAND_IS_DDP(this) … #define ONENAND_IS_MLC(this) … #ifdef CONFIG_MTD_ONENAND_2X_PROGRAM #define ONENAND_IS_2PLANE(this) … #else #define ONENAND_IS_2PLANE … #endif #define ONENAND_IS_CACHE_PROGRAM(this) … #define ONENAND_IS_NOP_1(this) … /* Check byte access in OneNAND */ #define ONENAND_CHECK_BYTE_ACCESS(addr) … #define ONENAND_BADBLOCK_POS … /* * Options bits */ #define ONENAND_HAS_CONT_LOCK … #define ONENAND_HAS_UNLOCK_ALL … #define ONENAND_HAS_2PLANE … #define ONENAND_HAS_4KB_PAGE … #define ONENAND_HAS_CACHE_PROGRAM … #define ONENAND_HAS_NOP_1 … #define ONENAND_SKIP_UNLOCK_CHECK … #define ONENAND_PAGEBUF_ALLOC … #define ONENAND_OOBBUF_ALLOC … #define ONENAND_SKIP_INITIAL_UNLOCKING … #define ONENAND_IS_4KB_PAGE(this) … /* * OneNAND Flash Manufacturer ID Codes */ #define ONENAND_MFR_SAMSUNG … #define ONENAND_MFR_NUMONYX … /** * struct onenand_manufacturers - NAND Flash Manufacturer ID Structure * @name: Manufacturer name * @id: manufacturer ID code of device. */ struct onenand_manufacturers { … }; int onenand_bbt_read_oob(struct mtd_info *mtd, loff_t from, struct mtd_oob_ops *ops); unsigned onenand_block(struct onenand_chip *this, loff_t addr); loff_t onenand_addr(struct onenand_chip *this, int block); int flexonenand_region(struct mtd_info *mtd, loff_t addr); struct mtd_partition; struct onenand_platform_data { … }; #endif /* __LINUX_MTD_ONENAND_H */
Codebase Browser
linux