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) },
66 /* Atheros AR9285 Malbec with sflash firmware */
67 { USB_DEVICE(0x03F0, 0x311D) },
69 /* Atheros AR3012 with sflash firmware*/
70 { USB_DEVICE(0x0CF3, 0x3004) },
72 /* Atheros AR5BBU12 with sflash firmware */
73 { USB_DEVICE(0x0489, 0xE02C) },
75 { } /* Terminating entry */
78 MODULE_DEVICE_TABLE(usb
, ath3k_table
);
80 #define BTUSB_ATH3012 0x80
81 /* This table is to load patch and sysconfig files
83 static struct usb_device_id ath3k_blist_tbl
[] = {
85 /* Atheros AR3012 with sflash firmware*/
86 { USB_DEVICE(0x0cf3, 0x3004), .driver_info
= BTUSB_ATH3012
},
88 { } /* Terminating entry */
91 #define USB_REQ_DFU_DNLOAD 1
92 #define BULK_SIZE 4096
93 #define FW_HDR_SIZE 20
95 static int ath3k_load_firmware(struct usb_device
*udev
,
96 const struct firmware
*firmware
)
99 int err
, pipe
, len
, size
, sent
= 0;
100 int count
= firmware
->size
;
102 BT_DBG("udev %p", udev
);
104 pipe
= usb_sndctrlpipe(udev
, 0);
106 send_buf
= kmalloc(BULK_SIZE
, GFP_ATOMIC
);
108 BT_ERR("Can't allocate memory chunk for firmware");
112 memcpy(send_buf
, firmware
->data
, 20);
113 if ((err
= usb_control_msg(udev
, pipe
,
115 USB_TYPE_VENDOR
, 0, 0,
116 send_buf
, 20, USB_CTRL_SET_TIMEOUT
)) < 0) {
117 BT_ERR("Can't change to loading configuration err");
124 size
= min_t(uint
, count
, BULK_SIZE
);
125 pipe
= usb_sndbulkpipe(udev
, 0x02);
126 memcpy(send_buf
, firmware
->data
+ sent
, size
);
128 err
= usb_bulk_msg(udev
, pipe
, send_buf
, size
,
131 if (err
|| (len
!= size
)) {
132 BT_ERR("Error in firmware loading err = %d,"
133 "len = %d, size = %d", err
, len
, size
);
149 static int ath3k_get_state(struct usb_device
*udev
, unsigned char *state
)
153 pipe
= usb_rcvctrlpipe(udev
, 0);
154 return usb_control_msg(udev
, pipe
, ATH3K_GETSTATE
,
155 USB_TYPE_VENDOR
| USB_DIR_IN
, 0, 0,
156 state
, 0x01, USB_CTRL_SET_TIMEOUT
);
159 static int ath3k_get_version(struct usb_device
*udev
,
160 struct ath3k_version
*version
)
164 pipe
= usb_rcvctrlpipe(udev
, 0);
165 return usb_control_msg(udev
, pipe
, ATH3K_GETVERSION
,
166 USB_TYPE_VENDOR
| USB_DIR_IN
, 0, 0, version
,
167 sizeof(struct ath3k_version
),
168 USB_CTRL_SET_TIMEOUT
);
171 static int ath3k_load_fwfile(struct usb_device
*udev
,
172 const struct firmware
*firmware
)
175 int err
, pipe
, len
, size
, count
, sent
= 0;
178 count
= firmware
->size
;
180 send_buf
= kmalloc(BULK_SIZE
, GFP_ATOMIC
);
182 BT_ERR("Can't allocate memory chunk for firmware");
186 size
= min_t(uint
, count
, FW_HDR_SIZE
);
187 memcpy(send_buf
, firmware
->data
, size
);
189 pipe
= usb_sndctrlpipe(udev
, 0);
190 ret
= usb_control_msg(udev
, pipe
, ATH3K_DNLOAD
,
191 USB_TYPE_VENDOR
, 0, 0, send_buf
,
192 size
, USB_CTRL_SET_TIMEOUT
);
194 BT_ERR("Can't change to loading configuration err");
203 size
= min_t(uint
, count
, BULK_SIZE
);
204 pipe
= usb_sndbulkpipe(udev
, 0x02);
206 memcpy(send_buf
, firmware
->data
+ sent
, size
);
208 err
= usb_bulk_msg(udev
, pipe
, send_buf
, size
,
210 if (err
|| (len
!= size
)) {
211 BT_ERR("Error in firmware loading err = %d,"
212 "len = %d, size = %d", err
, len
, size
);
224 static int ath3k_switch_pid(struct usb_device
*udev
)
228 pipe
= usb_sndctrlpipe(udev
, 0);
229 return usb_control_msg(udev
, pipe
, USB_REG_SWITCH_VID_PID
,
230 USB_TYPE_VENDOR
, 0, 0,
231 NULL
, 0, USB_CTRL_SET_TIMEOUT
);
234 static int ath3k_set_normal_mode(struct usb_device
*udev
)
236 unsigned char fw_state
;
239 ret
= ath3k_get_state(udev
, &fw_state
);
241 BT_ERR("Can't get state to change to normal mode err");
245 if ((fw_state
& ATH3K_MODE_MASK
) == ATH3K_NORMAL_MODE
) {
246 BT_DBG("firmware was already in normal mode");
250 pipe
= usb_sndctrlpipe(udev
, 0);
251 return usb_control_msg(udev
, pipe
, ATH3K_SET_NORMAL_MODE
,
252 USB_TYPE_VENDOR
, 0, 0,
253 NULL
, 0, USB_CTRL_SET_TIMEOUT
);
256 static int ath3k_load_patch(struct usb_device
*udev
)
258 unsigned char fw_state
;
259 char filename
[ATH3K_NAME_LEN
] = {0};
260 const struct firmware
*firmware
;
261 struct ath3k_version fw_version
, pt_version
;
264 ret
= ath3k_get_state(udev
, &fw_state
);
266 BT_ERR("Can't get state to change to load ram patch err");
270 if (fw_state
& ATH3K_PATCH_UPDATE
) {
271 BT_DBG("Patch was already downloaded");
275 ret
= ath3k_get_version(udev
, &fw_version
);
277 BT_ERR("Can't get version to change to load ram patch err");
281 snprintf(filename
, ATH3K_NAME_LEN
, "ar3k/AthrBT_0x%08x.dfu",
282 fw_version
.rom_version
);
284 ret
= request_firmware(&firmware
, filename
, &udev
->dev
);
286 BT_ERR("Patch file not found %s", filename
);
290 pt_version
.rom_version
= *(int *)(firmware
->data
+ firmware
->size
- 8);
291 pt_version
.build_version
= *(int *)
292 (firmware
->data
+ firmware
->size
- 4);
294 if ((pt_version
.rom_version
!= fw_version
.rom_version
) ||
295 (pt_version
.build_version
<= fw_version
.build_version
)) {
296 BT_ERR("Patch file version did not match with firmware");
297 release_firmware(firmware
);
301 ret
= ath3k_load_fwfile(udev
, firmware
);
302 release_firmware(firmware
);
307 static int ath3k_load_syscfg(struct usb_device
*udev
)
309 unsigned char fw_state
;
310 char filename
[ATH3K_NAME_LEN
] = {0};
311 const struct firmware
*firmware
;
312 struct ath3k_version fw_version
;
315 ret
= ath3k_get_state(udev
, &fw_state
);
317 BT_ERR("Can't get state to change to load configration err");
321 ret
= ath3k_get_version(udev
, &fw_version
);
323 BT_ERR("Can't get version to change to load ram patch err");
327 switch (fw_version
.ref_clock
) {
329 case ATH3K_XTAL_FREQ_26M
:
332 case ATH3K_XTAL_FREQ_40M
:
335 case ATH3K_XTAL_FREQ_19P2
:
343 snprintf(filename
, ATH3K_NAME_LEN
, "ar3k/ramps_0x%08x_%d%s",
344 fw_version
.rom_version
, clk_value
, ".dfu");
346 ret
= request_firmware(&firmware
, filename
, &udev
->dev
);
348 BT_ERR("Configuration file not found %s", filename
);
352 ret
= ath3k_load_fwfile(udev
, firmware
);
353 release_firmware(firmware
);
358 static int ath3k_probe(struct usb_interface
*intf
,
359 const struct usb_device_id
*id
)
361 const struct firmware
*firmware
;
362 struct usb_device
*udev
= interface_to_usbdev(intf
);
365 BT_DBG("intf %p id %p", intf
, id
);
367 if (intf
->cur_altsetting
->desc
.bInterfaceNumber
!= 0)
370 /* match device ID in ath3k blacklist table */
371 if (!id
->driver_info
) {
372 const struct usb_device_id
*match
;
373 match
= usb_match_id(intf
, ath3k_blist_tbl
);
378 /* load patch and sysconfig files for AR3012 */
379 if (id
->driver_info
& BTUSB_ATH3012
) {
380 ret
= ath3k_load_patch(udev
);
382 BT_ERR("Loading patch file failed");
385 ret
= ath3k_load_syscfg(udev
);
387 BT_ERR("Loading sysconfig file failed");
390 ret
= ath3k_set_normal_mode(udev
);
392 BT_ERR("Set normal mode failed");
395 ath3k_switch_pid(udev
);
399 if (request_firmware(&firmware
, "ath3k-1.fw", &udev
->dev
) < 0) {
400 BT_ERR("Error loading firmware");
404 ret
= ath3k_load_firmware(udev
, firmware
);
405 release_firmware(firmware
);
410 static void ath3k_disconnect(struct usb_interface
*intf
)
412 BT_DBG("ath3k_disconnect intf %p", intf
);
415 static struct usb_driver ath3k_driver
= {
417 .probe
= ath3k_probe
,
418 .disconnect
= ath3k_disconnect
,
419 .id_table
= ath3k_table
,
422 static int __init
ath3k_init(void)
424 BT_INFO("Atheros AR30xx firmware driver ver %s", VERSION
);
425 return usb_register(&ath3k_driver
);
428 static void __exit
ath3k_exit(void)
430 usb_deregister(&ath3k_driver
);
433 module_init(ath3k_init
);
434 module_exit(ath3k_exit
);
436 MODULE_AUTHOR("Atheros Communications");
437 MODULE_DESCRIPTION("Atheros AR30xx firmware driver");
438 MODULE_VERSION(VERSION
);
439 MODULE_LICENSE("GPL");
440 MODULE_FIRMWARE("ath3k-1.fw");