blob: b6595b3c68b6f9117dbb582dab66e53d9daf7609 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Thomas Gleixnere4f06482005-11-07 11:15:37 +00002 * Portions of MTD ABI definition which are shared by kernel and user space
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 */
4
5#ifndef __MTD_ABI_H__
6#define __MTD_ABI_H__
7
Arnd Bergmannccef7ab2009-02-26 00:51:41 +01008#include <linux/types.h>
9
Linus Torvalds1da177e2005-04-16 15:20:36 -070010struct erase_info_user {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010011 __u32 start;
12 __u32 length;
Linus Torvalds1da177e2005-04-16 15:20:36 -070013};
14
15struct mtd_oob_buf {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010016 __u32 start;
17 __u32 length;
Linus Torvalds1da177e2005-04-16 15:20:36 -070018 unsigned char __user *ptr;
19};
20
21#define MTD_ABSENT 0
David Woodhouse21c8db92006-06-14 21:39:48 +010022#define MTD_RAM 1
23#define MTD_ROM 2
Linus Torvalds1da177e2005-04-16 15:20:36 -070024#define MTD_NORFLASH 3
25#define MTD_NANDFLASH 4
Andrew Victor8f15fd52005-02-09 09:17:45 +000026#define MTD_DATAFLASH 6
Artem B. Bityutskiy801c1352006-06-27 12:22:22 +040027#define MTD_UBIVOLUME 7
Linus Torvalds1da177e2005-04-16 15:20:36 -070028
Joern Engel8ca9ed52006-05-22 23:17:23 +020029#define MTD_WRITEABLE 0x400 /* Device is writeable */
Joern Engel5fa43392006-05-22 23:18:29 +020030#define MTD_BIT_WRITEABLE 0x800 /* Single bits can be flipped */
Joern Engel92cbfdc2006-05-30 14:25:24 +020031#define MTD_NO_ERASE 0x1000 /* No erase necessary */
Justin Treone619a752008-01-30 10:25:49 -080032#define MTD_POWERUP_LOCK 0x2000 /* Always locked after reset */
Linus Torvalds1da177e2005-04-16 15:20:36 -070033
34// Some common devices / combinations of capabilities
35#define MTD_CAP_ROM 0
Joern Engel92cbfdc2006-05-30 14:25:24 +020036#define MTD_CAP_RAM (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
Joern Engel5fa43392006-05-22 23:18:29 +020037#define MTD_CAP_NORFLASH (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
Joern Engel8ca9ed52006-05-22 23:17:23 +020038#define MTD_CAP_NANDFLASH (MTD_WRITEABLE)
Linus Torvalds1da177e2005-04-16 15:20:36 -070039
Linus Torvalds1da177e2005-04-16 15:20:36 -070040/* ECC byte placement */
41#define MTD_NANDECC_OFF 0 // Switch off ECC (Not recommended)
42#define MTD_NANDECC_PLACE 1 // Use the given placement in the structure (YAFFS1 legacy mode)
43#define MTD_NANDECC_AUTOPLACE 2 // Use the default placement scheme
44#define MTD_NANDECC_PLACEONLY 3 // Use the given placement in the structure (Do not store ecc result on read)
Thomas Gleixner90e260c2005-05-19 17:10:26 +010045#define MTD_NANDECC_AUTOPL_USR 4 // Use the given autoplacement scheme rather than using the default
Linus Torvalds1da177e2005-04-16 15:20:36 -070046
Nicolas Pitre31f42332005-02-08 17:45:55 +000047/* OTP mode selection */
48#define MTD_OTP_OFF 0
49#define MTD_OTP_FACTORY 1
50#define MTD_OTP_USER 2
51
Linus Torvalds1da177e2005-04-16 15:20:36 -070052struct mtd_info_user {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010053 __u8 type;
54 __u32 flags;
55 __u32 size; // Total size of the MTD
56 __u32 erasesize;
57 __u32 writesize;
58 __u32 oobsize; // Amount of OOB data per block (e.g. 16)
Artem Bityutskiy64f60712007-01-30 10:50:43 +020059 /* The below two fields are obsolete and broken, do not use them
60 * (TODO: remove at some point) */
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010061 __u32 ecctype;
62 __u32 eccsize;
Linus Torvalds1da177e2005-04-16 15:20:36 -070063};
64
65struct region_info_user {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010066 __u32 offset; /* At which this region starts,
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 * from the beginning of the MTD */
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010068 __u32 erasesize; /* For this region */
69 __u32 numblocks; /* Number of blocks in this region */
70 __u32 regionindex;
Linus Torvalds1da177e2005-04-16 15:20:36 -070071};
72
Nicolas Pitref77814d2005-02-08 17:11:19 +000073struct otp_info {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +010074 __u32 start;
75 __u32 length;
76 __u32 locked;
Nicolas Pitref77814d2005-02-08 17:11:19 +000077};
78
Thomas Gleixner5bd34c02006-05-27 22:16:10 +020079#define MEMGETINFO _IOR('M', 1, struct mtd_info_user)
80#define MEMERASE _IOW('M', 2, struct erase_info_user)
81#define MEMWRITEOOB _IOWR('M', 3, struct mtd_oob_buf)
82#define MEMREADOOB _IOWR('M', 4, struct mtd_oob_buf)
83#define MEMLOCK _IOW('M', 5, struct erase_info_user)
84#define MEMUNLOCK _IOW('M', 6, struct erase_info_user)
Linus Torvalds1da177e2005-04-16 15:20:36 -070085#define MEMGETREGIONCOUNT _IOR('M', 7, int)
86#define MEMGETREGIONINFO _IOWR('M', 8, struct region_info_user)
87#define MEMSETOOBSEL _IOW('M', 9, struct nand_oobinfo)
88#define MEMGETOOBSEL _IOR('M', 10, struct nand_oobinfo)
Arnd Bergmann85efde62009-02-26 00:51:39 +010089#define MEMGETBADBLOCK _IOW('M', 11, __kernel_loff_t)
90#define MEMSETBADBLOCK _IOW('M', 12, __kernel_loff_t)
Nicolas Pitre31f42332005-02-08 17:45:55 +000091#define OTPSELECT _IOR('M', 13, int)
92#define OTPGETREGIONCOUNT _IOW('M', 14, int)
93#define OTPGETREGIONINFO _IOW('M', 15, struct otp_info)
Thomas Gleixner5bd34c02006-05-27 22:16:10 +020094#define OTPLOCK _IOR('M', 16, struct otp_info)
95#define ECCGETLAYOUT _IOR('M', 17, struct nand_ecclayout)
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +020096#define ECCGETSTATS _IOR('M', 18, struct mtd_ecc_stats)
97#define MTDFILEMODE _IO('M', 19)
Linus Torvalds1da177e2005-04-16 15:20:36 -070098
Thomas Gleixner5bd34c02006-05-27 22:16:10 +020099/*
100 * Obsolete legacy interface. Keep it in order not to break userspace
101 * interfaces
102 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103struct nand_oobinfo {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +0100104 __u32 useecc;
105 __u32 eccbytes;
106 __u32 oobfree[8][2];
107 __u32 eccpos[32];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108};
109
Thomas Gleixner5bd34c02006-05-27 22:16:10 +0200110struct nand_oobfree {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +0100111 __u32 offset;
112 __u32 length;
Thomas Gleixner5bd34c02006-05-27 22:16:10 +0200113};
114
115#define MTD_MAX_OOBFREE_ENTRIES 8
116/*
117 * ECC layout control structure. Exported to userspace for
118 * diagnosis and to allow creation of raw images
119 */
120struct nand_ecclayout {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +0100121 __u32 eccbytes;
122 __u32 eccpos[64];
123 __u32 oobavail;
Thomas Gleixner5bd34c02006-05-27 22:16:10 +0200124 struct nand_oobfree oobfree[MTD_MAX_OOBFREE_ENTRIES];
125};
126
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200127/**
Randy Dunlapea9b6dc2006-06-28 21:48:38 -0700128 * struct mtd_ecc_stats - error correction stats
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200129 *
130 * @corrected: number of corrected bits
131 * @failed: number of uncorrectable errors
132 * @badblocks: number of bad blocks in this partition
133 * @bbtblocks: number of blocks reserved for bad block tables
134 */
135struct mtd_ecc_stats {
Arnd Bergmannccef7ab2009-02-26 00:51:41 +0100136 __u32 corrected;
137 __u32 failed;
138 __u32 badblocks;
139 __u32 bbtblocks;
Thomas Gleixnerf1a28c02006-05-30 00:37:34 +0200140};
141
142/*
143 * Read/write file modes for access to MTD
144 */
145enum mtd_file_modes {
146 MTD_MODE_NORMAL = MTD_OTP_OFF,
147 MTD_MODE_OTP_FACTORY = MTD_OTP_FACTORY,
148 MTD_MODE_OTP_USER = MTD_OTP_USER,
149 MTD_MODE_RAW,
150};
151
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152#endif /* __MTD_ABI_H__ */