[PATCH v4 1/2] ASoC: dt-bindings: add Texas Instruments TAS2557

From: Gianluca Boiano

Date: Thu Nov 19 2026 - 19:44:34 EST


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@xxxxxxxxx>
---

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@xxxxxxxxx>
+%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@xxxxxxxxx>
+
+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@xxxxxx>
L: linux-sound@xxxxxxxxxxxxxxx
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