| Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame] | 1 | # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) |
| 2 | %YAML 1.2 |
| 3 | --- |
| 4 | $id: http://devicetree.org/schemas/net/broadcom-bluetooth.yaml# |
| 5 | $schema: http://devicetree.org/meta-schemas/core.yaml# |
| 6 | |
| 7 | title: Broadcom Bluetooth Chips |
| 8 | |
| 9 | maintainers: |
| 10 | - Linus Walleij <linus.walleij@linaro.org> |
| 11 | |
| 12 | description: |
| 13 | This binding describes Broadcom UART-attached bluetooth chips. |
| 14 | |
| 15 | properties: |
| 16 | compatible: |
| Tom Rini | 762f85b | 2024-07-20 11:15:10 -0600 | [diff] [blame] | 17 | oneOf: |
| 18 | - items: |
| 19 | - enum: |
| 20 | - infineon,cyw43439-bt |
| 21 | - const: brcm,bcm4329-bt |
| 22 | - enum: |
| 23 | - brcm,bcm20702a1 |
| 24 | - brcm,bcm4329-bt |
| 25 | - brcm,bcm4330-bt |
| 26 | - brcm,bcm4334-bt |
| 27 | - brcm,bcm43430a0-bt |
| 28 | - brcm,bcm43430a1-bt |
| 29 | - brcm,bcm43438-bt |
| 30 | - brcm,bcm4345c5 |
| 31 | - brcm,bcm43540-bt |
| 32 | - brcm,bcm4335a0 |
| 33 | - brcm,bcm4349-bt |
| 34 | - cypress,cyw4373a0-bt |
| 35 | - infineon,cyw55572-bt |
| Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame] | 36 | |
| 37 | shutdown-gpios: |
| 38 | maxItems: 1 |
| 39 | description: GPIO specifier for the line BT_REG_ON used to |
| 40 | power on the BT module |
| 41 | |
| 42 | reset-gpios: |
| 43 | maxItems: 1 |
| 44 | description: GPIO specifier for the line BT_RST_N used to |
| 45 | reset the BT module. This should be marked as |
| 46 | GPIO_ACTIVE_LOW. |
| 47 | |
| 48 | device-wakeup-gpios: |
| 49 | maxItems: 1 |
| 50 | description: GPIO specifier for the line BT_WAKE used to |
| 51 | wakeup the controller. This is using the BT_GPIO_0 |
| 52 | pin on the chip when in use. |
| 53 | |
| 54 | host-wakeup-gpios: |
| 55 | maxItems: 1 |
| 56 | deprecated: true |
| 57 | description: GPIO specifier for the line HOST_WAKE used |
| 58 | to wakeup the host processor. This is using he BT_GPIO_1 |
| 59 | pin on the chip when in use. This is deprecated and replaced |
| 60 | by interrupts and "host-wakeup" interrupt-names |
| 61 | |
| 62 | clocks: |
| 63 | minItems: 1 |
| 64 | maxItems: 2 |
| 65 | description: 1 or 2 clocks as defined in clock-names below, |
| 66 | in that order |
| 67 | |
| 68 | clock-names: |
| 69 | description: Names of the 1 to 2 supplied clocks |
| 70 | oneOf: |
| 71 | - const: extclk |
| 72 | deprecated: true |
| 73 | description: Deprecated in favor of txco |
| 74 | |
| 75 | - const: txco |
| 76 | description: > |
| 77 | external reference clock (not a standalone crystal) |
| 78 | |
| 79 | - const: lpo |
| 80 | description: > |
| 81 | external low power 32.768 kHz clock |
| 82 | |
| 83 | - items: |
| 84 | - const: txco |
| 85 | - const: lpo |
| 86 | |
| 87 | vbat-supply: |
| 88 | description: phandle to regulator supply for VBAT |
| 89 | |
| 90 | vddio-supply: |
| 91 | description: phandle to regulator supply for VDDIO |
| 92 | |
| 93 | brcm,bt-pcm-int-params: |
| 94 | $ref: /schemas/types.yaml#/definitions/uint8-array |
| 95 | minItems: 5 |
| 96 | maxItems: 5 |
| 97 | description: |- |
| 98 | configure PCM parameters via a 5-byte array: |
| 99 | sco-routing: 0 = PCM, 1 = Transport, 2 = Codec, 3 = I2S |
| 100 | pcm-interface-rate: 128KBps, 256KBps, 512KBps, 1024KBps, 2048KBps |
| 101 | pcm-frame-type: short, long |
| 102 | pcm-sync-mode: slave, master |
| 103 | pcm-clock-mode: slave, master |
| 104 | |
| 105 | brcm,requires-autobaud-mode: |
| 106 | type: boolean |
| 107 | description: |
| 108 | Set this property if autobaud mode is required. Autobaud mode is required |
| 109 | if the device's initial baud rate in normal mode is not supported by the |
| 110 | host or if the device requires autobaud mode startup before loading FW. |
| 111 | |
| 112 | interrupts: |
| 113 | items: |
| 114 | - description: Handle to the line HOST_WAKE used to wake |
| 115 | up the host processor. This uses the BT_GPIO_1 pin on |
| 116 | the chip when in use. |
| 117 | |
| 118 | interrupt-names: |
| 119 | items: |
| 120 | - const: host-wakeup |
| 121 | |
| 122 | max-speed: true |
| 123 | current-speed: true |
| 124 | |
| 125 | required: |
| 126 | - compatible |
| 127 | |
| 128 | dependencies: |
| 129 | brcm,requires-autobaud-mode: [ shutdown-gpios ] |
| 130 | |
| 131 | if: |
| 132 | not: |
| 133 | properties: |
| 134 | compatible: |
| 135 | contains: |
| 136 | enum: |
| 137 | - brcm,bcm20702a1 |
| 138 | - brcm,bcm4329-bt |
| 139 | - brcm,bcm4330-bt |
| 140 | then: |
| 141 | properties: |
| 142 | reset-gpios: false |
| 143 | |
| 144 | additionalProperties: false |
| 145 | |
| 146 | examples: |
| 147 | - | |
| 148 | #include <dt-bindings/gpio/gpio.h> |
| 149 | #include <dt-bindings/interrupt-controller/irq.h> |
| 150 | |
| 151 | uart { |
| 152 | uart-has-rtscts; |
| 153 | |
| 154 | bluetooth { |
| 155 | compatible = "brcm,bcm4330-bt"; |
| 156 | max-speed = <921600>; |
| 157 | brcm,bt-pcm-int-params = [01 02 00 01 01]; |
| 158 | shutdown-gpios = <&gpio 30 GPIO_ACTIVE_HIGH>; |
| 159 | device-wakeup-gpios = <&gpio 7 GPIO_ACTIVE_HIGH>; |
| 160 | reset-gpios = <&gpio 9 GPIO_ACTIVE_LOW>; |
| 161 | interrupt-parent = <&gpio>; |
| 162 | interrupts = <8 IRQ_TYPE_EDGE_FALLING>; |
| 163 | }; |
| 164 | }; |