Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

ASoC: cs4234: Add dtschema binding document

Document the bindings for the CS4234 ASoC codec driver.

Signed-off-by: Charles Keepax <ckeepax@opensource.cirrus.com>
Link: https://lore.kernel.org/r/20200928111821.26967-1-rf@opensource.cirrus.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Charles Keepax and committed by
Mark Brown
5ebba5e7 9fe0ec27

+74
+74
Documentation/devicetree/bindings/sound/cirrus,cs4234.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/sound/cirrus,cs4234.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Cirrus Logic cs4234 audio CODEC 8 + 9 + maintainers: 10 + - patches@opensource.cirrus.com 11 + 12 + description: 13 + The CS4234 is a highly versatile CODEC that combines 4 channels of 14 + high performance analog to digital conversion, 4 channels of high 15 + performance digital to analog conversion for audio, and 1 channel of 16 + digital to analog conversion to provide a nondelayed audio reference 17 + signal to an external Class H tracking power supply. If not used to 18 + drive a tracking power supply, the 5th DAC can instead be used as a 19 + standard audio grade DAC, with performance specifications identical 20 + to that of the 4 DACs in the audio path. Additionally, the CS4234 21 + includes tunable group delay for each of the 4 audio DAC paths to 22 + provide lead time for the external switch-mode power supply, and a 23 + nondelayed path into the DAC outputs for input signals requiring a 24 + low-latency path to the outputs. 25 + 26 + properties: 27 + compatible: 28 + enum: 29 + - cirrus,cs4234 30 + 31 + reg: 32 + description: 33 + The 7-bit I2C address depends on the state of the ADx pins, in 34 + binary given by [0 0 1 0 AD2 AD1 AD0 0]. 35 + items: 36 + minimum: 0x10 37 + maximum: 0x17 38 + 39 + VA-supply: 40 + description: 41 + Analogue power supply. 42 + 43 + VL-supply: 44 + description: 45 + Interface power supply. 46 + 47 + reset-gpios: 48 + maxItems: 1 49 + 50 + required: 51 + - compatible 52 + - reg 53 + - VA-supply 54 + - VL-supply 55 + 56 + additionalProperties: false 57 + 58 + examples: 59 + - | 60 + i2c@e0004000 { 61 + #address-cells = <1>; 62 + #size-cells = <0>; 63 + reg = <0xe0004000 0x1000>; 64 + 65 + cs4234: codec@11 { 66 + compatible = "cirrus,cs4234"; 67 + reg = <0x11>; 68 + 69 + VA-supply = <&vdd3v3>; 70 + VL-supply = <&vdd3v3>; 71 + 72 + reset-gpios = <&gpio 0>; 73 + }; 74 + };