xref: /freebsd/sys/contrib/device-tree/Bindings/net/ti,bluetooth.yaml (revision d5b0e70f7e04d971691517ce1304d86a1e367e2e) 
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