[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