2 * linux/drivers/mmc/core/sdio_io.c
4 * Copyright 2007 Pierre Ossman
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or (at
9 * your option) any later version.
12 #include <linux/mmc/host.h>
13 #include <linux/mmc/card.h>
14 #include <linux/mmc/sdio.h>
15 #include <linux/mmc/sdio_func.h>
20 * sdio_claim_host - exclusively claim a bus for a certain SDIO function
21 * @func: SDIO function that will be accessed
23 * Claim a bus for a set of operations. The SDIO function given
24 * is used to figure out which bus is relevant.
26 void sdio_claim_host(struct sdio_func
*func
)
31 mmc_claim_host(func
->card
->host
);
33 EXPORT_SYMBOL_GPL(sdio_claim_host
);
36 * sdio_release_host - release a bus for a certain SDIO function
37 * @func: SDIO function that was accessed
39 * Release a bus, allowing others to claim the bus for their
42 void sdio_release_host(struct sdio_func
*func
)
47 mmc_release_host(func
->card
->host
);
49 EXPORT_SYMBOL_GPL(sdio_release_host
);
52 * sdio_enable_func - enables a SDIO function for usage
53 * @func: SDIO function to enable
55 * Powers up and activates a SDIO function so that register
58 int sdio_enable_func(struct sdio_func
*func
)
62 unsigned long timeout
;
67 pr_debug("SDIO: Enabling device %s...\n", sdio_func_id(func
));
69 ret
= mmc_io_rw_direct(func
->card
, 0, 0, SDIO_CCCR_IOEx
, 0, ®
);
73 reg
|= 1 << func
->num
;
75 ret
= mmc_io_rw_direct(func
->card
, 1, 0, SDIO_CCCR_IOEx
, reg
, NULL
);
80 * FIXME: This should timeout based on information in the CIS,
81 * but we don't have card to parse that yet.
83 timeout
= jiffies
+ HZ
;
86 ret
= mmc_io_rw_direct(func
->card
, 0, 0, SDIO_CCCR_IORx
, 0, ®
);
89 if (reg
& (1 << func
->num
))
92 if (time_after(jiffies
, timeout
))
96 pr_debug("SDIO: Enabled device %s\n", sdio_func_id(func
));
101 pr_debug("SDIO: Failed to enable device %s\n", sdio_func_id(func
));
104 EXPORT_SYMBOL_GPL(sdio_enable_func
);
107 * sdio_disable_func - disable a SDIO function
108 * @func: SDIO function to disable
110 * Powers down and deactivates a SDIO function. Register access
111 * to this function will fail until the function is reenabled.
113 int sdio_disable_func(struct sdio_func
*func
)
121 pr_debug("SDIO: Disabling device %s...\n", sdio_func_id(func
));
123 ret
= mmc_io_rw_direct(func
->card
, 0, 0, SDIO_CCCR_IOEx
, 0, ®
);
127 reg
&= ~(1 << func
->num
);
129 ret
= mmc_io_rw_direct(func
->card
, 1, 0, SDIO_CCCR_IOEx
, reg
, NULL
);
133 pr_debug("SDIO: Disabled device %s\n", sdio_func_id(func
));
138 pr_debug("SDIO: Failed to disable device %s\n", sdio_func_id(func
));
141 EXPORT_SYMBOL_GPL(sdio_disable_func
);
144 * sdio_set_block_size - set the block size of an SDIO function
145 * @func: SDIO function to change
146 * @blksz: new block size or 0 to use the default.
148 * The default block size is the largest supported by both the function
149 * and the host, with a maximum of 512 to ensure that arbitrarily sized
150 * data transfer use the optimal (least) number of commands.
152 * A driver may call this to override the default block size set by the
153 * core. This can be used to set a block size greater than the maximum
154 * that reported by the card; it is the driver's responsibility to ensure
155 * it uses a value that the card supports.
157 * Returns 0 on success, -EINVAL if the host does not support the
158 * requested block size, or -EIO (etc.) if one of the resultant FBR block
159 * size register writes failed.
162 int sdio_set_block_size(struct sdio_func
*func
, unsigned blksz
)
166 if (blksz
> func
->card
->host
->max_blk_size
)
172 func
->card
->host
->max_blk_size
),
176 ret
= mmc_io_rw_direct(func
->card
, 1, 0,
177 SDIO_FBR_BASE(func
->num
) + SDIO_FBR_BLKSIZE
,
181 ret
= mmc_io_rw_direct(func
->card
, 1, 0,
182 SDIO_FBR_BASE(func
->num
) + SDIO_FBR_BLKSIZE
+ 1,
183 (blksz
>> 8) & 0xff, NULL
);
186 func
->cur_blksize
= blksz
;
190 EXPORT_SYMBOL_GPL(sdio_set_block_size
);
193 * sdio_readb - read a single byte from a SDIO function
194 * @func: SDIO function to access
195 * @addr: address to read
196 * @err_ret: optional status value from transfer
198 * Reads a single byte from the address space of a given SDIO
199 * function. If there is a problem reading the address, 0xff
200 * is returned and @err_ret will contain the error code.
202 unsigned char sdio_readb(struct sdio_func
*func
, unsigned int addr
,
213 ret
= mmc_io_rw_direct(func
->card
, 0, func
->num
, addr
, 0, &val
);
222 EXPORT_SYMBOL_GPL(sdio_readb
);
225 * sdio_writeb - write a single byte to a SDIO function
226 * @func: SDIO function to access
228 * @addr: address to write to
229 * @err_ret: optional status value from transfer
231 * Writes a single byte to the address space of a given SDIO
232 * function. @err_ret will contain the status of the actual
235 void sdio_writeb(struct sdio_func
*func
, unsigned char b
, unsigned int addr
,
242 ret
= mmc_io_rw_direct(func
->card
, 1, func
->num
, addr
, b
, NULL
);
246 EXPORT_SYMBOL_GPL(sdio_writeb
);
249 * sdio_memcpy_fromio - read a chunk of memory from a SDIO function
250 * @func: SDIO function to access
251 * @dst: buffer to store the data
252 * @addr: address to begin reading from
253 * @count: number of bytes to read
255 * Reads up to 512 bytes from the address space of a given SDIO
256 * function. Return value indicates if the transfer succeeded or
259 int sdio_memcpy_fromio(struct sdio_func
*func
, void *dst
,
260 unsigned int addr
, int count
)
262 return mmc_io_rw_extended(func
->card
, 0, func
->num
, addr
, 0, dst
,
265 EXPORT_SYMBOL_GPL(sdio_memcpy_fromio
);
268 * sdio_memcpy_toio - write a chunk of memory to a SDIO function
269 * @func: SDIO function to access
270 * @addr: address to start writing to
271 * @src: buffer that contains the data to write
272 * @count: number of bytes to write
274 * Writes up to 512 bytes to the address space of a given SDIO
275 * function. Return value indicates if the transfer succeeded or
278 int sdio_memcpy_toio(struct sdio_func
*func
, unsigned int addr
,
279 void *src
, int count
)
281 return mmc_io_rw_extended(func
->card
, 1, func
->num
, addr
, 0, src
,
284 EXPORT_SYMBOL_GPL(sdio_memcpy_toio
);
287 * sdio_readsb - read from a FIFO on a SDIO function
288 * @func: SDIO function to access
289 * @dst: buffer to store the data
290 * @addr: address of (single byte) FIFO
291 * @count: number of bytes to read
293 * Reads up to 512 bytes from the specified FIFO of a given SDIO
294 * function. Return value indicates if the transfer succeeded or
297 int sdio_readsb(struct sdio_func
*func
, void *dst
, unsigned int addr
,
300 return mmc_io_rw_extended(func
->card
, 0, func
->num
, addr
, 1, dst
,
304 EXPORT_SYMBOL_GPL(sdio_readsb
);
307 * sdio_writesb - write to a FIFO of a SDIO function
308 * @func: SDIO function to access
309 * @addr: address of (single byte) FIFO
310 * @src: buffer that contains the data to write
311 * @count: number of bytes to write
313 * Writes up to 512 bytes to the specified FIFO of a given SDIO
314 * function. Return value indicates if the transfer succeeded or
317 int sdio_writesb(struct sdio_func
*func
, unsigned int addr
, void *src
,
320 return mmc_io_rw_extended(func
->card
, 1, func
->num
, addr
, 1, src
,
323 EXPORT_SYMBOL_GPL(sdio_writesb
);
326 * sdio_readw - read a 16 bit integer from a SDIO function
327 * @func: SDIO function to access
328 * @addr: address to read
329 * @err_ret: optional status value from transfer
331 * Reads a 16 bit integer from the address space of a given SDIO
332 * function. If there is a problem reading the address, 0xffff
333 * is returned and @err_ret will contain the error code.
335 unsigned short sdio_readw(struct sdio_func
*func
, unsigned int addr
,
343 ret
= sdio_memcpy_fromio(func
, func
->tmpbuf
, addr
, 2);
350 return le16_to_cpu(*(u16
*)func
->tmpbuf
);
352 EXPORT_SYMBOL_GPL(sdio_readw
);
355 * sdio_writew - write a 16 bit integer to a SDIO function
356 * @func: SDIO function to access
357 * @b: integer to write
358 * @addr: address to write to
359 * @err_ret: optional status value from transfer
361 * Writes a 16 bit integer to the address space of a given SDIO
362 * function. @err_ret will contain the status of the actual
365 void sdio_writew(struct sdio_func
*func
, unsigned short b
, unsigned int addr
,
370 *(u16
*)func
->tmpbuf
= cpu_to_le16(b
);
372 ret
= sdio_memcpy_toio(func
, addr
, func
->tmpbuf
, 2);
376 EXPORT_SYMBOL_GPL(sdio_writew
);
379 * sdio_readl - read a 32 bit integer from a SDIO function
380 * @func: SDIO function to access
381 * @addr: address to read
382 * @err_ret: optional status value from transfer
384 * Reads a 32 bit integer from the address space of a given SDIO
385 * function. If there is a problem reading the address,
386 * 0xffffffff is returned and @err_ret will contain the error
389 unsigned long sdio_readl(struct sdio_func
*func
, unsigned int addr
,
397 ret
= sdio_memcpy_fromio(func
, func
->tmpbuf
, addr
, 4);
404 return le32_to_cpu(*(u32
*)func
->tmpbuf
);
406 EXPORT_SYMBOL_GPL(sdio_readl
);
409 * sdio_writel - write a 32 bit integer to a SDIO function
410 * @func: SDIO function to access
411 * @b: integer to write
412 * @addr: address to write to
413 * @err_ret: optional status value from transfer
415 * Writes a 32 bit integer to the address space of a given SDIO
416 * function. @err_ret will contain the status of the actual
419 void sdio_writel(struct sdio_func
*func
, unsigned long b
, unsigned int addr
,
424 *(u32
*)func
->tmpbuf
= cpu_to_le32(b
);
426 ret
= sdio_memcpy_toio(func
, addr
, func
->tmpbuf
, 4);
430 EXPORT_SYMBOL_GPL(sdio_writel
);