1 // SPDX-License-Identifier: GPL-2.0-or-later
4 * Bluetooth support for Intel devices
6 * Copyright (C) 2015 Intel Corporation
9 #include <linux/module.h>
10 #include <linux/firmware.h>
11 #include <linux/regmap.h>
12 #include <linux/acpi.h>
13 #include <acpi/acpi_bus.h>
14 #include <asm/unaligned.h>
15 #include <linux/efi.h>
17 #include <net/bluetooth/bluetooth.h>
18 #include <net/bluetooth/hci_core.h>
24 #define BDADDR_INTEL (&(bdaddr_t){{0x00, 0x8b, 0x9e, 0x19, 0x03, 0x00}})
25 #define RSA_HEADER_LEN 644
26 #define CSS_HEADER_OFFSET 8
27 #define ECDSA_OFFSET 644
28 #define ECDSA_HEADER_LEN 320
30 #define BTINTEL_EFI_DSBR L"UefiCnvCommonDSBR"
33 DSM_SET_WDISABLE2_DELAY = 1,
34 DSM_SET_RESET_METHOD = 3,
37 #define CMD_WRITE_BOOT_PARAMS 0xfc0e
38 struct cmd_write_boot_params {
46 const char *driver_name;
51 static const guid_t btintel_guid_dsm =
52 GUID_INIT(0xaa10f4e0, 0x81ac, 0x4233,
53 0xab, 0xf6, 0x3b, 0x2a, 0xc5, 0x0e, 0x28, 0xd9);
55 int btintel_check_bdaddr(struct hci_dev *hdev)
57 struct hci_rp_read_bd_addr *bda;
60 skb = __hci_cmd_sync(hdev, HCI_OP_READ_BD_ADDR, 0, NULL,
63 int err = PTR_ERR(skb);
64 bt_dev_err(hdev, "Reading Intel device address failed (%d)",
69 if (skb->len != sizeof(*bda)) {
70 bt_dev_err(hdev, "Intel device address length mismatch");
75 bda = (struct hci_rp_read_bd_addr *)skb->data;
77 /* For some Intel based controllers, the default Bluetooth device
78 * address 00:03:19:9E:8B:00 can be found. These controllers are
79 * fully operational, but have the danger of duplicate addresses
80 * and that in turn can cause problems with Bluetooth operation.
82 if (!bacmp(&bda->bdaddr, BDADDR_INTEL)) {
83 bt_dev_err(hdev, "Found Intel default device address (%pMR)",
85 set_bit(HCI_QUIRK_INVALID_BDADDR, &hdev->quirks);
92 EXPORT_SYMBOL_GPL(btintel_check_bdaddr);
94 int btintel_enter_mfg(struct hci_dev *hdev)
96 static const u8 param[] = { 0x01, 0x00 };
99 skb = __hci_cmd_sync(hdev, 0xfc11, 2, param, HCI_CMD_TIMEOUT);
101 bt_dev_err(hdev, "Entering manufacturer mode failed (%ld)",
109 EXPORT_SYMBOL_GPL(btintel_enter_mfg);
111 int btintel_exit_mfg(struct hci_dev *hdev, bool reset, bool patched)
113 u8 param[] = { 0x00, 0x00 };
116 /* The 2nd command parameter specifies the manufacturing exit method:
117 * 0x00: Just disable the manufacturing mode (0x00).
118 * 0x01: Disable manufacturing mode and reset with patches deactivated.
119 * 0x02: Disable manufacturing mode and reset with patches activated.
122 param[1] |= patched ? 0x02 : 0x01;
124 skb = __hci_cmd_sync(hdev, 0xfc11, 2, param, HCI_CMD_TIMEOUT);
126 bt_dev_err(hdev, "Exiting manufacturer mode failed (%ld)",
134 EXPORT_SYMBOL_GPL(btintel_exit_mfg);
136 int btintel_set_bdaddr(struct hci_dev *hdev, const bdaddr_t *bdaddr)
141 skb = __hci_cmd_sync(hdev, 0xfc31, 6, bdaddr, HCI_INIT_TIMEOUT);
144 bt_dev_err(hdev, "Changing Intel device address failed (%d)",
152 EXPORT_SYMBOL_GPL(btintel_set_bdaddr);
154 static int btintel_set_event_mask(struct hci_dev *hdev, bool debug)
156 u8 mask[8] = { 0x87, 0x0c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
163 skb = __hci_cmd_sync(hdev, 0xfc52, 8, mask, HCI_INIT_TIMEOUT);
166 bt_dev_err(hdev, "Setting Intel event mask failed (%d)", err);
174 int btintel_set_diag(struct hci_dev *hdev, bool enable)
190 skb = __hci_cmd_sync(hdev, 0xfc43, 3, param, HCI_INIT_TIMEOUT);
195 bt_dev_err(hdev, "Changing Intel diagnostic mode failed (%d)",
202 btintel_set_event_mask(hdev, enable);
205 EXPORT_SYMBOL_GPL(btintel_set_diag);
207 static int btintel_set_diag_mfg(struct hci_dev *hdev, bool enable)
211 err = btintel_enter_mfg(hdev);
215 ret = btintel_set_diag(hdev, enable);
217 err = btintel_exit_mfg(hdev, false, false);
224 static int btintel_set_diag_combined(struct hci_dev *hdev, bool enable)
228 /* Legacy ROM device needs to be in the manufacturer mode to apply
231 * This flag is set after reading the Intel version.
233 if (btintel_test_flag(hdev, INTEL_ROM_LEGACY))
234 ret = btintel_set_diag_mfg(hdev, enable);
236 ret = btintel_set_diag(hdev, enable);
241 void btintel_hw_error(struct hci_dev *hdev, u8 code)
246 bt_dev_err(hdev, "Hardware error 0x%2.2x", code);
248 skb = __hci_cmd_sync(hdev, HCI_OP_RESET, 0, NULL, HCI_INIT_TIMEOUT);
250 bt_dev_err(hdev, "Reset after hardware error failed (%ld)",
256 skb = __hci_cmd_sync(hdev, 0xfc22, 1, &type, HCI_INIT_TIMEOUT);
258 bt_dev_err(hdev, "Retrieving Intel exception info failed (%ld)",
263 if (skb->len != 13) {
264 bt_dev_err(hdev, "Exception info size mismatch");
269 bt_dev_err(hdev, "Exception info %s", (char *)(skb->data + 1));
273 EXPORT_SYMBOL_GPL(btintel_hw_error);
275 int btintel_version_info(struct hci_dev *hdev, struct intel_version *ver)
279 /* The hardware platform number has a fixed value of 0x37 and
280 * for now only accept this single value.
282 if (ver->hw_platform != 0x37) {
283 bt_dev_err(hdev, "Unsupported Intel hardware platform (%u)",
288 /* Check for supported iBT hardware variants of this firmware
291 * This check has been put in place to ensure correct forward
292 * compatibility options when newer hardware variants come along.
294 switch (ver->hw_variant) {
295 case 0x07: /* WP - Legacy ROM */
296 case 0x08: /* StP - Legacy ROM */
305 bt_dev_err(hdev, "Unsupported Intel hardware variant (%u)",
310 switch (ver->fw_variant) {
312 variant = "Legacy ROM 2.5";
315 variant = "Bootloader";
318 variant = "Legacy ROM 2.x";
321 variant = "Firmware";
324 bt_dev_err(hdev, "Unsupported firmware variant(%02x)", ver->fw_variant);
328 coredump_info.hw_variant = ver->hw_variant;
329 coredump_info.fw_build_num = ver->fw_build_num;
331 bt_dev_info(hdev, "%s revision %u.%u build %u week %u %u",
332 variant, ver->fw_revision >> 4, ver->fw_revision & 0x0f,
333 ver->fw_build_num, ver->fw_build_ww,
334 2000 + ver->fw_build_yy);
338 EXPORT_SYMBOL_GPL(btintel_version_info);
340 static int btintel_secure_send(struct hci_dev *hdev, u8 fragment_type, u32 plen,
345 u8 cmd_param[253], fragment_len = (plen > 252) ? 252 : plen;
347 cmd_param[0] = fragment_type;
348 memcpy(cmd_param + 1, param, fragment_len);
350 skb = __hci_cmd_sync(hdev, 0xfc09, fragment_len + 1,
351 cmd_param, HCI_INIT_TIMEOUT);
357 plen -= fragment_len;
358 param += fragment_len;
364 int btintel_load_ddc_config(struct hci_dev *hdev, const char *ddc_name)
366 const struct firmware *fw;
371 err = request_firmware_direct(&fw, ddc_name, &hdev->dev);
373 bt_dev_err(hdev, "Failed to load Intel DDC file %s (%d)",
378 bt_dev_info(hdev, "Found Intel DDC parameters: %s", ddc_name);
382 /* DDC file contains one or more DDC structure which has
383 * Length (1 byte), DDC ID (2 bytes), and DDC value (Length - 2).
385 while (fw->size > fw_ptr - fw->data) {
386 u8 cmd_plen = fw_ptr[0] + sizeof(u8);
388 skb = __hci_cmd_sync(hdev, 0xfc8b, cmd_plen, fw_ptr,
391 bt_dev_err(hdev, "Failed to send Intel_Write_DDC (%ld)",
393 release_firmware(fw);
401 release_firmware(fw);
403 bt_dev_info(hdev, "Applying Intel DDC parameters completed");
407 EXPORT_SYMBOL_GPL(btintel_load_ddc_config);
409 int btintel_set_event_mask_mfg(struct hci_dev *hdev, bool debug)
413 err = btintel_enter_mfg(hdev);
417 ret = btintel_set_event_mask(hdev, debug);
419 err = btintel_exit_mfg(hdev, false, false);
425 EXPORT_SYMBOL_GPL(btintel_set_event_mask_mfg);
427 int btintel_read_version(struct hci_dev *hdev, struct intel_version *ver)
431 skb = __hci_cmd_sync(hdev, 0xfc05, 0, NULL, HCI_CMD_TIMEOUT);
433 bt_dev_err(hdev, "Reading Intel version information failed (%ld)",
438 if (!skb || skb->len != sizeof(*ver)) {
439 bt_dev_err(hdev, "Intel version event size mismatch");
444 memcpy(ver, skb->data, sizeof(*ver));
450 EXPORT_SYMBOL_GPL(btintel_read_version);
452 int btintel_version_info_tlv(struct hci_dev *hdev,
453 struct intel_version_tlv *version)
457 /* The hardware platform number has a fixed value of 0x37 and
458 * for now only accept this single value.
460 if (INTEL_HW_PLATFORM(version->cnvi_bt) != 0x37) {
461 bt_dev_err(hdev, "Unsupported Intel hardware platform (0x%2x)",
462 INTEL_HW_PLATFORM(version->cnvi_bt));
466 /* Check for supported iBT hardware variants of this firmware
469 * This check has been put in place to ensure correct forward
470 * compatibility options when newer hardware variants come along.
472 switch (INTEL_HW_VARIANT(version->cnvi_bt)) {
475 case 0x19: /* Slr-F */
477 case 0x1c: /* Gale Peak (GaP) */
478 case 0x1d: /* BlazarU (BzrU) */
479 case 0x1e: /* BlazarI (Bzr) */
482 bt_dev_err(hdev, "Unsupported Intel hardware variant (0x%x)",
483 INTEL_HW_VARIANT(version->cnvi_bt));
487 switch (version->img_type) {
488 case BTINTEL_IMG_BOOTLOADER:
489 variant = "Bootloader";
490 /* It is required that every single firmware fragment is acknowledged
491 * with a command complete event. If the boot parameters indicate
492 * that this bootloader does not send them, then abort the setup.
494 if (version->limited_cce != 0x00) {
495 bt_dev_err(hdev, "Unsupported Intel firmware loading method (0x%x)",
496 version->limited_cce);
500 /* Secure boot engine type should be either 1 (ECDSA) or 0 (RSA) */
501 if (version->sbe_type > 0x01) {
502 bt_dev_err(hdev, "Unsupported Intel secure boot engine type (0x%x)",
507 bt_dev_info(hdev, "Device revision is %u", version->dev_rev_id);
508 bt_dev_info(hdev, "Secure boot is %s",
509 version->secure_boot ? "enabled" : "disabled");
510 bt_dev_info(hdev, "OTP lock is %s",
511 version->otp_lock ? "enabled" : "disabled");
512 bt_dev_info(hdev, "API lock is %s",
513 version->api_lock ? "enabled" : "disabled");
514 bt_dev_info(hdev, "Debug lock is %s",
515 version->debug_lock ? "enabled" : "disabled");
516 bt_dev_info(hdev, "Minimum firmware build %u week %u %u",
517 version->min_fw_build_nn, version->min_fw_build_cw,
518 2000 + version->min_fw_build_yy);
520 case BTINTEL_IMG_IML:
521 variant = "Intermediate loader";
524 variant = "Firmware";
527 bt_dev_err(hdev, "Unsupported image type(%02x)", version->img_type);
531 coredump_info.hw_variant = INTEL_HW_VARIANT(version->cnvi_bt);
532 coredump_info.fw_build_num = version->build_num;
534 bt_dev_info(hdev, "%s timestamp %u.%u buildtype %u build %u", variant,
535 2000 + (version->timestamp >> 8), version->timestamp & 0xff,
536 version->build_type, version->build_num);
537 if (version->img_type == BTINTEL_IMG_OP)
538 bt_dev_info(hdev, "Firmware SHA1: 0x%8.8x", version->git_sha1);
542 EXPORT_SYMBOL_GPL(btintel_version_info_tlv);
544 int btintel_parse_version_tlv(struct hci_dev *hdev,
545 struct intel_version_tlv *version,
548 /* Consume Command Complete Status field */
551 /* Event parameters contatin multiple TLVs. Read each of them
552 * and only keep the required data. Also, it use existing legacy
553 * version field like hw_platform, hw_variant, and fw_variant
554 * to keep the existing setup flow
557 struct intel_tlv *tlv;
559 /* Make sure skb has a minimum length of the header */
560 if (skb->len < sizeof(*tlv))
563 tlv = (struct intel_tlv *)skb->data;
565 /* Make sure skb has a enough data */
566 if (skb->len < tlv->len + sizeof(*tlv))
570 case INTEL_TLV_CNVI_TOP:
571 version->cnvi_top = get_unaligned_le32(tlv->val);
573 case INTEL_TLV_CNVR_TOP:
574 version->cnvr_top = get_unaligned_le32(tlv->val);
576 case INTEL_TLV_CNVI_BT:
577 version->cnvi_bt = get_unaligned_le32(tlv->val);
579 case INTEL_TLV_CNVR_BT:
580 version->cnvr_bt = get_unaligned_le32(tlv->val);
582 case INTEL_TLV_DEV_REV_ID:
583 version->dev_rev_id = get_unaligned_le16(tlv->val);
585 case INTEL_TLV_IMAGE_TYPE:
586 version->img_type = tlv->val[0];
588 case INTEL_TLV_TIME_STAMP:
589 /* If image type is Operational firmware (0x03), then
590 * running FW Calendar Week and Year information can
591 * be extracted from Timestamp information
593 version->min_fw_build_cw = tlv->val[0];
594 version->min_fw_build_yy = tlv->val[1];
595 version->timestamp = get_unaligned_le16(tlv->val);
597 case INTEL_TLV_BUILD_TYPE:
598 version->build_type = tlv->val[0];
600 case INTEL_TLV_BUILD_NUM:
601 /* If image type is Operational firmware (0x03), then
602 * running FW build number can be extracted from the
605 version->min_fw_build_nn = tlv->val[0];
606 version->build_num = get_unaligned_le32(tlv->val);
608 case INTEL_TLV_SECURE_BOOT:
609 version->secure_boot = tlv->val[0];
611 case INTEL_TLV_OTP_LOCK:
612 version->otp_lock = tlv->val[0];
614 case INTEL_TLV_API_LOCK:
615 version->api_lock = tlv->val[0];
617 case INTEL_TLV_DEBUG_LOCK:
618 version->debug_lock = tlv->val[0];
620 case INTEL_TLV_MIN_FW:
621 version->min_fw_build_nn = tlv->val[0];
622 version->min_fw_build_cw = tlv->val[1];
623 version->min_fw_build_yy = tlv->val[2];
625 case INTEL_TLV_LIMITED_CCE:
626 version->limited_cce = tlv->val[0];
628 case INTEL_TLV_SBE_TYPE:
629 version->sbe_type = tlv->val[0];
631 case INTEL_TLV_OTP_BDADDR:
632 memcpy(&version->otp_bd_addr, tlv->val,
635 case INTEL_TLV_GIT_SHA1:
636 version->git_sha1 = get_unaligned_le32(tlv->val);
638 case INTEL_TLV_FW_ID:
639 snprintf(version->fw_id, sizeof(version->fw_id),
643 /* Ignore rest of information */
646 /* consume the current tlv and move to next*/
647 skb_pull(skb, tlv->len + sizeof(*tlv));
652 EXPORT_SYMBOL_GPL(btintel_parse_version_tlv);
654 static int btintel_read_version_tlv(struct hci_dev *hdev,
655 struct intel_version_tlv *version)
658 const u8 param[1] = { 0xFF };
663 skb = __hci_cmd_sync(hdev, 0xfc05, 1, param, HCI_CMD_TIMEOUT);
665 bt_dev_err(hdev, "Reading Intel version information failed (%ld)",
671 bt_dev_err(hdev, "Intel Read Version command failed (%02x)",
677 btintel_parse_version_tlv(hdev, version, skb);
683 /* ------- REGMAP IBT SUPPORT ------- */
685 #define IBT_REG_MODE_8BIT 0x00
686 #define IBT_REG_MODE_16BIT 0x01
687 #define IBT_REG_MODE_32BIT 0x02
689 struct regmap_ibt_context {
690 struct hci_dev *hdev;
695 struct ibt_cp_reg_access {
702 struct ibt_rp_reg_access {
708 static int regmap_ibt_read(void *context, const void *addr, size_t reg_size,
709 void *val, size_t val_size)
711 struct regmap_ibt_context *ctx = context;
712 struct ibt_cp_reg_access cp;
713 struct ibt_rp_reg_access *rp;
717 if (reg_size != sizeof(__le32))
722 cp.mode = IBT_REG_MODE_8BIT;
725 cp.mode = IBT_REG_MODE_16BIT;
728 cp.mode = IBT_REG_MODE_32BIT;
734 /* regmap provides a little-endian formatted addr */
735 cp.addr = *(__le32 *)addr;
738 bt_dev_dbg(ctx->hdev, "Register (0x%x) read", le32_to_cpu(cp.addr));
740 skb = hci_cmd_sync(ctx->hdev, ctx->op_read, sizeof(cp), &cp,
744 bt_dev_err(ctx->hdev, "regmap: Register (0x%x) read error (%d)",
745 le32_to_cpu(cp.addr), err);
749 if (skb->len != sizeof(*rp) + val_size) {
750 bt_dev_err(ctx->hdev, "regmap: Register (0x%x) read error, bad len",
751 le32_to_cpu(cp.addr));
756 rp = (struct ibt_rp_reg_access *)skb->data;
758 if (rp->addr != cp.addr) {
759 bt_dev_err(ctx->hdev, "regmap: Register (0x%x) read error, bad addr",
760 le32_to_cpu(rp->addr));
765 memcpy(val, rp->data, val_size);
772 static int regmap_ibt_gather_write(void *context,
773 const void *addr, size_t reg_size,
774 const void *val, size_t val_size)
776 struct regmap_ibt_context *ctx = context;
777 struct ibt_cp_reg_access *cp;
779 int plen = sizeof(*cp) + val_size;
783 if (reg_size != sizeof(__le32))
788 mode = IBT_REG_MODE_8BIT;
791 mode = IBT_REG_MODE_16BIT;
794 mode = IBT_REG_MODE_32BIT;
800 cp = kmalloc(plen, GFP_KERNEL);
804 /* regmap provides a little-endian formatted addr/value */
805 cp->addr = *(__le32 *)addr;
808 memcpy(&cp->data, val, val_size);
810 bt_dev_dbg(ctx->hdev, "Register (0x%x) write", le32_to_cpu(cp->addr));
812 skb = hci_cmd_sync(ctx->hdev, ctx->op_write, plen, cp, HCI_CMD_TIMEOUT);
815 bt_dev_err(ctx->hdev, "regmap: Register (0x%x) write error (%d)",
816 le32_to_cpu(cp->addr), err);
826 static int regmap_ibt_write(void *context, const void *data, size_t count)
828 /* data contains register+value, since we only support 32bit addr,
829 * minimum data size is 4 bytes.
831 if (WARN_ONCE(count < 4, "Invalid register access"))
834 return regmap_ibt_gather_write(context, data, 4, data + 4, count - 4);
837 static void regmap_ibt_free_context(void *context)
842 static const struct regmap_bus regmap_ibt = {
843 .read = regmap_ibt_read,
844 .write = regmap_ibt_write,
845 .gather_write = regmap_ibt_gather_write,
846 .free_context = regmap_ibt_free_context,
847 .reg_format_endian_default = REGMAP_ENDIAN_LITTLE,
848 .val_format_endian_default = REGMAP_ENDIAN_LITTLE,
851 /* Config is the same for all register regions */
852 static const struct regmap_config regmap_ibt_cfg = {
853 .name = "btintel_regmap",
858 struct regmap *btintel_regmap_init(struct hci_dev *hdev, u16 opcode_read,
861 struct regmap_ibt_context *ctx;
863 bt_dev_info(hdev, "regmap: Init R%x-W%x region", opcode_read,
866 ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
868 return ERR_PTR(-ENOMEM);
870 ctx->op_read = opcode_read;
871 ctx->op_write = opcode_write;
874 return regmap_init(&hdev->dev, ®map_ibt, ctx, ®map_ibt_cfg);
876 EXPORT_SYMBOL_GPL(btintel_regmap_init);
878 int btintel_send_intel_reset(struct hci_dev *hdev, u32 boot_param)
880 struct intel_reset params = { 0x00, 0x01, 0x00, 0x01, 0x00000000 };
883 params.boot_param = cpu_to_le32(boot_param);
885 skb = __hci_cmd_sync(hdev, 0xfc01, sizeof(params), ¶ms,
888 bt_dev_err(hdev, "Failed to send Intel Reset command");
896 EXPORT_SYMBOL_GPL(btintel_send_intel_reset);
898 int btintel_read_boot_params(struct hci_dev *hdev,
899 struct intel_boot_params *params)
903 skb = __hci_cmd_sync(hdev, 0xfc0d, 0, NULL, HCI_INIT_TIMEOUT);
905 bt_dev_err(hdev, "Reading Intel boot parameters failed (%ld)",
910 if (skb->len != sizeof(*params)) {
911 bt_dev_err(hdev, "Intel boot parameters size mismatch");
916 memcpy(params, skb->data, sizeof(*params));
920 if (params->status) {
921 bt_dev_err(hdev, "Intel boot parameters command failed (%02x)",
923 return -bt_to_errno(params->status);
926 bt_dev_info(hdev, "Device revision is %u",
927 le16_to_cpu(params->dev_revid));
929 bt_dev_info(hdev, "Secure boot is %s",
930 params->secure_boot ? "enabled" : "disabled");
932 bt_dev_info(hdev, "OTP lock is %s",
933 params->otp_lock ? "enabled" : "disabled");
935 bt_dev_info(hdev, "API lock is %s",
936 params->api_lock ? "enabled" : "disabled");
938 bt_dev_info(hdev, "Debug lock is %s",
939 params->debug_lock ? "enabled" : "disabled");
941 bt_dev_info(hdev, "Minimum firmware build %u week %u %u",
942 params->min_fw_build_nn, params->min_fw_build_cw,
943 2000 + params->min_fw_build_yy);
947 EXPORT_SYMBOL_GPL(btintel_read_boot_params);
949 static int btintel_sfi_rsa_header_secure_send(struct hci_dev *hdev,
950 const struct firmware *fw)
954 /* Start the firmware download transaction with the Init fragment
955 * represented by the 128 bytes of CSS header.
957 err = btintel_secure_send(hdev, 0x00, 128, fw->data);
959 bt_dev_err(hdev, "Failed to send firmware header (%d)", err);
963 /* Send the 256 bytes of public key information from the firmware
964 * as the PKey fragment.
966 err = btintel_secure_send(hdev, 0x03, 256, fw->data + 128);
968 bt_dev_err(hdev, "Failed to send firmware pkey (%d)", err);
972 /* Send the 256 bytes of signature information from the firmware
973 * as the Sign fragment.
975 err = btintel_secure_send(hdev, 0x02, 256, fw->data + 388);
977 bt_dev_err(hdev, "Failed to send firmware signature (%d)", err);
985 static int btintel_sfi_ecdsa_header_secure_send(struct hci_dev *hdev,
986 const struct firmware *fw)
990 /* Start the firmware download transaction with the Init fragment
991 * represented by the 128 bytes of CSS header.
993 err = btintel_secure_send(hdev, 0x00, 128, fw->data + 644);
995 bt_dev_err(hdev, "Failed to send firmware header (%d)", err);
999 /* Send the 96 bytes of public key information from the firmware
1000 * as the PKey fragment.
1002 err = btintel_secure_send(hdev, 0x03, 96, fw->data + 644 + 128);
1004 bt_dev_err(hdev, "Failed to send firmware pkey (%d)", err);
1008 /* Send the 96 bytes of signature information from the firmware
1009 * as the Sign fragment
1011 err = btintel_secure_send(hdev, 0x02, 96, fw->data + 644 + 224);
1013 bt_dev_err(hdev, "Failed to send firmware signature (%d)",
1020 static int btintel_download_firmware_payload(struct hci_dev *hdev,
1021 const struct firmware *fw,
1028 fw_ptr = fw->data + offset;
1032 while (fw_ptr - fw->data < fw->size) {
1033 struct hci_command_hdr *cmd = (void *)(fw_ptr + frag_len);
1035 frag_len += sizeof(*cmd) + cmd->plen;
1037 /* The parameter length of the secure send command requires
1038 * a 4 byte alignment. It happens so that the firmware file
1039 * contains proper Intel_NOP commands to align the fragments
1042 * Send set of commands with 4 byte alignment from the
1043 * firmware data buffer as a single Data fragement.
1045 if (!(frag_len % 4)) {
1046 err = btintel_secure_send(hdev, 0x01, frag_len, fw_ptr);
1049 "Failed to send firmware data (%d)",
1063 static bool btintel_firmware_version(struct hci_dev *hdev,
1064 u8 num, u8 ww, u8 yy,
1065 const struct firmware *fw,
1072 while (fw_ptr - fw->data < fw->size) {
1073 struct hci_command_hdr *cmd = (void *)(fw_ptr);
1075 /* Each SKU has a different reset parameter to use in the
1076 * HCI_Intel_Reset command and it is embedded in the firmware
1077 * data. So, instead of using static value per SKU, check
1078 * the firmware data and save it for later use.
1080 if (le16_to_cpu(cmd->opcode) == CMD_WRITE_BOOT_PARAMS) {
1081 struct cmd_write_boot_params *params;
1083 params = (void *)(fw_ptr + sizeof(*cmd));
1085 *boot_addr = le32_to_cpu(params->boot_addr);
1087 bt_dev_info(hdev, "Boot Address: 0x%x", *boot_addr);
1089 bt_dev_info(hdev, "Firmware Version: %u-%u.%u",
1090 params->fw_build_num, params->fw_build_ww,
1091 params->fw_build_yy);
1093 return (num == params->fw_build_num &&
1094 ww == params->fw_build_ww &&
1095 yy == params->fw_build_yy);
1098 fw_ptr += sizeof(*cmd) + cmd->plen;
1104 int btintel_download_firmware(struct hci_dev *hdev,
1105 struct intel_version *ver,
1106 const struct firmware *fw,
1111 /* SfP and WsP don't seem to update the firmware version on file
1112 * so version checking is currently not possible.
1114 switch (ver->hw_variant) {
1115 case 0x0b: /* SfP */
1116 case 0x0c: /* WsP */
1117 /* Skip version checking */
1121 /* Skip download if firmware has the same version */
1122 if (btintel_firmware_version(hdev, ver->fw_build_num,
1123 ver->fw_build_ww, ver->fw_build_yy,
1125 bt_dev_info(hdev, "Firmware already loaded");
1126 /* Return -EALREADY to indicate that the firmware has
1127 * already been loaded.
1133 /* The firmware variant determines if the device is in bootloader
1134 * mode or is running operational firmware. The value 0x06 identifies
1135 * the bootloader and the value 0x23 identifies the operational
1138 * If the firmware version has changed that means it needs to be reset
1139 * to bootloader when operational so the new firmware can be loaded.
1141 if (ver->fw_variant == 0x23)
1144 err = btintel_sfi_rsa_header_secure_send(hdev, fw);
1148 return btintel_download_firmware_payload(hdev, fw, RSA_HEADER_LEN);
1150 EXPORT_SYMBOL_GPL(btintel_download_firmware);
1152 static int btintel_download_fw_tlv(struct hci_dev *hdev,
1153 struct intel_version_tlv *ver,
1154 const struct firmware *fw, u32 *boot_param,
1155 u8 hw_variant, u8 sbe_type)
1160 /* Skip download if firmware has the same version */
1161 if (btintel_firmware_version(hdev, ver->min_fw_build_nn,
1162 ver->min_fw_build_cw,
1163 ver->min_fw_build_yy,
1165 bt_dev_info(hdev, "Firmware already loaded");
1166 /* Return -EALREADY to indicate that firmware has
1167 * already been loaded.
1172 /* The firmware variant determines if the device is in bootloader
1173 * mode or is running operational firmware. The value 0x01 identifies
1174 * the bootloader and the value 0x03 identifies the operational
1177 * If the firmware version has changed that means it needs to be reset
1178 * to bootloader when operational so the new firmware can be loaded.
1180 if (ver->img_type == BTINTEL_IMG_OP)
1183 /* iBT hardware variants 0x0b, 0x0c, 0x11, 0x12, 0x13, 0x14 support
1184 * only RSA secure boot engine. Hence, the corresponding sfi file will
1185 * have RSA header of 644 bytes followed by Command Buffer.
1187 * iBT hardware variants 0x17, 0x18 onwards support both RSA and ECDSA
1188 * secure boot engine. As a result, the corresponding sfi file will
1189 * have RSA header of 644, ECDSA header of 320 bytes followed by
1192 * CSS Header byte positions 0x08 to 0x0B represent the CSS Header
1193 * version: RSA(0x00010000) , ECDSA (0x00020000)
1195 css_header_ver = get_unaligned_le32(fw->data + CSS_HEADER_OFFSET);
1196 if (css_header_ver != 0x00010000) {
1197 bt_dev_err(hdev, "Invalid CSS Header version");
1201 if (hw_variant <= 0x14) {
1202 if (sbe_type != 0x00) {
1203 bt_dev_err(hdev, "Invalid SBE type for hardware variant (%d)",
1208 err = btintel_sfi_rsa_header_secure_send(hdev, fw);
1212 err = btintel_download_firmware_payload(hdev, fw, RSA_HEADER_LEN);
1215 } else if (hw_variant >= 0x17) {
1216 /* Check if CSS header for ECDSA follows the RSA header */
1217 if (fw->data[ECDSA_OFFSET] != 0x06)
1220 /* Check if the CSS Header version is ECDSA(0x00020000) */
1221 css_header_ver = get_unaligned_le32(fw->data + ECDSA_OFFSET + CSS_HEADER_OFFSET);
1222 if (css_header_ver != 0x00020000) {
1223 bt_dev_err(hdev, "Invalid CSS Header version");
1227 if (sbe_type == 0x00) {
1228 err = btintel_sfi_rsa_header_secure_send(hdev, fw);
1232 err = btintel_download_firmware_payload(hdev, fw,
1233 RSA_HEADER_LEN + ECDSA_HEADER_LEN);
1236 } else if (sbe_type == 0x01) {
1237 err = btintel_sfi_ecdsa_header_secure_send(hdev, fw);
1241 err = btintel_download_firmware_payload(hdev, fw,
1242 RSA_HEADER_LEN + ECDSA_HEADER_LEN);
1250 static void btintel_reset_to_bootloader(struct hci_dev *hdev)
1252 struct intel_reset params;
1253 struct sk_buff *skb;
1255 /* Send Intel Reset command. This will result in
1256 * re-enumeration of BT controller.
1258 * Intel Reset parameter description:
1259 * reset_type : 0x00 (Soft reset),
1261 * patch_enable : 0x00 (Do not enable),
1263 * ddc_reload : 0x00 (Do not reload),
1265 * boot_option: 0x00 (Current image),
1266 * 0x01 (Specified boot address)
1267 * boot_param: Boot address
1270 params.reset_type = 0x01;
1271 params.patch_enable = 0x01;
1272 params.ddc_reload = 0x01;
1273 params.boot_option = 0x00;
1274 params.boot_param = cpu_to_le32(0x00000000);
1276 skb = __hci_cmd_sync(hdev, 0xfc01, sizeof(params),
1277 ¶ms, HCI_INIT_TIMEOUT);
1279 bt_dev_err(hdev, "FW download error recovery failed (%ld)",
1283 bt_dev_info(hdev, "Intel reset sent to retry FW download");
1286 /* Current Intel BT controllers(ThP/JfP) hold the USB reset
1287 * lines for 2ms when it receives Intel Reset in bootloader mode.
1288 * Whereas, the upcoming Intel BT controllers will hold USB reset
1289 * for 150ms. To keep the delay generic, 150ms is chosen here.
1294 static int btintel_read_debug_features(struct hci_dev *hdev,
1295 struct intel_debug_features *features)
1297 struct sk_buff *skb;
1300 /* Intel controller supports two pages, each page is of 128-bit
1301 * feature bit mask. And each bit defines specific feature support
1303 skb = __hci_cmd_sync(hdev, 0xfca6, sizeof(page_no), &page_no,
1306 bt_dev_err(hdev, "Reading supported features failed (%ld)",
1308 return PTR_ERR(skb);
1311 if (skb->len != (sizeof(features->page1) + 3)) {
1312 bt_dev_err(hdev, "Supported features event size mismatch");
1317 memcpy(features->page1, skb->data + 3, sizeof(features->page1));
1319 /* Read the supported features page2 if required in future.
1325 static int btintel_set_debug_features(struct hci_dev *hdev,
1326 const struct intel_debug_features *features)
1328 u8 mask[11] = { 0x0a, 0x92, 0x02, 0x7f, 0x00, 0x00, 0x00, 0x00,
1330 u8 period[5] = { 0x04, 0x91, 0x02, 0x05, 0x00 };
1331 u8 trace_enable = 0x02;
1332 struct sk_buff *skb;
1335 bt_dev_warn(hdev, "Debug features not read");
1339 if (!(features->page1[0] & 0x3f)) {
1340 bt_dev_info(hdev, "Telemetry exception format not supported");
1344 skb = __hci_cmd_sync(hdev, 0xfc8b, 11, mask, HCI_INIT_TIMEOUT);
1346 bt_dev_err(hdev, "Setting Intel telemetry ddc write event mask failed (%ld)",
1348 return PTR_ERR(skb);
1352 skb = __hci_cmd_sync(hdev, 0xfc8b, 5, period, HCI_INIT_TIMEOUT);
1354 bt_dev_err(hdev, "Setting periodicity for link statistics traces failed (%ld)",
1356 return PTR_ERR(skb);
1360 skb = __hci_cmd_sync(hdev, 0xfca1, 1, &trace_enable, HCI_INIT_TIMEOUT);
1362 bt_dev_err(hdev, "Enable tracing of link statistics events failed (%ld)",
1364 return PTR_ERR(skb);
1368 bt_dev_info(hdev, "set debug features: trace_enable 0x%02x mask 0x%02x",
1369 trace_enable, mask[3]);
1374 static int btintel_reset_debug_features(struct hci_dev *hdev,
1375 const struct intel_debug_features *features)
1377 u8 mask[11] = { 0x0a, 0x92, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00,
1379 u8 trace_enable = 0x00;
1380 struct sk_buff *skb;
1383 bt_dev_warn(hdev, "Debug features not read");
1387 if (!(features->page1[0] & 0x3f)) {
1388 bt_dev_info(hdev, "Telemetry exception format not supported");
1392 /* Should stop the trace before writing ddc event mask. */
1393 skb = __hci_cmd_sync(hdev, 0xfca1, 1, &trace_enable, HCI_INIT_TIMEOUT);
1395 bt_dev_err(hdev, "Stop tracing of link statistics events failed (%ld)",
1397 return PTR_ERR(skb);
1401 skb = __hci_cmd_sync(hdev, 0xfc8b, 11, mask, HCI_INIT_TIMEOUT);
1403 bt_dev_err(hdev, "Setting Intel telemetry ddc write event mask failed (%ld)",
1405 return PTR_ERR(skb);
1409 bt_dev_info(hdev, "reset debug features: trace_enable 0x%02x mask 0x%02x",
1410 trace_enable, mask[3]);
1415 int btintel_set_quality_report(struct hci_dev *hdev, bool enable)
1417 struct intel_debug_features features;
1420 bt_dev_dbg(hdev, "enable %d", enable);
1422 /* Read the Intel supported features and if new exception formats
1423 * supported, need to load the additional DDC config to enable.
1425 err = btintel_read_debug_features(hdev, &features);
1429 /* Set or reset the debug features. */
1431 err = btintel_set_debug_features(hdev, &features);
1433 err = btintel_reset_debug_features(hdev, &features);
1437 EXPORT_SYMBOL_GPL(btintel_set_quality_report);
1439 static void btintel_coredump(struct hci_dev *hdev)
1441 struct sk_buff *skb;
1443 skb = __hci_cmd_sync(hdev, 0xfc4e, 0, NULL, HCI_CMD_TIMEOUT);
1445 bt_dev_err(hdev, "Coredump failed (%ld)", PTR_ERR(skb));
1452 static void btintel_dmp_hdr(struct hci_dev *hdev, struct sk_buff *skb)
1456 snprintf(buf, sizeof(buf), "Controller Name: 0x%X\n",
1457 coredump_info.hw_variant);
1458 skb_put_data(skb, buf, strlen(buf));
1460 snprintf(buf, sizeof(buf), "Firmware Version: 0x%X\n",
1461 coredump_info.fw_build_num);
1462 skb_put_data(skb, buf, strlen(buf));
1464 snprintf(buf, sizeof(buf), "Driver: %s\n", coredump_info.driver_name);
1465 skb_put_data(skb, buf, strlen(buf));
1467 snprintf(buf, sizeof(buf), "Vendor: Intel\n");
1468 skb_put_data(skb, buf, strlen(buf));
1471 static int btintel_register_devcoredump_support(struct hci_dev *hdev)
1473 struct intel_debug_features features;
1476 err = btintel_read_debug_features(hdev, &features);
1478 bt_dev_info(hdev, "Error reading debug features");
1482 if (!(features.page1[0] & 0x3f)) {
1483 bt_dev_dbg(hdev, "Telemetry exception format not supported");
1487 hci_devcd_register(hdev, btintel_coredump, btintel_dmp_hdr, NULL);
1492 static const struct firmware *btintel_legacy_rom_get_fw(struct hci_dev *hdev,
1493 struct intel_version *ver)
1495 const struct firmware *fw;
1499 snprintf(fwname, sizeof(fwname),
1500 "intel/ibt-hw-%x.%x.%x-fw-%x.%x.%x.%x.%x.bseq",
1501 ver->hw_platform, ver->hw_variant, ver->hw_revision,
1502 ver->fw_variant, ver->fw_revision, ver->fw_build_num,
1503 ver->fw_build_ww, ver->fw_build_yy);
1505 ret = request_firmware(&fw, fwname, &hdev->dev);
1507 if (ret == -EINVAL) {
1508 bt_dev_err(hdev, "Intel firmware file request failed (%d)",
1513 bt_dev_err(hdev, "failed to open Intel firmware file: %s (%d)",
1516 /* If the correct firmware patch file is not found, use the
1517 * default firmware patch file instead
1519 snprintf(fwname, sizeof(fwname), "intel/ibt-hw-%x.%x.bseq",
1520 ver->hw_platform, ver->hw_variant);
1521 if (request_firmware(&fw, fwname, &hdev->dev) < 0) {
1522 bt_dev_err(hdev, "failed to open default fw file: %s",
1528 bt_dev_info(hdev, "Intel Bluetooth firmware file: %s", fwname);
1533 static int btintel_legacy_rom_patching(struct hci_dev *hdev,
1534 const struct firmware *fw,
1535 const u8 **fw_ptr, int *disable_patch)
1537 struct sk_buff *skb;
1538 struct hci_command_hdr *cmd;
1539 const u8 *cmd_param;
1540 struct hci_event_hdr *evt = NULL;
1541 const u8 *evt_param = NULL;
1542 int remain = fw->size - (*fw_ptr - fw->data);
1544 /* The first byte indicates the types of the patch command or event.
1545 * 0x01 means HCI command and 0x02 is HCI event. If the first bytes
1546 * in the current firmware buffer doesn't start with 0x01 or
1547 * the size of remain buffer is smaller than HCI command header,
1548 * the firmware file is corrupted and it should stop the patching
1551 if (remain > HCI_COMMAND_HDR_SIZE && *fw_ptr[0] != 0x01) {
1552 bt_dev_err(hdev, "Intel fw corrupted: invalid cmd read");
1558 cmd = (struct hci_command_hdr *)(*fw_ptr);
1559 *fw_ptr += sizeof(*cmd);
1560 remain -= sizeof(*cmd);
1562 /* Ensure that the remain firmware data is long enough than the length
1563 * of command parameter. If not, the firmware file is corrupted.
1565 if (remain < cmd->plen) {
1566 bt_dev_err(hdev, "Intel fw corrupted: invalid cmd len");
1570 /* If there is a command that loads a patch in the firmware
1571 * file, then enable the patch upon success, otherwise just
1572 * disable the manufacturer mode, for example patch activation
1573 * is not required when the default firmware patch file is used
1574 * because there are no patch data to load.
1576 if (*disable_patch && le16_to_cpu(cmd->opcode) == 0xfc8e)
1579 cmd_param = *fw_ptr;
1580 *fw_ptr += cmd->plen;
1581 remain -= cmd->plen;
1583 /* This reads the expected events when the above command is sent to the
1584 * device. Some vendor commands expects more than one events, for
1585 * example command status event followed by vendor specific event.
1586 * For this case, it only keeps the last expected event. so the command
1587 * can be sent with __hci_cmd_sync_ev() which returns the sk_buff of
1588 * last expected event.
1590 while (remain > HCI_EVENT_HDR_SIZE && *fw_ptr[0] == 0x02) {
1594 evt = (struct hci_event_hdr *)(*fw_ptr);
1595 *fw_ptr += sizeof(*evt);
1596 remain -= sizeof(*evt);
1598 if (remain < evt->plen) {
1599 bt_dev_err(hdev, "Intel fw corrupted: invalid evt len");
1603 evt_param = *fw_ptr;
1604 *fw_ptr += evt->plen;
1605 remain -= evt->plen;
1608 /* Every HCI commands in the firmware file has its correspond event.
1609 * If event is not found or remain is smaller than zero, the firmware
1610 * file is corrupted.
1612 if (!evt || !evt_param || remain < 0) {
1613 bt_dev_err(hdev, "Intel fw corrupted: invalid evt read");
1617 skb = __hci_cmd_sync_ev(hdev, le16_to_cpu(cmd->opcode), cmd->plen,
1618 cmd_param, evt->evt, HCI_INIT_TIMEOUT);
1620 bt_dev_err(hdev, "sending Intel patch command (0x%4.4x) failed (%ld)",
1621 cmd->opcode, PTR_ERR(skb));
1622 return PTR_ERR(skb);
1625 /* It ensures that the returned event matches the event data read from
1626 * the firmware file. At fist, it checks the length and then
1627 * the contents of the event.
1629 if (skb->len != evt->plen) {
1630 bt_dev_err(hdev, "mismatch event length (opcode 0x%4.4x)",
1631 le16_to_cpu(cmd->opcode));
1636 if (memcmp(skb->data, evt_param, evt->plen)) {
1637 bt_dev_err(hdev, "mismatch event parameter (opcode 0x%4.4x)",
1638 le16_to_cpu(cmd->opcode));
1647 static int btintel_legacy_rom_setup(struct hci_dev *hdev,
1648 struct intel_version *ver)
1650 const struct firmware *fw;
1652 int disable_patch, err;
1653 struct intel_version new_ver;
1655 BT_DBG("%s", hdev->name);
1657 /* fw_patch_num indicates the version of patch the device currently
1658 * have. If there is no patch data in the device, it is always 0x00.
1659 * So, if it is other than 0x00, no need to patch the device again.
1661 if (ver->fw_patch_num) {
1663 "Intel device is already patched. patch num: %02x",
1668 /* Opens the firmware patch file based on the firmware version read
1669 * from the controller. If it fails to open the matching firmware
1670 * patch file, it tries to open the default firmware patch file.
1671 * If no patch file is found, allow the device to operate without
1674 fw = btintel_legacy_rom_get_fw(hdev, ver);
1679 /* Enable the manufacturer mode of the controller.
1680 * Only while this mode is enabled, the driver can download the
1681 * firmware patch data and configuration parameters.
1683 err = btintel_enter_mfg(hdev);
1685 release_firmware(fw);
1691 /* The firmware data file consists of list of Intel specific HCI
1692 * commands and its expected events. The first byte indicates the
1693 * type of the message, either HCI command or HCI event.
1695 * It reads the command and its expected event from the firmware file,
1696 * and send to the controller. Once __hci_cmd_sync_ev() returns,
1697 * the returned event is compared with the event read from the firmware
1698 * file and it will continue until all the messages are downloaded to
1701 * Once the firmware patching is completed successfully,
1702 * the manufacturer mode is disabled with reset and activating the
1705 * If the firmware patching fails, the manufacturer mode is
1706 * disabled with reset and deactivating the patch.
1708 * If the default patch file is used, no reset is done when disabling
1711 while (fw->size > fw_ptr - fw->data) {
1714 ret = btintel_legacy_rom_patching(hdev, fw, &fw_ptr,
1717 goto exit_mfg_deactivate;
1720 release_firmware(fw);
1723 goto exit_mfg_disable;
1725 /* Patching completed successfully and disable the manufacturer mode
1726 * with reset and activate the downloaded firmware patches.
1728 err = btintel_exit_mfg(hdev, true, true);
1732 /* Need build number for downloaded fw patches in
1733 * every power-on boot
1735 err = btintel_read_version(hdev, &new_ver);
1739 bt_dev_info(hdev, "Intel BT fw patch 0x%02x completed & activated",
1740 new_ver.fw_patch_num);
1745 /* Disable the manufacturer mode without reset */
1746 err = btintel_exit_mfg(hdev, false, false);
1750 bt_dev_info(hdev, "Intel firmware patch completed");
1754 exit_mfg_deactivate:
1755 release_firmware(fw);
1757 /* Patching failed. Disable the manufacturer mode with reset and
1758 * deactivate the downloaded firmware patches.
1760 err = btintel_exit_mfg(hdev, true, false);
1764 bt_dev_info(hdev, "Intel firmware patch completed and deactivated");
1767 /* Set the event mask for Intel specific vendor events. This enables
1768 * a few extra events that are useful during general operation.
1770 btintel_set_event_mask_mfg(hdev, false);
1772 btintel_check_bdaddr(hdev);
1777 static int btintel_download_wait(struct hci_dev *hdev, ktime_t calltime, int msec)
1779 ktime_t delta, rettime;
1780 unsigned long long duration;
1783 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
1785 bt_dev_info(hdev, "Waiting for firmware download to complete");
1787 err = btintel_wait_on_flag_timeout(hdev, INTEL_DOWNLOADING,
1789 msecs_to_jiffies(msec));
1790 if (err == -EINTR) {
1791 bt_dev_err(hdev, "Firmware loading interrupted");
1796 bt_dev_err(hdev, "Firmware loading timeout");
1800 if (btintel_test_flag(hdev, INTEL_FIRMWARE_FAILED)) {
1801 bt_dev_err(hdev, "Firmware loading failed");
1805 rettime = ktime_get();
1806 delta = ktime_sub(rettime, calltime);
1807 duration = (unsigned long long)ktime_to_ns(delta) >> 10;
1809 bt_dev_info(hdev, "Firmware loaded in %llu usecs", duration);
1814 static int btintel_boot_wait(struct hci_dev *hdev, ktime_t calltime, int msec)
1816 ktime_t delta, rettime;
1817 unsigned long long duration;
1820 bt_dev_info(hdev, "Waiting for device to boot");
1822 err = btintel_wait_on_flag_timeout(hdev, INTEL_BOOTING,
1824 msecs_to_jiffies(msec));
1825 if (err == -EINTR) {
1826 bt_dev_err(hdev, "Device boot interrupted");
1831 bt_dev_err(hdev, "Device boot timeout");
1835 rettime = ktime_get();
1836 delta = ktime_sub(rettime, calltime);
1837 duration = (unsigned long long) ktime_to_ns(delta) >> 10;
1839 bt_dev_info(hdev, "Device booted in %llu usecs", duration);
1844 static int btintel_boot(struct hci_dev *hdev, u32 boot_addr)
1849 calltime = ktime_get();
1851 btintel_set_flag(hdev, INTEL_BOOTING);
1853 err = btintel_send_intel_reset(hdev, boot_addr);
1855 bt_dev_err(hdev, "Intel Soft Reset failed (%d)", err);
1856 btintel_reset_to_bootloader(hdev);
1860 /* The bootloader will not indicate when the device is ready. This
1861 * is done by the operational firmware sending bootup notification.
1863 * Booting into operational firmware should not take longer than
1864 * 1 second. However if that happens, then just fail the setup
1865 * since something went wrong.
1867 err = btintel_boot_wait(hdev, calltime, 1000);
1868 if (err == -ETIMEDOUT)
1869 btintel_reset_to_bootloader(hdev);
1874 static int btintel_get_fw_name(struct intel_version *ver,
1875 struct intel_boot_params *params,
1876 char *fw_name, size_t len,
1879 switch (ver->hw_variant) {
1880 case 0x0b: /* SfP */
1881 case 0x0c: /* WsP */
1882 snprintf(fw_name, len, "intel/ibt-%u-%u.%s",
1884 le16_to_cpu(params->dev_revid),
1887 case 0x11: /* JfP */
1888 case 0x12: /* ThP */
1889 case 0x13: /* HrP */
1890 case 0x14: /* CcP */
1891 snprintf(fw_name, len, "intel/ibt-%u-%u-%u.%s",
1904 static int btintel_download_fw(struct hci_dev *hdev,
1905 struct intel_version *ver,
1906 struct intel_boot_params *params,
1909 const struct firmware *fw;
1914 if (!ver || !params)
1917 /* The firmware variant determines if the device is in bootloader
1918 * mode or is running operational firmware. The value 0x06 identifies
1919 * the bootloader and the value 0x23 identifies the operational
1922 * When the operational firmware is already present, then only
1923 * the check for valid Bluetooth device address is needed. This
1924 * determines if the device will be added as configured or
1925 * unconfigured controller.
1927 * It is not possible to use the Secure Boot Parameters in this
1928 * case since that command is only available in bootloader mode.
1930 if (ver->fw_variant == 0x23) {
1931 btintel_clear_flag(hdev, INTEL_BOOTLOADER);
1932 btintel_check_bdaddr(hdev);
1934 /* SfP and WsP don't seem to update the firmware version on file
1935 * so version checking is currently possible.
1937 switch (ver->hw_variant) {
1938 case 0x0b: /* SfP */
1939 case 0x0c: /* WsP */
1943 /* Proceed to download to check if the version matches */
1947 /* Read the secure boot parameters to identify the operating
1948 * details of the bootloader.
1950 err = btintel_read_boot_params(hdev, params);
1954 /* It is required that every single firmware fragment is acknowledged
1955 * with a command complete event. If the boot parameters indicate
1956 * that this bootloader does not send them, then abort the setup.
1958 if (params->limited_cce != 0x00) {
1959 bt_dev_err(hdev, "Unsupported Intel firmware loading method (%u)",
1960 params->limited_cce);
1964 /* If the OTP has no valid Bluetooth device address, then there will
1965 * also be no valid address for the operational firmware.
1967 if (!bacmp(¶ms->otp_bdaddr, BDADDR_ANY)) {
1968 bt_dev_info(hdev, "No device address configured");
1969 set_bit(HCI_QUIRK_INVALID_BDADDR, &hdev->quirks);
1973 /* With this Intel bootloader only the hardware variant and device
1974 * revision information are used to select the right firmware for SfP
1977 * The firmware filename is ibt-<hw_variant>-<dev_revid>.sfi.
1979 * Currently the supported hardware variants are:
1980 * 11 (0x0b) for iBT3.0 (LnP/SfP)
1981 * 12 (0x0c) for iBT3.5 (WsP)
1983 * For ThP/JfP and for future SKU's, the FW name varies based on HW
1984 * variant, HW revision and FW revision, as these are dependent on CNVi
1985 * and RF Combination.
1987 * 17 (0x11) for iBT3.5 (JfP)
1988 * 18 (0x12) for iBT3.5 (ThP)
1990 * The firmware file name for these will be
1991 * ibt-<hw_variant>-<hw_revision>-<fw_revision>.sfi.
1994 err = btintel_get_fw_name(ver, params, fwname, sizeof(fwname), "sfi");
1996 if (!btintel_test_flag(hdev, INTEL_BOOTLOADER)) {
1997 /* Firmware has already been loaded */
1998 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
2002 bt_dev_err(hdev, "Unsupported Intel firmware naming");
2006 err = firmware_request_nowarn(&fw, fwname, &hdev->dev);
2008 if (!btintel_test_flag(hdev, INTEL_BOOTLOADER)) {
2009 /* Firmware has already been loaded */
2010 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
2014 bt_dev_err(hdev, "Failed to load Intel firmware file %s (%d)",
2019 bt_dev_info(hdev, "Found device firmware: %s", fwname);
2021 if (fw->size < 644) {
2022 bt_dev_err(hdev, "Invalid size of firmware file (%zu)",
2028 calltime = ktime_get();
2030 btintel_set_flag(hdev, INTEL_DOWNLOADING);
2032 /* Start firmware downloading and get boot parameter */
2033 err = btintel_download_firmware(hdev, ver, fw, boot_param);
2035 if (err == -EALREADY) {
2036 /* Firmware has already been loaded */
2037 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
2042 /* When FW download fails, send Intel Reset to retry
2045 btintel_reset_to_bootloader(hdev);
2049 /* Before switching the device into operational mode and with that
2050 * booting the loaded firmware, wait for the bootloader notification
2051 * that all fragments have been successfully received.
2053 * When the event processing receives the notification, then the
2054 * INTEL_DOWNLOADING flag will be cleared.
2056 * The firmware loading should not take longer than 5 seconds
2057 * and thus just timeout if that happens and fail the setup
2060 err = btintel_download_wait(hdev, calltime, 5000);
2061 if (err == -ETIMEDOUT)
2062 btintel_reset_to_bootloader(hdev);
2065 release_firmware(fw);
2069 static int btintel_bootloader_setup(struct hci_dev *hdev,
2070 struct intel_version *ver)
2072 struct intel_version new_ver;
2073 struct intel_boot_params params;
2078 BT_DBG("%s", hdev->name);
2080 /* Set the default boot parameter to 0x0 and it is updated to
2081 * SKU specific boot parameter after reading Intel_Write_Boot_Params
2082 * command while downloading the firmware.
2084 boot_param = 0x00000000;
2086 btintel_set_flag(hdev, INTEL_BOOTLOADER);
2088 err = btintel_download_fw(hdev, ver, ¶ms, &boot_param);
2092 /* controller is already having an operational firmware */
2093 if (ver->fw_variant == 0x23)
2096 err = btintel_boot(hdev, boot_param);
2100 btintel_clear_flag(hdev, INTEL_BOOTLOADER);
2102 err = btintel_get_fw_name(ver, ¶ms, ddcname,
2103 sizeof(ddcname), "ddc");
2106 bt_dev_err(hdev, "Unsupported Intel firmware naming");
2108 /* Once the device is running in operational mode, it needs to
2109 * apply the device configuration (DDC) parameters.
2111 * The device can work without DDC parameters, so even if it
2112 * fails to load the file, no need to fail the setup.
2114 btintel_load_ddc_config(hdev, ddcname);
2117 hci_dev_clear_flag(hdev, HCI_QUALITY_REPORT);
2119 /* Read the Intel version information after loading the FW */
2120 err = btintel_read_version(hdev, &new_ver);
2124 btintel_version_info(hdev, &new_ver);
2127 /* Set the event mask for Intel specific vendor events. This enables
2128 * a few extra events that are useful during general operation. It
2129 * does not enable any debugging related events.
2131 * The device will function correctly without these events enabled
2132 * and thus no need to fail the setup.
2134 btintel_set_event_mask(hdev, false);
2139 static void btintel_get_fw_name_tlv(const struct intel_version_tlv *ver,
2140 char *fw_name, size_t len,
2146 cnvi = INTEL_CNVX_TOP_PACK_SWAB(INTEL_CNVX_TOP_TYPE(ver->cnvi_top),
2147 INTEL_CNVX_TOP_STEP(ver->cnvi_top));
2149 cnvr = INTEL_CNVX_TOP_PACK_SWAB(INTEL_CNVX_TOP_TYPE(ver->cnvr_top),
2150 INTEL_CNVX_TOP_STEP(ver->cnvr_top));
2152 /* Only Blazar product supports downloading of intermediate loader
2155 if (INTEL_HW_VARIANT(ver->cnvi_bt) >= 0x1e) {
2156 u8 zero[BTINTEL_FWID_MAXLEN];
2158 if (ver->img_type == BTINTEL_IMG_BOOTLOADER) {
2159 format = "intel/ibt-%04x-%04x-iml.%s";
2160 snprintf(fw_name, len, format, cnvi, cnvr, suffix);
2164 memset(zero, 0, sizeof(zero));
2166 /* ibt-<cnvi_top type+cnvi_top step>-<cnvr_top type+cnvr_top step-fw_id> */
2167 if (memcmp(ver->fw_id, zero, sizeof(zero))) {
2168 format = "intel/ibt-%04x-%04x-%s.%s";
2169 snprintf(fw_name, len, format, cnvi, cnvr,
2170 ver->fw_id, suffix);
2173 /* If firmware id is not present, fallback to legacy naming
2177 /* Fallback to legacy naming convention for other controllers
2178 * ibt-<cnvi_top type+cnvi_top step>-<cnvr_top type+cnvr_top step>
2180 format = "intel/ibt-%04x-%04x.%s";
2181 snprintf(fw_name, len, format, cnvi, cnvr, suffix);
2184 static void btintel_get_iml_tlv(const struct intel_version_tlv *ver,
2185 char *fw_name, size_t len,
2191 cnvi = INTEL_CNVX_TOP_PACK_SWAB(INTEL_CNVX_TOP_TYPE(ver->cnvi_top),
2192 INTEL_CNVX_TOP_STEP(ver->cnvi_top));
2194 cnvr = INTEL_CNVX_TOP_PACK_SWAB(INTEL_CNVX_TOP_TYPE(ver->cnvr_top),
2195 INTEL_CNVX_TOP_STEP(ver->cnvr_top));
2197 format = "intel/ibt-%04x-%04x-iml.%s";
2198 snprintf(fw_name, len, format, cnvi, cnvr, suffix);
2201 static int btintel_prepare_fw_download_tlv(struct hci_dev *hdev,
2202 struct intel_version_tlv *ver,
2205 const struct firmware *fw;
2210 if (!ver || !boot_param)
2213 /* The firmware variant determines if the device is in bootloader
2214 * mode or is running operational firmware. The value 0x03 identifies
2215 * the bootloader and the value 0x23 identifies the operational
2218 * When the operational firmware is already present, then only
2219 * the check for valid Bluetooth device address is needed. This
2220 * determines if the device will be added as configured or
2221 * unconfigured controller.
2223 * It is not possible to use the Secure Boot Parameters in this
2224 * case since that command is only available in bootloader mode.
2226 if (ver->img_type == BTINTEL_IMG_OP) {
2227 btintel_clear_flag(hdev, INTEL_BOOTLOADER);
2228 btintel_check_bdaddr(hdev);
2231 * Check for valid bd address in boot loader mode. Device
2232 * will be marked as unconfigured if empty bd address is
2235 if (!bacmp(&ver->otp_bd_addr, BDADDR_ANY)) {
2236 bt_dev_info(hdev, "No device address configured");
2237 set_bit(HCI_QUIRK_INVALID_BDADDR, &hdev->quirks);
2241 if (ver->img_type == BTINTEL_IMG_OP) {
2242 /* Controller running OP image. In case of FW downgrade,
2243 * FWID TLV may not be present and driver may attempt to load
2244 * firmware image which doesn't exist. Lets compare the version
2247 if (INTEL_HW_VARIANT(ver->cnvi_bt) >= 0x1e)
2248 btintel_get_iml_tlv(ver, fwname, sizeof(fwname), "sfi");
2250 btintel_get_fw_name_tlv(ver, fwname, sizeof(fwname), "sfi");
2252 btintel_get_fw_name_tlv(ver, fwname, sizeof(fwname), "sfi");
2255 err = firmware_request_nowarn(&fw, fwname, &hdev->dev);
2257 if (!btintel_test_flag(hdev, INTEL_BOOTLOADER)) {
2258 /* Firmware has already been loaded */
2259 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
2263 bt_dev_err(hdev, "Failed to load Intel firmware file %s (%d)",
2269 bt_dev_info(hdev, "Found device firmware: %s", fwname);
2271 if (fw->size < 644) {
2272 bt_dev_err(hdev, "Invalid size of firmware file (%zu)",
2278 calltime = ktime_get();
2280 btintel_set_flag(hdev, INTEL_DOWNLOADING);
2282 /* Start firmware downloading and get boot parameter */
2283 err = btintel_download_fw_tlv(hdev, ver, fw, boot_param,
2284 INTEL_HW_VARIANT(ver->cnvi_bt),
2287 if (err == -EALREADY) {
2288 /* Firmware has already been loaded */
2289 btintel_set_flag(hdev, INTEL_FIRMWARE_LOADED);
2294 /* When FW download fails, send Intel Reset to retry
2297 btintel_reset_to_bootloader(hdev);
2301 /* Before switching the device into operational mode and with that
2302 * booting the loaded firmware, wait for the bootloader notification
2303 * that all fragments have been successfully received.
2305 * When the event processing receives the notification, then the
2306 * BTUSB_DOWNLOADING flag will be cleared.
2308 * The firmware loading should not take longer than 5 seconds
2309 * and thus just timeout if that happens and fail the setup
2312 err = btintel_download_wait(hdev, calltime, 5000);
2313 if (err == -ETIMEDOUT)
2314 btintel_reset_to_bootloader(hdev);
2317 release_firmware(fw);
2321 static int btintel_get_codec_config_data(struct hci_dev *hdev,
2322 __u8 link, struct bt_codec *codec,
2323 __u8 *ven_len, __u8 **ven_data)
2327 if (!ven_data || !ven_len)
2333 if (link != ESCO_LINK) {
2334 bt_dev_err(hdev, "Invalid link type(%u)", link);
2338 *ven_data = kmalloc(sizeof(__u8), GFP_KERNEL);
2344 /* supports only CVSD and mSBC offload codecs */
2345 switch (codec->id) {
2354 bt_dev_err(hdev, "Invalid codec id(%u)", codec->id);
2357 /* codec and its capabilities are pre-defined to ids
2358 * preset id = 0x00 represents CVSD codec with sampling rate 8K
2359 * preset id = 0x01 represents mSBC codec with sampling rate 16K
2361 *ven_len = sizeof(__u8);
2370 static int btintel_get_data_path_id(struct hci_dev *hdev, __u8 *data_path_id)
2372 /* Intel uses 1 as data path id for all the usecases */
2377 static int btintel_configure_offload(struct hci_dev *hdev)
2379 struct sk_buff *skb;
2381 struct intel_offload_use_cases *use_cases;
2383 skb = __hci_cmd_sync(hdev, 0xfc86, 0, NULL, HCI_INIT_TIMEOUT);
2385 bt_dev_err(hdev, "Reading offload use cases failed (%ld)",
2387 return PTR_ERR(skb);
2390 if (skb->len < sizeof(*use_cases)) {
2395 use_cases = (void *)skb->data;
2397 if (use_cases->status) {
2398 err = -bt_to_errno(skb->data[0]);
2402 if (use_cases->preset[0] & 0x03) {
2403 hdev->get_data_path_id = btintel_get_data_path_id;
2404 hdev->get_codec_config_data = btintel_get_codec_config_data;
2411 static void btintel_set_ppag(struct hci_dev *hdev, struct intel_version_tlv *ver)
2413 struct sk_buff *skb;
2414 struct hci_ppag_enable_cmd ppag_cmd;
2416 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
2417 union acpi_object *p, *elements;
2421 /* PPAG is not supported if CRF is HrP2, Jfp2, JfP1 */
2422 switch (ver->cnvr_top & 0xFFF) {
2423 case 0x504: /* Hrp2 */
2424 case 0x202: /* Jfp2 */
2425 case 0x201: /* Jfp1 */
2426 bt_dev_dbg(hdev, "PPAG not supported for Intel CNVr (0x%3x)",
2427 ver->cnvr_top & 0xFFF);
2431 handle = ACPI_HANDLE(GET_HCIDEV_DEV(hdev));
2433 bt_dev_info(hdev, "No support for BT device in ACPI firmware");
2437 status = acpi_evaluate_object(handle, "PPAG", NULL, &buffer);
2438 if (ACPI_FAILURE(status)) {
2439 if (status == AE_NOT_FOUND) {
2440 bt_dev_dbg(hdev, "PPAG-BT: ACPI entry not found");
2443 bt_dev_warn(hdev, "PPAG-BT: ACPI Failure: %s", acpi_format_exception(status));
2448 if (p->type != ACPI_TYPE_PACKAGE || p->package.count != 2) {
2449 bt_dev_warn(hdev, "PPAG-BT: Invalid object type: %d or package count: %d",
2450 p->type, p->package.count);
2451 kfree(buffer.pointer);
2455 elements = p->package.elements;
2457 /* PPAG table is located at element[1] */
2460 domain = (u32)p->package.elements[0].integer.value;
2461 mode = (u32)p->package.elements[1].integer.value;
2462 kfree(buffer.pointer);
2464 if (domain != 0x12) {
2465 bt_dev_dbg(hdev, "PPAG-BT: Bluetooth domain is disabled in ACPI firmware");
2470 * BIT 0 : 0 Disabled in EU
2472 * BIT 1 : 0 Disabled in China
2473 * 1 Enabled in China
2478 bt_dev_dbg(hdev, "PPAG-BT: EU, China mode are disabled in BIOS");
2482 ppag_cmd.ppag_enable_flags = cpu_to_le32(mode);
2484 skb = __hci_cmd_sync(hdev, INTEL_OP_PPAG_CMD, sizeof(ppag_cmd),
2485 &ppag_cmd, HCI_CMD_TIMEOUT);
2487 bt_dev_warn(hdev, "Failed to send PPAG Enable (%ld)", PTR_ERR(skb));
2490 bt_dev_info(hdev, "PPAG-BT: Enabled (Mode %d)", mode);
2494 static int btintel_acpi_reset_method(struct hci_dev *hdev)
2498 union acpi_object *p, *ref;
2499 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
2501 status = acpi_evaluate_object(ACPI_HANDLE(GET_HCIDEV_DEV(hdev)), "_PRR", NULL, &buffer);
2502 if (ACPI_FAILURE(status)) {
2503 bt_dev_err(hdev, "Failed to run _PRR method");
2509 if (p->package.count != 1 || p->type != ACPI_TYPE_PACKAGE) {
2510 bt_dev_err(hdev, "Invalid arguments");
2515 ref = &p->package.elements[0];
2516 if (ref->type != ACPI_TYPE_LOCAL_REFERENCE) {
2517 bt_dev_err(hdev, "Invalid object type: 0x%x", ref->type);
2522 status = acpi_evaluate_object(ref->reference.handle, "_RST", NULL, NULL);
2523 if (ACPI_FAILURE(status)) {
2524 bt_dev_err(hdev, "Failed to run_RST method");
2530 kfree(buffer.pointer);
2534 static void btintel_set_dsm_reset_method(struct hci_dev *hdev,
2535 struct intel_version_tlv *ver_tlv)
2537 struct btintel_data *data = hci_get_priv(hdev);
2538 acpi_handle handle = ACPI_HANDLE(GET_HCIDEV_DEV(hdev));
2539 u8 reset_payload[4] = {0x01, 0x00, 0x01, 0x00};
2540 union acpi_object *obj, argv4;
2542 RESET_TYPE_WDISABLE2,
2546 handle = ACPI_HANDLE(GET_HCIDEV_DEV(hdev));
2549 bt_dev_dbg(hdev, "No support for bluetooth device in ACPI firmware");
2553 if (!acpi_has_method(handle, "_PRR")) {
2554 bt_dev_err(hdev, "No support for _PRR ACPI method");
2558 switch (ver_tlv->cnvi_top & 0xfff) {
2559 case 0x910: /* GalePeak2 */
2560 reset_payload[2] = RESET_TYPE_VSEC;
2563 /* WDISABLE2 is the default reset method */
2564 reset_payload[2] = RESET_TYPE_WDISABLE2;
2566 if (!acpi_check_dsm(handle, &btintel_guid_dsm, 0,
2567 BIT(DSM_SET_WDISABLE2_DELAY))) {
2568 bt_dev_err(hdev, "No dsm support to set reset delay");
2571 argv4.integer.type = ACPI_TYPE_INTEGER;
2572 /* delay required to toggle BT power */
2573 argv4.integer.value = 160;
2574 obj = acpi_evaluate_dsm(handle, &btintel_guid_dsm, 0,
2575 DSM_SET_WDISABLE2_DELAY, &argv4);
2577 bt_dev_err(hdev, "Failed to call dsm to set reset delay");
2583 bt_dev_info(hdev, "DSM reset method type: 0x%02x", reset_payload[2]);
2585 if (!acpi_check_dsm(handle, &btintel_guid_dsm, 0,
2586 DSM_SET_RESET_METHOD)) {
2587 bt_dev_warn(hdev, "No support for dsm to set reset method");
2590 argv4.buffer.type = ACPI_TYPE_BUFFER;
2591 argv4.buffer.length = sizeof(reset_payload);
2592 argv4.buffer.pointer = reset_payload;
2594 obj = acpi_evaluate_dsm(handle, &btintel_guid_dsm, 0,
2595 DSM_SET_RESET_METHOD, &argv4);
2597 bt_dev_err(hdev, "Failed to call dsm to set reset method");
2601 data->acpi_reset_method = btintel_acpi_reset_method;
2604 #define BTINTEL_ISODATA_HANDLE_BASE 0x900
2606 static u8 btintel_classify_pkt_type(struct hci_dev *hdev, struct sk_buff *skb)
2609 * Distinguish ISO data packets form ACL data packets
2610 * based on their connection handle value range.
2612 if (hci_skb_pkt_type(skb) == HCI_ACLDATA_PKT) {
2613 __u16 handle = __le16_to_cpu(hci_acl_hdr(skb)->handle);
2615 if (hci_handle(handle) >= BTINTEL_ISODATA_HANDLE_BASE)
2616 return HCI_ISODATA_PKT;
2619 return hci_skb_pkt_type(skb);
2623 * UefiCnvCommonDSBR UEFI variable provides information from the OEM platforms
2624 * if they have replaced the BRI (Bluetooth Radio Interface) resistor to
2625 * overcome the potential STEP errors on their designs. Based on the
2626 * configauration, bluetooth firmware shall adjust the BRI response line drive
2627 * strength. The below structure represents DSBR data.
2633 * header - defines revision number of the structure
2634 * dsbr - defines drive strength BRI response
2636 * 0 - instructs bluetooth firmware to use default values
2637 * 1 - instructs bluetooth firmware to override default values
2641 * DSBR override values (only if bit0 is set. Default value is 0xF
2644 * Expected values for dsbr field:
2645 * 1. 0xF1 - indicates that the resistor on board is 33 Ohm
2646 * 2. 0x00 or 0xB1 - indicates that the resistor on board is 10 Ohm
2647 * 3. Non existing UEFI variable or invalid (none of the above) - indicates
2648 * that the resistor on board is 10 Ohm
2649 * Even if uefi variable is not present, driver shall send 0xfc0a command to
2650 * firmware to use default values.
2653 static int btintel_uefi_get_dsbr(u32 *dsbr_var)
2655 struct btintel_dsbr {
2660 efi_status_t status;
2661 unsigned long data_size = 0;
2662 efi_guid_t guid = EFI_GUID(0xe65d8884, 0xd4af, 0x4b20, 0x8d, 0x03,
2663 0x77, 0x2e, 0xcc, 0x3d, 0xa5, 0x31);
2665 if (!IS_ENABLED(CONFIG_EFI))
2668 if (!efi_rt_services_supported(EFI_RT_SUPPORTED_GET_VARIABLE))
2671 status = efi.get_variable(BTINTEL_EFI_DSBR, &guid, NULL, &data_size,
2674 if (status != EFI_BUFFER_TOO_SMALL || !data_size)
2677 status = efi.get_variable(BTINTEL_EFI_DSBR, &guid, NULL, &data_size,
2680 if (status != EFI_SUCCESS)
2683 *dsbr_var = data.dsbr;
2687 static int btintel_set_dsbr(struct hci_dev *hdev, struct intel_version_tlv *ver)
2689 struct btintel_dsbr_cmd {
2694 struct btintel_dsbr_cmd cmd;
2695 struct sk_buff *skb;
2701 /* DSBR command needs to be sent for BlazarI + B0 step product after
2702 * downloading IML image.
2704 apply_dsbr = (ver->img_type == BTINTEL_IMG_IML &&
2705 ((ver->cnvi_top & 0xfff) == BTINTEL_CNVI_BLAZARI) &&
2706 INTEL_CNVX_TOP_STEP(ver->cnvi_top) == 0x01);
2712 err = btintel_uefi_get_dsbr(&dsbr);
2714 bt_dev_dbg(hdev, "Error reading efi: %ls (%d)",
2715 BTINTEL_EFI_DSBR, err);
2717 cmd.enable = dsbr & BIT(0);
2718 cmd.dsbr = dsbr >> 4 & 0xF;
2720 bt_dev_info(hdev, "dsbr: enable: 0x%2.2x value: 0x%2.2x", cmd.enable,
2723 skb = __hci_cmd_sync(hdev, 0xfc0a, sizeof(cmd), &cmd, HCI_CMD_TIMEOUT);
2725 return -bt_to_errno(PTR_ERR(skb));
2727 status = skb->data[0];
2731 return -bt_to_errno(status);
2736 int btintel_bootloader_setup_tlv(struct hci_dev *hdev,
2737 struct intel_version_tlv *ver)
2742 struct intel_version_tlv new_ver;
2744 bt_dev_dbg(hdev, "");
2746 /* Set the default boot parameter to 0x0 and it is updated to
2747 * SKU specific boot parameter after reading Intel_Write_Boot_Params
2748 * command while downloading the firmware.
2750 boot_param = 0x00000000;
2752 btintel_set_flag(hdev, INTEL_BOOTLOADER);
2754 err = btintel_prepare_fw_download_tlv(hdev, ver, &boot_param);
2758 /* check if controller is already having an operational firmware */
2759 if (ver->img_type == BTINTEL_IMG_OP)
2762 err = btintel_boot(hdev, boot_param);
2766 err = btintel_read_version_tlv(hdev, ver);
2770 /* set drive strength of BRI response */
2771 err = btintel_set_dsbr(hdev, ver);
2773 bt_dev_err(hdev, "Failed to send dsbr command (%d)", err);
2777 /* If image type returned is BTINTEL_IMG_IML, then controller supports
2778 * intermediate loader image
2780 if (ver->img_type == BTINTEL_IMG_IML) {
2781 err = btintel_prepare_fw_download_tlv(hdev, ver, &boot_param);
2785 err = btintel_boot(hdev, boot_param);
2790 btintel_clear_flag(hdev, INTEL_BOOTLOADER);
2792 btintel_get_fw_name_tlv(ver, ddcname, sizeof(ddcname), "ddc");
2793 /* Once the device is running in operational mode, it needs to
2794 * apply the device configuration (DDC) parameters.
2796 * The device can work without DDC parameters, so even if it
2797 * fails to load the file, no need to fail the setup.
2799 btintel_load_ddc_config(hdev, ddcname);
2801 /* Read supported use cases and set callbacks to fetch datapath id */
2802 btintel_configure_offload(hdev);
2804 hci_dev_clear_flag(hdev, HCI_QUALITY_REPORT);
2806 /* Set PPAG feature */
2807 btintel_set_ppag(hdev, ver);
2809 /* Read the Intel version information after loading the FW */
2810 err = btintel_read_version_tlv(hdev, &new_ver);
2814 btintel_version_info_tlv(hdev, &new_ver);
2817 /* Set the event mask for Intel specific vendor events. This enables
2818 * a few extra events that are useful during general operation. It
2819 * does not enable any debugging related events.
2821 * The device will function correctly without these events enabled
2822 * and thus no need to fail the setup.
2824 btintel_set_event_mask(hdev, false);
2828 EXPORT_SYMBOL_GPL(btintel_bootloader_setup_tlv);
2830 void btintel_set_msft_opcode(struct hci_dev *hdev, u8 hw_variant)
2832 switch (hw_variant) {
2833 /* Legacy bootloader devices that supports MSFT Extension */
2834 case 0x11: /* JfP */
2835 case 0x12: /* ThP */
2836 case 0x13: /* HrP */
2837 case 0x14: /* CcP */
2838 /* All Intel new genration controllers support the Microsoft vendor
2839 * extension are using 0xFC1E for VsMsftOpCode.
2848 hci_set_msft_opcode(hdev, 0xFC1E);
2855 EXPORT_SYMBOL_GPL(btintel_set_msft_opcode);
2857 void btintel_print_fseq_info(struct hci_dev *hdev)
2859 struct sk_buff *skb;
2864 skb = __hci_cmd_sync(hdev, 0xfcb3, 0, NULL, HCI_CMD_TIMEOUT);
2866 bt_dev_dbg(hdev, "Reading fseq status command failed (%ld)",
2871 if (skb->len < (sizeof(u32) * 16 + 2)) {
2872 bt_dev_dbg(hdev, "Malformed packet of length %u received",
2878 p = skb_pull_data(skb, 1);
2880 bt_dev_dbg(hdev, "Failed to get fseq status (0x%2.2x)", *p);
2885 p = skb_pull_data(skb, 1);
2891 str = "Fatal error";
2894 str = "Semaphore acquire error";
2897 str = "Unknown error";
2902 bt_dev_err(hdev, "Fseq status: %s (0x%2.2x)", str, *p);
2907 bt_dev_info(hdev, "Fseq status: %s (0x%2.2x)", str, *p);
2909 val = get_unaligned_le32(skb_pull_data(skb, 4));
2910 bt_dev_dbg(hdev, "Reason: 0x%8.8x", val);
2912 val = get_unaligned_le32(skb_pull_data(skb, 4));
2913 bt_dev_dbg(hdev, "Global version: 0x%8.8x", val);
2915 val = get_unaligned_le32(skb_pull_data(skb, 4));
2916 bt_dev_dbg(hdev, "Installed version: 0x%8.8x", val);
2919 skb_pull_data(skb, 4);
2920 bt_dev_info(hdev, "Fseq executed: %2.2u.%2.2u.%2.2u.%2.2u", p[0], p[1],
2924 skb_pull_data(skb, 4);
2925 bt_dev_info(hdev, "Fseq BT Top: %2.2u.%2.2u.%2.2u.%2.2u", p[0], p[1],
2928 val = get_unaligned_le32(skb_pull_data(skb, 4));
2929 bt_dev_dbg(hdev, "Fseq Top init version: 0x%8.8x", val);
2931 val = get_unaligned_le32(skb_pull_data(skb, 4));
2932 bt_dev_dbg(hdev, "Fseq Cnvio init version: 0x%8.8x", val);
2934 val = get_unaligned_le32(skb_pull_data(skb, 4));
2935 bt_dev_dbg(hdev, "Fseq MBX Wifi file version: 0x%8.8x", val);
2937 val = get_unaligned_le32(skb_pull_data(skb, 4));
2938 bt_dev_dbg(hdev, "Fseq BT version: 0x%8.8x", val);
2940 val = get_unaligned_le32(skb_pull_data(skb, 4));
2941 bt_dev_dbg(hdev, "Fseq Top reset address: 0x%8.8x", val);
2943 val = get_unaligned_le32(skb_pull_data(skb, 4));
2944 bt_dev_dbg(hdev, "Fseq MBX timeout: 0x%8.8x", val);
2946 val = get_unaligned_le32(skb_pull_data(skb, 4));
2947 bt_dev_dbg(hdev, "Fseq MBX ack: 0x%8.8x", val);
2949 val = get_unaligned_le32(skb_pull_data(skb, 4));
2950 bt_dev_dbg(hdev, "Fseq CNVi id: 0x%8.8x", val);
2952 val = get_unaligned_le32(skb_pull_data(skb, 4));
2953 bt_dev_dbg(hdev, "Fseq CNVr id: 0x%8.8x", val);
2955 val = get_unaligned_le32(skb_pull_data(skb, 4));
2956 bt_dev_dbg(hdev, "Fseq Error handle: 0x%8.8x", val);
2958 val = get_unaligned_le32(skb_pull_data(skb, 4));
2959 bt_dev_dbg(hdev, "Fseq Magic noalive indication: 0x%8.8x", val);
2961 val = get_unaligned_le32(skb_pull_data(skb, 4));
2962 bt_dev_dbg(hdev, "Fseq OTP version: 0x%8.8x", val);
2964 val = get_unaligned_le32(skb_pull_data(skb, 4));
2965 bt_dev_dbg(hdev, "Fseq MBX otp version: 0x%8.8x", val);
2969 EXPORT_SYMBOL_GPL(btintel_print_fseq_info);
2971 static int btintel_setup_combined(struct hci_dev *hdev)
2973 const u8 param[1] = { 0xFF };
2974 struct intel_version ver;
2975 struct intel_version_tlv ver_tlv;
2976 struct sk_buff *skb;
2979 BT_DBG("%s", hdev->name);
2981 /* The some controllers have a bug with the first HCI command sent to it
2982 * returning number of completed commands as zero. This would stall the
2983 * command processing in the Bluetooth core.
2985 * As a workaround, send HCI Reset command first which will reset the
2986 * number of completed commands and allow normal command processing
2989 * Regarding the INTEL_BROKEN_SHUTDOWN_LED flag, these devices maybe
2990 * in the SW_RFKILL ON state as a workaround of fixing LED issue during
2991 * the shutdown() procedure, and once the device is in SW_RFKILL ON
2992 * state, the only way to exit out of it is sending the HCI_Reset
2995 if (btintel_test_flag(hdev, INTEL_BROKEN_INITIAL_NCMD) ||
2996 btintel_test_flag(hdev, INTEL_BROKEN_SHUTDOWN_LED)) {
2997 skb = __hci_cmd_sync(hdev, HCI_OP_RESET, 0, NULL,
3001 "sending initial HCI reset failed (%ld)",
3003 return PTR_ERR(skb);
3008 /* Starting from TyP device, the command parameter and response are
3009 * changed even though the OCF for HCI_Intel_Read_Version command
3010 * remains same. The legacy devices can handle even if the
3011 * command has a parameter and returns a correct version information.
3012 * So, it uses new format to support both legacy and new format.
3014 skb = __hci_cmd_sync(hdev, 0xfc05, 1, param, HCI_CMD_TIMEOUT);
3016 bt_dev_err(hdev, "Reading Intel version command failed (%ld)",
3018 return PTR_ERR(skb);
3021 /* Check the status */
3023 bt_dev_err(hdev, "Intel Read Version command failed (%02x)",
3029 /* Apply the common HCI quirks for Intel device */
3030 set_bit(HCI_QUIRK_STRICT_DUPLICATE_FILTER, &hdev->quirks);
3031 set_bit(HCI_QUIRK_SIMULTANEOUS_DISCOVERY, &hdev->quirks);
3032 set_bit(HCI_QUIRK_NON_PERSISTENT_DIAG, &hdev->quirks);
3034 /* Set up the quality report callback for Intel devices */
3035 hdev->set_quality_report = btintel_set_quality_report;
3037 /* For Legacy device, check the HW platform value and size */
3038 if (skb->len == sizeof(ver) && skb->data[1] == 0x37) {
3039 bt_dev_dbg(hdev, "Read the legacy Intel version information");
3041 memcpy(&ver, skb->data, sizeof(ver));
3043 /* Display version information */
3044 btintel_version_info(hdev, &ver);
3046 /* Check for supported iBT hardware variants of this firmware
3049 * This check has been put in place to ensure correct forward
3050 * compatibility options when newer hardware variants come
3053 switch (ver.hw_variant) {
3055 case 0x08: /* StP */
3056 /* Legacy ROM product */
3057 btintel_set_flag(hdev, INTEL_ROM_LEGACY);
3059 /* Apply the device specific HCI quirks
3061 * WBS for SdP - For the Legacy ROM products, only SdP
3062 * supports the WBS. But the version information is not
3063 * enough to use here because the StP2 and SdP have same
3064 * hw_variant and fw_variant. So, this flag is set by
3065 * the transport driver (btusb) based on the HW info
3068 if (!btintel_test_flag(hdev,
3069 INTEL_ROM_LEGACY_NO_WBS_SUPPORT))
3070 set_bit(HCI_QUIRK_WIDEBAND_SPEECH_SUPPORTED,
3073 err = btintel_legacy_rom_setup(hdev, &ver);
3075 case 0x0b: /* SfP */
3076 case 0x11: /* JfP */
3077 case 0x12: /* ThP */
3078 case 0x13: /* HrP */
3079 case 0x14: /* CcP */
3081 case 0x0c: /* WsP */
3082 /* Apply the device specific HCI quirks
3084 * All Legacy bootloader devices support WBS
3086 set_bit(HCI_QUIRK_WIDEBAND_SPEECH_SUPPORTED,
3089 /* These variants don't seem to support LE Coded PHY */
3090 set_bit(HCI_QUIRK_BROKEN_LE_CODED, &hdev->quirks);
3092 /* Setup MSFT Extension support */
3093 btintel_set_msft_opcode(hdev, ver.hw_variant);
3095 err = btintel_bootloader_setup(hdev, &ver);
3096 btintel_register_devcoredump_support(hdev);
3099 bt_dev_err(hdev, "Unsupported Intel hw variant (%u)",
3104 hci_set_hw_info(hdev,
3105 "INTEL platform=%u variant=%u revision=%u",
3106 ver.hw_platform, ver.hw_variant,
3112 /* memset ver_tlv to start with clean state as few fields are exclusive
3113 * to bootloader mode and are not populated in operational mode
3115 memset(&ver_tlv, 0, sizeof(ver_tlv));
3116 /* For TLV type device, parse the tlv data */
3117 err = btintel_parse_version_tlv(hdev, &ver_tlv, skb);
3119 bt_dev_err(hdev, "Failed to parse TLV version information");
3123 if (INTEL_HW_PLATFORM(ver_tlv.cnvi_bt) != 0x37) {
3124 bt_dev_err(hdev, "Unsupported Intel hardware platform (0x%2x)",
3125 INTEL_HW_PLATFORM(ver_tlv.cnvi_bt));
3130 /* Check for supported iBT hardware variants of this firmware
3133 * This check has been put in place to ensure correct forward
3134 * compatibility options when newer hardware variants come
3137 switch (INTEL_HW_VARIANT(ver_tlv.cnvi_bt)) {
3138 case 0x11: /* JfP */
3139 case 0x12: /* ThP */
3140 case 0x13: /* HrP */
3141 case 0x14: /* CcP */
3142 /* Some legacy bootloader devices starting from JfP,
3143 * the operational firmware supports both old and TLV based
3144 * HCI_Intel_Read_Version command based on the command
3147 * For upgrading firmware case, the TLV based version cannot
3148 * be used because the firmware filename for legacy bootloader
3149 * is based on the old format.
3151 * Also, it is not easy to convert TLV based version from the
3152 * legacy version format.
3154 * So, as a workaround for those devices, use the legacy
3155 * HCI_Intel_Read_Version to get the version information and
3156 * run the legacy bootloader setup.
3158 err = btintel_read_version(hdev, &ver);
3162 /* Apply the device specific HCI quirks
3164 * All Legacy bootloader devices support WBS
3166 set_bit(HCI_QUIRK_WIDEBAND_SPEECH_SUPPORTED, &hdev->quirks);
3168 /* These variants don't seem to support LE Coded PHY */
3169 set_bit(HCI_QUIRK_BROKEN_LE_CODED, &hdev->quirks);
3171 /* Setup MSFT Extension support */
3172 btintel_set_msft_opcode(hdev, ver.hw_variant);
3174 err = btintel_bootloader_setup(hdev, &ver);
3175 btintel_register_devcoredump_support(hdev);
3177 case 0x18: /* GfP2 */
3178 case 0x1c: /* GaP */
3179 /* Re-classify packet type for controllers with LE audio */
3180 hdev->classify_pkt_type = btintel_classify_pkt_type;
3187 /* Display version information of TLV type */
3188 btintel_version_info_tlv(hdev, &ver_tlv);
3190 /* Apply the device specific HCI quirks for TLV based devices
3192 * All TLV based devices support WBS
3194 set_bit(HCI_QUIRK_WIDEBAND_SPEECH_SUPPORTED, &hdev->quirks);
3196 /* Setup MSFT Extension support */
3197 btintel_set_msft_opcode(hdev,
3198 INTEL_HW_VARIANT(ver_tlv.cnvi_bt));
3199 btintel_set_dsm_reset_method(hdev, &ver_tlv);
3201 err = btintel_bootloader_setup_tlv(hdev, &ver_tlv);
3205 btintel_register_devcoredump_support(hdev);
3206 btintel_print_fseq_info(hdev);
3209 bt_dev_err(hdev, "Unsupported Intel hw variant (%u)",
3210 INTEL_HW_VARIANT(ver_tlv.cnvi_bt));
3215 hci_set_hw_info(hdev, "INTEL platform=%u variant=%u",
3216 INTEL_HW_PLATFORM(ver_tlv.cnvi_bt),
3217 INTEL_HW_VARIANT(ver_tlv.cnvi_bt));
3225 int btintel_shutdown_combined(struct hci_dev *hdev)
3227 struct sk_buff *skb;
3230 /* Send HCI Reset to the controller to stop any BT activity which
3231 * were triggered. This will help to save power and maintain the
3232 * sync b/w Host and controller
3234 skb = __hci_cmd_sync(hdev, HCI_OP_RESET, 0, NULL, HCI_INIT_TIMEOUT);
3236 bt_dev_err(hdev, "HCI reset during shutdown failed");
3237 return PTR_ERR(skb);
3242 /* Some platforms have an issue with BT LED when the interface is
3243 * down or BT radio is turned off, which takes 5 seconds to BT LED
3244 * goes off. As a workaround, sends HCI_Intel_SW_RFKILL to put the
3245 * device in the RFKILL ON state which turns off the BT LED immediately.
3247 if (btintel_test_flag(hdev, INTEL_BROKEN_SHUTDOWN_LED)) {
3248 skb = __hci_cmd_sync(hdev, 0xfc3f, 0, NULL, HCI_INIT_TIMEOUT);
3251 bt_dev_err(hdev, "turning off Intel device LED failed");
3259 EXPORT_SYMBOL_GPL(btintel_shutdown_combined);
3261 int btintel_configure_setup(struct hci_dev *hdev, const char *driver_name)
3263 hdev->manufacturer = 2;
3264 hdev->setup = btintel_setup_combined;
3265 hdev->shutdown = btintel_shutdown_combined;
3266 hdev->hw_error = btintel_hw_error;
3267 hdev->set_diag = btintel_set_diag_combined;
3268 hdev->set_bdaddr = btintel_set_bdaddr;
3270 coredump_info.driver_name = driver_name;
3274 EXPORT_SYMBOL_GPL(btintel_configure_setup);
3276 static int btintel_diagnostics(struct hci_dev *hdev, struct sk_buff *skb)
3278 struct intel_tlv *tlv = (void *)&skb->data[5];
3280 /* The first event is always an event type TLV */
3281 if (tlv->type != INTEL_TLV_TYPE_ID)
3284 switch (tlv->val[0]) {
3285 case INTEL_TLV_SYSTEM_EXCEPTION:
3286 case INTEL_TLV_FATAL_EXCEPTION:
3287 case INTEL_TLV_DEBUG_EXCEPTION:
3288 case INTEL_TLV_TEST_EXCEPTION:
3289 /* Generate devcoredump from exception */
3290 if (!hci_devcd_init(hdev, skb->len)) {
3291 hci_devcd_append(hdev, skb);
3292 hci_devcd_complete(hdev);
3294 bt_dev_err(hdev, "Failed to generate devcoredump");
3299 bt_dev_err(hdev, "Invalid exception type %02X", tlv->val[0]);
3303 return hci_recv_frame(hdev, skb);
3306 int btintel_recv_event(struct hci_dev *hdev, struct sk_buff *skb)
3308 struct hci_event_hdr *hdr = (void *)skb->data;
3309 const char diagnostics_hdr[] = { 0x87, 0x80, 0x03 };
3311 if (skb->len > HCI_EVENT_HDR_SIZE && hdr->evt == 0xff &&
3313 const void *ptr = skb->data + HCI_EVENT_HDR_SIZE + 1;
3314 unsigned int len = skb->len - HCI_EVENT_HDR_SIZE - 1;
3316 if (btintel_test_flag(hdev, INTEL_BOOTLOADER)) {
3317 switch (skb->data[2]) {
3319 /* When switching to the operational firmware
3320 * the device sends a vendor specific event
3321 * indicating that the bootup completed.
3323 btintel_bootup(hdev, ptr, len);
3326 /* When the firmware loading completes the
3327 * device sends out a vendor specific event
3328 * indicating the result of the firmware
3331 btintel_secure_send_result(hdev, ptr, len);
3336 /* Handle all diagnostics events separately. May still call
3339 if (len >= sizeof(diagnostics_hdr) &&
3340 memcmp(&skb->data[2], diagnostics_hdr,
3341 sizeof(diagnostics_hdr)) == 0) {
3342 return btintel_diagnostics(hdev, skb);
3346 return hci_recv_frame(hdev, skb);
3348 EXPORT_SYMBOL_GPL(btintel_recv_event);
3350 void btintel_bootup(struct hci_dev *hdev, const void *ptr, unsigned int len)
3352 const struct intel_bootup *evt = ptr;
3354 if (len != sizeof(*evt))
3357 if (btintel_test_and_clear_flag(hdev, INTEL_BOOTING))
3358 btintel_wake_up_flag(hdev, INTEL_BOOTING);
3360 EXPORT_SYMBOL_GPL(btintel_bootup);
3362 void btintel_secure_send_result(struct hci_dev *hdev,
3363 const void *ptr, unsigned int len)
3365 const struct intel_secure_send_result *evt = ptr;
3367 if (len != sizeof(*evt))
3371 btintel_set_flag(hdev, INTEL_FIRMWARE_FAILED);
3373 if (btintel_test_and_clear_flag(hdev, INTEL_DOWNLOADING) &&
3374 btintel_test_flag(hdev, INTEL_FIRMWARE_LOADED))
3375 btintel_wake_up_flag(hdev, INTEL_DOWNLOADING);
3377 EXPORT_SYMBOL_GPL(btintel_secure_send_result);
3380 MODULE_DESCRIPTION("Bluetooth support for Intel devices ver " VERSION);
3381 MODULE_VERSION(VERSION);
3382 MODULE_LICENSE("GPL");
3383 MODULE_FIRMWARE("intel/ibt-11-5.sfi");
3384 MODULE_FIRMWARE("intel/ibt-11-5.ddc");
3385 MODULE_FIRMWARE("intel/ibt-12-16.sfi");
3386 MODULE_FIRMWARE("intel/ibt-12-16.ddc");