1 // SPDX-License-Identifier: GPL-2.0-only
3 * PCMCIA high-level CIS access functions
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.
9 * Copyright (C) 1999 David A. Hinds
10 * Copyright (C) 2004-2010 Dominik Brodowski
13 #include <linux/slab.h>
14 #include <linux/module.h>
15 #include <linux/kernel.h>
16 #include <linux/netdevice.h>
18 #include <pcmcia/cisreg.h>
19 #include <pcmcia/cistpl.h>
20 #include <pcmcia/ss.h>
21 #include <pcmcia/ds.h>
22 #include "cs_internal.h"
26 * pccard_read_tuple() - internal CIS tuple access
27 * @s: the struct pcmcia_socket where the card is inserted
28 * @function: the device function we loop for
29 * @code: which CIS code shall we look for?
30 * @parse: buffer where the tuple shall be parsed (or NULL, if no parse)
32 * pccard_read_tuple() reads out one tuple and attempts to parse it
34 int pccard_read_tuple(struct pcmcia_socket
*s
, unsigned int function
,
35 cisdata_t code
, void *parse
)
41 buf
= kmalloc(256, GFP_KERNEL
);
43 dev_warn(&s
->dev
, "no memory to read tuple\n");
46 tuple
.DesiredTuple
= code
;
48 if (function
== BIND_FN_ALL
)
49 tuple
.Attributes
= TUPLE_RETURN_COMMON
;
50 ret
= pccard_get_first_tuple(s
, function
, &tuple
);
53 tuple
.TupleData
= buf
;
54 tuple
.TupleOffset
= 0;
55 tuple
.TupleDataMax
= 255;
56 ret
= pccard_get_tuple_data(s
, &tuple
);
59 ret
= pcmcia_parse_tuple(&tuple
, parse
);
67 * pccard_loop_tuple() - loop over tuples in the CIS
68 * @s: the struct pcmcia_socket where the card is inserted
69 * @function: the device function we loop for
70 * @code: which CIS code shall we look for?
71 * @parse: buffer where the tuple shall be parsed (or NULL, if no parse)
72 * @priv_data: private data to be passed to the loop_tuple function.
73 * @loop_tuple: function to call for each CIS entry of type @function. IT
74 * gets passed the raw tuple, the paresed tuple (if @parse is
75 * set) and @priv_data.
77 * pccard_loop_tuple() loops over all CIS entries of type @function, and
78 * calls the @loop_tuple function for each entry. If the call to @loop_tuple
79 * returns 0, the loop exits. Returns 0 on success or errorcode otherwise.
81 int pccard_loop_tuple(struct pcmcia_socket
*s
, unsigned int function
,
82 cisdata_t code
, cisparse_t
*parse
, void *priv_data
,
83 int (*loop_tuple
) (tuple_t
*tuple
,
91 buf
= kzalloc(256, GFP_KERNEL
);
93 dev_warn(&s
->dev
, "no memory to read tuple\n");
97 tuple
.TupleData
= buf
;
98 tuple
.TupleDataMax
= 255;
99 tuple
.TupleOffset
= 0;
100 tuple
.DesiredTuple
= code
;
101 tuple
.Attributes
= 0;
103 ret
= pccard_get_first_tuple(s
, function
, &tuple
);
105 if (pccard_get_tuple_data(s
, &tuple
))
109 if (pcmcia_parse_tuple(&tuple
, parse
))
112 ret
= loop_tuple(&tuple
, parse
, priv_data
);
117 ret
= pccard_get_next_tuple(s
, function
, &tuple
);
126 * pcmcia_io_cfg_data_width() - convert cfgtable to data path width parameter
128 static int pcmcia_io_cfg_data_width(unsigned int flags
)
130 if (!(flags
& CISTPL_IO_8BIT
))
131 return IO_DATA_PATH_WIDTH_16
;
132 if (!(flags
& CISTPL_IO_16BIT
))
133 return IO_DATA_PATH_WIDTH_8
;
134 return IO_DATA_PATH_WIDTH_AUTO
;
138 struct pcmcia_cfg_mem
{
139 struct pcmcia_device
*p_dev
;
140 int (*conf_check
) (struct pcmcia_device
*p_dev
, void *priv_data
);
143 cistpl_cftable_entry_t dflt
;
147 * pcmcia_do_loop_config() - internal helper for pcmcia_loop_config()
149 * pcmcia_do_loop_config() is the internal callback for the call from
150 * pcmcia_loop_config() to pccard_loop_tuple(). Data is transferred
151 * by a struct pcmcia_cfg_mem.
153 static int pcmcia_do_loop_config(tuple_t
*tuple
, cisparse_t
*parse
, void *priv
)
155 struct pcmcia_cfg_mem
*cfg_mem
= priv
;
156 struct pcmcia_device
*p_dev
= cfg_mem
->p_dev
;
157 cistpl_cftable_entry_t
*cfg
= &parse
->cftable_entry
;
158 cistpl_cftable_entry_t
*dflt
= &cfg_mem
->dflt
;
159 unsigned int flags
= p_dev
->config_flags
;
160 unsigned int vcc
= p_dev
->socket
->socket
.Vcc
;
162 dev_dbg(&p_dev
->dev
, "testing configuration %x, autoconf %x\n",
166 cfg_mem
->p_dev
->config_index
= cfg
->index
;
167 if (cfg
->flags
& CISTPL_CFTABLE_DEFAULT
)
168 cfg_mem
->dflt
= *cfg
;
170 /* check for matching Vcc? */
171 if (flags
& CONF_AUTO_CHECK_VCC
) {
172 if (cfg
->vcc
.present
& (1 << CISTPL_POWER_VNOM
)) {
173 if (vcc
!= cfg
->vcc
.param
[CISTPL_POWER_VNOM
] / 10000)
175 } else if (dflt
->vcc
.present
& (1 << CISTPL_POWER_VNOM
)) {
176 if (vcc
!= dflt
->vcc
.param
[CISTPL_POWER_VNOM
] / 10000)
182 if (flags
& CONF_AUTO_SET_VPP
) {
183 if (cfg
->vpp1
.present
& (1 << CISTPL_POWER_VNOM
))
184 p_dev
->vpp
= cfg
->vpp1
.param
[CISTPL_POWER_VNOM
] / 10000;
185 else if (dflt
->vpp1
.present
& (1 << CISTPL_POWER_VNOM
))
187 dflt
->vpp1
.param
[CISTPL_POWER_VNOM
] / 10000;
191 if ((flags
& CONF_AUTO_AUDIO
) && (cfg
->flags
& CISTPL_CFTABLE_AUDIO
))
192 p_dev
->config_flags
|= CONF_ENABLE_SPKR
;
195 /* IO window settings? */
196 if (flags
& CONF_AUTO_SET_IO
) {
197 cistpl_io_t
*io
= (cfg
->io
.nwin
) ? &cfg
->io
: &dflt
->io
;
200 p_dev
->resource
[0]->start
= p_dev
->resource
[0]->end
= 0;
201 p_dev
->resource
[1]->start
= p_dev
->resource
[1]->end
= 0;
205 p_dev
->resource
[0]->flags
&= ~IO_DATA_PATH_WIDTH
;
206 p_dev
->resource
[0]->flags
|=
207 pcmcia_io_cfg_data_width(io
->flags
);
209 /* For multifunction cards, by convention, we
210 * configure the network function with window 0,
211 * and serial with window 1 */
212 i
= (io
->win
[1].len
> io
->win
[0].len
);
213 p_dev
->resource
[1]->flags
= p_dev
->resource
[0]->flags
;
214 p_dev
->resource
[1]->start
= io
->win
[1-i
].base
;
215 p_dev
->resource
[1]->end
= io
->win
[1-i
].len
;
217 p_dev
->resource
[0]->start
= io
->win
[i
].base
;
218 p_dev
->resource
[0]->end
= io
->win
[i
].len
;
219 p_dev
->io_lines
= io
->flags
& CISTPL_IO_LINES_MASK
;
222 /* MEM window settings? */
223 if (flags
& CONF_AUTO_SET_IOMEM
) {
224 /* so far, we only set one memory window */
225 cistpl_mem_t
*mem
= (cfg
->mem
.nwin
) ? &cfg
->mem
: &dflt
->mem
;
227 p_dev
->resource
[2]->start
= p_dev
->resource
[2]->end
= 0;
231 p_dev
->resource
[2]->start
= mem
->win
[0].host_addr
;
232 p_dev
->resource
[2]->end
= mem
->win
[0].len
;
233 if (p_dev
->resource
[2]->end
< 0x1000)
234 p_dev
->resource
[2]->end
= 0x1000;
235 p_dev
->card_addr
= mem
->win
[0].card_addr
;
239 "checking configuration %x: %pr %pr %pr (%d lines)\n",
240 p_dev
->config_index
, p_dev
->resource
[0], p_dev
->resource
[1],
241 p_dev
->resource
[2], p_dev
->io_lines
);
243 return cfg_mem
->conf_check(p_dev
, cfg_mem
->priv_data
);
247 * pcmcia_loop_config() - loop over configuration options
248 * @p_dev: the struct pcmcia_device which we need to loop for.
249 * @conf_check: function to call for each configuration option.
250 * It gets passed the struct pcmcia_device and private data
251 * being passed to pcmcia_loop_config()
252 * @priv_data: private data to be passed to the conf_check function.
254 * pcmcia_loop_config() loops over all configuration options, and calls
255 * the driver-specific conf_check() for each one, checking whether
256 * it is a valid one. Returns 0 on success or errorcode otherwise.
258 int pcmcia_loop_config(struct pcmcia_device
*p_dev
,
259 int (*conf_check
) (struct pcmcia_device
*p_dev
,
263 struct pcmcia_cfg_mem
*cfg_mem
;
266 cfg_mem
= kzalloc(sizeof(struct pcmcia_cfg_mem
), GFP_KERNEL
);
270 cfg_mem
->p_dev
= p_dev
;
271 cfg_mem
->conf_check
= conf_check
;
272 cfg_mem
->priv_data
= priv_data
;
274 ret
= pccard_loop_tuple(p_dev
->socket
, p_dev
->func
,
275 CISTPL_CFTABLE_ENTRY
, &cfg_mem
->parse
,
276 cfg_mem
, pcmcia_do_loop_config
);
281 EXPORT_SYMBOL(pcmcia_loop_config
);
284 struct pcmcia_loop_mem
{
285 struct pcmcia_device
*p_dev
;
287 int (*loop_tuple
) (struct pcmcia_device
*p_dev
,
293 * pcmcia_do_loop_tuple() - internal helper for pcmcia_loop_config()
295 * pcmcia_do_loop_tuple() is the internal callback for the call from
296 * pcmcia_loop_tuple() to pccard_loop_tuple(). Data is transferred
297 * by a struct pcmcia_cfg_mem.
299 static int pcmcia_do_loop_tuple(tuple_t
*tuple
, cisparse_t
*parse
, void *priv
)
301 struct pcmcia_loop_mem
*loop
= priv
;
303 return loop
->loop_tuple(loop
->p_dev
, tuple
, loop
->priv_data
);
307 * pcmcia_loop_tuple() - loop over tuples in the CIS
308 * @p_dev: the struct pcmcia_device which we need to loop for.
309 * @code: which CIS code shall we look for?
310 * @priv_data: private data to be passed to the loop_tuple function.
311 * @loop_tuple: function to call for each CIS entry of type @function. IT
312 * gets passed the raw tuple and @priv_data.
314 * pcmcia_loop_tuple() loops over all CIS entries of type @function, and
315 * calls the @loop_tuple function for each entry. If the call to @loop_tuple
316 * returns 0, the loop exits. Returns 0 on success or errorcode otherwise.
318 int pcmcia_loop_tuple(struct pcmcia_device
*p_dev
, cisdata_t code
,
319 int (*loop_tuple
) (struct pcmcia_device
*p_dev
,
324 struct pcmcia_loop_mem loop
= {
326 .loop_tuple
= loop_tuple
,
327 .priv_data
= priv_data
};
329 return pccard_loop_tuple(p_dev
->socket
, p_dev
->func
, code
, NULL
,
330 &loop
, pcmcia_do_loop_tuple
);
332 EXPORT_SYMBOL(pcmcia_loop_tuple
);
335 struct pcmcia_loop_get
{
341 * pcmcia_do_get_tuple() - internal helper for pcmcia_get_tuple()
343 * pcmcia_do_get_tuple() is the internal callback for the call from
344 * pcmcia_get_tuple() to pcmcia_loop_tuple(). As we're only interested in
345 * the first tuple, return 0 unconditionally. Create a memory buffer large
346 * enough to hold the content of the tuple, and fill it with the tuple data.
347 * The caller is responsible to free the buffer.
349 static int pcmcia_do_get_tuple(struct pcmcia_device
*p_dev
, tuple_t
*tuple
,
352 struct pcmcia_loop_get
*get
= priv
;
354 *get
->buf
= kzalloc(tuple
->TupleDataLen
, GFP_KERNEL
);
356 get
->len
= tuple
->TupleDataLen
;
357 memcpy(*get
->buf
, tuple
->TupleData
, tuple
->TupleDataLen
);
359 dev_dbg(&p_dev
->dev
, "do_get_tuple: out of memory\n");
364 * pcmcia_get_tuple() - get first tuple from CIS
365 * @p_dev: the struct pcmcia_device which we need to loop for.
366 * @code: which CIS code shall we look for?
367 * @buf: pointer to store the buffer to.
369 * pcmcia_get_tuple() gets the content of the first CIS entry of type @code.
370 * It returns the buffer length (or zero). The caller is responsible to free
371 * the buffer passed in @buf.
373 size_t pcmcia_get_tuple(struct pcmcia_device
*p_dev
, cisdata_t code
,
376 struct pcmcia_loop_get get
= {
382 pcmcia_loop_tuple(p_dev
, code
, pcmcia_do_get_tuple
, &get
);
386 EXPORT_SYMBOL(pcmcia_get_tuple
);
390 * pcmcia_do_get_mac() - internal helper for pcmcia_get_mac_from_cis()
392 * pcmcia_do_get_mac() is the internal callback for the call from
393 * pcmcia_get_mac_from_cis() to pcmcia_loop_tuple(). We check whether the
394 * tuple contains a proper LAN_NODE_ID of length 6, and copy the data
395 * to struct net_device->dev_addr[i].
397 static int pcmcia_do_get_mac(struct pcmcia_device
*p_dev
, tuple_t
*tuple
,
400 struct net_device
*dev
= priv
;
403 if (tuple
->TupleData
[0] != CISTPL_FUNCE_LAN_NODE_ID
)
405 if (tuple
->TupleDataLen
< ETH_ALEN
+ 2) {
406 dev_warn(&p_dev
->dev
, "Invalid CIS tuple length for "
411 if (tuple
->TupleData
[1] != ETH_ALEN
) {
412 dev_warn(&p_dev
->dev
, "Invalid header for LAN_NODE_ID\n");
415 for (i
= 0; i
< 6; i
++)
416 dev
->dev_addr
[i
] = tuple
->TupleData
[i
+2];
421 * pcmcia_get_mac_from_cis() - read out MAC address from CISTPL_FUNCE
422 * @p_dev: the struct pcmcia_device for which we want the address.
423 * @dev: a properly prepared struct net_device to store the info to.
425 * pcmcia_get_mac_from_cis() reads out the hardware MAC address from
426 * CISTPL_FUNCE and stores it into struct net_device *dev->dev_addr which
427 * must be set up properly by the driver (see examples!).
429 int pcmcia_get_mac_from_cis(struct pcmcia_device
*p_dev
, struct net_device
*dev
)
431 return pcmcia_loop_tuple(p_dev
, CISTPL_FUNCE
, pcmcia_do_get_mac
, dev
);
433 EXPORT_SYMBOL(pcmcia_get_mac_from_cis
);