forked from luck/tmp_suning_uos_patched
e99d8b089a
Implement a new ioctl for writing both page data and OOB to flash at the same time. This ioctl is intended to be a generic interface that can replace other ioctls (MEMWRITEOOB and MEMWRITEOOB64) and cover the functionality of several other old ones, e.g., MEMWRITE can: * write autoplaced OOB instead of using ECCGETLAYOUT (deprecated) and working around the reserved areas * write raw (no ECC) OOB instead of using MTDFILEMODE to set the per-file-descriptor MTD_FILE_MODE_RAW * write raw (no ECC) data instead of using MTDFILEMODE (MTD_FILE_MODE_RAW) and using standard character device "write" This ioctl is especially useful for MLC NAND, which cannot be written twice (i.e., we cannot successfully write the page data and OOB in two separate operations). Instead, MEMWRITE can write both in a single operation. Note that this ioctl is not affected by the MTD file mode (i.e., MTD_FILE_MODE_RAW vs. MTD_FILE_MODE_NORMAL), since it receives its write mode as an input parameter. Signed-off-by: Brian Norris <computersforpeace@gmail.com> Signed-off-by: Artem Bityutskiy <artem.bityutskiy@intel.com>
221 lines
6.4 KiB
C
221 lines
6.4 KiB
C
/*
|
|
* Copyright © 1999-2010 David Woodhouse <dwmw2@infradead.org> et al.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* 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.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*
|
|
*/
|
|
|
|
#ifndef __MTD_ABI_H__
|
|
#define __MTD_ABI_H__
|
|
|
|
#include <linux/types.h>
|
|
|
|
struct erase_info_user {
|
|
__u32 start;
|
|
__u32 length;
|
|
};
|
|
|
|
struct erase_info_user64 {
|
|
__u64 start;
|
|
__u64 length;
|
|
};
|
|
|
|
struct mtd_oob_buf {
|
|
__u32 start;
|
|
__u32 length;
|
|
unsigned char __user *ptr;
|
|
};
|
|
|
|
struct mtd_oob_buf64 {
|
|
__u64 start;
|
|
__u32 pad;
|
|
__u32 length;
|
|
__u64 usr_ptr;
|
|
};
|
|
|
|
/*
|
|
* MTD operation modes
|
|
*
|
|
* MTD_OPS_PLACE_OOB: oob data are placed at the given offset (default)
|
|
* MTD_OPS_AUTO_OOB: oob data are automatically placed at the free areas
|
|
* which are defined by the internal ecclayout
|
|
* MTD_OPS_RAW: mode to read or write oob and data without doing ECC
|
|
* checking
|
|
*/
|
|
enum {
|
|
MTD_OPS_PLACE_OOB = 0,
|
|
MTD_OPS_AUTO_OOB = 1,
|
|
MTD_OPS_RAW = 2,
|
|
};
|
|
|
|
struct mtd_write_req {
|
|
__u64 start;
|
|
__u64 len;
|
|
__u64 ooblen;
|
|
__u64 usr_data;
|
|
__u64 usr_oob;
|
|
__u8 mode;
|
|
__u8 padding[7];
|
|
};
|
|
|
|
#define MTD_ABSENT 0
|
|
#define MTD_RAM 1
|
|
#define MTD_ROM 2
|
|
#define MTD_NORFLASH 3
|
|
#define MTD_NANDFLASH 4
|
|
#define MTD_DATAFLASH 6
|
|
#define MTD_UBIVOLUME 7
|
|
#define MTD_MLCNANDFLASH 8
|
|
|
|
#define MTD_WRITEABLE 0x400 /* Device is writeable */
|
|
#define MTD_BIT_WRITEABLE 0x800 /* Single bits can be flipped */
|
|
#define MTD_NO_ERASE 0x1000 /* No erase necessary */
|
|
#define MTD_POWERUP_LOCK 0x2000 /* Always locked after reset */
|
|
|
|
// Some common devices / combinations of capabilities
|
|
#define MTD_CAP_ROM 0
|
|
#define MTD_CAP_RAM (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
|
|
#define MTD_CAP_NORFLASH (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
|
|
#define MTD_CAP_NANDFLASH (MTD_WRITEABLE)
|
|
|
|
/* ECC byte placement */
|
|
#define MTD_NANDECC_OFF 0 // Switch off ECC (Not recommended)
|
|
#define MTD_NANDECC_PLACE 1 // Use the given placement in the structure (YAFFS1 legacy mode)
|
|
#define MTD_NANDECC_AUTOPLACE 2 // Use the default placement scheme
|
|
#define MTD_NANDECC_PLACEONLY 3 // Use the given placement in the structure (Do not store ecc result on read)
|
|
#define MTD_NANDECC_AUTOPL_USR 4 // Use the given autoplacement scheme rather than using the default
|
|
|
|
/* OTP mode selection */
|
|
#define MTD_OTP_OFF 0
|
|
#define MTD_OTP_FACTORY 1
|
|
#define MTD_OTP_USER 2
|
|
|
|
struct mtd_info_user {
|
|
__u8 type;
|
|
__u32 flags;
|
|
__u32 size; // Total size of the MTD
|
|
__u32 erasesize;
|
|
__u32 writesize;
|
|
__u32 oobsize; // Amount of OOB data per block (e.g. 16)
|
|
/* The below two fields are obsolete and broken, do not use them
|
|
* (TODO: remove at some point) */
|
|
__u32 ecctype;
|
|
__u32 eccsize;
|
|
};
|
|
|
|
struct region_info_user {
|
|
__u32 offset; /* At which this region starts,
|
|
* from the beginning of the MTD */
|
|
__u32 erasesize; /* For this region */
|
|
__u32 numblocks; /* Number of blocks in this region */
|
|
__u32 regionindex;
|
|
};
|
|
|
|
struct otp_info {
|
|
__u32 start;
|
|
__u32 length;
|
|
__u32 locked;
|
|
};
|
|
|
|
/*
|
|
* Note, the following ioctl existed in the past and was removed:
|
|
* #define MEMSETOOBSEL _IOW('M', 9, struct nand_oobinfo)
|
|
* Try to avoid adding a new ioctl with the same ioctl number.
|
|
*/
|
|
|
|
#define MEMGETINFO _IOR('M', 1, struct mtd_info_user)
|
|
#define MEMERASE _IOW('M', 2, struct erase_info_user)
|
|
#define MEMWRITEOOB _IOWR('M', 3, struct mtd_oob_buf)
|
|
#define MEMREADOOB _IOWR('M', 4, struct mtd_oob_buf)
|
|
#define MEMLOCK _IOW('M', 5, struct erase_info_user)
|
|
#define MEMUNLOCK _IOW('M', 6, struct erase_info_user)
|
|
#define MEMGETREGIONCOUNT _IOR('M', 7, int)
|
|
#define MEMGETREGIONINFO _IOWR('M', 8, struct region_info_user)
|
|
#define MEMGETOOBSEL _IOR('M', 10, struct nand_oobinfo)
|
|
#define MEMGETBADBLOCK _IOW('M', 11, __kernel_loff_t)
|
|
#define MEMSETBADBLOCK _IOW('M', 12, __kernel_loff_t)
|
|
#define OTPSELECT _IOR('M', 13, int)
|
|
#define OTPGETREGIONCOUNT _IOW('M', 14, int)
|
|
#define OTPGETREGIONINFO _IOW('M', 15, struct otp_info)
|
|
#define OTPLOCK _IOR('M', 16, struct otp_info)
|
|
#define ECCGETLAYOUT _IOR('M', 17, struct nand_ecclayout_user)
|
|
#define ECCGETSTATS _IOR('M', 18, struct mtd_ecc_stats)
|
|
#define MTDFILEMODE _IO('M', 19)
|
|
#define MEMERASE64 _IOW('M', 20, struct erase_info_user64)
|
|
#define MEMWRITEOOB64 _IOWR('M', 21, struct mtd_oob_buf64)
|
|
#define MEMREADOOB64 _IOWR('M', 22, struct mtd_oob_buf64)
|
|
#define MEMISLOCKED _IOR('M', 23, struct erase_info_user)
|
|
#define MEMWRITE _IOWR('M', 24, struct mtd_write_req)
|
|
|
|
/*
|
|
* Obsolete legacy interface. Keep it in order not to break userspace
|
|
* interfaces
|
|
*/
|
|
struct nand_oobinfo {
|
|
__u32 useecc;
|
|
__u32 eccbytes;
|
|
__u32 oobfree[8][2];
|
|
__u32 eccpos[32];
|
|
};
|
|
|
|
struct nand_oobfree {
|
|
__u32 offset;
|
|
__u32 length;
|
|
};
|
|
|
|
#define MTD_MAX_OOBFREE_ENTRIES 8
|
|
#define MTD_MAX_ECCPOS_ENTRIES 64
|
|
/*
|
|
* OBSOLETE: ECC layout control structure. Exported to user-space via ioctl
|
|
* ECCGETLAYOUT for backwards compatbility and should not be mistaken as a
|
|
* complete set of ECC information. The ioctl truncates the larger internal
|
|
* structure to retain binary compatibility with the static declaration of the
|
|
* ioctl. Note that the "MTD_MAX_..._ENTRIES" macros represent the max size of
|
|
* the user struct, not the MAX size of the internal struct nand_ecclayout.
|
|
*/
|
|
struct nand_ecclayout_user {
|
|
__u32 eccbytes;
|
|
__u32 eccpos[MTD_MAX_ECCPOS_ENTRIES];
|
|
__u32 oobavail;
|
|
struct nand_oobfree oobfree[MTD_MAX_OOBFREE_ENTRIES];
|
|
};
|
|
|
|
/**
|
|
* struct mtd_ecc_stats - error correction stats
|
|
*
|
|
* @corrected: number of corrected bits
|
|
* @failed: number of uncorrectable errors
|
|
* @badblocks: number of bad blocks in this partition
|
|
* @bbtblocks: number of blocks reserved for bad block tables
|
|
*/
|
|
struct mtd_ecc_stats {
|
|
__u32 corrected;
|
|
__u32 failed;
|
|
__u32 badblocks;
|
|
__u32 bbtblocks;
|
|
};
|
|
|
|
/*
|
|
* Read/write file modes for access to MTD
|
|
*/
|
|
enum mtd_file_modes {
|
|
MTD_FILE_MODE_NORMAL = MTD_OTP_OFF,
|
|
MTD_FILE_MODE_OTP_FACTORY = MTD_OTP_FACTORY,
|
|
MTD_FILE_MODE_OTP_USER = MTD_OTP_USER,
|
|
MTD_FILE_MODE_RAW,
|
|
};
|
|
|
|
#endif /* __MTD_ABI_H__ */
|