xref: /freebsd/sys/contrib/device-tree/Bindings/net/ti-bluetooth.txt (revision 59c8e88e72633afbc47a4ace0d2170d00d51f7dc)
1Texas Instruments Bluetooth Chips
2---------------------------------
3
4This documents the binding structure and common properties for serial
5attached TI Bluetooth devices. The following chips are included in this
6binding:
7
8* TI CC256x Bluetooth devices
9* TI WiLink 7/8 (wl12xx/wl18xx) Shared Transport BT/FM/GPS devices
10
11TI WiLink devices have a UART interface for providing Bluetooth, FM radio,
12and GPS over what's called "shared transport". The shared transport is
13standard BT HCI protocol with additional channels for the other functions.
14
15TI WiLink devices also have a separate WiFi interface as described in
16wireless/ti,wlcore.txt.
17
18This bindings follows the UART slave device binding in ../serial/serial.yaml.
19
20Required properties:
21 - compatible: should be one of the following:
22    "ti,cc2560"
23    "ti,wl1271-st"
24    "ti,wl1273-st"
25    "ti,wl1281-st"
26    "ti,wl1283-st"
27    "ti,wl1285-st"
28    "ti,wl1801-st"
29    "ti,wl1805-st"
30    "ti,wl1807-st"
31    "ti,wl1831-st"
32    "ti,wl1835-st"
33    "ti,wl1837-st"
34
35Optional properties:
36 - enable-gpios : GPIO signal controlling enabling of BT. Active high.
37 - vio-supply : Vio input supply (1.8V)
38 - vbat-supply : Vbat input supply (2.9-4.8V)
39 - clocks : Must contain an entry, for each entry in clock-names.
40   See ../clocks/clock-bindings.txt for details.
41 - clock-names : Must include the following entry:
42   "ext_clock" (External clock provided to the TI combo chip).
43 - nvmem-cells: phandle to nvmem data cell that contains a 6 byte BD address
44   with the most significant byte first (big-endian).
45 - nvmem-cell-names: "bd-address" (required when nvmem-cells is specified)
46
47Example:
48
49&serial0 {
50	compatible = "ns16550a";
51	...
52	bluetooth {
53		compatible = "ti,wl1835-st";
54		enable-gpios = <&gpio1 7 GPIO_ACTIVE_HIGH>;
55		clocks = <&clk32k_wl18xx>;
56		clock-names = "ext_clock";
57		nvmem-cells = <&bd_address>;
58		nvmem-cell-names = "bd-address";
59	};
60};
61