blob: 1ca50542ce199a1a56358de6c065d0c7f50e116c [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
13#include <linux/mmc/mmc.h>
14
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
Linus Torvalds1da177e2005-04-16 15:20:36 -070058struct mmc_host;
59
60/*
61 * MMC device
62 */
63struct mmc_card {
64 struct list_head node; /* node in hosts devices list */
65 struct mmc_host *host; /* the host this device belongs to */
66 struct device dev; /* the device */
67 unsigned int rca; /* relative card address of device */
Pierre Ossman9c2c0af2006-12-26 15:25:58 +010068 unsigned int type; /* card type */
69#define MMC_TYPE_MMC 0 /* MMC card */
70#define MMC_TYPE_SD 1 /* SD card */
Linus Torvalds1da177e2005-04-16 15:20:36 -070071 unsigned int state; /* (our) card state */
72#define MMC_STATE_PRESENT (1<<0) /* present in sysfs */
73#define MMC_STATE_DEAD (1<<1) /* device no longer in stack */
74#define MMC_STATE_BAD (1<<2) /* unrecognised device */
Pierre Ossman9c2c0af2006-12-26 15:25:58 +010075#define MMC_STATE_READONLY (1<<3) /* card is read-only */
76#define MMC_STATE_HIGHSPEED (1<<4) /* card is in high speed mode */
77#define MMC_STATE_BLOCKADDR (1<<5) /* card uses block-addressing */
Linus Torvalds1da177e2005-04-16 15:20:36 -070078 u32 raw_cid[4]; /* raw card CID */
79 u32 raw_csd[4]; /* raw card CSD */
Pierre Ossmanb57c43a2005-09-06 15:18:53 -070080 u32 raw_scr[2]; /* raw card SCR */
Linus Torvalds1da177e2005-04-16 15:20:36 -070081 struct mmc_cid cid; /* card identification */
82 struct mmc_csd csd; /* card specific */
Philip Langdalebce40a32006-10-21 12:35:02 +020083 struct mmc_ext_csd ext_csd; /* mmc v4 extended card specific */
Pierre Ossmanb57c43a2005-09-06 15:18:53 -070084 struct sd_scr scr; /* extra SD information */
Pierre Ossman7ccd2662006-11-08 23:03:10 +010085 struct sd_switch_caps sw_caps; /* switch (CMD6) caps */
Linus Torvalds1da177e2005-04-16 15:20:36 -070086};
87
Pierre Ossman9c2c0af2006-12-26 15:25:58 +010088#define mmc_card_mmc(c) ((c)->type == MMC_TYPE_MMC)
89#define mmc_card_sd(c) ((c)->type == MMC_TYPE_SD)
90
Linus Torvalds1da177e2005-04-16 15:20:36 -070091#define mmc_card_present(c) ((c)->state & MMC_STATE_PRESENT)
92#define mmc_card_dead(c) ((c)->state & MMC_STATE_DEAD)
93#define mmc_card_bad(c) ((c)->state & MMC_STATE_BAD)
Pierre Ossmana00fc092005-09-06 15:18:52 -070094#define mmc_card_readonly(c) ((c)->state & MMC_STATE_READONLY)
Philip Langdalebce40a32006-10-21 12:35:02 +020095#define mmc_card_highspeed(c) ((c)->state & MMC_STATE_HIGHSPEED)
Philip Langdalefba68bd2007-01-04 06:57:32 -080096#define mmc_card_blockaddr(c) ((c)->state & MMC_STATE_BLOCKADDR)
Linus Torvalds1da177e2005-04-16 15:20:36 -070097
98#define mmc_card_set_present(c) ((c)->state |= MMC_STATE_PRESENT)
99#define mmc_card_set_dead(c) ((c)->state |= MMC_STATE_DEAD)
100#define mmc_card_set_bad(c) ((c)->state |= MMC_STATE_BAD)
Pierre Ossmana00fc092005-09-06 15:18:52 -0700101#define mmc_card_set_readonly(c) ((c)->state |= MMC_STATE_READONLY)
Philip Langdalebce40a32006-10-21 12:35:02 +0200102#define mmc_card_set_highspeed(c) ((c)->state |= MMC_STATE_HIGHSPEED)
Philip Langdalefba68bd2007-01-04 06:57:32 -0800103#define mmc_card_set_blockaddr(c) ((c)->state |= MMC_STATE_BLOCKADDR)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104
105#define mmc_card_name(c) ((c)->cid.prod_name)
106#define mmc_card_id(c) ((c)->dev.bus_id)
107
108#define mmc_list_to_card(l) container_of(l, struct mmc_card, node)
109#define mmc_get_drvdata(c) dev_get_drvdata(&(c)->dev)
110#define mmc_set_drvdata(c,d) dev_set_drvdata(&(c)->dev, d)
111
112/*
113 * MMC device driver (e.g., Flash card, I/O card...)
114 */
115struct mmc_driver {
116 struct device_driver drv;
117 int (*probe)(struct mmc_card *);
118 void (*remove)(struct mmc_card *);
119 int (*suspend)(struct mmc_card *, pm_message_t);
120 int (*resume)(struct mmc_card *);
121};
122
123extern int mmc_register_driver(struct mmc_driver *);
124extern void mmc_unregister_driver(struct mmc_driver *);
125
126static inline int mmc_card_claim_host(struct mmc_card *card)
127{
128 return __mmc_claim_host(card->host, card);
129}
130
131#define mmc_card_release_host(c) mmc_release_host((c)->host)
132
133#endif