2 * Copyright (c) 2008-2009 Atheros Communications Inc.
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 #include <linux/module.h>
22 #include <linux/kernel.h>
23 #include <linux/init.h>
24 #include <linux/slab.h>
25 #include <linux/types.h>
26 #include <linux/errno.h>
27 #include <linux/device.h>
28 #include <linux/firmware.h>
29 #include <linux/usb.h>
30 #include <net/bluetooth/bluetooth.h>
34 #define ATH3K_DNLOAD 0x01
35 #define ATH3K_GETSTATE 0x05
36 #define ATH3K_SET_NORMAL_MODE 0x07
37 #define ATH3K_GETVERSION 0x09
38 #define USB_REG_SWITCH_VID_PID 0x0a
40 #define ATH3K_MODE_MASK 0x3F
41 #define ATH3K_NORMAL_MODE 0x0E
43 #define ATH3K_PATCH_UPDATE 0x80
44 #define ATH3K_SYSCFG_UPDATE 0x40
46 #define ATH3K_XTAL_FREQ_26M 0x00
47 #define ATH3K_XTAL_FREQ_40M 0x01
48 #define ATH3K_XTAL_FREQ_19P2 0x02
49 #define ATH3K_NAME_LEN 0xFF
51 struct ath3k_version
{
52 unsigned int rom_version
;
53 unsigned int build_version
;
54 unsigned int ram_version
;
55 unsigned char ref_clock
;
56 unsigned char reserved
[0x07];
59 static struct usb_device_id ath3k_table
[] = {
61 { USB_DEVICE(0x0CF3, 0x3000) },
63 /* Atheros AR3011 with sflash firmware*/
64 { USB_DEVICE(0x0CF3, 0x3002) },
65 { USB_DEVICE(0x13d3, 0x3304) },
67 /* Atheros AR9285 Malbec with sflash firmware */
68 { USB_DEVICE(0x03F0, 0x311D) },
70 /* Atheros AR3012 with sflash firmware*/
71 { USB_DEVICE(0x0CF3, 0x3004) },
73 /* Atheros AR5BBU12 with sflash firmware */
74 { USB_DEVICE(0x0489, 0xE02C) },
76 { } /* Terminating entry */
79 MODULE_DEVICE_TABLE(usb
, ath3k_table
);
81 #define BTUSB_ATH3012 0x80
82 /* This table is to load patch and sysconfig files
84 static struct usb_device_id ath3k_blist_tbl
[] = {
86 /* Atheros AR3012 with sflash firmware*/
87 { USB_DEVICE(0x0cf3, 0x3004), .driver_info
= BTUSB_ATH3012
},
89 { } /* Terminating entry */
92 #define USB_REQ_DFU_DNLOAD 1
93 #define BULK_SIZE 4096
94 #define FW_HDR_SIZE 20
96 static int ath3k_load_firmware(struct usb_device
*udev
,
97 const struct firmware
*firmware
)
100 int err
, pipe
, len
, size
, sent
= 0;
101 int count
= firmware
->size
;
103 BT_DBG("udev %p", udev
);
105 pipe
= usb_sndctrlpipe(udev
, 0);
107 send_buf
= kmalloc(BULK_SIZE
, GFP_ATOMIC
);
109 BT_ERR("Can't allocate memory chunk for firmware");
113 memcpy(send_buf
, firmware
->data
, 20);
114 if ((err
= usb_control_msg(udev
, pipe
,
116 USB_TYPE_VENDOR
, 0, 0,
117 send_buf
, 20, USB_CTRL_SET_TIMEOUT
)) < 0) {
118 BT_ERR("Can't change to loading configuration err");
125 size
= min_t(uint
, count
, BULK_SIZE
);
126 pipe
= usb_sndbulkpipe(udev
, 0x02);
127 memcpy(send_buf
, firmware
->data
+ sent
, size
);
129 err
= usb_bulk_msg(udev
, pipe
, send_buf
, size
,
132 if (err
|| (len
!= size
)) {
133 BT_ERR("Error in firmware loading err = %d,"
134 "len = %d, size = %d", err
, len
, size
);
147 static int ath3k_get_state(struct usb_device
*udev
, unsigned char *state
)
151 pipe
= usb_rcvctrlpipe(udev
, 0);
152 return usb_control_msg(udev
, pipe
, ATH3K_GETSTATE
,
153 USB_TYPE_VENDOR
| USB_DIR_IN
, 0, 0,
154 state
, 0x01, USB_CTRL_SET_TIMEOUT
);
157 static int ath3k_get_version(struct usb_device
*udev
,
158 struct ath3k_version
*version
)
162 pipe
= usb_rcvctrlpipe(udev
, 0);
163 return usb_control_msg(udev
, pipe
, ATH3K_GETVERSION
,
164 USB_TYPE_VENDOR
| USB_DIR_IN
, 0, 0, version
,
165 sizeof(struct ath3k_version
),
166 USB_CTRL_SET_TIMEOUT
);
169 static int ath3k_load_fwfile(struct usb_device
*udev
,
170 const struct firmware
*firmware
)
173 int err
, pipe
, len
, size
, count
, sent
= 0;
176 count
= firmware
->size
;
178 send_buf
= kmalloc(BULK_SIZE
, GFP_ATOMIC
);
180 BT_ERR("Can't allocate memory chunk for firmware");
184 size
= min_t(uint
, count
, FW_HDR_SIZE
);
185 memcpy(send_buf
, firmware
->data
, size
);
187 pipe
= usb_sndctrlpipe(udev
, 0);
188 ret
= usb_control_msg(udev
, pipe
, ATH3K_DNLOAD
,
189 USB_TYPE_VENDOR
, 0, 0, send_buf
,
190 size
, USB_CTRL_SET_TIMEOUT
);
192 BT_ERR("Can't change to loading configuration err");
201 size
= min_t(uint
, count
, BULK_SIZE
);
202 pipe
= usb_sndbulkpipe(udev
, 0x02);
204 memcpy(send_buf
, firmware
->data
+ sent
, size
);
206 err
= usb_bulk_msg(udev
, pipe
, send_buf
, size
,
208 if (err
|| (len
!= size
)) {
209 BT_ERR("Error in firmware loading err = %d,"
210 "len = %d, size = %d", err
, len
, size
);
222 static int ath3k_switch_pid(struct usb_device
*udev
)
226 pipe
= usb_sndctrlpipe(udev
, 0);
227 return usb_control_msg(udev
, pipe
, USB_REG_SWITCH_VID_PID
,
228 USB_TYPE_VENDOR
, 0, 0,
229 NULL
, 0, USB_CTRL_SET_TIMEOUT
);
232 static int ath3k_set_normal_mode(struct usb_device
*udev
)
234 unsigned char fw_state
;
237 ret
= ath3k_get_state(udev
, &fw_state
);
239 BT_ERR("Can't get state to change to normal mode err");
243 if ((fw_state
& ATH3K_MODE_MASK
) == ATH3K_NORMAL_MODE
) {
244 BT_DBG("firmware was already in normal mode");
248 pipe
= usb_sndctrlpipe(udev
, 0);
249 return usb_control_msg(udev
, pipe
, ATH3K_SET_NORMAL_MODE
,
250 USB_TYPE_VENDOR
, 0, 0,
251 NULL
, 0, USB_CTRL_SET_TIMEOUT
);
254 static int ath3k_load_patch(struct usb_device
*udev
)
256 unsigned char fw_state
;
257 char filename
[ATH3K_NAME_LEN
] = {0};
258 const struct firmware
*firmware
;
259 struct ath3k_version fw_version
, pt_version
;
262 ret
= ath3k_get_state(udev
, &fw_state
);
264 BT_ERR("Can't get state to change to load ram patch err");
268 if (fw_state
& ATH3K_PATCH_UPDATE
) {
269 BT_DBG("Patch was already downloaded");
273 ret
= ath3k_get_version(udev
, &fw_version
);
275 BT_ERR("Can't get version to change to load ram patch err");
279 snprintf(filename
, ATH3K_NAME_LEN
, "ar3k/AthrBT_0x%08x.dfu",
280 fw_version
.rom_version
);
282 ret
= request_firmware(&firmware
, filename
, &udev
->dev
);
284 BT_ERR("Patch file not found %s", filename
);
288 pt_version
.rom_version
= *(int *)(firmware
->data
+ firmware
->size
- 8);
289 pt_version
.build_version
= *(int *)
290 (firmware
->data
+ firmware
->size
- 4);
292 if ((pt_version
.rom_version
!= fw_version
.rom_version
) ||
293 (pt_version
.build_version
<= fw_version
.build_version
)) {
294 BT_ERR("Patch file version did not match with firmware");
295 release_firmware(firmware
);
299 ret
= ath3k_load_fwfile(udev
, firmware
);
300 release_firmware(firmware
);
305 static int ath3k_load_syscfg(struct usb_device
*udev
)
307 unsigned char fw_state
;
308 char filename
[ATH3K_NAME_LEN
] = {0};
309 const struct firmware
*firmware
;
310 struct ath3k_version fw_version
;
313 ret
= ath3k_get_state(udev
, &fw_state
);
315 BT_ERR("Can't get state to change to load configration err");
319 ret
= ath3k_get_version(udev
, &fw_version
);
321 BT_ERR("Can't get version to change to load ram patch err");
325 switch (fw_version
.ref_clock
) {
327 case ATH3K_XTAL_FREQ_26M
:
330 case ATH3K_XTAL_FREQ_40M
:
333 case ATH3K_XTAL_FREQ_19P2
:
341 snprintf(filename
, ATH3K_NAME_LEN
, "ar3k/ramps_0x%08x_%d%s",
342 fw_version
.rom_version
, clk_value
, ".dfu");
344 ret
= request_firmware(&firmware
, filename
, &udev
->dev
);
346 BT_ERR("Configuration file not found %s", filename
);
350 ret
= ath3k_load_fwfile(udev
, firmware
);
351 release_firmware(firmware
);
356 static int ath3k_probe(struct usb_interface
*intf
,
357 const struct usb_device_id
*id
)
359 const struct firmware
*firmware
;
360 struct usb_device
*udev
= interface_to_usbdev(intf
);
363 BT_DBG("intf %p id %p", intf
, id
);
365 if (intf
->cur_altsetting
->desc
.bInterfaceNumber
!= 0)
368 /* match device ID in ath3k blacklist table */
369 if (!id
->driver_info
) {
370 const struct usb_device_id
*match
;
371 match
= usb_match_id(intf
, ath3k_blist_tbl
);
376 /* load patch and sysconfig files for AR3012 */
377 if (id
->driver_info
& BTUSB_ATH3012
) {
378 ret
= ath3k_load_patch(udev
);
380 BT_ERR("Loading patch file failed");
383 ret
= ath3k_load_syscfg(udev
);
385 BT_ERR("Loading sysconfig file failed");
388 ret
= ath3k_set_normal_mode(udev
);
390 BT_ERR("Set normal mode failed");
393 ath3k_switch_pid(udev
);
397 if (request_firmware(&firmware
, "ath3k-1.fw", &udev
->dev
) < 0) {
398 BT_ERR("Error loading firmware");
402 ret
= ath3k_load_firmware(udev
, firmware
);
403 release_firmware(firmware
);
408 static void ath3k_disconnect(struct usb_interface
*intf
)
410 BT_DBG("ath3k_disconnect intf %p", intf
);
413 static struct usb_driver ath3k_driver
= {
415 .probe
= ath3k_probe
,
416 .disconnect
= ath3k_disconnect
,
417 .id_table
= ath3k_table
,
420 static int __init
ath3k_init(void)
422 BT_INFO("Atheros AR30xx firmware driver ver %s", VERSION
);
423 return usb_register(&ath3k_driver
);
426 static void __exit
ath3k_exit(void)
428 usb_deregister(&ath3k_driver
);
431 module_init(ath3k_init
);
432 module_exit(ath3k_exit
);
434 MODULE_AUTHOR("Atheros Communications");
435 MODULE_DESCRIPTION("Atheros AR30xx firmware driver");
436 MODULE_VERSION(VERSION
);
437 MODULE_LICENSE("GPL");
438 MODULE_FIRMWARE("ath3k-1.fw");