2 * Intel Wireless WiMAX Connection 2400m
3 * Firmware uploader's SDIO specifics
6 * Copyright (C) 2007-2008 Intel Corporation. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * * Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
18 * * Neither the name of Intel Corporation nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 * Intel Corporation <linux-wimax@intel.com>
36 * Yanir Lubetkin <yanirx.lubetkin@intel.com>
37 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
38 * - Initial implementation
40 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
41 * - Bus generic/specific split for USB
43 * Dirk Brandewie <dirk.j.brandewie@intel.com>
44 * - Initial implementation for SDIO
46 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
47 * - SDIO rehash for changes in the bus-driver model
51 * See fw.c for the generic description of this procedure.
53 * This file implements only the SDIO specifics. It boils down to how
54 * to send a command and waiting for an acknowledgement from the
55 * device. We do polled reads.
59 * THe generic firmware upload code will call i2400m_bus_bm_cmd_send()
62 * The SDIO devices expects things in 256 byte blocks, so it will pad
63 * it, compute the checksum (if needed) and pass it to SDIO.
67 * This works in polling mode -- the fw loader says when to wait for
68 * data and for that it calls i2400ms_bus_bm_wait_for_ack().
70 * This will poll the device for data until it is received. We need to
71 * receive at least as much bytes as where asked for (although it'll
72 * always be a multiple of 256 bytes).
74 #include <linux/mmc/sdio_func.h>
75 #include "i2400m-sdio.h"
78 #define D_SUBMODULE fw
79 #include "sdio-debug-levels.h"
82 * Send a boot-mode command to the SDIO function
84 * We use a bounce buffer (i2400m->bm_cmd_buf) because we need to
85 * touch the header if the RAW flag is not set.
87 * @flags: pass thru from i2400m_bm_cmd()
88 * @return: cmd_size if ok, < 0 errno code on error.
90 * Note the command is padded to the SDIO block size for the device.
92 ssize_t
i2400ms_bus_bm_cmd_send(struct i2400m
*i2400m
,
93 const struct i2400m_bootrom_header
*_cmd
,
94 size_t cmd_size
, int flags
)
97 struct device
*dev
= i2400m_dev(i2400m
);
98 struct i2400ms
*i2400ms
= container_of(i2400m
, struct i2400ms
, i2400m
);
99 int opcode
= _cmd
== NULL
? -1 : i2400m_brh_get_opcode(_cmd
);
100 struct i2400m_bootrom_header
*cmd
;
101 /* SDIO restriction */
102 size_t cmd_size_a
= ALIGN(cmd_size
, I2400MS_BLK_SIZE
);
104 d_fnstart(5, dev
, "(i2400m %p cmd %p size %zu)\n",
105 i2400m
, _cmd
, cmd_size
);
107 if (cmd_size
> I2400M_BM_CMD_BUF_SIZE
)
110 memcpy(i2400m
->bm_cmd_buf
, _cmd
, cmd_size
); /* Prep command */
111 cmd
= i2400m
->bm_cmd_buf
;
112 if (cmd_size_a
> cmd_size
) /* Zero pad space */
113 memset(i2400m
->bm_cmd_buf
+ cmd_size
, 0, cmd_size_a
- cmd_size
);
114 if ((flags
& I2400M_BM_CMD_RAW
) == 0) {
115 if (WARN_ON(i2400m_brh_get_response_required(cmd
) == 0))
116 dev_warn(dev
, "SW BUG: response_required == 0\n");
117 i2400m_bm_cmd_prepare(cmd
);
119 d_printf(4, dev
, "BM cmd %d: %zu bytes (%zu padded)\n",
120 opcode
, cmd_size
, cmd_size_a
);
121 d_dump(5, dev
, cmd
, cmd_size
);
123 sdio_claim_host(i2400ms
->func
); /* Send & check */
124 result
= sdio_memcpy_toio(i2400ms
->func
, I2400MS_DATA_ADDR
,
125 i2400m
->bm_cmd_buf
, cmd_size_a
);
126 sdio_release_host(i2400ms
->func
);
128 dev_err(dev
, "BM cmd %d: cannot send: %ld\n",
129 opcode
, (long) result
);
135 d_fnend(5, dev
, "(i2400m %p cmd %p size %zu) = %d\n",
136 i2400m
, _cmd
, cmd_size
, (int) result
);
142 * Read an ack from the device's boot-mode (polling)
145 * @_ack: pointer to where to store the read data
146 * @ack_size: how many bytes we should read
148 * Returns: < 0 errno code on error; otherwise, amount of received bytes.
150 * The ACK for a BM command is always at least sizeof(*ack) bytes, so
151 * check for that. We don't need to check for device reboots
153 * NOTE: We do an artificial timeout of 1 sec over the SDIO timeout;
154 * this way we have control over it...there is no way that I know
155 * of setting an SDIO transaction timeout.
157 ssize_t
i2400ms_bus_bm_wait_for_ack(struct i2400m
*i2400m
,
158 struct i2400m_bootrom_header
*ack
,
164 struct i2400ms
*i2400ms
= container_of(i2400m
, struct i2400ms
, i2400m
);
165 struct sdio_func
*func
= i2400ms
->func
;
166 struct device
*dev
= &func
->dev
;
168 BUG_ON(sizeof(*ack
) > ack_size
);
170 d_fnstart(5, dev
, "(i2400m %p ack %p size %zu)\n",
171 i2400m
, ack
, ack_size
);
173 timeout
= get_jiffies_64() + 2 * HZ
;
174 sdio_claim_host(func
);
176 if (time_after64(get_jiffies_64(), timeout
)) {
177 rx_size
= -ETIMEDOUT
;
178 dev_err(dev
, "timeout waiting for ack data\n");
182 /* Find the RX size, check if it fits or not -- it if
183 * doesn't fit, fail, as we have no way to dispose of
185 rx_size
= __i2400ms_rx_get_size(i2400ms
);
187 goto error_rx_get_size
;
188 result
= -ENOSPC
; /* Check it fits */
189 if (rx_size
< sizeof(*ack
)) {
191 dev_err(dev
, "HW BUG? received is too small (%zu vs "
192 "%zu needed)\n", sizeof(*ack
), rx_size
);
193 goto error_too_small
;
195 if (rx_size
> I2400M_BM_ACK_BUF_SIZE
) {
196 dev_err(dev
, "SW BUG? BM_ACK_BUF is too small (%u vs "
197 "%zu needed)\n", I2400M_BM_ACK_BUF_SIZE
,
199 goto error_too_small
;
203 result
= sdio_memcpy_fromio(func
, i2400m
->bm_ack_buf
,
204 I2400MS_DATA_ADDR
, rx_size
);
205 if (result
== -ETIMEDOUT
|| result
== -ETIME
)
208 dev_err(dev
, "BM SDIO receive (%zu B) failed: %d\n",
214 rx_size
= min((ssize_t
)ack_size
, rx_size
);
215 memcpy(ack
, i2400m
->bm_ack_buf
, rx_size
);
220 sdio_release_host(func
);
221 d_fnend(5, dev
, "(i2400m %p ack %p size %zu) = %ld\n",
222 i2400m
, ack
, ack_size
, (long) rx_size
);
This page took 0.040612 seconds and 5 git commands to generate.