core.h 5.9 KB
Newer Older
L
Linus Torvalds 已提交
1
/*
2
 *  linux/drivers/mmc/core/core.h
L
Linus Torvalds 已提交
3 4
 *
 *  Copyright (C) 2003 Russell King, All Rights Reserved.
P
Pierre Ossman 已提交
5
 *  Copyright 2007 Pierre Ossman
L
Linus Torvalds 已提交
6 7 8 9 10
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */
P
Pierre Ossman 已提交
11 12
#ifndef _MMC_CORE_CORE_H
#define _MMC_CORE_CORE_H
R
Russell King 已提交
13

P
Pierre Ossman 已提交
14
#include <linux/delay.h>
15 16 17 18
#include <linux/sched.h>

struct mmc_host;
struct mmc_card;
19
struct mmc_request;
P
Pierre Ossman 已提交
20 21 22

#define MMC_CMD_RETRIES        3

P
Pierre Ossman 已提交
23 24 25
struct mmc_bus_ops {
	void (*remove)(struct mmc_host *);
	void (*detect)(struct mmc_host *);
26
	int (*pre_suspend)(struct mmc_host *);
27 28
	int (*suspend)(struct mmc_host *);
	int (*resume)(struct mmc_host *);
29 30
	int (*runtime_suspend)(struct mmc_host *);
	int (*runtime_resume)(struct mmc_host *);
31 32
	int (*power_save)(struct mmc_host *);
	int (*power_restore)(struct mmc_host *);
33
	int (*alive)(struct mmc_host *);
34
	int (*shutdown)(struct mmc_host *);
35
	int (*hw_reset)(struct mmc_host *);
36
	int (*sw_reset)(struct mmc_host *);
P
Pierre Ossman 已提交
37 38 39 40 41
};

void mmc_attach_bus(struct mmc_host *host, const struct mmc_bus_ops *ops);
void mmc_detach_bus(struct mmc_host *host);

42 43 44
struct device_node *mmc_of_find_child_device(struct mmc_host *host,
		unsigned func_num);

45 46
void mmc_init_erase(struct mmc_card *card);

P
Pierre Ossman 已提交
47
void mmc_set_chip_select(struct mmc_host *host, int mode);
P
Pierre Ossman 已提交
48 49 50 51
void mmc_set_clock(struct mmc_host *host, unsigned int hz);
void mmc_set_bus_mode(struct mmc_host *host, unsigned int mode);
void mmc_set_bus_width(struct mmc_host *host, unsigned int width);
u32 mmc_select_voltage(struct mmc_host *host, u32 ocr);
52
int mmc_set_uhs_voltage(struct mmc_host *host, u32 ocr);
53
int mmc_host_set_uhs_voltage(struct mmc_host *host);
54
int mmc_set_signal_voltage(struct mmc_host *host, int signal_voltage);
55
void mmc_set_initial_signal_voltage(struct mmc_host *host);
P
Pierre Ossman 已提交
56
void mmc_set_timing(struct mmc_host *host, unsigned int timing);
57
void mmc_set_driver_type(struct mmc_host *host, unsigned int drv_type);
58 59
int mmc_select_drive_strength(struct mmc_card *card, unsigned int max_dtr,
			      int card_drv_type, int *drv_type);
60
void mmc_power_up(struct mmc_host *host, u32 ocr);
61
void mmc_power_off(struct mmc_host *host);
62
void mmc_power_cycle(struct mmc_host *host, u32 ocr);
63
void mmc_set_initial_state(struct mmc_host *host);
P
Pierre Ossman 已提交
64

P
Pierre Ossman 已提交
65 66
static inline void mmc_delay(unsigned int ms)
{
67 68 69
	if (ms <= 20)
		usleep_range(ms * 1000, ms * 1250);
	else
P
Pierre Ossman 已提交
70 71
		msleep(ms);
}
P
Pierre Ossman 已提交
72

73 74 75 76
void mmc_rescan(struct work_struct *work);
void mmc_start_host(struct mmc_host *host);
void mmc_stop_host(struct mmc_host *host);

77
int _mmc_detect_card_removed(struct mmc_host *host);
78
int mmc_detect_card_removed(struct mmc_host *host);
79

80 81 82
int mmc_attach_mmc(struct mmc_host *host);
int mmc_attach_sd(struct mmc_host *host);
int mmc_attach_sdio(struct mmc_host *host);
83

84
/* Module parameters */
85
extern bool use_spi_crc;
D
David Brownell 已提交
86

87 88 89 90
/* Debugfs information for hosts and cards */
void mmc_add_host_debugfs(struct mmc_host *host);
void mmc_remove_host_debugfs(struct mmc_host *host);

91 92 93
void mmc_add_card_debugfs(struct mmc_card *card);
void mmc_remove_card_debugfs(struct mmc_card *card);

94
int mmc_execute_tuning(struct mmc_card *card);
95 96
int mmc_hs200_to_hs400(struct mmc_card *card);
int mmc_hs400_to_hs200(struct mmc_card *card);
97

98 99 100 101
#ifdef CONFIG_PM_SLEEP
void mmc_register_pm_notifier(struct mmc_host *host);
void mmc_unregister_pm_notifier(struct mmc_host *host);
#else
102 103
static inline void mmc_register_pm_notifier(struct mmc_host *host) { }
static inline void mmc_unregister_pm_notifier(struct mmc_host *host) { }
104 105
#endif

106 107 108
void mmc_wait_for_req_done(struct mmc_host *host, struct mmc_request *mrq);
bool mmc_is_req_done(struct mmc_host *host, struct mmc_request *mrq);

109 110
int mmc_start_request(struct mmc_host *host, struct mmc_request *mrq);

111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
int mmc_erase(struct mmc_card *card, unsigned int from, unsigned int nr,
		unsigned int arg);
int mmc_can_erase(struct mmc_card *card);
int mmc_can_trim(struct mmc_card *card);
int mmc_can_discard(struct mmc_card *card);
int mmc_can_sanitize(struct mmc_card *card);
int mmc_can_secure_erase_trim(struct mmc_card *card);
int mmc_erase_group_aligned(struct mmc_card *card, unsigned int from,
			unsigned int nr);
unsigned int mmc_calc_max_discard(struct mmc_card *card);

int mmc_set_blocklen(struct mmc_card *card, unsigned int blocklen);
int mmc_set_blockcount(struct mmc_card *card, unsigned int blockcount,
			bool is_rel_write);

126 127
int __mmc_claim_host(struct mmc_host *host, struct mmc_ctx *ctx,
		     atomic_t *abort);
128
void mmc_release_host(struct mmc_host *host);
129 130
void mmc_get_card(struct mmc_card *card, struct mmc_ctx *ctx);
void mmc_put_card(struct mmc_card *card, struct mmc_ctx *ctx);
131 132 133 134 135 136 137 138 139

/**
 *	mmc_claim_host - exclusively claim a host
 *	@host: mmc host to claim
 *
 *	Claim a host for a set of operations.
 */
static inline void mmc_claim_host(struct mmc_host *host)
{
140
	__mmc_claim_host(host, NULL, NULL);
141
}
P
Pierre Ossman 已提交
142

143 144 145 146
int mmc_cqe_start_req(struct mmc_host *host, struct mmc_request *mrq);
void mmc_cqe_post_req(struct mmc_host *host, struct mmc_request *mrq);
int mmc_cqe_recovery(struct mmc_host *host);

147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177
/**
 *	mmc_pre_req - Prepare for a new request
 *	@host: MMC host to prepare command
 *	@mrq: MMC request to prepare for
 *
 *	mmc_pre_req() is called in prior to mmc_start_req() to let
 *	host prepare for the new request. Preparation of a request may be
 *	performed while another request is running on the host.
 */
static inline void mmc_pre_req(struct mmc_host *host, struct mmc_request *mrq)
{
	if (host->ops->pre_req)
		host->ops->pre_req(host, mrq);
}

/**
 *	mmc_post_req - Post process a completed request
 *	@host: MMC host to post process command
 *	@mrq: MMC request to post process for
 *	@err: Error, if non zero, clean up any resources made in pre_req
 *
 *	Let the host post process a completed request. Post processing of
 *	a request may be performed while another request is running.
 */
static inline void mmc_post_req(struct mmc_host *host, struct mmc_request *mrq,
				int err)
{
	if (host->ops->post_req)
		host->ops->post_req(host, mrq, err);
}

178
#endif