diff options
author | Alex Dubov <oakad@yahoo.com> | 2008-02-09 13:20:54 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@woody.linux-foundation.org> | 2008-02-09 14:08:34 -0500 |
commit | baf8532a147d5b76681ce040e2c8f25a3f0e718d (patch) | |
tree | 69c228046709295c1152f2063321327789c3b9f4 /include/linux/memstick.h | |
parent | 941edd030b9725f9f85bd62dfdb68cde3a50fb66 (diff) |
memstick: initial commit for Sony MemoryStick support
Sony MemoryStick cards are used in many products manufactured by Sony.
They are available both as storage and as IO expansion cards. Currently,
only MemoryStick Pro storage cards are supported via TI FlashMedia
MemoryStick interface.
[mboton@gmail.com: biuld fix]
[akpm@linux-foundation.org: build fix]
Signed-off-by: Alex Dubov <oakad@yahoo.com>
Signed-off-by: Miguel Boton <mboton@gmail.co>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'include/linux/memstick.h')
-rw-r--r-- | include/linux/memstick.h | 299 |
1 files changed, 299 insertions, 0 deletions
diff --git a/include/linux/memstick.h b/include/linux/memstick.h new file mode 100644 index 000000000000..334d059d6794 --- /dev/null +++ b/include/linux/memstick.h | |||
@@ -0,0 +1,299 @@ | |||
1 | /* | ||
2 | * Sony MemoryStick support | ||
3 | * | ||
4 | * Copyright (C) 2007 Alex Dubov <oakad@yahoo.com> | ||
5 | * | ||
6 | * This program is free software; you can redistribute it and/or modify | ||
7 | * it under the terms of the GNU General Public License version 2 as | ||
8 | * published by the Free Software Foundation. | ||
9 | * | ||
10 | */ | ||
11 | |||
12 | #ifndef _MEMSTICK_H | ||
13 | #define _MEMSTICK_H | ||
14 | |||
15 | #include <linux/workqueue.h> | ||
16 | #include <linux/scatterlist.h> | ||
17 | #include <linux/device.h> | ||
18 | |||
19 | /*** Hardware based structures ***/ | ||
20 | |||
21 | struct ms_status_register { | ||
22 | unsigned char reserved; | ||
23 | unsigned char interrupt; | ||
24 | #define MEMSTICK_INT_CMDNAK 0x0001 | ||
25 | #define MEMSTICK_INT_BREQ 0x0020 | ||
26 | #define MEMSTICK_INT_ERR 0x0040 | ||
27 | #define MEMSTICK_INT_CED 0x0080 | ||
28 | |||
29 | unsigned char status0; | ||
30 | #define MEMSTICK_STATUS0_WP 0x0001 | ||
31 | #define MEMSTICK_STATUS0_SL 0x0002 | ||
32 | #define MEMSTICK_STATUS0_BF 0x0010 | ||
33 | #define MEMSTICK_STATUS0_BE 0x0020 | ||
34 | #define MEMSTICK_STATUS0_FB0 0x0040 | ||
35 | #define MEMSTICK_STATUS0_MB 0x0080 | ||
36 | |||
37 | unsigned char status1; | ||
38 | #define MEMSTICK_STATUS1_UCFG 0x0001 | ||
39 | #define MEMSTICK_STATUS1_FGER 0x0002 | ||
40 | #define MEMSTICK_STATUS1_UCEX 0x0004 | ||
41 | #define MEMSTICK_STATUS1_EXER 0x0008 | ||
42 | #define MEMSTICK_STATUS1_UCDT 0x0010 | ||
43 | #define MEMSTICK_STATUS1_DTER 0x0020 | ||
44 | #define MEMSTICK_STATUS1_FBI 0x0040 | ||
45 | #define MEMSTICK_STATUS1_MB 0x0080 | ||
46 | } __attribute__((packed)); | ||
47 | |||
48 | struct ms_id_register { | ||
49 | unsigned char type; | ||
50 | unsigned char reserved; | ||
51 | unsigned char category; | ||
52 | unsigned char class; | ||
53 | } __attribute__((packed)); | ||
54 | |||
55 | struct ms_param_register { | ||
56 | unsigned char system; | ||
57 | unsigned char block_address_msb; | ||
58 | unsigned short block_address; | ||
59 | unsigned char cp; | ||
60 | #define MEMSTICK_CP_BLOCK 0x0000 | ||
61 | #define MEMSTICK_CP_PAGE 0x0020 | ||
62 | #define MEMSTICK_CP_EXTRA 0x0040 | ||
63 | #define MEMSTICK_CP_OVERWRITE 0x0080 | ||
64 | |||
65 | unsigned char page_address; | ||
66 | } __attribute__((packed)); | ||
67 | |||
68 | struct ms_extra_data_register { | ||
69 | unsigned char overwrite_flag; | ||
70 | #define MEMSTICK_OVERWRITE_UPDATA 0x0010 | ||
71 | #define MEMSTICK_OVERWRITE_PAGE 0x0060 | ||
72 | #define MEMSTICK_OVERWRITE_BLOCK 0x0080 | ||
73 | |||
74 | unsigned char management_flag; | ||
75 | #define MEMSTICK_MANAGEMENT_SYSTEM 0x0004 | ||
76 | #define MEMSTICK_MANAGEMENT_TRANS_TABLE 0x0008 | ||
77 | #define MEMSTICK_MANAGEMENT_COPY 0x0010 | ||
78 | #define MEMSTICK_MANAGEMENT_ACCESS 0x0020 | ||
79 | |||
80 | unsigned short logical_address; | ||
81 | } __attribute__((packed)); | ||
82 | |||
83 | struct ms_register { | ||
84 | struct ms_status_register status; | ||
85 | struct ms_id_register id; | ||
86 | unsigned char reserved[8]; | ||
87 | struct ms_param_register param; | ||
88 | struct ms_extra_data_register extra_data; | ||
89 | } __attribute__((packed)); | ||
90 | |||
91 | struct mspro_param_register { | ||
92 | unsigned char system; | ||
93 | unsigned short data_count; | ||
94 | unsigned int data_address; | ||
95 | unsigned char cmd_param; | ||
96 | } __attribute__((packed)); | ||
97 | |||
98 | struct mspro_register { | ||
99 | struct ms_status_register status; | ||
100 | struct ms_id_register id; | ||
101 | unsigned char reserved[8]; | ||
102 | struct mspro_param_register param; | ||
103 | } __attribute__((packed)); | ||
104 | |||
105 | struct ms_register_addr { | ||
106 | unsigned char r_offset; | ||
107 | unsigned char r_length; | ||
108 | unsigned char w_offset; | ||
109 | unsigned char w_length; | ||
110 | } __attribute__((packed)); | ||
111 | |||
112 | enum { | ||
113 | MS_TPC_READ_LONG_DATA = 0x02, | ||
114 | MS_TPC_READ_SHORT_DATA = 0x03, | ||
115 | MS_TPC_READ_REG = 0x04, | ||
116 | MS_TPC_READ_IO_DATA = 0x05, /* unverified */ | ||
117 | MS_TPC_GET_INT = 0x07, | ||
118 | MS_TPC_SET_RW_REG_ADRS = 0x08, | ||
119 | MS_TPC_EX_SET_CMD = 0x09, | ||
120 | MS_TPC_WRITE_IO_DATA = 0x0a, /* unverified */ | ||
121 | MS_TPC_WRITE_REG = 0x0b, | ||
122 | MS_TPC_WRITE_SHORT_DATA = 0x0c, | ||
123 | MS_TPC_WRITE_LONG_DATA = 0x0d, | ||
124 | MS_TPC_SET_CMD = 0x0e | ||
125 | }; | ||
126 | |||
127 | enum { | ||
128 | MS_CMD_BLOCK_END = 0x33, | ||
129 | MS_CMD_RESET = 0x3c, | ||
130 | MS_CMD_BLOCK_WRITE = 0x55, | ||
131 | MS_CMD_SLEEP = 0x5a, | ||
132 | MS_CMD_BLOCK_ERASE = 0x99, | ||
133 | MS_CMD_BLOCK_READ = 0xaa, | ||
134 | MS_CMD_CLEAR_BUF = 0xc3, | ||
135 | MS_CMD_FLASH_STOP = 0xcc, | ||
136 | MSPRO_CMD_FORMAT = 0x10, | ||
137 | MSPRO_CMD_SLEEP = 0x11, | ||
138 | MSPRO_CMD_READ_DATA = 0x20, | ||
139 | MSPRO_CMD_WRITE_DATA = 0x21, | ||
140 | MSPRO_CMD_READ_ATRB = 0x24, | ||
141 | MSPRO_CMD_STOP = 0x25, | ||
142 | MSPRO_CMD_ERASE = 0x26, | ||
143 | MSPRO_CMD_SET_IBA = 0x46, | ||
144 | MSPRO_CMD_SET_IBD = 0x47 | ||
145 | /* | ||
146 | MSPRO_CMD_RESET | ||
147 | MSPRO_CMD_WAKEUP | ||
148 | MSPRO_CMD_IN_IO_DATA | ||
149 | MSPRO_CMD_OUT_IO_DATA | ||
150 | MSPRO_CMD_READ_IO_ATRB | ||
151 | MSPRO_CMD_IN_IO_FIFO | ||
152 | MSPRO_CMD_OUT_IO_FIFO | ||
153 | MSPRO_CMD_IN_IOM | ||
154 | MSPRO_CMD_OUT_IOM | ||
155 | */ | ||
156 | }; | ||
157 | |||
158 | /*** Driver structures and functions ***/ | ||
159 | |||
160 | #define MEMSTICK_PART_SHIFT 3 | ||
161 | |||
162 | enum memstick_param { MEMSTICK_POWER = 1, MEMSTICK_INTERFACE }; | ||
163 | |||
164 | #define MEMSTICK_POWER_OFF 0 | ||
165 | #define MEMSTICK_POWER_ON 1 | ||
166 | |||
167 | #define MEMSTICK_SERIAL 0 | ||
168 | #define MEMSTICK_PARALLEL 1 | ||
169 | |||
170 | struct memstick_host; | ||
171 | struct memstick_driver; | ||
172 | |||
173 | #define MEMSTICK_MATCH_ALL 0x01 | ||
174 | |||
175 | #define MEMSTICK_TYPE_LEGACY 0xff | ||
176 | #define MEMSTICK_TYPE_DUO 0x00 | ||
177 | #define MEMSTICK_TYPE_PRO 0x01 | ||
178 | |||
179 | #define MEMSTICK_CATEGORY_STORAGE 0xff | ||
180 | #define MEMSTICK_CATEGORY_STORAGE_DUO 0x00 | ||
181 | |||
182 | #define MEMSTICK_CLASS_GENERIC 0xff | ||
183 | #define MEMSTICK_CLASS_GENERIC_DUO 0x00 | ||
184 | |||
185 | |||
186 | struct memstick_device_id { | ||
187 | unsigned char match_flags; | ||
188 | unsigned char type; | ||
189 | unsigned char category; | ||
190 | unsigned char class; | ||
191 | }; | ||
192 | |||
193 | struct memstick_request { | ||
194 | unsigned char tpc; | ||
195 | unsigned char data_dir:1, | ||
196 | need_card_int:1, | ||
197 | get_int_reg:1, | ||
198 | io_type:2; | ||
199 | #define MEMSTICK_IO_NONE 0 | ||
200 | #define MEMSTICK_IO_VAL 1 | ||
201 | #define MEMSTICK_IO_SG 2 | ||
202 | |||
203 | unsigned char int_reg; | ||
204 | int error; | ||
205 | union { | ||
206 | struct scatterlist sg; | ||
207 | struct { | ||
208 | unsigned char data_len; | ||
209 | unsigned char data[15]; | ||
210 | }; | ||
211 | }; | ||
212 | }; | ||
213 | |||
214 | struct memstick_dev { | ||
215 | struct memstick_device_id id; | ||
216 | struct memstick_host *host; | ||
217 | struct ms_register_addr reg_addr; | ||
218 | struct completion mrq_complete; | ||
219 | struct memstick_request current_mrq; | ||
220 | |||
221 | /* Check that media driver is still willing to operate the device. */ | ||
222 | int (*check)(struct memstick_dev *card); | ||
223 | /* Get next request from the media driver. */ | ||
224 | int (*next_request)(struct memstick_dev *card, | ||
225 | struct memstick_request **mrq); | ||
226 | |||
227 | struct device dev; | ||
228 | }; | ||
229 | |||
230 | struct memstick_host { | ||
231 | struct mutex lock; | ||
232 | unsigned int id; | ||
233 | unsigned int caps; | ||
234 | #define MEMSTICK_CAP_PARALLEL 1 | ||
235 | #define MEMSTICK_CAP_AUTO_GET_INT 2 | ||
236 | |||
237 | struct work_struct media_checker; | ||
238 | struct class_device cdev; | ||
239 | |||
240 | struct memstick_dev *card; | ||
241 | unsigned int retries; | ||
242 | |||
243 | /* Notify the host that some requests are pending. */ | ||
244 | void (*request)(struct memstick_host *host); | ||
245 | /* Set host IO parameters (power, clock, etc). */ | ||
246 | void (*set_param)(struct memstick_host *host, | ||
247 | enum memstick_param param, | ||
248 | int value); | ||
249 | unsigned long private[0] ____cacheline_aligned; | ||
250 | }; | ||
251 | |||
252 | struct memstick_driver { | ||
253 | struct memstick_device_id *id_table; | ||
254 | int (*probe)(struct memstick_dev *card); | ||
255 | void (*remove)(struct memstick_dev *card); | ||
256 | int (*suspend)(struct memstick_dev *card, | ||
257 | pm_message_t state); | ||
258 | int (*resume)(struct memstick_dev *card); | ||
259 | |||
260 | struct device_driver driver; | ||
261 | }; | ||
262 | |||
263 | int memstick_register_driver(struct memstick_driver *drv); | ||
264 | void memstick_unregister_driver(struct memstick_driver *drv); | ||
265 | |||
266 | struct memstick_host *memstick_alloc_host(unsigned int extra, | ||
267 | struct device *dev); | ||
268 | |||
269 | int memstick_add_host(struct memstick_host *host); | ||
270 | void memstick_remove_host(struct memstick_host *host); | ||
271 | void memstick_free_host(struct memstick_host *host); | ||
272 | void memstick_detect_change(struct memstick_host *host); | ||
273 | |||
274 | void memstick_init_req_sg(struct memstick_request *mrq, unsigned char tpc, | ||
275 | struct scatterlist *sg); | ||
276 | void memstick_init_req(struct memstick_request *mrq, unsigned char tpc, | ||
277 | void *buf, size_t length); | ||
278 | int memstick_next_req(struct memstick_host *host, | ||
279 | struct memstick_request **mrq); | ||
280 | void memstick_new_req(struct memstick_host *host); | ||
281 | |||
282 | int memstick_set_rw_addr(struct memstick_dev *card); | ||
283 | |||
284 | static inline void *memstick_priv(struct memstick_host *host) | ||
285 | { | ||
286 | return (void *)host->private; | ||
287 | } | ||
288 | |||
289 | static inline void *memstick_get_drvdata(struct memstick_dev *card) | ||
290 | { | ||
291 | return dev_get_drvdata(&card->dev); | ||
292 | } | ||
293 | |||
294 | static inline void memstick_set_drvdata(struct memstick_dev *card, void *data) | ||
295 | { | ||
296 | dev_set_drvdata(&card->dev, data); | ||
297 | } | ||
298 | |||
299 | #endif | ||