1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * ds.h -- 16-bit PCMCIA core support 4 * 5 * The initial developer of the original code is David A. Hinds 6 * <dahinds@users.sourceforge.net>. Portions created by David A. Hinds 7 * are Copyright (C) 1999 David A. Hinds. All Rights Reserved. 8 * 9 * (C) 1999 David A. Hinds 10 * (C) 2003 - 2008 Dominik Brodowski 11 */ 12 13 #ifndef _LINUX_DS_H 14 #define _LINUX_DS_H 15 16 #ifdef __KERNEL__ 17 #include <linux/mod_devicetable.h> 18 #endif 19 20 #include <pcmcia/device_id.h> 21 22 #ifdef __KERNEL__ 23 #include <linux/device.h> 24 #include <linux/interrupt.h> 25 #include <pcmcia/ss.h> 26 #include <linux/atomic.h> 27 28 29 /* 30 * PCMCIA device drivers (16-bit cards only; 32-bit cards require CardBus 31 * a.k.a. PCI drivers 32 */ 33 struct pcmcia_socket; 34 struct pcmcia_device; 35 struct config_t; 36 struct net_device; 37 38 /* dynamic device IDs for PCMCIA device drivers. See 39 * Documentation/pcmcia/driver.rst for details. 40 */ 41 struct pcmcia_dynids { 42 struct mutex lock; 43 struct list_head list; 44 }; 45 46 struct pcmcia_driver { 47 const char *name; 48 49 int (*probe) (struct pcmcia_device *dev); 50 void (*remove) (struct pcmcia_device *dev); 51 52 int (*suspend) (struct pcmcia_device *dev); 53 int (*resume) (struct pcmcia_device *dev); 54 55 struct module *owner; 56 const struct pcmcia_device_id *id_table; 57 struct device_driver drv; 58 struct pcmcia_dynids dynids; 59 }; 60 61 /* driver registration */ 62 int pcmcia_register_driver(struct pcmcia_driver *driver); 63 void pcmcia_unregister_driver(struct pcmcia_driver *driver); 64 65 /** 66 * module_pcmcia_driver() - Helper macro for registering a pcmcia driver 67 * @__pcmcia_driver: pcmcia_driver struct 68 * 69 * Helper macro for pcmcia drivers which do not do anything special in module 70 * init/exit. This eliminates a lot of boilerplate. Each module may only use 71 * this macro once, and calling it replaces module_init() and module_exit(). 72 */ 73 #define module_pcmcia_driver(__pcmcia_driver) \ 74 module_driver(__pcmcia_driver, pcmcia_register_driver, \ 75 pcmcia_unregister_driver) 76 77 /* for struct resource * array embedded in struct pcmcia_device */ 78 enum { 79 PCMCIA_IOPORT_0, 80 PCMCIA_IOPORT_1, 81 PCMCIA_IOMEM_0, 82 PCMCIA_IOMEM_1, 83 PCMCIA_IOMEM_2, 84 PCMCIA_IOMEM_3, 85 PCMCIA_NUM_RESOURCES, 86 }; 87 88 struct pcmcia_device { 89 /* the socket and the device_no [for multifunction devices] 90 uniquely define a pcmcia_device */ 91 struct pcmcia_socket *socket; 92 93 char *devname; 94 95 u8 device_no; 96 97 /* the hardware "function" device; certain subdevices can 98 * share one hardware "function" device. */ 99 u8 func; 100 struct config_t *function_config; 101 102 struct list_head socket_device_list; 103 104 /* device setup */ 105 unsigned int irq; 106 struct resource *resource[PCMCIA_NUM_RESOURCES]; 107 resource_size_t card_addr; /* for the 1st IOMEM resource */ 108 unsigned int vpp; 109 110 unsigned int config_flags; /* CONF_ENABLE_ flags below */ 111 unsigned int config_base; 112 unsigned int config_index; 113 unsigned int config_regs; /* PRESENT_ flags below */ 114 unsigned int io_lines; /* number of I/O lines */ 115 116 /* Is the device suspended? */ 117 u16 suspended:1; 118 119 /* Flags whether io, irq, win configurations were 120 * requested, and whether the configuration is "locked" */ 121 u16 _irq:1; 122 u16 _io:1; 123 u16 _win:4; 124 u16 _locked:1; 125 126 /* Flag whether a "fuzzy" func_id based match is 127 * allowed. */ 128 u16 allow_func_id_match:1; 129 130 /* information about this device */ 131 u16 has_manf_id:1; 132 u16 has_card_id:1; 133 u16 has_func_id:1; 134 135 u16 reserved:4; 136 137 u8 func_id; 138 u16 manf_id; 139 u16 card_id; 140 141 char *prod_id[4]; 142 143 u64 dma_mask; 144 struct device dev; 145 146 /* data private to drivers */ 147 void *priv; 148 unsigned int open; 149 }; 150 151 #define to_pcmcia_dev(n) container_of(n, struct pcmcia_device, dev) 152 #define to_pcmcia_drv(n) container_of(n, struct pcmcia_driver, drv) 153 154 155 /* 156 * CIS access. 157 * 158 * Please use the following functions to access CIS tuples: 159 * - pcmcia_get_tuple() 160 * - pcmcia_loop_tuple() 161 * - pcmcia_get_mac_from_cis() 162 * 163 * To parse a tuple_t, pcmcia_parse_tuple() exists. Its interface 164 * might change in future. 165 */ 166 167 /* get the very first CIS entry of type @code. Note that buf is pointer 168 * to u8 *buf; and that you need to kfree(buf) afterwards. */ 169 size_t pcmcia_get_tuple(struct pcmcia_device *p_dev, cisdata_t code, 170 u8 **buf); 171 172 /* loop over CIS entries */ 173 int pcmcia_loop_tuple(struct pcmcia_device *p_dev, cisdata_t code, 174 int (*loop_tuple) (struct pcmcia_device *p_dev, 175 tuple_t *tuple, 176 void *priv_data), 177 void *priv_data); 178 179 /* get the MAC address from CISTPL_FUNCE */ 180 int pcmcia_get_mac_from_cis(struct pcmcia_device *p_dev, 181 struct net_device *dev); 182 183 184 /* parse a tuple_t */ 185 int pcmcia_parse_tuple(tuple_t *tuple, cisparse_t *parse); 186 187 /* loop CIS entries for valid configuration */ 188 int pcmcia_loop_config(struct pcmcia_device *p_dev, 189 int (*conf_check) (struct pcmcia_device *p_dev, 190 void *priv_data), 191 void *priv_data); 192 193 /* is the device still there? */ 194 struct pcmcia_device *pcmcia_dev_present(struct pcmcia_device *p_dev); 195 196 /* low-level interface reset */ 197 int pcmcia_reset_card(struct pcmcia_socket *skt); 198 199 /* CIS config */ 200 int pcmcia_read_config_byte(struct pcmcia_device *p_dev, off_t where, u8 *val); 201 int pcmcia_write_config_byte(struct pcmcia_device *p_dev, off_t where, u8 val); 202 203 /* device configuration */ 204 int pcmcia_request_io(struct pcmcia_device *p_dev); 205 206 int __must_check pcmcia_request_irq(struct pcmcia_device *p_dev, 207 irq_handler_t handler); 208 209 int pcmcia_enable_device(struct pcmcia_device *p_dev); 210 211 int pcmcia_request_window(struct pcmcia_device *p_dev, struct resource *res, 212 unsigned int speed); 213 int pcmcia_release_window(struct pcmcia_device *p_dev, struct resource *res); 214 int pcmcia_map_mem_page(struct pcmcia_device *p_dev, struct resource *res, 215 unsigned int offset); 216 217 int pcmcia_fixup_vpp(struct pcmcia_device *p_dev, unsigned char new_vpp); 218 int pcmcia_fixup_iowidth(struct pcmcia_device *p_dev); 219 220 void pcmcia_disable_device(struct pcmcia_device *p_dev); 221 222 /* IO ports */ 223 #define IO_DATA_PATH_WIDTH 0x18 224 #define IO_DATA_PATH_WIDTH_8 0x00 225 #define IO_DATA_PATH_WIDTH_16 0x08 226 #define IO_DATA_PATH_WIDTH_AUTO 0x10 227 228 /* IO memory */ 229 #define WIN_MEMORY_TYPE_CM 0x00 /* default */ 230 #define WIN_MEMORY_TYPE_AM 0x20 /* MAP_ATTRIB */ 231 #define WIN_DATA_WIDTH_8 0x00 /* default */ 232 #define WIN_DATA_WIDTH_16 0x02 /* MAP_16BIT */ 233 #define WIN_ENABLE 0x01 /* MAP_ACTIVE */ 234 #define WIN_USE_WAIT 0x40 /* MAP_USE_WAIT */ 235 236 #define WIN_FLAGS_MAP 0x63 /* MAP_ATTRIB | MAP_16BIT | MAP_ACTIVE | 237 MAP_USE_WAIT */ 238 #define WIN_FLAGS_REQ 0x1c /* mapping to socket->win[i]: 239 0x04 -> 0 240 0x08 -> 1 241 0x0c -> 2 242 0x10 -> 3 */ 243 244 /* config_reg{ister}s present for this PCMCIA device */ 245 #define PRESENT_OPTION 0x001 246 #define PRESENT_STATUS 0x002 247 #define PRESENT_PIN_REPLACE 0x004 248 #define PRESENT_COPY 0x008 249 #define PRESENT_EXT_STATUS 0x010 250 #define PRESENT_IOBASE_0 0x020 251 #define PRESENT_IOBASE_1 0x040 252 #define PRESENT_IOBASE_2 0x080 253 #define PRESENT_IOBASE_3 0x100 254 #define PRESENT_IOSIZE 0x200 255 256 /* flags to be passed to pcmcia_enable_device() */ 257 #define CONF_ENABLE_IRQ 0x0001 258 #define CONF_ENABLE_SPKR 0x0002 259 #define CONF_ENABLE_PULSE_IRQ 0x0004 260 #define CONF_ENABLE_ESR 0x0008 261 #define CONF_ENABLE_IOCARD 0x0010 /* auto-enabled if IO resources or IRQ 262 * (CONF_ENABLE_IRQ) in use */ 263 #define CONF_ENABLE_ZVCARD 0x0020 264 265 /* flags used by pcmcia_loop_config() autoconfiguration */ 266 #define CONF_AUTO_CHECK_VCC 0x0100 /* check for matching Vcc? */ 267 #define CONF_AUTO_SET_VPP 0x0200 /* set Vpp? */ 268 #define CONF_AUTO_AUDIO 0x0400 /* enable audio line? */ 269 #define CONF_AUTO_SET_IO 0x0800 /* set ->resource[0,1] */ 270 #define CONF_AUTO_SET_IOMEM 0x1000 /* set ->resource[2] */ 271 272 #endif /* __KERNEL__ */ 273 274 #endif /* _LINUX_DS_H */ 275