xref: /linux/Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml (revision 7f71507851fc7764b36a3221839607d3a45c2025)
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
20properties:
21  compatible:
22    enum:
23      - nxp,88w8987-bt
24      - nxp,88w8997-bt
25
26  fw-init-baudrate:
27    $ref: /schemas/types.yaml#/definitions/uint32
28    default: 115200
29    description:
30      Chip baudrate after FW is downloaded and initialized.
31      This property depends on the module vendor's
32      configuration.
33
34  firmware-name:
35    maxItems: 1
36
37  device-wakeup-gpios:
38    maxItems: 1
39    description:
40      Host-To-Chip power save mechanism is driven by this GPIO
41      connected to BT_WAKE_IN pin of the NXP chipset.
42
43required:
44  - compatible
45
46additionalProperties: false
47
48examples:
49  - |
50    #include <dt-bindings/gpio/gpio.h>
51    serial {
52        bluetooth {
53            compatible = "nxp,88w8987-bt";
54            fw-init-baudrate = <3000000>;
55            firmware-name = "uartuart8987_bt_v0.bin";
56            device-wakeup-gpios = <&gpio 11 GPIO_ACTIVE_HIGH>;
57        };
58    };
59