ASoC: dt-bindings: cirrus,cs4271: Convert to dtschema
Subsystems (4)
PATCH v3 1/1 ASoC: dt-bindings: cirrus,cs4271: Convert to dtschema
Convert the Cirrus Logic CS4271 audio CODEC bindings to DT schema.
Add missing spi-cpha, spi-cpol, '#sound-dai-cells' and port, as they are already being used in the DTS and the driver for this device.
Switch to 'reset-gpios' and drop legacy 'reset-gpio' used in original bindings.
Based on Animesh Agarwal cs42xx8 conversion patch.
---
This is complementary patch to ep93xx DT conversion series.
Based on "ASoC: dt-bindings: cirrus,cs4270: Convert to dtschema" patch.
Krzysztof, thank you once again for your patience.
---
Changes in v3:
- Switch to 'reset-gpios'
- Use 'codec' for node name
- Link to v2: https://lore.kernel.org/r/[email protected]
Changes in v2:
Krzysztof Kozlowski:
- fix SoB above link
- replace 'driver' with 'device'
- mention properties not present in original bindings
- mention using 'gpio-reset' instead of 'gpios-reset'
- dropped unused label
- use defines for gpio bindings
- newline at end of file
- Link to v1: https://lore.kernel.org/r/[email protected]
--- .../devicetree/bindings/sound/cirrus,cs4271.yaml | 101 +++++++++++++++++++++ Documentation/devicetree/bindings/sound/cs4271.txt | 57 ------------ 2 files changed, 101 insertions(+), 57 deletions(-)
Documentation/devicetree/bindings/sound/cirrus,cs4271.yaml new file +101 -0
@@ -0,0 +1,101 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/cirrus,cs4271.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Cirrus Logic CS4271 audio CODEC + +maintainers: + - Alexander Sverdlin <[email protected]> + - Nikita Shubin <[email protected]> + +description: + The CS4271 is a stereo audio codec. This device supports both the I2C + and the SPI bus. + +allOf: + - $ref: dai-common.yaml# + - $ref: /schemas/spi/spi-peripheral-props.yaml# + +properties: + compatible: + const: cirrus,cs4271 + + reg: + maxItems: 1 + + spi-cpha: true + + spi-cpol: true + + '#sound-dai-cells': + const: 0 + + reset-gpios: + description: + This pin will be deasserted before communication to the codec starts. + maxItems: 1 + + va-supply: + description: Analog power supply. + + vd-supply: + description: Digital power supply. + + vl-supply: + description: Serial Control Port power supply. + + port: + $ref: audio-graph-port.yaml# + unevaluatedProperties: false + + cirrus,amuteb-eq-bmutec: + description: + When given, the Codec's AMUTEB=BMUTEC flag is enabled. + type: boolean + + cirrus,enable-soft-reset: + description: | + The CS4271 requires its LRCLK and MCLK to be stable before its RESET + line is de-asserted. That also means that clocks cannot be changed + without putting the chip back into hardware reset, which also requires + a complete re-initialization of all registers. + + One (undocumented) workaround is to assert and de-assert the PDN bit + in the MODE2 register. This workaround can be enabled with this DT + property. + + Note that this is not needed in case the clocks are stable + throughout the entire runtime of the codec. + type: boolean + +required: + - compatible + - reg + +unevaluatedProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + spi { + #address-cells = <1>; + #size-cells = <0>; + codec@0 { + compatible = "cirrus,cs4271"; + reg = <0>; + #sound-dai-cells = <0>; + spi-max-frequency = <6000000>; + spi-cpol; + spi-cpha; + reset-gpios = <&gpio0 1 GPIO_ACTIVE_LOW>; + port { + endpoint { + remote-endpoint = <&i2s_ep>; + }; + }; + }; + }; + +...
Documentation/devicetree/bindings/sound/cs4271.txt deleted +0 -57
57 lines not on this page · raw message
---
base-commit: 5be63fc19fcaa4c236b307420483578a56986a37
change-id: 20240826-cs4271-yaml-e3890230dbbf
Best regards,
Signature · 1 line
Nikita Shubin <[email protected]>
Quoted 15 lines · On 29/08/2024 09:52, Nikita Shubin via B4 Relay wrote:
From: Nikita Shubin <[email protected]>
Convert the Cirrus Logic CS4271 audio CODEC bindings to DT schema.
Add missing spi-cpha, spi-cpol, '#sound-dai-cells' and port, as they are already being used in the DTS and the driver for this device.
Switch to 'reset-gpios' and drop legacy 'reset-gpio' used in original bindings.
Based on Animesh Agarwal cs42xx8 conversion patch.
Cc Alexander Sverdlin <[email protected]>Signed-off-by Nikita Shubin <[email protected]>
Quoted 6 lines
---
This is complementary patch to ep93xx DT conversion series.Based on "ASoC: dt-bindings: cirrus,cs4270: Convert to dtschema" patch.
Krzysztof, thank you once again for your patience.
Thanks for the conversion, looks good.
Best regards,
Krzysztof
Mark Brown
maintainerQuoted 9 lines · Nikita Shubin
Convert the Cirrus Logic CS4271 audio CODEC bindings to DT schema.
Add missing spi-cpha, spi-cpol, '#sound-dai-cells' and port, as they are already being used in the DTS and the driver for this device.
Switch to 'reset-gpios' and drop legacy 'reset-gpio' used in original bindings.
[...]
Applied to
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next
Thanks!
[1/1] ASoC: dt-bindings: cirrus,cs4271: Convert to dtschema
commit: 7817eb1ad353d732bac546b39316f2422c76fff4
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