sdio_func.h 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
  1. /*
  2. * include/linux/mmc/sdio_func.h
  3. *
  4. * Copyright 2007 Pierre Ossman
  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 as published by
  8. * the Free Software Foundation; either version 2 of the License, or (at
  9. * your option) any later version.
  10. */
  11. #ifndef MMC_SDIO_FUNC_H
  12. #define MMC_SDIO_FUNC_H
  13. #include <linux/device.h>
  14. #include <linux/mod_devicetable.h>
  15. struct mmc_card;
  16. struct sdio_func;
  17. typedef void (sdio_irq_handler_t)(struct sdio_func *);
  18. /*
  19. * SDIO function CIS tuple (unknown to the core)
  20. */
  21. struct sdio_func_tuple {
  22. struct sdio_func_tuple *next;
  23. unsigned char code;
  24. unsigned char size;
  25. unsigned char data[0];
  26. };
  27. /*
  28. * SDIO function devices
  29. */
  30. struct sdio_func {
  31. struct mmc_card *card; /* the card this device belongs to */
  32. struct device dev; /* the device */
  33. sdio_irq_handler_t *irq_handler; /* IRQ callback */
  34. unsigned int num; /* function number */
  35. unsigned char class; /* standard interface class */
  36. unsigned short vendor; /* vendor id */
  37. unsigned short device; /* device id */
  38. unsigned max_blksize; /* maximum block size */
  39. unsigned cur_blksize; /* current block size */
  40. unsigned int state; /* function state */
  41. #define SDIO_STATE_PRESENT (1<<0) /* present in sysfs */
  42. u8 tmpbuf[4]; /* DMA:able scratch buffer */
  43. unsigned num_info; /* number of info strings */
  44. const char **info; /* info strings */
  45. struct sdio_func_tuple *tuples;
  46. };
  47. #define sdio_func_present(f) ((f)->state & SDIO_STATE_PRESENT)
  48. #define sdio_func_set_present(f) ((f)->state |= SDIO_STATE_PRESENT)
  49. #define sdio_func_id(f) ((f)->dev.bus_id)
  50. #define sdio_get_drvdata(f) dev_get_drvdata(&(f)->dev)
  51. #define sdio_set_drvdata(f,d) dev_set_drvdata(&(f)->dev, d)
  52. /*
  53. * SDIO function device driver
  54. */
  55. struct sdio_driver {
  56. char *name;
  57. const struct sdio_device_id *id_table;
  58. int (*probe)(struct sdio_func *, const struct sdio_device_id *);
  59. void (*remove)(struct sdio_func *);
  60. struct device_driver drv;
  61. };
  62. /**
  63. * SDIO_DEVICE - macro used to describe a specific SDIO device
  64. * @vend: the 16 bit manufacturer code
  65. * @dev: the 16 bit function id
  66. *
  67. * This macro is used to create a struct sdio_device_id that matches a
  68. * specific device. The class field will be set to SDIO_ANY_ID.
  69. */
  70. #define SDIO_DEVICE(vend,dev) \
  71. .class = SDIO_ANY_ID, \
  72. .vendor = (vend), .device = (dev)
  73. /**
  74. * SDIO_DEVICE_CLASS - macro used to describe a specific SDIO device class
  75. * @dev_class: the 8 bit standard interface code
  76. *
  77. * This macro is used to create a struct sdio_device_id that matches a
  78. * specific standard SDIO function type. The vendor and device fields will
  79. * be set to SDIO_ANY_ID.
  80. */
  81. #define SDIO_DEVICE_CLASS(dev_class) \
  82. .class = (dev_class), \
  83. .vendor = SDIO_ANY_ID, .device = SDIO_ANY_ID
  84. extern int sdio_register_driver(struct sdio_driver *);
  85. extern void sdio_unregister_driver(struct sdio_driver *);
  86. /*
  87. * SDIO I/O operations
  88. */
  89. extern void sdio_claim_host(struct sdio_func *func);
  90. extern void sdio_release_host(struct sdio_func *func);
  91. extern int sdio_enable_func(struct sdio_func *func);
  92. extern int sdio_disable_func(struct sdio_func *func);
  93. extern int sdio_set_block_size(struct sdio_func *func, unsigned blksz);
  94. extern int sdio_claim_irq(struct sdio_func *func, sdio_irq_handler_t *handler);
  95. extern int sdio_release_irq(struct sdio_func *func);
  96. extern unsigned char sdio_readb(struct sdio_func *func,
  97. unsigned int addr, int *err_ret);
  98. extern unsigned short sdio_readw(struct sdio_func *func,
  99. unsigned int addr, int *err_ret);
  100. extern unsigned long sdio_readl(struct sdio_func *func,
  101. unsigned int addr, int *err_ret);
  102. extern int sdio_memcpy_fromio(struct sdio_func *func, void *dst,
  103. unsigned int addr, int count);
  104. extern int sdio_readsb(struct sdio_func *func, void *dst,
  105. unsigned int addr, int count);
  106. extern void sdio_writeb(struct sdio_func *func, unsigned char b,
  107. unsigned int addr, int *err_ret);
  108. extern void sdio_writew(struct sdio_func *func, unsigned short b,
  109. unsigned int addr, int *err_ret);
  110. extern void sdio_writel(struct sdio_func *func, unsigned long b,
  111. unsigned int addr, int *err_ret);
  112. extern int sdio_memcpy_toio(struct sdio_func *func, unsigned int addr,
  113. void *src, int count);
  114. extern int sdio_writesb(struct sdio_func *func, unsigned int addr,
  115. void *src, int count);
  116. extern unsigned char sdio_f0_readb(struct sdio_func *func,
  117. unsigned int addr, int *err_ret);
  118. extern void sdio_f0_writeb(struct sdio_func *func, unsigned char b,
  119. unsigned int addr, int *err_ret);
  120. #endif