xref: /linux/Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml (revision 184e56e77c06a7eef68a021e9d4b11a11a8ab096) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/bluetooth/nxp,88w8987-bt.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: NXP Bluetooth chips
8
9description:
10  This binding describes UART-attached NXP bluetooth chips. These chips
11  are dual-radio chips supporting WiFi and Bluetooth. The bluetooth
12  works on standard H4 protocol over 4-wire UART. The RTS and CTS lines
13  are used during FW download. To enable power save mode, the host
14  asserts break signal over UART-TX line to put the chip into power save
15  state. De-asserting break wakes up the BT chip.
16
17maintainers:
18  - Neeraj Sanjay Kale <neeraj.sanjaykale@nxp.com>
19
20allOf:
21  - $ref: bluetooth-controller.yaml#
22
23properties:
24  compatible:
25    enum:
26      - nxp,88w8987-bt
27      - nxp,88w8997-bt
28
29  fw-init-baudrate:
30    $ref: /schemas/types.yaml#/definitions/uint32
31    default: 115200
32    description:
33      Chip baudrate after FW is downloaded and initialized.
34      This property depends on the module vendor's
35      configuration.
36
37  firmware-name:
38    maxItems: 1
39
40  device-wakeup-gpios:
41    maxItems: 1
42    description:
43      Host-To-Chip power save mechanism is driven by this GPIO
44      connected to BT_WAKE_IN pin of the NXP chipset.
45
46  nxp,wakein-pin:
47    $ref: /schemas/types.yaml#/definitions/uint8
48    description:
49      The GPIO number of the NXP chipset used for BT_WAKE_IN.
50
51  nxp,wakeout-pin:
52    $ref: /schemas/types.yaml#/definitions/uint8
53    description:
54      The GPIO number of the NXP chipset used for BT_WAKE_OUT.
55
56required:
57  - compatible
58
59unevaluatedProperties: false
60
61examples:
62  - |
63    #include <dt-bindings/gpio/gpio.h>
64    serial {
65        bluetooth {
66            compatible = "nxp,88w8987-bt";
67            fw-init-baudrate = <3000000>;
68            firmware-name = "uartuart8987_bt_v0.bin";
69            device-wakeup-gpios = <&gpio 11 GPIO_ACTIVE_HIGH>;
70            nxp,wakein-pin = /bits/ 8 <18>;
71            nxp,wakeout-pin = /bits/ 8 <19>;
72            local-bd-address = [66 55 44 33 22 11];
73        };
74    };
75