TAS2781: How to generate the two .bin files that the linux software driver needs

Hi James, 

There are two bin files, one for the DSP coefficients as you identified, this comes from PPC3. the second one is the register bin file. the reg bin file has a separate tool used to generate it

RegBin tool -> Non_Integrated_Bin_Tool_v1.4.1 « toolset « regbin - tas2781-linux-drivers/tas2781-linux-driver - Unnamed repository; edit this file 'description' to name the repository.

Users Guide -> Regbin file User Guidance

thanks, 

Arthur

Arthur, the Regbin User Guide is very confusing. What is the file that PPC3 generates that is needed as input to the Regbin utility in order produce the reg bin file?

Hi James, 

you do not need any files from PPC3 for the regbin tool. we have a few example .json files provided with the regbin tool and these can be used directly or modified to your needs. 

after lauching the nw.exe 'regbin' tool. click the three lines on the top left and select "open"

navigate to the tas2781-linux-driver/regbin/jsn directory, and select either the 1,2, or 4 amp .json file based on your system, then press next

from here you can modify or create new profiles - perhaps you will only need one. each profile contains blocks. per device there is one block for "POWER_UP" and "SHUTDOWN" you should only really need to modify the "POWER_UP" block. add any register commands here which are specific to your system. this block should contain any settings which where changed from the PPC3 "Device Control" panel

once completed you can name and generate the bin file (this is your reg.bin file) this file will contain all profiles. 

Regards,
Arthur

Hi Arthur,

I think I've made some progress in understanding the process. Some questions that I can't find answers to:

1. What exactly does Pre Powerup and Preshutdown mean in actual usage?
2. I assume all the profiles and blocks that are present in the reg bin tool will be present in the resultant bin file. How many are necessary and how does the driver select which to use? What would the simplest bare bones arrangement consist of?
3. What does LPA and MPA mean?
4. It looks like there's an option to import the .cfg filter coeffs into the .bin file. What are the advantages and disadvantages relative to leaving it as a separate .cfg file which is put into the directory OS directory structure?

Sorry for all the (probably basic) questions. Your help is appreciated.

James

Hi James,

James May said:

What exactly does Pre Powerup and Preshutdown mean in actual usage?

when the device is being enabled. the driver will load the DSP coefficients from the DSP bin files exported from PPC3, and then it will load the Pre Powerup from the reg bin file. when the driver attempts to disable the device it will execute the Pre Shutdown. this shutdown block is very simple and typically will only have one write to place the device in software shutdown mode. 

James May said:

I assume all the profiles and blocks that are present in the reg bin tool will be present in the resultant bin file. How many are necessary and how does the driver select which to use? What would the simplest bare bones arrangement consist of?

yes they will all be in the reg bin file. only one profile, with a power up and shutdown block is needed. for more complex end systems you can create different profiles

James May said:

What does LPA and MPA mean?

LPA(low power audio) MPA (mid power audio) are the two separate TI product likes for audio amps. TAS2781 is a LPA  part. actually all TAS2xxx parts will be "LPA" and all TAS3xxx,4xxx,5xxx will be MPA devices

James May said:

It looks like there's an option to import the .cfg filter coeffs into the .bin file. What are the advantages and disadvantages relative to leaving it as a separate .cfg file which is put into the directory OS directory structure?

Its recommended to use the two separate files. Reg.bin from this tool, and DSP.bin from PPC3. I'm actually not so sure about this feature can you share a screenshot and i will check it?

Regards,
Arthur

Arthur,

Thanks, those answer are very helpful. On your advice, I'm going to skip the idea of importing the filter coeffs .cfg into the json then the resultant reg bin file. This is mentioned but I think it only applies to MPA situations.

I'll be testing next week. One thing to mention is that it is pretty tedious to import all the register values from PPC into this reg bin program manually. Is there some automated way?

Hi James,

no, unfortunately there is no automated way to import the writes. they will need to be done line-by-line manually. 

you should not need a huge amount of writes here. only items which you are changing from the default settings. such as TDM settings and device gains. 

Regards,
Arthur

Hi Arthur,

I think I'm able to configure the registers as desired with the regbin tool, but haven't got it to work yet. I've so far combined it with a coeffs bin file from PPC, and put them both in the same folder. I'm seeing this error and wonder if you can decipher it: The two files are called Micro Pi Registers.bin and Micro Pi Coeffs.bin.

    6.009924] tas2781-codec 1-0038: fw_parse_variable_header_kernel: ndev(1) in dspbin mismatch ndev(2) in DTS

[    6.009953] tas2781-codec 1-0038: dspfw load tas2781_coef.bin error

thanks,

James

Hi James, 

Let me loop our driver team to check on this one. 

Regards,

Arthur

Arthur,

I've made some progress in that my regbin works with the reference coeffs bin, and does not give the error message above. But, the right channel appears to have little bass. This is also true using the reference regbin. This brings me to the heart of this question: how do two chips get linked as stereo to the driver? Are there settings in the PPC generated bin that inform the driver, and if so how do I configure that? I've been looking through the console and can't seem to find that anywhere. Or if there is some other mechanism, please explain.

Thanks,

James

Hi Shenghao,

We're using linux kernel v 6.6 according to my colleague. Can you please clarify which document you are referring to with P40-41?

James

Hi Shenghao,

Could TI provide a coeffs .bin for passthrough operation, no filtering, that is suitable for two amp chips being used in tandem as a stereo pair? This is the point that we are stuck.

James

I am still not understanding what to do. I have a reg bin that sets the chip into the class H power mode. I'd like a coeffs bin that is pass thru with no DSP that will work for two chips configured as a stereo pair. Which file should I use?

Thanks, that is helpful information.

Some of the commands in the bypass example you cite are in conflict with the commands I've issued to set up the Class H operation. And in general, some of the commands in the example configs use registers that don't appear to be documented in the data sheet. For example, how to set bypass of DSP.

So for the sake of simplicity could you do one of these two things please?

1. document exactly which commands are needed to bypass the DSP

2. take my attached json file (renamed to .png to allow upload) and add the commands that are needed to bypass the DSP to the existing profile. I don't want a separate bypass profile, since I want to use the configuration parameters I've set up for class H power supply, etc.

here's the json code, the previous attachment didn't work.

{
    "version": "1.4.1",
    "settings": {
        "configurationList": [
            {
                "blocksList": [
                    {
                        "blockName": "PRE_POWER_UP - Dev 1",
                        "commands": [
                            {
                                "book": "0",
                                "page": "0",
                                "register": "00",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "sets page 0",
                                "$$hashKey": "19L"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "02",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "BOP diabled, V and I sense enabled, active mode without mute",
                                "$$hashKey": "19F"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "03",
                                "mask": "ff",
                                "data": "28",
                                "delay": "",
                                "comments": "Y bridge, PRW_MODE1. This is default as it turns out.",
                                "$$hashKey": "15V"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "4",
                                "mask": "ff",
                                "data": "21",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "15S"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "A",
                                "mask": "ff",
                                "data": "0A",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "15D"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "B",
                                "mask": "ff",
                                "data": "28",
                                "delay": "",
                                "comments": "default? missing from data sheet",
                                "$$hashKey": "15A"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "C",
                                "mask": "ff",
                                "data": "10",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "157"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "D",
                                "mask": "ff",
                                "data": "03",
                                "delay": "",
                                "comments": "TDM TX SDOUT unused bit field fill 0 not high z",
                                "$$hashKey": "154"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "E",
                                "mask": "ff",
                                "data": "42",
                                "delay": "",
                                "comments": "class H = 8 bits, V sense enabled time slot 2",
                                "$$hashKey": "151"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "0F",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "I sense enabled, time slot 0",
                                "$$hashKey": "2XF"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "10",
                                "mask": "ff",
                                "data": "C4",
                                "delay": "",
                                "comments": "16 bit V/I data left justified",
                                "$$hashKey": "14Y"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "14",
                                "mask": "ff",
                                "data": "0A",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "162"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "16",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "TDM audio slot lenght = 16bits, enabled.",
                                "$$hashKey": "165"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "19",
                                "mask": "ff",
                                "data": "8D",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "16B"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "1D",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "device paired with Device 1. Not sure what this means.",
                                "$$hashKey": "16K"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "21",
                                "mask": "ff",
                                "data": "14",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "16Q"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "35",
                                "mask": "ff",
                                "data": "B9",
                                "delay": "",
                                "comments": "noise gate disabled",
                                "$$hashKey": "16W"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "38",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "weak pulldowns for SDIN, SDOUT, Clocks disabled",
                                "$$hashKey": "19X"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "58",
                                "mask": "ff",
                                "data": "07",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "17K"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "60",
                                "mask": "ff",
                                "data": "21",
                                "delay": "",
                                "comments": "clock config",
                                "$$hashKey": "2XO"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "66",
                                "mask": "ff",
                                "data": "B2",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "182"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "75",
                                "mask": "ff",
                                "data": "E0",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "18Y"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "7A",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "PWM control open drain",
                                "$$hashKey": "194"
                            }
                        ],
                        "blockType": "PRE_POWER_UP",
                        "deviceName": "Dev 1 - TAS2558",
                        "deviceValue": 1,
                        "deviceShortName": ""
                    },
                    {
                        "blockName": "PRE_SHUTDOWN - Dev 1",
                        "commands": [
                            {
                                "book": "0",
                                "page": "0",
                                "register": "02",
                                "mask": "ff",
                                "data": "02",
                                "delay": "",
                                "$$hashKey": "0ZH"
                            }
                        ],
                        "blockType": "PRE_SHUTDOWN",
                        "deviceName": "Dev 1 - TAS2558",
                        "deviceValue": 1,
                        "deviceShortName": ""
                    },
                    {
                        "blockName": "PRE_SHUTDOWN - Dev 2",
                        "commands": [
                            {
                                "book": "0",
                                "page": "0",
                                "register": "02",
                                "mask": "ff",
                                "data": "02",
                                "delay": "",
                                "$$hashKey": "0ZK"
                            }
                        ],
                        "blockType": "PRE_SHUTDOWN",
                        "deviceName": "Dev 2 - TAS2558",
                        "deviceValue": 2,
                        "deviceShortName": ""
                    },
                    {
                        "blockName": "PRE_POWER_UP - Dev 2",
                        "commands": [
                            {
                                "book": "0",
                                "page": "0",
                                "register": "00",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "sets page 0",
                                "$$hashKey": "2Y0"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "02",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "BOP diabled, V and I sense enabled, active mode without mute",
                                "$$hashKey": "2Y1"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "03",
                                "mask": "ff",
                                "data": "28",
                                "delay": "",
                                "comments": "Y bridge, PRW_MODE1. This is default as it turns out.",
                                "$$hashKey": "2Y2"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "4",
                                "mask": "ff",
                                "data": "21",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "2Y3"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "A",
                                "mask": "ff",
                                "data": "0A",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "2Y4"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "B",
                                "mask": "ff",
                                "data": "28",
                                "delay": "",
                                "comments": "default? missing from data sheet",
                                "$$hashKey": "2Y5"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "C",
                                "mask": "ff",
                                "data": "10",
                                "delay": "",
                                "comments": "default",
                                "$$hashKey": "2Y6"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "D",
                                "mask": "ff",
                                "data": "03",
                                "delay": "",
                                "comments": "TDM TX SDOUT unused bit field fill 0 not high z",
                                "$$hashKey": "2Y7"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "E",
                                "mask": "ff",
                                "data": "42",
                                "delay": "",
                                "comments": "class H = 8 bits, V sense enabled time slot 2",
                                "$$hashKey": "2Y8"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "0F",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "I sense enabled, time slot 0",
                                "$$hashKey": "2Y9"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "10",
                                "mask": "ff",
                                "data": "C4",
                                "delay": "",
                                "comments": "16 bit V/I data left justified",
                                "$$hashKey": "2YA"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "14",
                                "mask": "ff",
                                "data": "0A",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YB"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "16",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "TDM audio slot lenght = 16bits, enabled.",
                                "$$hashKey": "2YC"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "19",
                                "mask": "ff",
                                "data": "8D",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YD"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "1D",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "device paired with Device 1. Not sure what this means.",
                                "$$hashKey": "2YE"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "21",
                                "mask": "ff",
                                "data": "14",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YF"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "35",
                                "mask": "ff",
                                "data": "B9",
                                "delay": "",
                                "comments": "noise gate disabled",
                                "$$hashKey": "2YG"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "38",
                                "mask": "ff",
                                "data": "00",
                                "delay": "",
                                "comments": "weak pulldowns for SDIN, SDOUT, Clocks disabled",
                                "$$hashKey": "2YH"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "58",
                                "mask": "ff",
                                "data": "07",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YI"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "60",
                                "mask": "ff",
                                "data": "21",
                                "delay": "",
                                "comments": "clock config",
                                "$$hashKey": "2YJ"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "66",
                                "mask": "ff",
                                "data": "B2",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YK"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "75",
                                "mask": "ff",
                                "data": "E0",
                                "delay": "",
                                "comments": "??? not in data sheet",
                                "$$hashKey": "2YL"
                            },
                            {
                                "book": "0",
                                "page": "0",
                                "register": "7A",
                                "mask": "ff",
                                "data": "40",
                                "delay": "",
                                "comments": "PWM control open drain",
                                "$$hashKey": "2YM"
                            }
                        ],
                        "blockType": "PRE_POWER_UP",
                        "deviceName": "Dev 2 - TAS2558",
                        "deviceValue": 2,
                        "deviceShortName": ""
                    }
                ],
                "configName": "Micro Pi ET-446",
                "blockTypeValues": {
                    "COEFF": "0x01",
                    "POST_POWER_UP": "0x02",
                    "PRE_SHUTDOWN": "0x03",
                    "PRE_POWER_UP": "0x04",
                    "POST_SHUTDOWN": "0x05"
                },
                "subBlockTypeValues": {
                    "SINGLE_BYTE_WRITES": "0x01",
                    "BURST_WRITES": "0x02",
                    "DELAY": "0x03",
                    "FIELD_WRITES": "0x04"
                },
                "$$hashKey": "0VZ"
            }
        ],
        "binConfig": {
            "headerSize": 292,
            "binaryVersion": [
                0,
                0,
                1,
                5
            ],
            "driverVersion": [
                0,
                0,
                1,
                1
            ],
            "maxConfigs": 64,
            "maxDevice": 8,
            "configNameLength": 64,
            "types": {
                "deviceType": {
                    "availableDeviceTypes": [
                        "Integrated",
                        "Non Integrated"
                    ]
                },
                "platformType": {
                    "values": {
                        "QCom": "0x01",
                        "MTK": "0x02",
                        "LSI": "0x03"
                    },
                    "valueType": "int",
                    "length": 1
                },
                "deviceCount": {
                    "values": {
                        "1 Device": "0x01",
                        "2 Devices": "0x02",
                        "3 Device": "0x03",
                        "4 Devices": "0x04",
                        "5 Device": "0x05",
                        "6 Devices": "0x06",
                        "7 Devices": "0x07",
                        "8 Devices": "0x08"
                    },
                    "valueType": "int",
                    "length": 1
                },
                "amplifierType": {
                    "values": {
                        "TAS2558": "0x01",
                        "TAS2560": "0x02",
                        "TAS2562": "0x03",
                        "TAS2564": "0x04",
                        "TAS2783": "0x05"
                    },
                    "valueType": "int",
                    "length": 8
                },
                "blockType": {
                    "values": {
                        "COEFF": "0x01",
                        "POST_POWER_UP": "0x02",
                        "PRE_SHUTDOWN": "0x03",
                        "PRE_POWER_UP": "0x04",
                        "POST_SHUTDOWN": "0x05"
                    },
                    "valueType": "int",
                    "length": 1
                },
                "subBlockType": {
                    "values": {
                        "SINGLE_BYTE_WRITES": "0x01",
                        "BURST_WRITES": "0x02",
                        "DELAY": "0x03",
                        "FIELD_WRITES": "0x04"
                    },
                    "valueType": "int",
                    "length": 1
                }
            }
        },
        "platformType": "QCom",
        "devicesCount": "2 Devices",
        "amplifierType": [
            "TAS2558",
            "TAS2558"
        ],
        "deviceType": "Non Integrated"
    }
}

Let me loop our expert, Ivan, for TAS2781.

Hi James,

I'll try to help with the TAS2781 register configuration.

The Class-H power supply control feature from TAS2781 requires the DSP processing. Bypassing DSP while keeping Class-H function would not be possible.

The DSP bypass mode is otherwise called ROM mode; you can see in PPC3 that you can choose either Tuning (DSP) mode or ROM mode.

Is there anything specific you're trying to test by using the DSP bypass configuration?

Best regards,
-Ivan Salazar
Applications Engineer

Hi Ivan,

Thanks for that info, it wasn't clear. So what I really need then is a coeff bin file that enables class H for both channels. My colleague has, I think, gotten the dsp coeff file I generated (for class H, no signal EQ) to work for one channel only. The other channel (the right channel) had a very strange frequency response with little bass. So another way to phrase the question is: what do I need to do to my coeff bin file to make it work for both channels (with no signal EQ)?

James

Hi James,

Are you using 2xTAS2781 on your system? Or do you mean that the same device had different response when playing Left vs Right data only?

If possible, please share the PPC3 file you used to generate the bin file you have used so far.

Best regards,
-Ivan Salazar
Applications Engineer

Hi Ivan,

There are 2xTAS28781 chips on the board, and we're wanting them to play stereo L and R. I can't seem to insert .ppc3 and .json files. How do I do that?

James

Hi James,

Let me reach out offline to share files.

Best regards,
-Ivan Salazar
Applications Engineer