xref: /freebsd/sys/contrib/device-tree/Bindings/net/ti,bluetooth.yaml (revision 7fdf597e96a02165cfe22ff357b857d5fa15ed8a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/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
77additionalProperties: false
78
79examples:
80  - |
81    #include <dt-bindings/gpio/gpio.h>
82
83    serial {
84            bluetooth {
85                    compatible = "ti,wl1835-st";
86                    enable-gpios = <&gpio1 7 GPIO_ACTIVE_HIGH>;
87                    clocks = <&clk32k_wl18xx>;
88                    clock-names = "ext_clock";
89                    nvmem-cells = <&bd_address>;
90                    nvmem-cell-names = "bd-address";
91            };
92    };
93