blob: 0d508ac17d6452b5a35429fd38704c8de2c13de4 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * linux/include/linux/mmc/card.h
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
7 *
8 * Card driver specific definitions.
9 */
10#ifndef LINUX_MMC_CARD_H
11#define LINUX_MMC_CARD_H
12
Pierre Ossmanaaac1b42007-02-28 15:33:10 +010013#include <linux/mmc/core.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070014
15struct mmc_cid {
16 unsigned int manfid;
17 char prod_name[8];
18 unsigned int serial;
19 unsigned short oemid;
20 unsigned short year;
21 unsigned char hwrev;
22 unsigned char fwrev;
23 unsigned char month;
24};
25
26struct mmc_csd {
27 unsigned char mmca_vsn;
28 unsigned short cmdclass;
29 unsigned short tacc_clks;
30 unsigned int tacc_ns;
Russell King37be4e72006-05-02 17:24:59 +010031 unsigned int r2w_factor;
Linus Torvalds1da177e2005-04-16 15:20:36 -070032 unsigned int max_dtr;
33 unsigned int read_blkbits;
Russell Kinga6f6c962006-01-03 22:38:44 +000034 unsigned int write_blkbits;
Linus Torvalds1da177e2005-04-16 15:20:36 -070035 unsigned int capacity;
Russell Kinga6f6c962006-01-03 22:38:44 +000036 unsigned int read_partial:1,
37 read_misalign:1,
Russell Kingce11a162006-01-04 12:40:39 +000038 write_partial:1,
Russell Kinga6f6c962006-01-03 22:38:44 +000039 write_misalign:1;
Linus Torvalds1da177e2005-04-16 15:20:36 -070040};
41
Philip Langdalebce40a32006-10-21 12:35:02 +020042struct mmc_ext_csd {
43 unsigned int hs_max_dtr;
Pierre Ossman85a18ad2007-02-17 22:15:27 +010044 unsigned int sectors;
Philip Langdalebce40a32006-10-21 12:35:02 +020045};
46
Pierre Ossmanb57c43a2005-09-06 15:18:53 -070047struct sd_scr {
48 unsigned char sda_vsn;
49 unsigned char bus_widths;
50#define SD_SCR_BUS_WIDTH_1 (1<<0)
51#define SD_SCR_BUS_WIDTH_4 (1<<2)
52};
53
Pierre Ossman7ccd2662006-11-08 23:03:10 +010054struct sd_switch_caps {
55 unsigned int hs_max_dtr;
56};
57
Pierre Ossman35c66c12007-06-11 20:25:43 +020058struct sdio_cccr {
59 unsigned int sdio_vsn;
60 unsigned int sd_vsn;
61 unsigned int multi_block:1,
62 low_speed:1,
63 wide_bus:1,
64 high_power:1,
65 high_speed:1;
66};
67
Pierre Ossman1a632f82007-07-30 15:15:30 +020068struct sdio_cis {
69 unsigned short vendor;
70 unsigned short device;
71 unsigned short blksize;
72 unsigned int max_dtr;
73};
74
Linus Torvalds1da177e2005-04-16 15:20:36 -070075struct mmc_host;
Pierre Ossmane29a7d72007-05-26 13:48:18 +020076struct sdio_func;
Pierre Ossman1a632f82007-07-30 15:15:30 +020077struct sdio_func_tuple;
Pierre Ossmane29a7d72007-05-26 13:48:18 +020078
79#define SDIO_MAX_FUNCS 7
Linus Torvalds1da177e2005-04-16 15:20:36 -070080
81/*
82 * MMC device
83 */
84struct mmc_card {
Linus Torvalds1da177e2005-04-16 15:20:36 -070085 struct mmc_host *host; /* the host this device belongs to */
86 struct device dev; /* the device */
87 unsigned int rca; /* relative card address of device */
Pierre Ossman9c2c0af2006-12-26 15:25:58 +010088 unsigned int type; /* card type */
89#define MMC_TYPE_MMC 0 /* MMC card */
90#define MMC_TYPE_SD 1 /* SD card */
Pierre Ossman5c4e6f12007-05-21 20:23:20 +020091#define MMC_TYPE_SDIO 2 /* SDIO card */
Linus Torvalds1da177e2005-04-16 15:20:36 -070092 unsigned int state; /* (our) card state */
93#define MMC_STATE_PRESENT (1<<0) /* present in sysfs */
Pierre Ossmanbd766312007-05-01 16:11:57 +020094#define MMC_STATE_READONLY (1<<1) /* card is read-only */
95#define MMC_STATE_HIGHSPEED (1<<2) /* card is in high speed mode */
96#define MMC_STATE_BLOCKADDR (1<<3) /* card uses block-addressing */
Pierre Ossmane29a7d72007-05-26 13:48:18 +020097
Linus Torvalds1da177e2005-04-16 15:20:36 -070098 u32 raw_cid[4]; /* raw card CID */
99 u32 raw_csd[4]; /* raw card CSD */
Pierre Ossmanb57c43a2005-09-06 15:18:53 -0700100 u32 raw_scr[2]; /* raw card SCR */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101 struct mmc_cid cid; /* card identification */
102 struct mmc_csd csd; /* card specific */
Philip Langdalebce40a32006-10-21 12:35:02 +0200103 struct mmc_ext_csd ext_csd; /* mmc v4 extended card specific */
Pierre Ossmanb57c43a2005-09-06 15:18:53 -0700104 struct sd_scr scr; /* extra SD information */
Pierre Ossman7ccd2662006-11-08 23:03:10 +0100105 struct sd_switch_caps sw_caps; /* switch (CMD6) caps */
Pierre Ossmane29a7d72007-05-26 13:48:18 +0200106
107 unsigned int sdio_funcs; /* number of SDIO functions */
Pierre Ossman35c66c12007-06-11 20:25:43 +0200108 struct sdio_cccr cccr; /* common card info */
Pierre Ossman1a632f82007-07-30 15:15:30 +0200109 struct sdio_cis cis; /* common tuple info */
Pierre Ossmane29a7d72007-05-26 13:48:18 +0200110 struct sdio_func *sdio_func[SDIO_MAX_FUNCS]; /* SDIO functions (devices) */
Pierre Ossman759bdc72007-09-19 18:42:16 +0200111 unsigned num_info; /* number of info strings */
112 const char **info; /* info strings */
Pierre Ossman1a632f82007-07-30 15:15:30 +0200113 struct sdio_func_tuple *tuples; /* unknown common tuples */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700114};
115
Pierre Ossman9c2c0af2006-12-26 15:25:58 +0100116#define mmc_card_mmc(c) ((c)->type == MMC_TYPE_MMC)
117#define mmc_card_sd(c) ((c)->type == MMC_TYPE_SD)
Pierre Ossman5c4e6f12007-05-21 20:23:20 +0200118#define mmc_card_sdio(c) ((c)->type == MMC_TYPE_SDIO)
Pierre Ossman9c2c0af2006-12-26 15:25:58 +0100119
Linus Torvalds1da177e2005-04-16 15:20:36 -0700120#define mmc_card_present(c) ((c)->state & MMC_STATE_PRESENT)
Pierre Ossmana00fc092005-09-06 15:18:52 -0700121#define mmc_card_readonly(c) ((c)->state & MMC_STATE_READONLY)
Philip Langdalebce40a32006-10-21 12:35:02 +0200122#define mmc_card_highspeed(c) ((c)->state & MMC_STATE_HIGHSPEED)
Philip Langdalefba68bd2007-01-04 06:57:32 -0800123#define mmc_card_blockaddr(c) ((c)->state & MMC_STATE_BLOCKADDR)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124
125#define mmc_card_set_present(c) ((c)->state |= MMC_STATE_PRESENT)
Pierre Ossmana00fc092005-09-06 15:18:52 -0700126#define mmc_card_set_readonly(c) ((c)->state |= MMC_STATE_READONLY)
Philip Langdalebce40a32006-10-21 12:35:02 +0200127#define mmc_card_set_highspeed(c) ((c)->state |= MMC_STATE_HIGHSPEED)
Philip Langdalefba68bd2007-01-04 06:57:32 -0800128#define mmc_card_set_blockaddr(c) ((c)->state |= MMC_STATE_BLOCKADDR)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700129
130#define mmc_card_name(c) ((c)->cid.prod_name)
131#define mmc_card_id(c) ((c)->dev.bus_id)
132
133#define mmc_list_to_card(l) container_of(l, struct mmc_card, node)
134#define mmc_get_drvdata(c) dev_get_drvdata(&(c)->dev)
135#define mmc_set_drvdata(c,d) dev_set_drvdata(&(c)->dev, d)
136
137/*
138 * MMC device driver (e.g., Flash card, I/O card...)
139 */
140struct mmc_driver {
141 struct device_driver drv;
142 int (*probe)(struct mmc_card *);
143 void (*remove)(struct mmc_card *);
144 int (*suspend)(struct mmc_card *, pm_message_t);
145 int (*resume)(struct mmc_card *);
146};
147
148extern int mmc_register_driver(struct mmc_driver *);
149extern void mmc_unregister_driver(struct mmc_driver *);
150
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151#endif