From: Gianluca Boiano <morf3089@gmail.com>
To: Mark Brown <broonie@kernel.org>,
Liam Girdwood <lgirdwood@gmail.com>,
Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>,
Jaroslav Kysela <perex@perex.cz>, Takashi Iwai <tiwai@suse.com>
Cc: Gianluca Boiano <morf3089@gmail.com>,
Shenghao Ding <shenghao-ding@ti.com>, Kevin Lu <kevin-lu@ti.com>,
Baojun Xu <baojun.xu@ti.com>, "Wang, Sen" <sen@ti.com>,
Markus Elfring <Markus.Elfring@web.de>,
linux-sound@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: [PATCH v4 1/2] ASoC: dt-bindings: add Texas Instruments TAS2557
Date: Fri, 20 Nov 2026 01:43:23 +0100 [thread overview]
Message-ID: <20261120004414.1686884-2-morf3089@gmail.com> (raw)
In-Reply-To: <20261120004414.1686884-1-morf3089@gmail.com>
Document the TAS2557 mono Class-D smart amplifier with an integrated
DSP for speaker protection. The device is controlled over I2C and
receives audio over I2S/TDM (ASI).
One node describes either a single device or, with a two-entry reg, a
stereo pair sharing one bus. The device at each reg index applies one
half of a stereo-tuned firmware image: index 0 is DEV_A and index 1 is
DEV_B. No channel selection property is needed, as for ti,tas2781.yaml.
reg is limited to two entries because the firmware format only defines
mono or DEV_A/DEV_B devices.
reset-gpios and interrupts are per device: the item at array index N
configures the device at the Nth reg entry, and a single entry is
shared by every device in the group. A pair wired to independent RESET
and INT pins uses two entries each.
ti,asi-port selects which of the two audio serial interfaces, ASI1 or
ASI2, is wired to the host.
The DSP boots from a firmware image generated per speaker design with
the TI PurePath Console tuning tools. The optional firmware-name
property selects a board specific image shared by the whole group. The
default names are the mono images, so a pair must set it.
Signed-off-by: Gianluca Boiano <morf3089@gmail.com>
---
Notes:
Changes in v4:
- use the ASoC subject prefix (Mark Brown)
- reset-gpios and interrupts take one entry per reg index, a single
entry is shared by the group (boards with independent RESET/INT
lines per chip)
- add ti,asi-port to name the wired ASI (Mark Brown)
- drop ti,imon-slot-nos and ti,vmon-slot-nos: the chip has no slot
field for I/V sense, SNS_CTRL only holds the I-sense scale, which
the firmware programs
- require firmware-name for two chips, the default names are mono
images
- move the review history out of the commit message (Krzysztof
Kozlowski); Reviewed-by not carried over because of the property
changes
Changes in v3:
- single-node reg-array model (up to two devices), matching
ti,tas2781.yaml; drop ti,channel, derive DEV_A/DEV_B from reg order
- rename ti,imon-slot-no/ti,vmon-slot-no to the plural
ti,imon-slot-nos/ti,vmon-slot-nos arrays; firmware-name maxItems: 1
Changes in v2:
- add the four mandatory supplies to "required" (Wang Sen)
.../devicetree/bindings/sound/ti,tas2557.yaml | 158 ++++++++++++++++++
MAINTAINERS | 1 +
2 files changed, 159 insertions(+)
create mode 100644 Documentation/devicetree/bindings/sound/ti,tas2557.yaml
diff --git a/Documentation/devicetree/bindings/sound/ti,tas2557.yaml b/Documentation/devicetree/bindings/sound/ti,tas2557.yaml
new file mode 100644
index 000000000..4a7f90659
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/ti,tas2557.yaml
@@ -0,0 +1,158 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+# Copyright (C) 2026 Gianluca Boiano <morf3089@gmail.com>
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/ti,tas2557.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments TAS2557 Mono Smart Amplifier
+
+maintainers:
+ - Gianluca Boiano <morf3089@gmail.com>
+
+description: |
+ The TAS2557 is a mono, digital-input Class-D amplifier with an
+ integrated DSP for speaker protection, controlled over I2C, with
+ audio over I2S/TDM (ASI). The DSP runs a firmware image generated for
+ the speaker with the TI PurePath Console tuning tools.
+
+ One node describes one device or a pair sharing one ASI bus, using
+ the reg-array convention of ti,tas2781.yaml. The device at reg index 0
+ is DEV_A and the one at index 1 is DEV_B; they select the two halves
+ of a stereo-tuned firmware image. The firmware format defines no
+ other device types, so a node has at most two devices.
+
+ Datasheet: https://www.ti.com/lit/gpn/tas2557
+
+allOf:
+ - $ref: dai-common.yaml#
+
+properties:
+ compatible:
+ const: ti,tas2557
+
+ reg:
+ minItems: 1
+ maxItems: 2
+ description:
+ I2C address of each physical device sharing this node. One
+ entry configures a single mono TAS2557. Two entries configure a
+ device pair; the device at index 0 is DEV_A and the device at
+ index 1 is DEV_B.
+
+ '#sound-dai-cells':
+ const: 0
+
+ reset-gpios:
+ minItems: 1
+ maxItems: 2
+ description:
+ GPIO connected to the active-low RESET pin of each physical
+ device sharing this node, one entry per reg entry. A single
+ entry is shared by every device in the group.
+
+ interrupts:
+ minItems: 1
+ maxItems: 2
+ description:
+ Fault interrupt output (INT) of each physical device sharing
+ this node, one entry per reg entry. A single entry is shared
+ by every device in the group.
+
+ vbat-supply:
+ description: Battery/boost input supply (VBAT), 2.9 V to 5.5 V.
+
+ iovdd-supply:
+ description: Digital I/O supply, 1.62 V to 3.6 V.
+
+ avdd-supply:
+ description: Analog supply, 1.65 V to 1.95 V.
+
+ dvdd-supply:
+ description: Digital core supply, 1.65 V to 1.95 V.
+
+ firmware-name:
+ maxItems: 1
+ description:
+ Name of the DSP firmware image to load. Defaults to a name
+ derived from the silicon revision, which is the mono image, so a
+ device pair must set this property. A device pair shares one
+ image; each device's half of it is selected by its reg index,
+ not by this property.
+
+ ti,asi-port:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [1, 2]
+ default: 2
+ description:
+ Which audio serial interface (ASI1 or ASI2) of the chip is
+ wired to the host. Only the selected interface is configured.
+
+required:
+ - compatible
+ - reg
+ - '#sound-dai-cells'
+ - vbat-supply
+ - iovdd-supply
+ - avdd-supply
+ - dvdd-supply
+
+if:
+ properties:
+ reg:
+ minItems: 2
+then:
+ required:
+ - firmware-name
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/gpio/gpio.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ i2c {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ audio-codec@4c {
+ compatible = "ti,tas2557";
+ reg = <0x4c>;
+ #sound-dai-cells = <0>;
+ reset-gpios = <&tlmm 77 GPIO_ACTIVE_LOW>;
+ interrupt-parent = <&tlmm>;
+ interrupts = <73 IRQ_TYPE_LEVEL_HIGH>;
+
+ vbat-supply = <&vph_pwr>;
+ iovdd-supply = <&vreg_l6b_1p8>;
+ avdd-supply = <&vreg_l6b_1p8>;
+ dvdd-supply = <&vreg_l6b_1p8>;
+ };
+ };
+ - |
+ #include <dt-bindings/gpio/gpio.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ i2c {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ audio-codec@4c {
+ compatible = "ti,tas2557";
+ reg = <0x4c>, <0x4e>;
+ #sound-dai-cells = <0>;
+ reset-gpios = <&tlmm 77 GPIO_ACTIVE_LOW>,
+ <&tlmm 78 GPIO_ACTIVE_LOW>;
+ interrupt-parent = <&tlmm>;
+ interrupts = <73 IRQ_TYPE_LEVEL_HIGH>, <74 IRQ_TYPE_LEVEL_HIGH>;
+
+ vbat-supply = <&vph_pwr>;
+ iovdd-supply = <&vreg_l6b_1p8>;
+ avdd-supply = <&vreg_l6b_1p8>;
+ dvdd-supply = <&vreg_l6b_1p8>;
+
+ firmware-name = "tas2557-stereo.bin";
+ };
+ };
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index d37ed235d..8e024bcfb 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -27724,6 +27724,7 @@ M: Sen Wang <sen@ti.com>
L: linux-sound@vger.kernel.org
S: Maintained
F: Documentation/devicetree/bindings/sound/ti,tas2552.yaml
+F: Documentation/devicetree/bindings/sound/ti,tas2557.yaml
F: Documentation/devicetree/bindings/sound/ti,tas2562.yaml
F: Documentation/devicetree/bindings/sound/ti,tas2770.yaml
F: Documentation/devicetree/bindings/sound/ti,tas27xx.yaml
--
2.56.1
next prev parent reply other threads:[~2026-11-20 0:44 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-20 0:43 [PATCH v4 0/2] ASoC: codecs: add Texas Instruments TAS2557 smart amplifier driver Gianluca Boiano
2026-11-20 0:43 ` Gianluca Boiano [this message]
2026-11-20 0:43 ` [PATCH v4 2/2] ASoC: codecs: add TAS2557 mono " Gianluca Boiano
2026-11-20 1:02 ` sashiko-bot
2026-11-20 15:14 ` [PATCH v4 0/2] ASoC: codecs: add Texas Instruments TAS2557 " David Heidelberg
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261120004414.1686884-2-morf3089@gmail.com \
--to=morf3089@gmail.com \
--cc=Markus.Elfring@web.de \
--cc=baojun.xu@ti.com \
--cc=broonie@kernel.org \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=kevin-lu@ti.com \
--cc=krzk+dt@kernel.org \
--cc=lgirdwood@gmail.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-sound@vger.kernel.org \
--cc=perex@perex.cz \
--cc=robh@kernel.org \
--cc=sen@ti.com \
--cc=shenghao-ding@ti.com \
--cc=tiwai@suse.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.