From:   Neeraj Sanjay Kale <neeraj.sanjaykale@nxp.com>
To:     davem@davemloft.net, edumazet@google.com, kuba@kernel.org,
        pabeni@redhat.com, robh+dt@kernel.org,
        krzysztof.kozlowski+dt@linaro.org, marcel@holtmann.org,
        johan.hedberg@gmail.com, luiz.dentz@gmail.com,
        gregkh@linuxfoundation.org, jirislaby@kernel.org,
        alok.a.tiwari@oracle.com, hdanton@sina.com,
        ilpo.jarvinen@linux.intel.com, leon@kernel.org,
        simon.horman@corigine.com
Cc:     netdev@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org, linux-bluetooth@vger.kernel.org,
        linux-serial@vger.kernel.org, amitkumar.karwar@nxp.com,
        rohit.fule@nxp.com, sherry.sun@nxp.com, neeraj.sanjaykale@nxp.com
Subject: [PATCH v10 2/3] dt-bindings: net: bluetooth: Add NXP bluetooth support
Date:   Mon, 13 Mar 2023 20:10:27 +0530
Message-Id: <20230313144028.3156825-3-neeraj.sanjaykale@nxp.com>
In-Reply-To: <20230313144028.3156825-1-neeraj.sanjaykale@nxp.com>
References: <20230313144028.3156825-1-neeraj.sanjaykale@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?38sHNEuTucZIN0ZYUuAm2ZIbQJagQ6vhodCyfM/C2eArGE3OdplITDZoaLOH?=
 =?us-ascii?Q?0/UU2PYuLl00kwlxO8ze0K1ubsgtlKtreh08fXBrJwmSx2swCjEWd6iQMJJp?=
 =?us-ascii?Q?uVmFJ2PlxPPH5ui2Oet6BTVYCt86S6kSqnwi1m1xyQPRgV7CQLuBeF5/eT+C?=
 =?us-ascii?Q?H30W7WHWObkgHec+PDWpwPETJiBDqEpL7ENsdmZ1kYKuwnDpZjAI2/uh3fJ5?=
 =?us-ascii?Q?LPbJ6vQ02IXyQvXMteKaSHdnzbLhSZHa8/e5FCzdlUZOBDP6iQDvyLQ6CaRM?=
 =?us-ascii?Q?GFgYVeaNY5dTa0kwlCbAWJfYwiz1u9/UUoXw9udL/vGS4uT7KOvL3eCxRMBa?=
 =?us-ascii?Q?EUD1PM5XT6K6qSMbav3X9Bbs0ShmN2B7Mp1HoaLdq+SyaAejwD0DpXw7xeW+?=
 =?us-ascii?Q?1r+kkLgFn+E8TOb0aGlvUI423egKSpLGDmSAgQNxzVNkDRRF6mZDgJSilY+9?=
 =?us-ascii?Q?UT9j5D6cF16a7mIOE3DoMXUa9i1Lb9R219wUmWhnUMyD63Bitx4Gkhq++UZ/?=
 =?us-ascii?Q?fYTN0+apY40Dy/DoBBXjWU6zqjUAvQiuexcLqNMCvDgz9LgXhZunZ76FEylD?=
 =?us-ascii?Q?ZwNJuRWQlkTu6Sz07t4Hl09aLFiVF1uAwm7RSks1aSYX8U4h7MaClUYSqyzi?=
 =?us-ascii?Q?Cd6dxwwLJEjEdcuno7x/n6aieKXE8rJDrJTTdUPEfy5HiUXLhyYsJAkG1PR0?=
 =?us-ascii?Q?4KPgnuiRkyozKx5A/nhxehjbYEnsJgOWptgu7ACJIDpf21UBAr4VmlQYeS4G?=
 =?us-ascii?Q?tNfq9ndmAiMLh0aLhY8YBqNc4ChFzcP3ne3pDSp+eLaxk0uAmeMJkK/CzNxj?=
 =?us-ascii?Q?mmuUKqKWrisLSGebKkvLDMQeQzZWcPsG2GomhA58ojfv/kiKq4wtX7jSz5VY?=
 =?us-ascii?Q?1OUrcKrtl3Lqr7g3ma4qFwafsOm9z5O+Fj61NXk079aS+pym5nWTN23M+JgR?=
 =?us-ascii?Q?GR5r0/ro4gd7UNJ1Y4nthz7Iho586qpTvKOU+YNrQlCIsvkzKTno58pLFZnt?=
 =?us-ascii?Q?LTZ+p8cgEuTtAs95tkjLxytHWb6rSscv0FKrHlSuueVzu+gyTiEzOvuOC/9m?=
 =?us-ascii?Q?ewLHRqZkTqWaCctUbnMRibB31hlm0hT3MytRmB/LFghgKfYTNvevzyycAYhr?=
 =?us-ascii?Q?X45BUYIOD6XWLYissdfgwHMpgIF1XvDIkvyQuFsr70FJH7sMWGiIfaUFHDpg?=
 =?us-ascii?Q?CKwxAS6fy3dkBIOI72Oki2zUO1N58uCr283HP6iYPu4tqF2htMr2ZoECf8WJ?=
 =?us-ascii?Q?/jn9MM8KFKxCwml3xGic3J1/4BFwnP5cMPkCdMtlyB2SceXT9WQwMt3mFipk?=
 =?us-ascii?Q?VT2aeQa15Vh85/LJwSQpTUggxI77NFJfqr3x/YOAewA+wR3HeEPDzRjAeYUa?=
 =?us-ascii?Q?5x5noCr9mfIaNoLudS644daw7Brq2/9TnBb5UkdnsjDTxJ20nx5H3nRAOPjl?=
 =?us-ascii?Q?bHsO7++uFG3CYB4IPf4bAT4OpNJHjmQJDSq0ZY0f0HATr4sTHM9QcEcYK2D4?=
 =?us-ascii?Q?Tt+TMPxJhnMurYOsYxbEzOtet64VUIpb3seXZX1JL2YcsxuKhQbbNSU1gp41?=
 =?us-ascii?Q?gf5UcDNIyQLXMcVANsjk5j0d6c5DEGEo5EtncP81ULzjI1lDL4HzuRoi69t7?=
 =?us-ascii?Q?YQ=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 47493fb2-4813-4626-c0d2-08db23d0ffa7
X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8603.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Mar 2023 14:41:15.4129
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: x+lPea/cc49vRKRkvRymSy2PriMR6+/BqRDb6unxVYcBIc/kbs80fuvdNJ89hUrVlL9bsv0hyCbQfzYQaJaMud58hiHsAG16fWx2+WUE5K8=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR04MB7744
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Add binding document for NXP bluetooth chipsets attached over UART.

Signed-off-by: Neeraj Sanjay Kale <neeraj.sanjaykale@nxp.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
---
v2: Resolved dt_binding_check errors. (Rob Herring)
v2: Modified description, added specific compatibility devices, corrected
indentations. (Krzysztof Kozlowski)
v3: Modified description, renamed file (Krzysztof Kozlowski)
v4: Resolved dt_binding_check errors, corrected indentation.
(Rob Herring, Krzysztof Kozlowski)
v5: Corrected serial device name in example. (Krzysztof Kozlowski)
---
 .../net/bluetooth/nxp,88w8987-bt.yaml         | 46 +++++++++++++++++++
 MAINTAINERS                                   |  6 +++
 2 files changed, 52 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml

diff --git a/Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml b/Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml
new file mode 100644
index 000000000000..b913ca59b489
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml
@@ -0,0 +1,46 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/bluetooth/nxp,88w8987-bt.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP Bluetooth chips
+
+description:
+  This binding describes UART-attached NXP bluetooth chips.
+  These chips are dual-radio chips supporting WiFi and Bluetooth.
+  The bluetooth works on standard H4 protocol over 4-wire UART.
+  The RTS and CTS lines are used during FW download.
+  To enable power save mode, the host asserts break signal
+  over UART-TX line to put the chip into power save state.
+  De-asserting break wakes-up the BT chip.
+
+maintainers:
+  - Neeraj Sanjay Kale <neeraj.sanjaykale@nxp.com>
+
+properties:
+  compatible:
+    enum:
+      - nxp,88w8987-bt
+      - nxp,88w8997-bt
+
+  fw-init-baudrate:
+    description:
+      Chip baudrate after FW is downloaded and initialized.
+      This property depends on the module vendor's
+      configuration. If this property is not specified,
+      115200 is set as default.
+
+required:
+  - compatible
+
+additionalProperties: false
+
+examples:
+  - |
+    serial {
+        bluetooth {
+            compatible = "nxp,88w8987-bt";
+            fw-init-baudrate = <3000000>;
+        };
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index 32dd41574930..030ec6fe89df 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -22835,6 +22835,12 @@ L:	linux-mm@kvack.org
 S:	Maintained
 F:	mm/zswap.c
 
+NXP BLUETOOTH WIRELESS DRIVERS
+M:	Amitkumar Karwar <amitkumar.karwar@nxp.com>
+M:	Neeraj Kale <neeraj.sanjaykale@nxp.com>
+S:	Maintained
+F:	Documentation/devicetree/bindings/net/bluetooth/nxp,88w8987-bt.yaml
+
 THE REST
 M:	Linus Torvalds <torvalds@linux-foundation.org>
 L:	linux-kernel@vger.kernel.org
-- 
2.34.1