# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) %YAML 1.2 --- $id: http://devicetree.org/schemas/sound/davinci-mcasp-audio.yaml# $schema: http://devicetree.org/meta-schemas/core.yaml# title: McASP Controller for TI SoCs maintainers: - Jayesh Choudhary properties: compatible: enum: - ti,dm646x-mcasp-audio - ti,da830-mcasp-audio - ti,am33xx-mcasp-audio - ti,dra7-mcasp-audio - ti,omap4-mcasp-audio reg: minItems: 1 items: - description: CFG registers - description: data registers reg-names: minItems: 1 items: - const: mpu - const: dat op-mode: $ref: /schemas/types.yaml#/definitions/uint32 description: 0 - I2S or 1 - DIT operation mode enum: - 0 - 1 tdm-slots: $ref: /schemas/types.yaml#/definitions/uint32 description: Number of channels over one serializer. This property specifies the TX playback TDM slot count, along with default RX slot count if tdm-slots-rx is not specified. The property is ignored in DIT mode. minimum: 2 maximum: 32 tdm-slots-rx: $ref: /schemas/types.yaml#/definitions/uint32 description: Number of RX capture channels over one serializer. If specified, allows independent RX TDM slot count separate from TX. Requires ti,async-mode to be enabled for independent TX/RX clock rates. The property is ignored in DIT mode. minimum: 2 maximum: 32 ti,async-mode: description: Specify to allow independent TX & RX clocking, to enable audio playback & record with different sampling rate, and different number of bits per frame. if property is omitted, TX and RX will share same bit clock and frame clock signals, thus RX need to use same bits per frame and sampling rate as TX in synchronous mode. the property is ignored in DIT mode (as DIT is TX-only) type: boolean serial-dir: description: A list of serializer configuration Entry is indication for serializer pin direction 0 - Inactive, 1 - TX, 2 - RX All AXR pins should be present in the array even if inactive $ref: /schemas/types.yaml#/definitions/uint32-array minItems: 1 maxItems: 25 items: minimum: 0 maximum: 2 dmas: minItems: 1 items: - description: transmission DMA channel - description: reception DMA channel dma-names: minItems: 1 items: - const: tx - const: rx ti,hwmods: $ref: /schemas/types.yaml#/definitions/string description: Name of hwmod associated with McASP maxItems: 1 deprecated: true tx-num-evt: $ref: /schemas/types.yaml#/definitions/uint32 description: configures WFIFO threshold 0 disables the FIFO use if property is missing, then also FIFO use is disabled rx-num-evt: $ref: /schemas/types.yaml#/definitions/uint32 description: configures RFIFO threshold 0 disables the FIFO use if property is missing, then also FIFO use is disabled dismod: $ref: /schemas/types.yaml#/definitions/uint32 description: specify the drive on TX pin during inactive time slots 0 - 3-state, 2 - logic low, 3 - logic high enum: - 0 - 2 - 3 default: 2 interrupts: minItems: 1 maxItems: 2 interrupt-names: oneOf: - description: TX interrupt const: tx - description: RX interrupt const: rx - description: TX and RX interrupts items: - const: tx - const: rx - description: Common/combined interrupt const: common fck_parent: $ref: /schemas/types.yaml#/definitions/string description: parent clock name for McASP fck maxItems: 1 auxclk-fs-ratio: $ref: /schemas/types.yaml#/definitions/uint32 description: Ratio of AUCLK and FS rate if applicable. This property specifies the TX ratio, along with default RX ratio if auxclk-fs-ratio-rx is not specified. When not specified, the inputted system clock frequency via set_sysclk callback by the machine driver is used for divider calculation. auxclk-fs-ratio-rx: $ref: /schemas/types.yaml#/definitions/uint32 description: Ratio of AUCLK and FS rate for RX. If specified, allows for a different RX ratio. Requires ti,async-mode to be enabled when the ratio differs from auxclk-fs-ratio. When not specified, it defaults to the value of auxclk-fs-ratio. The property is ignored in DIT mode. gpio-controller: true "#gpio-cells": const: 2 clocks: minItems: 1 items: - description: functional clock - description: module specific optional ahclkx clock - description: module specific optional ahclkr clock clock-names: minItems: 1 items: - const: fck - const: ahclkx - const: ahclkr power-domains: description: phandle to the corresponding power-domain maxItems: 1 "#sound-dai-cells": const: 0 port: description: connection for when McASP is used via graph card type: object required: - compatible - reg - reg-names - dmas - dma-names - interrupts - interrupt-names allOf: - $ref: dai-common.yaml# - if: properties: op-mode: enum: - 0 then: required: - tdm-slots - if: properties: op-mode: const: 1 then: properties: tdm-slots: false tdm-slots-rx: false ti,async-mode: false auxclk-fs-ratio-rx: false - if: required: - tdm-slots-rx then: required: - ti,async-mode - if: required: - auxclk-fs-ratio-rx then: required: - ti,async-mode unevaluatedProperties: false examples: - | mcasp0: mcasp0@1d00000 { compatible = "ti,da830-mcasp-audio"; reg = <0x100000 0x3000>; reg-names = "mpu"; interrupts = <82>, <83>; interrupt-names = "tx", "rx"; op-mode = <0>; /* MCASP_IIS_MODE */ tdm-slots = <2>; ti,async-mode; dmas = <&main_udmap 0xc400>, <&main_udmap 0x4400>; dma-names = "tx", "rx"; serial-dir = < 0 0 0 0 /* 0: INACTIVE, 1: TX, 2: RX */ 0 0 0 0 0 0 0 1 2 0 0 0 >; tx-num-evt = <1>; rx-num-evt = <1>; };