xref: /linux/Documentation/devicetree/bindings/net/bluetooth/ti,bluetooth.yaml (revision 3a39d672e7f48b8d6b91a09afa4b55352773b4b5) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/bluetooth/ti,bluetooth.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Texas Instruments Bluetooth Chips
8
9maintainers:
10  - David Lechner <david@lechnology.com>
11
12description: |
13  This documents the binding structure and common properties for serial
14  attached TI Bluetooth devices. The following chips are included in this
15  binding:
16
17  * TI CC256x Bluetooth devices
18  * TI WiLink 7/8 (wl12xx/wl18xx) Shared Transport BT/FM/GPS devices
19
20  TI WiLink devices have a UART interface for providing Bluetooth, FM radio,
21  and GPS over what's called "shared transport". The shared transport is
22  standard BT HCI protocol with additional channels for the other functions.
23
24  TI WiLink devices also have a separate WiFi interface as described in
25  wireless/ti,wlcore.yaml.
26
27  This bindings follows the UART slave device binding in ../serial/serial.yaml.
28
29properties:
30  compatible:
31    enum:
32      - ti,cc2560
33      - ti,wl1271-st
34      - ti,wl1273-st
35      - ti,wl1281-st
36      - ti,wl1283-st
37      - ti,wl1285-st
38      - ti,wl1801-st
39      - ti,wl1805-st
40      - ti,wl1807-st
41      - ti,wl1831-st
42      - ti,wl1835-st
43      - ti,wl1837-st
44
45  enable-gpios:
46    maxItems: 1
47
48  vio-supply:
49    description: Vio input supply (1.8V)
50
51  vbat-supply:
52    description: Vbat input supply (2.9-4.8V)
53
54  clocks:
55    maxItems: 1
56
57  clock-names:
58    items:
59      - const: ext_clock
60
61  max-speed:
62    default: 3000000
63
64  nvmem-cells:
65    maxItems: 1
66    description:
67      Nvmem data cell that contains a 6 byte BD address with the most
68      significant byte first (big-endian).
69
70  nvmem-cell-names:
71    items:
72      - const: bd-address
73
74required:
75  - compatible
76
77allOf:
78  - $ref: /schemas/serial/serial-peripheral-props.yaml#
79
80additionalProperties: false
81
82examples:
83  - |
84    #include <dt-bindings/gpio/gpio.h>
85
86    serial {
87            bluetooth {
88                    compatible = "ti,wl1835-st";
89                    enable-gpios = <&gpio1 7 GPIO_ACTIVE_HIGH>;
90                    clocks = <&clk32k_wl18xx>;
91                    clock-names = "ext_clock";
92                    nvmem-cells = <&bd_address>;
93                    nvmem-cell-names = "bd-address";
94            };
95    };
96