]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - include/linux/memstick.h
memstick: introduce correct definitions in the header
[mirror_ubuntu-artful-kernel.git] / include / linux / memstick.h
CommitLineData
baf8532a
AD
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
21struct ms_status_register {
22 unsigned char reserved;
23 unsigned char interrupt;
24#define MEMSTICK_INT_CMDNAK 0x0001
e1f19995
AD
25#define MEMSTICK_INT_IOREQ 0x0008
26#define MEMSTICK_INT_IOBREQ 0x0010
baf8532a
AD
27#define MEMSTICK_INT_BREQ 0x0020
28#define MEMSTICK_INT_ERR 0x0040
29#define MEMSTICK_INT_CED 0x0080
30
31 unsigned char status0;
32#define MEMSTICK_STATUS0_WP 0x0001
33#define MEMSTICK_STATUS0_SL 0x0002
34#define MEMSTICK_STATUS0_BF 0x0010
35#define MEMSTICK_STATUS0_BE 0x0020
36#define MEMSTICK_STATUS0_FB0 0x0040
37#define MEMSTICK_STATUS0_MB 0x0080
38
39 unsigned char status1;
40#define MEMSTICK_STATUS1_UCFG 0x0001
41#define MEMSTICK_STATUS1_FGER 0x0002
42#define MEMSTICK_STATUS1_UCEX 0x0004
43#define MEMSTICK_STATUS1_EXER 0x0008
44#define MEMSTICK_STATUS1_UCDT 0x0010
45#define MEMSTICK_STATUS1_DTER 0x0020
46#define MEMSTICK_STATUS1_FBI 0x0040
47#define MEMSTICK_STATUS1_MB 0x0080
48} __attribute__((packed));
49
50struct ms_id_register {
51 unsigned char type;
e1f19995 52 unsigned char if_mode;
baf8532a
AD
53 unsigned char category;
54 unsigned char class;
55} __attribute__((packed));
56
57struct ms_param_register {
58 unsigned char system;
e1f19995
AD
59#define MEMSTICK_SYS_ATEN 0xc0
60#define MEMSTICK_SYS_BAMD 0x80
61#define MEMSTICK_SYS_PAM 0x08
62
baf8532a
AD
63 unsigned char block_address_msb;
64 unsigned short block_address;
65 unsigned char cp;
66#define MEMSTICK_CP_BLOCK 0x0000
67#define MEMSTICK_CP_PAGE 0x0020
68#define MEMSTICK_CP_EXTRA 0x0040
69#define MEMSTICK_CP_OVERWRITE 0x0080
70
71 unsigned char page_address;
72} __attribute__((packed));
73
74struct ms_extra_data_register {
75 unsigned char overwrite_flag;
76#define MEMSTICK_OVERWRITE_UPDATA 0x0010
77#define MEMSTICK_OVERWRITE_PAGE 0x0060
78#define MEMSTICK_OVERWRITE_BLOCK 0x0080
79
80 unsigned char management_flag;
81#define MEMSTICK_MANAGEMENT_SYSTEM 0x0004
82#define MEMSTICK_MANAGEMENT_TRANS_TABLE 0x0008
83#define MEMSTICK_MANAGEMENT_COPY 0x0010
84#define MEMSTICK_MANAGEMENT_ACCESS 0x0020
85
86 unsigned short logical_address;
87} __attribute__((packed));
88
89struct ms_register {
90 struct ms_status_register status;
91 struct ms_id_register id;
92 unsigned char reserved[8];
93 struct ms_param_register param;
94 struct ms_extra_data_register extra_data;
95} __attribute__((packed));
96
97struct mspro_param_register {
98 unsigned char system;
e1f19995
AD
99#define MEMSTICK_SYS_SERIAL 0x80
100#define MEMSTICK_SYS_PAR4 0x00
101#define MEMSTICK_SYS_PAR8 0x40
102
103 unsigned short data_count;
104 unsigned int data_address;
105 unsigned char tpc_param;
106} __attribute__((packed));
107
108struct mspro_io_info_register {
109 unsigned char version;
110 unsigned char io_category;
111 unsigned char current_req;
112 unsigned char card_opt_info;
113 unsigned char rdy_wait_time;
114} __attribute__((packed));
115
116struct mspro_io_func_register {
117 unsigned char func_enable;
118 unsigned char func_select;
119 unsigned char func_intmask;
120 unsigned char transfer_mode;
121} __attribute__((packed));
122
123struct mspro_io_cmd_register {
124 unsigned short tpc_param;
baf8532a
AD
125 unsigned short data_count;
126 unsigned int data_address;
baf8532a
AD
127} __attribute__((packed));
128
129struct mspro_register {
e1f19995
AD
130 struct ms_status_register status;
131 struct ms_id_register id;
132 unsigned char reserved0[8];
133 struct mspro_param_register param;
134 unsigned char reserved1[8];
135 struct mspro_io_info_register io_info;
136 struct mspro_io_func_register io_func;
137 unsigned char reserved2[7];
138 struct mspro_io_cmd_register io_cmd;
139 unsigned char io_int;
140 unsigned char io_int_func;
baf8532a
AD
141} __attribute__((packed));
142
143struct ms_register_addr {
144 unsigned char r_offset;
145 unsigned char r_length;
146 unsigned char w_offset;
147 unsigned char w_length;
148} __attribute__((packed));
149
150enum {
e1f19995 151 MS_TPC_READ_MG_STATUS = 0x01,
baf8532a
AD
152 MS_TPC_READ_LONG_DATA = 0x02,
153 MS_TPC_READ_SHORT_DATA = 0x03,
e1f19995 154 MS_TPC_READ_MG_DATA = 0x03,
baf8532a 155 MS_TPC_READ_REG = 0x04,
e1f19995
AD
156 MS_TPC_READ_QUAD_DATA = 0x05,
157 MS_TPC_READ_IO_DATA = 0x05,
baf8532a
AD
158 MS_TPC_GET_INT = 0x07,
159 MS_TPC_SET_RW_REG_ADRS = 0x08,
160 MS_TPC_EX_SET_CMD = 0x09,
e1f19995
AD
161 MS_TPC_WRITE_QUAD_DATA = 0x0a,
162 MS_TPC_WRITE_IO_DATA = 0x0a,
baf8532a
AD
163 MS_TPC_WRITE_REG = 0x0b,
164 MS_TPC_WRITE_SHORT_DATA = 0x0c,
e1f19995 165 MS_TPC_WRITE_MG_DATA = 0x0c,
baf8532a
AD
166 MS_TPC_WRITE_LONG_DATA = 0x0d,
167 MS_TPC_SET_CMD = 0x0e
168};
169
170enum {
e1f19995
AD
171 MS_CMD_BLOCK_END = 0x33,
172 MS_CMD_RESET = 0x3c,
173 MS_CMD_BLOCK_WRITE = 0x55,
174 MS_CMD_SLEEP = 0x5a,
175 MS_CMD_BLOCK_ERASE = 0x99,
176 MS_CMD_BLOCK_READ = 0xaa,
177 MS_CMD_CLEAR_BUF = 0xc3,
178 MS_CMD_FLASH_STOP = 0xcc,
179 MS_CMD_LOAD_ID = 0x60,
180 MS_CMD_CMP_ICV = 0x7f,
181 MSPRO_CMD_FORMAT = 0x10,
182 MSPRO_CMD_SLEEP = 0x11,
183 MSPRO_CMD_WAKEUP = 0x12,
184 MSPRO_CMD_READ_DATA = 0x20,
185 MSPRO_CMD_WRITE_DATA = 0x21,
186 MSPRO_CMD_READ_ATRB = 0x24,
187 MSPRO_CMD_STOP = 0x25,
188 MSPRO_CMD_ERASE = 0x26,
189 MSPRO_CMD_READ_QUAD = 0x27,
190 MSPRO_CMD_WRITE_QUAD = 0x28,
191 MSPRO_CMD_SET_IBD = 0x46,
192 MSPRO_CMD_GET_IBD = 0x47,
193 MSPRO_CMD_IN_IO_DATA = 0xb0,
194 MSPRO_CMD_OUT_IO_DATA = 0xb1,
195 MSPRO_CMD_READ_IO_ATRB = 0xb2,
196 MSPRO_CMD_IN_IO_FIFO = 0xb3,
197 MSPRO_CMD_OUT_IO_FIFO = 0xb4,
198 MSPRO_CMD_IN_IOM = 0xb5,
199 MSPRO_CMD_OUT_IOM = 0xb6,
baf8532a
AD
200};
201
202/*** Driver structures and functions ***/
203
204#define MEMSTICK_PART_SHIFT 3
205
206enum memstick_param { MEMSTICK_POWER = 1, MEMSTICK_INTERFACE };
207
208#define MEMSTICK_POWER_OFF 0
209#define MEMSTICK_POWER_ON 1
210
211#define MEMSTICK_SERIAL 0
e1f19995
AD
212#define MEMSTICK_PAR4 1
213#define MEMSTICK_PAR8 2
baf8532a
AD
214
215struct memstick_host;
216struct memstick_driver;
217
218#define MEMSTICK_MATCH_ALL 0x01
219
220#define MEMSTICK_TYPE_LEGACY 0xff
221#define MEMSTICK_TYPE_DUO 0x00
222#define MEMSTICK_TYPE_PRO 0x01
223
224#define MEMSTICK_CATEGORY_STORAGE 0xff
225#define MEMSTICK_CATEGORY_STORAGE_DUO 0x00
226
227#define MEMSTICK_CLASS_GENERIC 0xff
228#define MEMSTICK_CLASS_GENERIC_DUO 0x00
229
230
231struct memstick_device_id {
232 unsigned char match_flags;
233 unsigned char type;
234 unsigned char category;
235 unsigned char class;
236};
237
238struct memstick_request {
239 unsigned char tpc;
240 unsigned char data_dir:1,
241 need_card_int:1,
242 get_int_reg:1,
e1f19995 243 long_data:1;
baf8532a
AD
244 unsigned char int_reg;
245 int error;
246 union {
247 struct scatterlist sg;
248 struct {
249 unsigned char data_len;
250 unsigned char data[15];
251 };
252 };
253};
254
255struct memstick_dev {
256 struct memstick_device_id id;
257 struct memstick_host *host;
258 struct ms_register_addr reg_addr;
259 struct completion mrq_complete;
260 struct memstick_request current_mrq;
261
262 /* Check that media driver is still willing to operate the device. */
263 int (*check)(struct memstick_dev *card);
264 /* Get next request from the media driver. */
265 int (*next_request)(struct memstick_dev *card,
266 struct memstick_request **mrq);
267
268 struct device dev;
269};
270
271struct memstick_host {
272 struct mutex lock;
273 unsigned int id;
274 unsigned int caps;
e1f19995
AD
275#define MEMSTICK_CAP_AUTO_GET_INT 1
276#define MEMSTICK_CAP_PAR4 2
277#define MEMSTICK_CAP_PAR8 4
baf8532a
AD
278
279 struct work_struct media_checker;
280 struct class_device cdev;
281
282 struct memstick_dev *card;
283 unsigned int retries;
284
285 /* Notify the host that some requests are pending. */
286 void (*request)(struct memstick_host *host);
287 /* Set host IO parameters (power, clock, etc). */
288 void (*set_param)(struct memstick_host *host,
289 enum memstick_param param,
290 int value);
291 unsigned long private[0] ____cacheline_aligned;
292};
293
294struct memstick_driver {
295 struct memstick_device_id *id_table;
296 int (*probe)(struct memstick_dev *card);
297 void (*remove)(struct memstick_dev *card);
298 int (*suspend)(struct memstick_dev *card,
299 pm_message_t state);
300 int (*resume)(struct memstick_dev *card);
301
302 struct device_driver driver;
303};
304
305int memstick_register_driver(struct memstick_driver *drv);
306void memstick_unregister_driver(struct memstick_driver *drv);
307
308struct memstick_host *memstick_alloc_host(unsigned int extra,
309 struct device *dev);
310
311int memstick_add_host(struct memstick_host *host);
312void memstick_remove_host(struct memstick_host *host);
313void memstick_free_host(struct memstick_host *host);
314void memstick_detect_change(struct memstick_host *host);
315
316void memstick_init_req_sg(struct memstick_request *mrq, unsigned char tpc,
317 struct scatterlist *sg);
318void memstick_init_req(struct memstick_request *mrq, unsigned char tpc,
319 void *buf, size_t length);
320int memstick_next_req(struct memstick_host *host,
321 struct memstick_request **mrq);
322void memstick_new_req(struct memstick_host *host);
323
324int memstick_set_rw_addr(struct memstick_dev *card);
325
326static inline void *memstick_priv(struct memstick_host *host)
327{
328 return (void *)host->private;
329}
330
331static inline void *memstick_get_drvdata(struct memstick_dev *card)
332{
333 return dev_get_drvdata(&card->dev);
334}
335
336static inline void memstick_set_drvdata(struct memstick_dev *card, void *data)
337{
338 dev_set_drvdata(&card->dev, data);
339}
340
341#endif