Documentation/devicetree/bindings/net/ti,bluetooth.yaml

   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
   7 title: Texas Instruments Bluetooth Chips
   8
   9 maintainers:
  10   - David Lechner <david@lechnology.com>
  11
  12 description: |
  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
  29 properties:
  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
  74 required:
  75   - compatible
  76
  77 additionalProperties: false
  78
  79 examples:
  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     };