1 /* 2 * linux/drivers/pcmcia/soc_common.h 3 * 4 * Copyright (C) 2000 John G Dorsey <john+@cs.cmu.edu> 5 * 6 * This file contains definitions for the PCMCIA support code common to 7 * integrated SOCs like the SA-11x0 and PXA2xx microprocessors. 8 */ 9 #ifndef _ASM_ARCH_PCMCIA 10 #define _ASM_ARCH_PCMCIA 11 12 /* include the world */ 13 #include <linux/cpufreq.h> 14 #include <pcmcia/cs.h> 15 #include <pcmcia/ss.h> 16 #include <pcmcia/cistpl.h> 17 18 19 struct device; 20 struct pcmcia_low_level; 21 22 /* 23 * This structure encapsulates per-socket state which we might need to 24 * use when responding to a Card Services query of some kind. 25 */ 26 struct soc_pcmcia_socket { 27 struct pcmcia_socket socket; 28 29 /* 30 * Info from low level handler 31 */ 32 unsigned int nr; 33 34 /* 35 * Core PCMCIA state 36 */ 37 const struct pcmcia_low_level *ops; 38 39 unsigned int status; 40 socket_state_t cs_state; 41 42 unsigned short spd_io[MAX_IO_WIN]; 43 unsigned short spd_mem[MAX_WIN]; 44 unsigned short spd_attr[MAX_WIN]; 45 46 struct resource res_skt; 47 struct resource res_io; 48 struct resource res_mem; 49 struct resource res_attr; 50 void __iomem *virt_io; 51 52 unsigned int irq_state; 53 54 struct timer_list poll_timer; 55 struct list_head node; 56 }; 57 58 struct skt_dev_info { 59 int nskt; 60 struct soc_pcmcia_socket skt[0]; 61 }; 62 63 struct pcmcia_state { 64 unsigned detect: 1, 65 ready: 1, 66 bvd1: 1, 67 bvd2: 1, 68 wrprot: 1, 69 vs_3v: 1, 70 vs_Xv: 1; 71 }; 72 73 struct pcmcia_low_level { 74 struct module *owner; 75 76 /* first socket in system */ 77 int first; 78 /* nr of sockets */ 79 int nr; 80 81 int (*hw_init)(struct soc_pcmcia_socket *); 82 void (*hw_shutdown)(struct soc_pcmcia_socket *); 83 84 void (*socket_state)(struct soc_pcmcia_socket *, struct pcmcia_state *); 85 int (*configure_socket)(struct soc_pcmcia_socket *, const socket_state_t *); 86 87 /* 88 * Enable card status IRQs on (re-)initialisation. This can 89 * be called at initialisation, power management event, or 90 * pcmcia event. 91 */ 92 void (*socket_init)(struct soc_pcmcia_socket *); 93 94 /* 95 * Disable card status IRQs and PCMCIA bus on suspend. 96 */ 97 void (*socket_suspend)(struct soc_pcmcia_socket *); 98 99 /* 100 * Hardware specific timing routines. 101 * If provided, the get_timing routine overrides the SOC default. 102 */ 103 unsigned int (*get_timing)(struct soc_pcmcia_socket *, unsigned int, unsigned int); 104 int (*set_timing)(struct soc_pcmcia_socket *); 105 int (*show_timing)(struct soc_pcmcia_socket *, char *); 106 107 #ifdef CONFIG_CPU_FREQ 108 /* 109 * CPUFREQ support. 110 */ 111 int (*frequency_change)(struct soc_pcmcia_socket *, unsigned long, struct cpufreq_freqs *); 112 #endif 113 }; 114 115 116 struct pcmcia_irqs { 117 int sock; 118 int irq; 119 const char *str; 120 }; 121 122 struct soc_pcmcia_timing { 123 unsigned short io; 124 unsigned short mem; 125 unsigned short attr; 126 }; 127 128 extern int soc_pcmcia_request_irqs(struct soc_pcmcia_socket *skt, struct pcmcia_irqs *irqs, int nr); 129 extern void soc_pcmcia_free_irqs(struct soc_pcmcia_socket *skt, struct pcmcia_irqs *irqs, int nr); 130 extern void soc_pcmcia_disable_irqs(struct soc_pcmcia_socket *skt, struct pcmcia_irqs *irqs, int nr); 131 extern void soc_pcmcia_enable_irqs(struct soc_pcmcia_socket *skt, struct pcmcia_irqs *irqs, int nr); 132 extern void soc_common_pcmcia_get_timing(struct soc_pcmcia_socket *, struct soc_pcmcia_timing *); 133 134 135 void soc_pcmcia_remove_one(struct soc_pcmcia_socket *skt); 136 int soc_pcmcia_add_one(struct soc_pcmcia_socket *skt); 137 138 139 #ifdef CONFIG_PCMCIA_DEBUG 140 141 extern void soc_pcmcia_debug(struct soc_pcmcia_socket *skt, const char *func, 142 int lvl, const char *fmt, ...); 143 144 #define debug(skt, lvl, fmt, arg...) \ 145 soc_pcmcia_debug(skt, __func__, lvl, fmt , ## arg) 146 147 #else 148 #define debug(skt, lvl, fmt, arg...) do { } while (0) 149 #endif 150 151 152 /* 153 * The PC Card Standard, Release 7, section 4.13.4, says that twIORD 154 * has a minimum value of 165ns. Section 4.13.5 says that twIOWR has 155 * a minimum value of 165ns, as well. Section 4.7.2 (describing 156 * common and attribute memory write timing) says that twWE has a 157 * minimum value of 150ns for a 250ns cycle time (for 5V operation; 158 * see section 4.7.4), or 300ns for a 600ns cycle time (for 3.3V 159 * operation, also section 4.7.4). Section 4.7.3 says that taOE 160 * has a maximum value of 150ns for a 300ns cycle time (for 5V 161 * operation), or 300ns for a 600ns cycle time (for 3.3V operation). 162 * 163 * When configuring memory maps, Card Services appears to adopt the policy 164 * that a memory access time of "0" means "use the default." The default 165 * PCMCIA I/O command width time is 165ns. The default PCMCIA 5V attribute 166 * and memory command width time is 150ns; the PCMCIA 3.3V attribute and 167 * memory command width time is 300ns. 168 */ 169 #define SOC_PCMCIA_IO_ACCESS (165) 170 #define SOC_PCMCIA_5V_MEM_ACCESS (150) 171 #define SOC_PCMCIA_3V_MEM_ACCESS (300) 172 #define SOC_PCMCIA_ATTR_MEM_ACCESS (300) 173 174 /* 175 * The socket driver actually works nicely in interrupt-driven form, 176 * so the (relatively infrequent) polling is "just to be sure." 177 */ 178 #define SOC_PCMCIA_POLL_PERIOD (2*HZ) 179 180 181 /* I/O pins replacing memory pins 182 * (PCMCIA System Architecture, 2nd ed., by Don Anderson, p.75) 183 * 184 * These signals change meaning when going from memory-only to 185 * memory-or-I/O interface: 186 */ 187 #define iostschg bvd1 188 #define iospkr bvd2 189 190 #endif 191