[PATCH v1 dt-bindings]dt-bindings: debix-model-a: Add bindings for BT and audio

WangErQian WangErQianY at icloud.com
Mon Jul 28 20:13:52 PDT 2025


Add bindings for Debix Model A Bluetooth and audio

This patch adds device tree binding documentation for:
- fsl,mxc_bt_rfkill.yaml: Bluetooth RF control node
- fsl,imx-audio-es8316.yaml: Audio codec interface

Signed-off-by: WangErQian <WangErQianY at icloud.com>
---
 .../bindings/bluetooth/fsl,mxc_bt_rfkill.yaml | 70 +++++++++++++++
 .../bindings/sound/fsl,imx-audio-es8316.yaml  | 88 +++++++++++++++++++
 2 files changed, 158 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/bluetooth/fsl,mxc_bt_rfkill.yaml
 create mode 100644 Documentation/devicetree/bindings/sound/fsl,imx-audio-es8316.yaml

diff --git a/Documentation/devicetree/bindings/bluetooth/fsl,mxc_bt_rfkill.yaml b/Documentation/devicetree/bindings/bluetooth/fsl,mxc_bt_rfkill.yaml
new file mode 100644
index 000000000000..b173de7a4102
--- /dev/null
+++ b/Documentation/devicetree/bindings/bluetooth/fsl,mxc_bt_rfkill.yaml
@@ -0,0 +1,70 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+$id: http://devicetree.org/schemas/bluetooth/fsl,mxc_bt_rfkill.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP i.MX Bluetooth RFKill Controller
+
+maintainers:
+  - WangErQian <wangerqiany at icloud.com>
+
+description: |
+  Binding for NXP i.MX Bluetooth RFKill controller, managing power and wake signals via GPIOs.
+
+properties:
+  compatible:
+    const: fsl,mxc_bt_rfkill
+
+  pinctrl-names:
+    maxItems: 1
+    items:
+      - const: default
+
+  pinctrl-0:
+    type: phandle
+    description: Phandle to default pin control configuration
+
+  bt-power-gpios:
+    description: GPIO controlling Bluetooth power (active low)
+    maxItems: 1
+
+  wake-bt-gpios:
+    description: GPIO for waking Bluetooth device (active low)
+    maxItems: 1
+
+  wake-host-gpios:
+    description: GPIO for host wake-up signal (active low)
+    maxItems: 1
+
+  status:
+    type: string
+    enum: [ "okay", "disabled" ]
+    default: "okay"
+
+required:
+  - compatible
+  - bt-power-gpios
+  - wake-bt-gpios
+  - wake-host-gpios
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+    pinctrl_bt_ctrl: bt_ctrl_grp {
+        fsl,pins = <
+            MX6UL_PAD_GPIO1_IO06__GPIO1_IO06 0x13059 /* BT_POWER */
+            MX6UL_PAD_GPIO1_IO07__GPIO1_IO07 0x13059 /* WAKE_BT */
+            MX6UL_PAD_GPIO1_IO08__GPIO1_IO08 0x13059 /* WAKE_HOST */
+        >;
+    };
+
+    bt_rfkill {
+        compatible = "fsl,mxc_bt_rfkill";
+        pinctrl-names = "default";
+        pinctrl-0 = <&pinctrl_bt_ctrl>;
+        bt-power-gpios = <&gpio1 6 GPIO_ACTIVE_LOW>;
+        wake-bt-gpios  = <&gpio1 7 GPIO_ACTIVE_LOW>;
+        wake-host-gpios = <&gpio1 8 GPIO_ACTIVE_LOW>;
+        status = "okay";
+    };
diff --git a/Documentation/devicetree/bindings/sound/fsl,imx-audio-es8316.yaml b/Documentation/devicetree/bindings/sound/fsl,imx-audio-es8316.yaml
new file mode 100644
index 000000000000..35f13d656caf
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/fsl,imx-audio-es8316.yaml
@@ -0,0 +1,88 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+$id: http://devicetree.org/schemas/sound/fsl,imx-audio-es8316.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP i.MX Audio Interface with ES8316 Codec
+
+maintainers:
+  - WangErQian <wangerqiany at icloud.com>
+
+description: |
+  Binding for NXP i.MX platforms using the Everest ES8316 audio codec.
+  Defines the connections between CPU DAI (SAI), codec, and audio routing.
+
+properties:
+  compatible:
+    const: fsl,imx-audio-es8316
+
+  model:
+    type: string
+    description: Descriptive name of the audio setup (e.g., board-specific)
+    default: "imx-audio-es8316"
+
+  audio-cpu:
+    type: phandle
+    description: Phandle to the CPU audio interface (e.g., SAI node)
+    maxItems: 1
+
+  audio-codec:
+    type: phandle
+    description: Phandle to the audio codec (ES8316 node)
+    maxItems: 1
+
+  format:
+    type: string
+    description: Audio data format (e.g., i2s, left-justified)
+    enum: ["i2s", "right-justified", "left-justified", "dsp-a", "dsp-b"]
+    default: "i2s"
+
+  hp-det-gpio:
+    type: phandle-array
+    description: GPIO for headphone detection (active high)
+    maxItems: 1
+    items:
+      - description: GPIO specifier (controller + pin + flags)
+
+  audio-routing:
+    type: string-array
+    description: Connection mapping between codec pins and audio components
+    items:
+      minItems: 2
+      maxItems: 2
+      items:
+        - description: Source endpoint (e.g., "Mic Jack")
+        - description: Sink endpoint (e.g., "MIC2")
+
+required:
+  - compatible
+  - audio-cpu
+  - audio-codec
+  - audio-routing
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+    sai3: sai at 40031000 {
+        compatible = "fsl,imx8mp-sai";
+        reg = <0x40031000 0x1000>;
+    };
+
+    codec: es8316 at 11 {
+        compatible = "everest,es8316";
+        reg = <0x11>;
+    };
+
+    sound {
+        compatible = "fsl,imx-audio-es8316";
+        model = "imx-audio-es8316";
+        audio-cpu = <&sai3>;
+        audio-codec = <&codec>;
+        format = "i2s";
+        hp-det-gpio = <&gpio4 29 GPIO_ACTIVE_HIGH>;
+        audio-routing =
+            "Mic Jack", "MIC2",
+            "Headphone Jack", "HPOL",
+            "Headphone Jack", "HPOR";
+    };
-- 
2.25.1




More information about the linux-arm-kernel mailing list