2 * Marvell BT-over-SDIO driver: SDIO interface related functions.
4 * Copyright (C) 2009, Marvell International Ltd.
6 * This software file (the "File") is distributed by Marvell International
7 * Ltd. under the terms of the GNU General Public License Version 2, June 1991
8 * (the "License"). You may use, redistribute and/or modify this File in
9 * accordance with the terms and conditions of the License, a copy of which
10 * is available by writing to the Free Software Foundation, Inc.,
11 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the
12 * worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
15 * THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
17 * ARE EXPRESSLY DISCLAIMED. The License provides additional details about
18 * this warranty disclaimer.
21 #include <linux/firmware.h>
23 #include <linux/mmc/sdio_ids.h>
24 #include <linux/mmc/sdio_func.h>
26 #include <net/bluetooth/bluetooth.h>
27 #include <net/bluetooth/hci_core.h>
29 #include "btmrvl_drv.h"
30 #include "btmrvl_sdio.h"
34 #ifndef SDIO_DEVICE_ID_MARVELL_8688BT
35 #define SDIO_DEVICE_ID_MARVELL_8688BT 0x9105
38 /* The btmrvl_sdio_remove() callback function is called
39 * when user removes this module from kernel space or ejects
40 * the card from the slot. The driver handles these 2 cases
42 * If the user is removing the module, a MODULE_SHUTDOWN_REQ
43 * command is sent to firmware and interrupt will be disabled.
44 * If the card is removed, there is no need to send command
45 * or disable interrupt.
47 * The variable 'user_rmmod' is used to distinguish these two
48 * scenarios. This flag is initialized as FALSE in case the card
49 * is removed, and will be set to TRUE for module removal when
50 * module_exit function is called.
54 static const struct sdio_device_id btmrvl_sdio_ids[] = {
55 {SDIO_DEVICE(SDIO_VENDOR_ID_MARVELL, SDIO_DEVICE_ID_MARVELL_8688BT)},
59 MODULE_DEVICE_TABLE(sdio, btmrvl_sdio_ids);
61 static struct btmrvl_sdio_device btmrvl_sdio_devices[] = {
63 .dev_id = SDIO_DEVICE_ID_MARVELL_8688BT,
64 .helper = "sd8688_helper.bin",
65 .firmware = "sd8688.bin",
69 static int btmrvl_sdio_get_rx_unit(struct btmrvl_sdio_card *card)
76 reg = sdio_readb(card->func, CARD_RX_UNIT_REG, &ret);
85 static int btmrvl_sdio_read_fw_status(struct btmrvl_sdio_card *card, u16 *dat)
94 fws0 = sdio_readb(card->func, CARD_FW_STATUS0_REG, &ret);
97 fws1 = sdio_readb(card->func, CARD_FW_STATUS1_REG, &ret);
104 *dat = (((u16) fws1) << 8) | fws0;
111 static int btmrvl_sdio_read_rx_len(struct btmrvl_sdio_card *card, u16 *dat)
118 reg = sdio_readb(card->func, CARD_RX_LEN_REG, &ret);
120 *dat = (u16) reg << card->rx_unit;
127 static int btmrvl_sdio_enable_host_int_mask(struct btmrvl_sdio_card *card,
134 sdio_writeb(card->func, mask, HOST_INT_MASK_REG, &ret);
136 BT_ERR("Unable to enable the host interrupt!");
145 static int btmrvl_sdio_disable_host_int_mask(struct btmrvl_sdio_card *card,
153 host_int_mask = sdio_readb(card->func, HOST_INT_MASK_REG, &ret);
159 host_int_mask &= ~mask;
161 sdio_writeb(card->func, host_int_mask, HOST_INT_MASK_REG, &ret);
163 BT_ERR("Unable to disable the host interrupt!");
176 static int btmrvl_sdio_poll_card_status(struct btmrvl_sdio_card *card, u8 bits)
184 for (tries = 0; tries < MAX_POLL_TRIES * 1000; tries++) {
185 status = sdio_readb(card->func, CARD_STATUS_REG, &ret);
188 if ((status & bits) == bits)
197 BT_ERR("FAILED! ret=%d", ret);
205 static int btmrvl_sdio_verify_fw_download(struct btmrvl_sdio_card *card,
208 int ret = -ETIMEDOUT;
214 /* Wait for firmware to become ready */
215 for (tries = 0; tries < pollnum; tries++) {
216 if (btmrvl_sdio_read_fw_status(card, &firmwarestat) < 0)
219 if (firmwarestat == FIRMWARE_READY) {
232 static int btmrvl_sdio_download_helper(struct btmrvl_sdio_card *card)
234 const struct firmware *fw_helper = NULL;
235 const u8 *helper = NULL;
237 void *tmphlprbuf = NULL;
238 int tmphlprbufsz, hlprblknow, helperlen;
244 ret = request_firmware(&fw_helper, card->helper,
246 if ((ret < 0) || !fw_helper) {
247 BT_ERR("request_firmware(helper) failed, error code = %d",
253 helper = fw_helper->data;
254 helperlen = fw_helper->size;
256 BT_DBG("Downloading helper image (%d bytes), block size %d bytes",
257 helperlen, SDIO_BLOCK_SIZE);
259 tmphlprbufsz = ALIGN_SZ(BTM_UPLD_SIZE, BTSDIO_DMA_ALIGN);
261 tmphlprbuf = kmalloc(tmphlprbufsz, GFP_KERNEL);
263 BT_ERR("Unable to allocate buffer for helper."
264 " Terminating download");
269 memset(tmphlprbuf, 0, tmphlprbufsz);
271 helperbuf = (u8 *) ALIGN_ADDR(tmphlprbuf, BTSDIO_DMA_ALIGN);
273 /* Perform helper data transfer */
274 tx_len = (FIRMWARE_TRANSFER_NBLOCK * SDIO_BLOCK_SIZE)
279 ret = btmrvl_sdio_poll_card_status(card,
280 CARD_IO_READY | DN_LD_CARD_RDY);
282 BT_ERR("Helper download poll status timeout @ %d",
287 /* Check if there is more data? */
288 if (hlprblknow >= helperlen)
291 if (helperlen - hlprblknow < tx_len)
292 tx_len = helperlen - hlprblknow;
295 helperbuf[0] = ((tx_len & 0x000000ff) >> 0);
296 helperbuf[1] = ((tx_len & 0x0000ff00) >> 8);
297 helperbuf[2] = ((tx_len & 0x00ff0000) >> 16);
298 helperbuf[3] = ((tx_len & 0xff000000) >> 24);
300 memcpy(&helperbuf[SDIO_HEADER_LEN], &helper[hlprblknow],
303 /* Now send the data */
304 ret = sdio_writesb(card->func, card->ioport,
306 FIRMWARE_TRANSFER_NBLOCK *
309 BT_ERR("IO error during helper download @ %d",
314 hlprblknow += tx_len;
317 BT_DBG("Transferring helper image EOF block");
319 memset(helperbuf, 0x0, SDIO_BLOCK_SIZE);
321 ret = sdio_writesb(card->func, card->ioport, helperbuf,
324 BT_ERR("IO error in writing helper image EOF block");
333 release_firmware(fw_helper);
340 static int btmrvl_sdio_download_fw_w_helper(struct btmrvl_sdio_card *card)
342 const struct firmware *fw_firmware = NULL;
343 const u8 *firmware = NULL;
344 int firmwarelen, tmpfwbufsz, ret;
345 unsigned int tries, offset;
347 void *tmpfwbuf = NULL;
350 int txlen = 0, tx_blocks = 0, count = 0;
354 ret = request_firmware(&fw_firmware, card->firmware,
356 if ((ret < 0) || !fw_firmware) {
357 BT_ERR("request_firmware(firmware) failed, error code = %d",
363 firmware = fw_firmware->data;
364 firmwarelen = fw_firmware->size;
366 BT_DBG("Downloading FW image (%d bytes)", firmwarelen);
368 tmpfwbufsz = ALIGN_SZ(BTM_UPLD_SIZE, BTSDIO_DMA_ALIGN);
369 tmpfwbuf = kmalloc(tmpfwbufsz, GFP_KERNEL);
371 BT_ERR("Unable to allocate buffer for firmware."
372 " Terminating download");
377 memset(tmpfwbuf, 0, tmpfwbufsz);
379 /* Ensure aligned firmware buffer */
380 fwbuf = (u8 *) ALIGN_ADDR(tmpfwbuf, BTSDIO_DMA_ALIGN);
382 /* Perform firmware data transfer */
385 ret = btmrvl_sdio_poll_card_status(card,
386 CARD_IO_READY | DN_LD_CARD_RDY);
388 BT_ERR("FW download with helper poll status"
389 " timeout @ %d", offset);
393 /* Check if there is more data ? */
394 if (offset >= firmwarelen)
397 for (tries = 0; tries < MAX_POLL_TRIES; tries++) {
398 base0 = sdio_readb(card->func,
399 SQ_READ_BASE_ADDRESS_A0_REG, &ret);
401 BT_ERR("BASE0 register read failed:"
402 " base0 = 0x%04X(%d)."
403 " Terminating download",
408 base1 = sdio_readb(card->func,
409 SQ_READ_BASE_ADDRESS_A1_REG, &ret);
411 BT_ERR("BASE1 register read failed:"
412 " base1 = 0x%04X(%d)."
413 " Terminating download",
419 len = (((u16) base1) << 8) | base0;
428 else if (len > BTM_UPLD_SIZE) {
429 BT_ERR("FW download failure @%d, invalid length %d",
439 if (count > MAX_WRITE_IOMEM_RETRY) {
440 BT_ERR("FW download failure @%d, "
441 "over max retry count", offset);
445 BT_ERR("FW CRC error indicated by the helper: "
446 "len = 0x%04X, txlen = %d", len, txlen);
448 /* Set txlen to 0 so as to resend from same offset */
454 if (firmwarelen - offset < txlen)
455 txlen = firmwarelen - offset;
458 (txlen + SDIO_BLOCK_SIZE - 1) / SDIO_BLOCK_SIZE;
460 memcpy(fwbuf, &firmware[offset], txlen);
463 ret = sdio_writesb(card->func, card->ioport, fwbuf,
464 tx_blocks * SDIO_BLOCK_SIZE);
467 BT_ERR("FW download, writesb(%d) failed @%d",
469 sdio_writeb(card->func, HOST_CMD53_FIN, CONFIG_REG,
472 BT_ERR("writeb failed (CFG)");
478 BT_DBG("FW download over, size %d bytes", offset);
486 release_firmware(fw_firmware);
493 static int btmrvl_sdio_card_to_host(struct btmrvl_private *priv)
496 int ret, buf_block_len, blksz;
497 struct sk_buff *skb = NULL;
500 struct hci_dev *hdev = priv->btmrvl_dev.hcidev;
501 struct btmrvl_sdio_card *card = priv->btmrvl_dev.card;
505 if (!card || !card->func) {
506 BT_ERR("card or function is NULL!");
511 /* Read the length of data to be transferred */
512 ret = btmrvl_sdio_read_rx_len(card, &buf_len);
514 BT_ERR("read rx_len failed");
519 blksz = SDIO_BLOCK_SIZE;
520 buf_block_len = (buf_len + blksz - 1) / blksz;
522 if (buf_len <= SDIO_HEADER_LEN
523 || (buf_block_len * blksz) > ALLOC_BUF_SIZE) {
524 BT_ERR("invalid packet length: %d", buf_len);
529 /* Allocate buffer */
530 skb = bt_skb_alloc(buf_block_len * blksz + BTSDIO_DMA_ALIGN,
533 BT_ERR("No free skb");
537 if ((u32) skb->data & (BTSDIO_DMA_ALIGN - 1)) {
538 skb_put(skb, (u32) skb->data & (BTSDIO_DMA_ALIGN - 1));
539 skb_pull(skb, (u32) skb->data & (BTSDIO_DMA_ALIGN - 1));
544 ret = sdio_readsb(card->func, payload, card->ioport,
545 buf_block_len * blksz);
547 BT_ERR("readsb failed: %d", ret);
552 /* This is SDIO specific header length: byte[2][1][0], type: byte[3]
553 * (HCI_COMMAND = 1, ACL_DATA = 2, SCO_DATA = 3, 0xFE = Vendor)
556 buf_len = payload[0];
557 buf_len |= (u16) payload[1] << 8;
561 case HCI_ACLDATA_PKT:
562 case HCI_SCODATA_PKT:
564 bt_cb(skb)->pkt_type = type;
565 skb->dev = (void *)hdev;
566 skb_put(skb, buf_len);
567 skb_pull(skb, SDIO_HEADER_LEN);
569 if (type == HCI_EVENT_PKT)
570 btmrvl_check_evtpkt(priv, skb);
573 hdev->stat.byte_rx += buf_len;
576 case MRVL_VENDOR_PKT:
577 bt_cb(skb)->pkt_type = HCI_VENDOR_PKT;
578 skb->dev = (void *)hdev;
579 skb_put(skb, buf_len);
580 skb_pull(skb, SDIO_HEADER_LEN);
582 if (btmrvl_process_event(priv, skb))
585 hdev->stat.byte_rx += buf_len;
589 BT_ERR("Unknow packet type:%d", type);
590 print_hex_dump_bytes("", DUMP_PREFIX_OFFSET, payload,
591 blksz * buf_block_len);
610 static int btmrvl_sdio_get_int_status(struct btmrvl_private *priv, u8 * ireg)
614 struct btmrvl_sdio_card *card = priv->btmrvl_dev.card;
620 sdio_ireg = sdio_readb(card->func, HOST_INTSTATUS_REG, &ret);
622 BT_ERR("sdio_readb: read int status register failed");
627 if (sdio_ireg != 0) {
629 * DN_LD_HOST_INT_STATUS and/or UP_LD_HOST_INT_STATUS
630 * Clear the interrupt status register and re-enable the
633 BT_DBG("sdio_ireg = 0x%x", sdio_ireg);
635 sdio_writeb(card->func, ~(sdio_ireg) & (DN_LD_HOST_INT_STATUS |
636 UP_LD_HOST_INT_STATUS),
637 HOST_INTSTATUS_REG, &ret);
639 BT_ERR("sdio_writeb: clear int status register "
646 if (sdio_ireg & DN_LD_HOST_INT_STATUS) {
647 if (priv->btmrvl_dev.tx_dnld_rdy)
648 BT_DBG("tx_done already received: "
649 " int_status=0x%x", sdio_ireg);
651 priv->btmrvl_dev.tx_dnld_rdy = true;
654 if (sdio_ireg & UP_LD_HOST_INT_STATUS)
655 btmrvl_sdio_card_to_host(priv);
667 static void btmrvl_sdio_interrupt(struct sdio_func *func)
669 struct btmrvl_private *priv;
670 struct hci_dev *hcidev;
671 struct btmrvl_sdio_card *card;
676 card = sdio_get_drvdata(func);
677 if (card && card->priv) {
679 hcidev = priv->btmrvl_dev.hcidev;
681 if (btmrvl_sdio_get_int_status(priv, &ireg))
682 BT_ERR("reading HOST_INT_STATUS_REG failed");
684 BT_DBG("HOST_INT_STATUS_REG %#x", ireg);
686 btmrvl_interrupt(priv);
692 static int btmrvl_sdio_register_dev(struct btmrvl_sdio_card *card)
696 struct sdio_func *func;
700 if (!card || !card->func) {
701 BT_ERR("Error: card or function is NULL!");
708 for (i = 0; i < ARRAY_SIZE(btmrvl_sdio_devices); i++) {
709 if (func->device == btmrvl_sdio_devices[i].dev_id)
713 if (i == ARRAY_SIZE(btmrvl_sdio_devices)) {
714 BT_ERR("Error: unknown device id 0x%x", func->device);
719 card->helper = btmrvl_sdio_devices[i].helper;
720 card->firmware = btmrvl_sdio_devices[i].firmware;
722 sdio_claim_host(func);
724 ret = sdio_enable_func(func);
726 BT_ERR("sdio_enable_func() failed: ret=%d", ret);
731 ret = sdio_claim_irq(func, btmrvl_sdio_interrupt);
733 BT_ERR("sdio_claim_irq failed: ret=%d", ret);
738 ret = sdio_set_block_size(card->func, SDIO_BLOCK_SIZE);
740 BT_ERR("cannot set SDIO block size");
745 reg = sdio_readb(func, IO_PORT_0_REG, &ret);
753 reg = sdio_readb(func, IO_PORT_1_REG, &ret);
759 card->ioport |= (reg << 8);
761 reg = sdio_readb(func, IO_PORT_2_REG, &ret);
767 card->ioport |= (reg << 16);
769 BT_DBG("SDIO FUNC%d IO port: 0x%x", func->num, card->ioport);
771 sdio_set_drvdata(func, card);
773 sdio_release_host(func);
779 sdio_release_irq(func);
782 sdio_disable_func(func);
785 sdio_release_host(func);
792 static int btmrvl_sdio_unregister_dev(struct btmrvl_sdio_card *card)
796 if (card && card->func) {
797 sdio_claim_host(card->func);
798 sdio_release_irq(card->func);
799 sdio_disable_func(card->func);
800 sdio_release_host(card->func);
801 sdio_set_drvdata(card->func, NULL);
809 static int btmrvl_sdio_enable_host_int(struct btmrvl_sdio_card *card)
815 if (!card || !card->func) {
820 sdio_claim_host(card->func);
822 ret = btmrvl_sdio_enable_host_int_mask(card, HIM_ENABLE);
824 btmrvl_sdio_get_rx_unit(card);
826 sdio_release_host(card->func);
833 static int btmrvl_sdio_disable_host_int(struct btmrvl_sdio_card *card)
839 if (!card || !card->func) {
844 sdio_claim_host(card->func);
846 ret = btmrvl_sdio_disable_host_int_mask(card, HIM_DISABLE);
848 sdio_release_host(card->func);
855 static int btmrvl_sdio_host_to_card(struct btmrvl_private *priv,
858 struct btmrvl_sdio_card *card = priv->btmrvl_dev.card;
869 if (!card || !card->func) {
870 BT_ERR("card or function is NULL!");
876 if ((u32) payload & (BTSDIO_DMA_ALIGN - 1)) {
877 tmpbufsz = ALIGN_SZ(nb, BTSDIO_DMA_ALIGN);
878 tmpbuf = kmalloc(tmpbufsz, GFP_KERNEL);
879 memset(tmpbuf, 0, tmpbufsz);
880 buf = (u8 *) ALIGN_ADDR(tmpbuf, BTSDIO_DMA_ALIGN);
881 memcpy(buf, payload, nb);
884 blksz = SDIO_BLOCK_SIZE;
885 buf_block_len = (nb + blksz - 1) / blksz;
887 sdio_claim_host(card->func);
890 /* Transfer data to card */
891 ret = sdio_writesb(card->func, card->ioport, buf,
892 buf_block_len * blksz);
895 BT_ERR("i=%d writesb failed: %d", i, ret);
896 print_hex_dump_bytes("", DUMP_PREFIX_OFFSET,
899 if (i > MAX_WRITE_IOMEM_RETRY)
904 priv->btmrvl_dev.tx_dnld_rdy = false;
907 sdio_release_host(card->func);
914 static int btmrvl_sdio_download_fw(struct btmrvl_sdio_card *card)
920 if (!card || !card->func) {
921 BT_ERR("card or function is NULL!");
925 sdio_claim_host(card->func);
927 if (!btmrvl_sdio_verify_fw_download(card, 1)) {
928 BT_DBG("Firmware already downloaded!");
932 ret = btmrvl_sdio_download_helper(card);
934 BT_ERR("Failed to download helper!");
939 if (btmrvl_sdio_download_fw_w_helper(card)) {
940 BT_ERR("Failed to download firmware!");
945 if (btmrvl_sdio_verify_fw_download(card, MAX_POLL_TRIES)) {
946 BT_ERR("FW failed to be active in time!");
952 sdio_release_host(card->func);
959 static int btmrvl_sdio_wakeup_fw(struct btmrvl_private *priv)
961 struct btmrvl_sdio_card *card = priv->btmrvl_dev.card;
966 if (!card || !card->func) {
967 BT_ERR("card or function is NULL!");
972 sdio_claim_host(card->func);
974 sdio_writeb(card->func, HOST_POWER_UP, CONFIG_REG, &ret);
976 sdio_release_host(card->func);
978 BT_DBG("wake up firmware");
985 static int btmrvl_sdio_probe(struct sdio_func *func,
986 const struct sdio_device_id *id)
989 struct btmrvl_private *priv = NULL;
990 struct btmrvl_sdio_card *card = NULL;
994 BT_INFO("vendor=0x%x, device=0x%x, class=%d, fn=%d",
995 id->vendor, id->device, id->class, func->num);
997 card = kzalloc(sizeof(*card), GFP_KERNEL);
1005 if (btmrvl_sdio_register_dev(card) < 0) {
1006 BT_ERR("Failed to register BT device!");
1011 /* Disable the interrupts on the card */
1012 btmrvl_sdio_disable_host_int(card);
1014 if (btmrvl_sdio_download_fw(card)) {
1015 BT_ERR("Downloading firmware failed!");
1022 btmrvl_sdio_enable_host_int(card);
1024 priv = btmrvl_add_card(card);
1026 BT_ERR("Initializing card failed!");
1028 goto disable_host_int;
1033 /* Initialize the interface specific function pointers */
1034 priv->hw_host_to_card = btmrvl_sdio_host_to_card;
1035 priv->hw_wakeup_firmware = btmrvl_sdio_wakeup_fw;
1037 strncpy(priv->btmrvl_dev.name, "btmrvl_sdio0",
1038 sizeof(priv->btmrvl_dev.name));
1040 btmrvl_send_module_cfg_cmd(priv, MODULE_BRINGUP_REQ);
1047 btmrvl_sdio_disable_host_int(card);
1049 btmrvl_sdio_unregister_dev(card);
1058 static void btmrvl_sdio_remove(struct sdio_func *func)
1060 struct btmrvl_sdio_card *card;
1065 card = sdio_get_drvdata(func);
1067 /* Send SHUTDOWN command & disable interrupt
1068 * if user removes the module.
1071 btmrvl_send_module_cfg_cmd(card->priv,
1072 MODULE_SHUTDOWN_REQ);
1073 btmrvl_sdio_disable_host_int(card);
1075 BT_DBG("unregester dev");
1076 btmrvl_sdio_unregister_dev(card);
1077 btmrvl_remove_card(card->priv);
1085 static struct sdio_driver bt_mrvl_sdio = {
1086 .name = "btmrvl_sdio",
1087 .id_table = btmrvl_sdio_ids,
1088 .probe = btmrvl_sdio_probe,
1089 .remove = btmrvl_sdio_remove,
1092 static int btmrvl_sdio_init_module(void)
1096 if (sdio_register_driver(&bt_mrvl_sdio) != 0) {
1097 BT_ERR("SDIO Driver Registration Failed");
1102 /* Clear the flag in case user removes the card. */
1110 static void btmrvl_sdio_exit_module(void)
1114 /* Set the flag as user is removing this module. */
1117 sdio_unregister_driver(&bt_mrvl_sdio);
1122 module_init(btmrvl_sdio_init_module);
1123 module_exit(btmrvl_sdio_exit_module);
1125 MODULE_AUTHOR("Marvell International Ltd.");
1126 MODULE_DESCRIPTION("Marvell BT-over-SDIO Driver v" VERSION);
1127 MODULE_VERSION(VERSION);
1128 MODULE_LICENSE("GPL v2");