[alsa-devel] [RFC] File format for topology data

[Vinod Koul]

On Thu, Apr 23, 2015 at 02:11:13AM +0100, Liam Girdwood wrote:
> On Wed, 2015-04-22 at 21:28 +0530, Vinod Koul wrote:
> > On Tue, Apr 21, 2015 at 02:06:46PM +0100, Liam Girdwood wrote:
> > > I've pasted below the topology data for the broadwell firmware using the
> > > text file format being used by UCM. Using the UCM format allows to to
> > > share parser code and allows us to also have UCM define topology data.
> > > 
> 
> Jaroslav, what's your take on the file format. It's using the UCM format
> you designed with some changes.
> 
> > > I've not yet completed the byte or enum controls but the rest of the
> > > data is there for comments. I've also included the recent channel
> > > changes suggested in the UAPI header comments.
> > > 
> > > # Firmware Topology Configuration for Broadwell
> > > 
> > > # TLV scale used by both global and stream volumes
> > > SectionTLV."hsw_vol_tlv" {
> > > 
> > > 	DBScale [
> > > 		min "-9000"
> > > 		step "300"
> > > 		mute "1"
> > > 	]
> > > }
> > So for our DSP we need to pass some private data, how do we go about
> > describing it for this and other controls?
> 
> I'm thinking we should have the same method as UCM here. We could either
> specify an array of comma separated bytes or a file that contains the
> data.
Yes that would be okay. Also I realized later that above is defination of
gain, so the data should come with instance below as eahc instance will have
different data set.

Also you should add feild for assigning default values
> 
> > 
> > > 
> > > # Controls from default pipeline
> > > SectionControl."Default Pipeline" {
> > > 
> > > 	Index "1"
> > > 
> > > 	# Master DSP volume
> > > 	Mixer [
> > > 		name "Master Playback Volume"
> > > 		Channel.0 [
> > > 			map "Left"
> > > 			reg "0"
> > > 			shift "0"
> > > 		]
> > > 		Channel.1 [
> > > 			map "Right"
> > > 			reg "0"
> > > 			shift "8"
> > > 		]
> > > 		max "31"
> > > 		invert "false"
> > > 		get "0"
> > > 		put "0"
> > what do these two mean?
> 
> These are for binding to the info(), get(), put() methods, but I'm not
> 100% sure of using an ID number here. Maybe we should be using a name
> that matches the names in the UAPI header. Let me think more about that.
> 
> > 
> > > 		tlv_array "hsw_vol_tlv"
> > > 	]
> > > 
> > > 	# Offload 0 volume
> > > 	Mixer [
> > > 		name "Media0 Playback Volume"
> > > 		Channel.0 [
> > > 			map "Left"
> > > 			reg "1"
> > > 			shift "0"
> > > 		]
> > > 		Channel.1 [
> > > 			map "Right"
> > > 			reg "1"
> > > 			shift "8"
> > > 		]
> > > 		max "31"
> > > 		invert "false"
> > > 		get "1"
> > > 		put "1"
> > > 		tlv_array "hsw_vol_tlv"
> > > 	]
> > > 
> > > 	# Enum controls
> > > 	Enum [
> > > 		...
> > > 	]
> > > 
> > > 	# Byte controls
> > > 	Bytes [
> > > 		...
> > > 	]
> > > }
> > > 
> > > # DAPM Widgets for main pipeline
> > > SectionWidget."Pipeline1" {
> > > 
> > > 	Index "1"
> > > 
> > > 	AIF_IN [
> > > 		name "SSP0 CODEC IN"
> > > 		stream_name ""
> > > 		slot ""
> > > 		reg "0"
> > > 		shift "0"
> > > 		invert "false"
> > > 	]
> > > 
> > > 	AIF_OUT [
> > > 		name "SSP0 CODEC OUT"
> > > 		stream_name ""
> > > 		slot ""
> > > 		reg "0"
> > > 		shift "0"
> > > 		invert "false"
> > > 	]
> > > 
> > > 	...
> > > }
> > > 
> > > # DAPM Routes
> > > SectionGraph."Pipeline 1 Graph" {
> > > 
> > > 	Index 1
> > > 
> > > 	Routes [
> > > 		"Playback VMixer, , System Playback"
> > > 		"Playback VMixer, , Offload0 Playback"
> > > 		"Playback VMixer, , Offload1 Playback"
> > > 		"SSP0 CODEC OUT, , Playback VMixer"
> > > 		"Analog Capture, , SSP0 CODEC IN"
> > > 	]
> > > }
> > > 
> > > # PCM Configurations supported by FW
> > > SectionPCMConfig."PCM 48k Stereo 24bit" {
> > > 
> > > 	Playback [
> > > 		format "S24_LE"
> > > 		rate "48000"
> > > 		channels "2"
> > > 		tdm_slot "0xf"
> > > 	]
> > > 
> > > 	Capture [
> > > 		format "S24_LE"
> > > 		rate "48000"
> > > 		channels "2"
> > > 		tdm_slot "0xf"
> > > 
> > > 	]
> > > }
> > > 
> > > SectionPCMConfig."PCM 48k Stereo 16bit" {
> > > 
> > > 	Playback [
> > > 		format "S16_LE"
> > > 		rate "48000"
> > > 		channels "2"
> > > 		tdm_slot "0xf"
> > > 	]
> > > 
> > > 	Capture [
> > > 		format "S16_LE"
> > > 		rate "48000"
> > > 		channels "2"
> > > 		tdm_slot "0xf"
> > > 
> > > 	]
> > > }
> > > 
> > > SectionPCMConfig."PCM 48k 2P/4C 16bit" {
> > > 
> > > 	Playback [
> > > 		format "S16_LE"
> > > 		rate "48000"
> > > 		channels "2"
> > > 		tdm_slot "0xf"
> > > 	]
> > > 
> > > 	Capture [
> > > 		format "S16_LE"
> > > 		rate "48000"
> > > 		channels "4"
> > > 		tdm_slot "0xf"
> > > 
> > > 	]
> > > }
> > > 
> > > # PCM capabilities supported by FW
> > > SectionPCMCapabilities."System Playback" {
> > > 
> > > 	Capabilities [
> > > 		formats "S24_LE, S16_LE"
> > > 		rate_min "48000"
> > > 		rate_max "48000"
> > > 		channels_min "2"
> > > 		channels_max "2"
> > > 	]
> > > }
> > > 
> > > SectionPCMCapabilities."Analog Capture" {
> > > 
> > > 	Capabilities [
> > > 		formats "S24_LE, S16_LE"
> > > 		rate_min "48000"
> > > 		rate_max "48000"
> > > 		channels_min "2"
> > > 		channels_max "4"
> > > 	]
> > > }
> > > 
> > > SectionPCMCapabilities."Offload Pin Playback" {
> > > 
> > > 	Capabilities [
> > > 		formats "S24_LE, S16_LE"
> > > 		rate_min "8000"
> > > 		rate_max "192000"
> > > 		channels_min "2"
> > > 		channels_max "2"
> > > 	]
> > > }
> > > 
> > > SectionPCMCapabilities."Loopback Capture" {
> > > 
> > > 	Capabilities [
> > > 		formats "S16_LE"
> > > 		rate_min "48000"
> > > 		rate_max "48000"
> > > 		channels_min "2"
> > > 		channels_max "2"
> > > 	]
> > > }
> > > 
> > > # PCM devices exported by Firmware
> > > SectionPCM."System Pin" {
> > > 
> > > 	Index 1
> > > 
> > > 	Playback [
> > > 		Capabilities "System Playback"
> > > 		Config "PCM 48k Stereo 24bit"
> > > 		Config "PCM 48k Stereo 16bit"
> > > 	]
> > > 
> > > 	Capture [
> > > 		Capabilities "Analog Capture"
> > > 		Config "PCM 48k Stereo 24bit"
> > > 		Config "PCM 48k Stereo 16bit"
> > > 		Config "PCM 48k 2P/4C 16bit"
> > > 	]
> > > }
> > Is this a FE or a BE? How about Dailinks?
> > 
> 
> This is PCM FE. I'll give some examples for the codec <-> codec links
> and BE DAI link shortly with updates to the other questions.
Okay, that will help

-- 
~Vinod

> 
> Liam
> 
> > -- 
> > ~Vinod
> > 
> > > 
> > > SectionPCM."Offload Pin 0" {
> > > 
> > > 	Index 1
> > > 
> > > 	Playback [
> > > 		Capabilities "Offload Pin Playback"
> > > 		Config "PCM 48k Stereo 24bit"
> > > 		Config "PCM 48k Stereo 16bit"
> > > 	]
> > > }
> > > 
> > > SectionPCM."Offload Pin 1" {
> > > 
> > > 	Index 1
> > > 
> > > 	Playback [
> > > 		Capabilities "Offload Pin Playback"
> > > 		Config "PCM 48k Stereo 24bit"
> > > 		Config "PCM 48k Stereo 16bit"
> > > 	]
> > > }
> > > 
> > > SectionPCM."Loopback Pin" {
> > > 
> > > 	Index 1
> > > 
> > > 	Capture [
> > > 		Capabilities "Loopback Capture"
> > > 		Config "PCM 48k Stereo 16bit"
> > > 	]
> > > }
> > > 
> > 
> 
> 

--