1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
2 | /* |
3 | * cs_internal.h -- definitions internal to the PCMCIA core modules |
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 - 2010 Dominik Brodowski |
11 | * |
12 | * This file contains definitions _only_ needed by the PCMCIA core modules. |
13 | * It must not be included by PCMCIA socket drivers or by PCMCIA device |
14 | * drivers. |
15 | */ |
16 | |
17 | #ifndef _LINUX_CS_INTERNAL_H |
18 | #define _LINUX_CS_INTERNAL_H |
19 | |
20 | #include <linux/kref.h> |
21 | |
22 | /* Flags in client state */ |
23 | #define CLIENT_WIN_REQ(i) (0x1<<(i)) |
24 | |
25 | /* Flag to access all functions */ |
26 | #define BIND_FN_ALL 0xff |
27 | |
28 | /* Each card function gets one of these guys */ |
29 | typedef struct config_t { |
30 | struct kref ref; |
31 | unsigned int state; |
32 | |
33 | struct resource io[MAX_IO_WIN]; /* io ports */ |
34 | struct resource mem[MAX_WIN]; /* mem areas */ |
35 | } config_t; |
36 | |
37 | |
38 | struct cis_cache_entry { |
39 | struct list_head node; |
40 | unsigned int addr; |
41 | unsigned int len; |
42 | unsigned int attr; |
43 | unsigned char cache[]; |
44 | }; |
45 | |
46 | struct pccard_resource_ops { |
47 | int (*validate_mem) (struct pcmcia_socket *s); |
48 | int (*find_io) (struct pcmcia_socket *s, |
49 | unsigned int attr, |
50 | unsigned int *base, |
51 | unsigned int num, |
52 | unsigned int align, |
53 | struct resource **parent); |
54 | struct resource* (*find_mem) (unsigned long base, unsigned long num, |
55 | unsigned long align, int low, |
56 | struct pcmcia_socket *s); |
57 | int (*init) (struct pcmcia_socket *s); |
58 | void (*exit) (struct pcmcia_socket *s); |
59 | }; |
60 | |
61 | /* Flags in config state */ |
62 | #define CONFIG_LOCKED 0x01 |
63 | #define CONFIG_IRQ_REQ 0x02 |
64 | #define CONFIG_IO_REQ 0x04 |
65 | |
66 | /* Flags in socket state */ |
67 | #define SOCKET_PRESENT 0x0008 |
68 | #define SOCKET_INUSE 0x0010 |
69 | #define SOCKET_IN_RESUME 0x0040 |
70 | #define SOCKET_SUSPEND 0x0080 |
71 | #define SOCKET_WIN_REQ(i) (0x0100<<(i)) |
72 | #define SOCKET_CARDBUS 0x8000 |
73 | #define SOCKET_CARDBUS_CONFIG 0x10000 |
74 | |
75 | |
76 | /* |
77 | * Stuff internal to module "pcmcia_rsrc": |
78 | */ |
79 | extern int static_init(struct pcmcia_socket *s); |
80 | extern struct resource *pcmcia_make_resource(resource_size_t start, |
81 | resource_size_t end, |
82 | unsigned long flags, const char *name); |
83 | |
84 | /* |
85 | * Stuff internal to module "pcmcia_core": |
86 | */ |
87 | |
88 | /* socket_sysfs.c */ |
89 | extern int pccard_sysfs_add_socket(struct device *dev); |
90 | extern void pccard_sysfs_remove_socket(struct device *dev); |
91 | |
92 | /* cardbus.c */ |
93 | int cb_alloc(struct pcmcia_socket *s); |
94 | void cb_free(struct pcmcia_socket *s); |
95 | |
96 | |
97 | |
98 | /* |
99 | * Stuff exported by module "pcmcia_core" to module "pcmcia" |
100 | */ |
101 | |
102 | struct pcmcia_callback{ |
103 | struct module *owner; |
104 | int (*add) (struct pcmcia_socket *s); |
105 | int (*remove) (struct pcmcia_socket *s); |
106 | void (*requery) (struct pcmcia_socket *s); |
107 | int (*validate) (struct pcmcia_socket *s, unsigned int *i); |
108 | int (*suspend) (struct pcmcia_socket *s); |
109 | int (*early_resume) (struct pcmcia_socket *s); |
110 | int (*resume) (struct pcmcia_socket *s); |
111 | }; |
112 | |
113 | /* cs.c */ |
114 | extern struct rw_semaphore pcmcia_socket_list_rwsem; |
115 | extern struct list_head pcmcia_socket_list; |
116 | extern struct class pcmcia_socket_class; |
117 | |
118 | int pccard_register_pcmcia(struct pcmcia_socket *s, struct pcmcia_callback *c); |
119 | struct pcmcia_socket *pcmcia_get_socket_by_nr(unsigned int nr); |
120 | |
121 | void pcmcia_parse_uevents(struct pcmcia_socket *socket, unsigned int events); |
122 | #define PCMCIA_UEVENT_EJECT 0x0001 |
123 | #define PCMCIA_UEVENT_INSERT 0x0002 |
124 | #define PCMCIA_UEVENT_SUSPEND 0x0004 |
125 | #define PCMCIA_UEVENT_RESUME 0x0008 |
126 | #define PCMCIA_UEVENT_REQUERY 0x0010 |
127 | |
128 | struct pcmcia_socket *pcmcia_get_socket(struct pcmcia_socket *skt); |
129 | void pcmcia_put_socket(struct pcmcia_socket *skt); |
130 | |
131 | /* |
132 | * Stuff internal to module "pcmcia". |
133 | */ |
134 | /* ds.c */ |
135 | extern struct bus_type pcmcia_bus_type; |
136 | |
137 | struct pcmcia_device; |
138 | |
139 | /* pcmcia_resource.c */ |
140 | extern int pcmcia_release_configuration(struct pcmcia_device *p_dev); |
141 | extern int pcmcia_validate_mem(struct pcmcia_socket *s); |
142 | extern struct resource *pcmcia_find_mem_region(u_long base, |
143 | u_long num, |
144 | u_long align, |
145 | int low, |
146 | struct pcmcia_socket *s); |
147 | |
148 | void pcmcia_cleanup_irq(struct pcmcia_socket *s); |
149 | int pcmcia_setup_irq(struct pcmcia_device *p_dev); |
150 | |
151 | /* cistpl.c */ |
152 | extern const struct bin_attribute pccard_cis_attr; |
153 | |
154 | int pcmcia_read_cis_mem(struct pcmcia_socket *s, int attr, |
155 | u_int addr, u_int len, void *ptr); |
156 | int pcmcia_write_cis_mem(struct pcmcia_socket *s, int attr, |
157 | u_int addr, u_int len, void *ptr); |
158 | void release_cis_mem(struct pcmcia_socket *s); |
159 | void destroy_cis_cache(struct pcmcia_socket *s); |
160 | int pccard_read_tuple(struct pcmcia_socket *s, unsigned int function, |
161 | cisdata_t code, void *parse); |
162 | int pcmcia_replace_cis(struct pcmcia_socket *s, |
163 | const u8 *data, const size_t len); |
164 | int pccard_validate_cis(struct pcmcia_socket *s, unsigned int *count); |
165 | int verify_cis_cache(struct pcmcia_socket *s); |
166 | |
167 | int pccard_get_first_tuple(struct pcmcia_socket *s, unsigned int function, |
168 | tuple_t *tuple); |
169 | |
170 | int pccard_get_next_tuple(struct pcmcia_socket *s, unsigned int function, |
171 | tuple_t *tuple); |
172 | |
173 | int pccard_get_tuple_data(struct pcmcia_socket *s, tuple_t *tuple); |
174 | |
175 | #endif /* _LINUX_CS_INTERNAL_H */ |
176 | |