Skip to contentSkip to conversation

dt-bindings: sound: ep93xx: Add I2S description

PATCH In review Alexander Sverdlin 3 participants 4 messages Apr 11, 2023 – Apr 12, 2023

Subsystems (4)
lore
Share & tools
lore

Alexander Sverdlin

author maintainer
#0 lore raw

PATCH v3 1/2 dt-bindings: sound: ep93xx: Add I2S description

Add device tree bindings for Cirrus Logic EP93xx internal SoCs' I2S controller.

---
Changelog:
v3:
- rebased onto
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next
v2:
- Incorporated most of the suggestions from Krzysztof Kozlowski [1]
- Dropped AC97 (deleted from the tree)

[1]. https://lore.kernel.org/lkml/[email protected]/

 .../bindings/sound/cirrus,ep9301-i2s.yaml     | 66 +++++++++++++++++++
 MAINTAINERS                                   |  1 +
 2 files changed, 67 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/sound/cirrus,ep9301-i2s.yaml
Documentation/devicetree/bindings/sound/cirrus,ep9301-i2s.yaml new file +66 -0
new file mode 100644
index 000000000000..453d493c941f
@@ -0,0 +1,66 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/cirrus,ep9301-i2s.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Cirrus EP93xx I2S Controller
+
+description: |
+  The I2S controller is used to stream serial audio data between the external
+  I2S CODECs’, ADCs/DACs, and the ARM Core. The controller supports I2S, Left-
+  and Right-Justified DSP formats.
+
+maintainers:
+  - Alexander Sverdlin <[email protected]>
+
+allOf:
+  - $ref: dai-common.yaml#
+
+properties:
+  compatible:
+    const: cirrus,ep9301-i2s
+
+  '#sound-dai-cells':
+    const: 0
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  clocks:
+    minItems: 3
+    maxItems: 3
+
+  clock-names:
+    items:
+      - const: mclk
+      - const: sclk
+      - const: lrclk
+
+required:
+  - compatible
+  - '#sound-dai-cells'
+  - reg
+  - clocks
+  - clock-names
+
+additionalProperties: false
+
+examples:
+  - |
+    i2s: i2s@80820000 {
+        compatible = "cirrus,ep9301-i2s";
+        #sound-dai-cells = <0>;
+        reg = <0x80820000 0x100>;
+        interrupt-parent = <&vic1>;
+        interrupts = <28>;
+        clocks = <&syscon 29>,
+                 <&syscon 30>,
+                 <&syscon 31>;
+        clock-names = "mclk", "sclk", "lrclk";
+    };
+
+...
MAINTAINERS +1 -0
index e52938f962b5..b39ec6dbcdc9 100644
@@ -2072,6 +2072,7 @@ M:	Alexander Sverdlin <[email protected]>
 L:	[email protected] (moderated for non-subscribers)
 S:	Maintained
 F:	Documentation/devicetree/bindings/iio/adc/cirrus,ep9301-adc.yaml
+F:	Documentation/devicetree/bindings/sound/cirrus,ep9301-*
 F:	arch/arm/boot/compressed/misc-ep93xx.h
 F:	arch/arm/mach-ep93xx/
 F:	drivers/iio/adc/ep93xx_adc.c
Signature · 1 line
2.40.0
author maintainer
#1 lore raw

PATCH v3 2/2 ASoC: ep93xx: Add OF support

Add the new cirrus,ep9301-ac97 and cirrus,ep9301-i2s compatibles.

---
Changelog:
v3:
- rebased onto
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next
v2:
- Dropped AC97 (deleted from the tree)

 sound/soc/cirrus/ep93xx-i2s.c | 8 ++++++++
 1 file changed, 8 insertions(+)
sound/soc/cirrus/ep93xx-i2s.c +8 -0
index 2abd1bce2290..afc6b5b570ea 100644
@@ -15,6 +15,7 @@
 #include <linux/slab.h>
 #include <linux/clk.h>
 #include <linux/io.h>
+#include <linux/of.h>
 
 #include <sound/core.h>
 #include <sound/dmaengine_pcm.h>
@@ -514,11 +515,18 @@ static void ep93xx_i2s_remove(struct platform_device *pdev)
 	clk_put(info->mclk);
 }
 
+static const struct of_device_id ep93xx_i2s_of_ids[] = {
+	{ .compatible = "cirrus,ep9301-i2s" },
+	{}
+};
+MODULE_DEVICE_TABLE(of, ep93xx_i2s_of_ids);
+
 static struct platform_driver ep93xx_i2s_driver = {
 	.probe	= ep93xx_i2s_probe,
 	.remove_new = ep93xx_i2s_remove,
 	.driver	= {
 		.name	= "ep93xx-i2s",
+		.of_match_table = ep93xx_i2s_of_ids,
 	},
 };
 
Signature · 1 line
2.40.0
Reviewed-by on v3 1/2
#2 lore raw
In reply to Alexander Sverdlin
Quoted 4 lines · Alexander Sverdlin

Add device tree bindings for Cirrus Logic EP93xx internal SoCs' I2S controller.

Quoted 9 lines

---
Changelog:
v3:
- rebased onto
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next
v2:
- Incorporated most of the suggestions from Krzysztof Kozlowski [1]
- Dropped AC97 (deleted from the tree)

This is a friendly reminder during the review process.

It looks like you received a tag and forgot to add it.

If you do not know the process, here is a short explanation:
Please add Acked-by/Reviewed-by/Tested-by tags when posting new versions. However, there's no need to repost patches *only* to add the tags. The upstream maintainer will do that for acks received on the version they apply.

https://elixir.bootlin.com/linux/v5.17/source/Documentation/process/submitting-patches.rst#L540

If a tag was not added on purpose, please state why and what changed.

Best regards,
Krzysztof

maintainer
#3 lore raw
In reply to Alexander Sverdlin
Quoted 4 lines · Alexander Sverdlin

Add device tree bindings for Cirrus Logic EP93xx internal SoCs' I2S controller.

Applied to

https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next

Thanks!

[1/2] dt-bindings: sound: ep93xx: Add I2S description

      commit: 13b1b95245a7c2dc959b06ed7f02f4832e401cd2
[2/2] ASoC: ep93xx: Add OF support
      commit: b599a4d7d905a8e8cf5c36ccae0b3dd97c956075

All being well this means that it will be integrated into the linux-next tree (usually sometime in the next 24 hours) and sent to Linus during the next merge window (or sooner if it is a bug fix), however if problems are discovered then the patch may be dropped or reverted.

You may get further e-mails resulting from automated or manual testing and review of the tree, please engage with people reporting problems and send followup patches addressing any issues that are reported if needed.

If any updates are required or you are submitting further changes they should be sent as incremental updates against current git, existing patches will not be replaced.

Please add any relevant lists and maintainers to the CCs when replying to this mail.

Thanks,
Mark