model_tas5805m.cpp

Go to the documentation of this file.

#include "tas58xx.h"
 
#include "esphome/core/hal.h"
 
namespace esphome::tas58xx {
 
// Remainder of the startup sequence from TI PurePath Console, run after the reset. Register 0x00 selects the page.
// Registers 0x46, 0x7D, 0x7E and page 1 register 0x51 are not documented in the datasheet.
static const uint8_t STARTUP_SEQUENCE[][2] PROGMEM = {
    {0x03, 0x00},  // DEVICE_CTRL_2: deep sleep
    {0x46, 0x01},
    {0x03, 0x02},  // DEVICE_CTRL_2: Hi-Z
    // The I2C address is latched at power up, after which the ADR pin can report faults
    {0x61, 0x0B},  // ADR_PIN_CONFIG: FAULTZ
    {0x60, 0x01},  // ADR_PIN_CTRL: output
    {0x7D, 0x11},
    {0x7E, 0xFF},
    {0x00, 0x01},  // Page 1
    {0x51, 0x05},
    {0x00, 0x00},  // Page 0
 
    // Additional register configuration
    {0x53, 0x60},  // ANA_CTRL: for high audio performance use 175kHz bandwidth with Fsw=768kHz
};
 
static const LogString *model_name() { return LOG_STR("TAS5805M"); }
 
// An if chain rather than a switch: a switch table would land in rodata, which is RAM on ESP8266.
static const LogString *fault_name(uint8_t index) {
  if (index == 0)
    return LOG_STR("Right channel over current");
  if (index == 1)
    return LOG_STR("Left channel over current");
  if (index == 2)
    return LOG_STR("Right channel DC fault");
  if (index == 3)
    return LOG_STR("Left channel DC fault");
  if (index == 8)
    return LOG_STR("PVDD under voltage");
  if (index == 9)
    return LOG_STR("PVDD over voltage");
  if (index == 10)
    return LOG_STR("Clock fault");
  if (index == 14)
    return LOG_STR("BQ write failed");
  if (index == 15)
    return LOG_STR("OTP CRC check error");
  if (index == 16)
    return LOG_STR("Over temperature shutdown");
  if (index == 26)
    return LOG_STR("Over temperature warning");
  return LOG_STR("Unknown fault");
}
 
const ModelInfo TAS5805M_MODEL = {
    .name = model_name,
    .startup_sequence = STARTUP_SEQUENCE,
    .startup_sequence_length = sizeof(STARTUP_SEQUENCE) / sizeof(STARTUP_SEQUENCE[0]),
    .mixer_book = 0x8C,
    .mixer_page = 0x29,
    .mixer_register = 0x18,
    // The clock fault is left out of the log and have_fault: it is set whenever the I2S clock stops, which is normal
    .fault_error_mask = 0x0001C30F,
    .fault_warning_mask = 0x04000000,
    // DC and over current faults keep the output off until cleared (datasheet 7.5.3.3.1, 7.5.3.3.2). They are not
    // cleared automatically: a DC fault re-trips only after 570 ms, so a clear on every poll would pass DC to the
    // speaker.
    .fault_output_off_mask = 0x0000000F,
    .fault_latched_mask = 0x0401C70F,
    .fault_name = fault_name,
    .fault_sensor_bits =
        {
            3,       // FAULT_SENSOR_LEFT_CHANNEL_DC_FAULT
            2,       // FAULT_SENSOR_RIGHT_CHANNEL_DC_FAULT
            1,       // FAULT_SENSOR_LEFT_CHANNEL_OVER_CURRENT
            0,       // FAULT_SENSOR_RIGHT_CHANNEL_OVER_CURRENT
            15,      // FAULT_SENSOR_OTP_CRC_CHECK
            14,      // FAULT_SENSOR_BQ_WRITE_FAILED
            10,      // FAULT_SENSOR_CLOCK_FAULT
            9,       // FAULT_SENSOR_PVDD_OVER_VOLTAGE
            8,       // FAULT_SENSOR_PVDD_UNDER_VOLTAGE
            16,      // FAULT_SENSOR_OVER_TEMP_SHUTDOWN
            26,      // FAULT_SENSOR_OVER_TEMP_WARNING
            NO_BIT,  // FAULT_SENSOR_LOAD_EEPROM_ERROR
            NO_BIT,  // FAULT_SENSOR_RIGHT_CHANNEL_CBC_OVER_CURRENT
            NO_BIT,  // FAULT_SENSOR_LEFT_CHANNEL_CBC_OVER_CURRENT
            NO_BIT,  // FAULT_SENSOR_LEFT_CHANNEL_CBC_OVER_CURRENT_WARNING
            NO_BIT,  // FAULT_SENSOR_RIGHT_CHANNEL_CBC_OVER_CURRENT_WARNING
            NO_BIT,  // FAULT_SENSOR_OVER_TEMP_146C_WARNING
        },
};
 
}  // namespace esphome::tas58xx