xref: /openbmc/linux/sound/x86/intel_hdmi_audio.h (revision fcc8487d)
1 /*
2  * Copyright (C) 2016 Intel Corporation
3  *  Authors:	Sailaja Bandarupalli <sailaja.bandarupalli@intel.com>
4  *		Ramesh Babu K V	<ramesh.babu@intel.com>
5  *		Vaibhav Agarwal <vaibhav.agarwal@intel.com>
6  *		Jerome Anand <jerome.anand@intel.com>
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining
9  * a copy of this software and associated documentation files
10  * (the "Software"), to deal in the Software without restriction,
11  * including without limitation the rights to use, copy, modify, merge,
12  * publish, distribute, sublicense, and/or sell copies of the Software,
13  * and to permit persons to whom the Software is furnished to do so,
14  * subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice (including the
17  * next paragraph) shall be included in all copies or substantial
18  * portions of the Software.
19  *
20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23  * NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
24  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
25  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
26  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27  * SOFTWARE.
28  */
29 
30 #ifndef _INTEL_HDMI_AUDIO_H_
31 #define _INTEL_HDMI_AUDIO_H_
32 
33 #include "intel_hdmi_lpe_audio.h"
34 
35 #define PCM_INDEX		0
36 #define MAX_PB_STREAMS		1
37 #define MAX_CAP_STREAMS		0
38 #define BYTES_PER_WORD		0x4
39 #define INTEL_HAD		"HdmiLpeAudio"
40 
41 /*
42  *	CEA speaker placement:
43  *
44  *	FL  FLC   FC   FRC   FR
45  *
46  *						LFE
47  *
48  *	RL  RLC   RC   RRC   RR
49  *
50  *	The Left/Right Surround channel _notions_ LS/RS in SMPTE 320M
51  *	corresponds to CEA RL/RR; The SMPTE channel _assignment_ C/LFE is
52  *	swapped to CEA LFE/FC.
53  */
54 enum cea_speaker_placement {
55 	FL  = (1 <<  0),        /* Front Left           */
56 	FC  = (1 <<  1),        /* Front Center         */
57 	FR  = (1 <<  2),        /* Front Right          */
58 	FLC = (1 <<  3),        /* Front Left Center    */
59 	FRC = (1 <<  4),        /* Front Right Center   */
60 	RL  = (1 <<  5),        /* Rear Left            */
61 	RC  = (1 <<  6),        /* Rear Center          */
62 	RR  = (1 <<  7),        /* Rear Right           */
63 	RLC = (1 <<  8),        /* Rear Left Center     */
64 	RRC = (1 <<  9),        /* Rear Right Center    */
65 	LFE = (1 << 10),        /* Low Frequency Effect */
66 };
67 
68 struct cea_channel_speaker_allocation {
69 	int ca_index;
70 	int speakers[8];
71 
72 	/* derived values, just for convenience */
73 	int channels;
74 	int spk_mask;
75 };
76 
77 struct channel_map_table {
78 	unsigned char map;              /* ALSA API channel map position */
79 	unsigned char cea_slot;         /* CEA slot value */
80 	int spk_mask;                   /* speaker position bit mask */
81 };
82 
83 struct pcm_stream_info {
84 	struct snd_pcm_substream *substream;
85 	int substream_refcount;
86 };
87 
88 /*
89  * struct snd_intelhad - intelhad driver structure
90  *
91  * @card: ptr to hold card details
92  * @connected: the monitor connection status
93  * @stream_info: stream information
94  * @eld: holds ELD info
95  * @curr_buf: pointer to hold current active ring buf
96  * @valid_buf_cnt: ring buffer count for stream
97  * @had_spinlock: driver lock
98  * @aes_bits: IEC958 status bits
99  * @buff_done: id of current buffer done intr
100  * @dev: platoform device handle
101  * @chmap: holds channel map info
102  */
103 struct snd_intelhad {
104 	struct snd_card	*card;
105 	bool		connected;
106 	struct		pcm_stream_info stream_info;
107 	unsigned char	eld[HDMI_MAX_ELD_BYTES];
108 	bool dp_output;
109 	unsigned int	aes_bits;
110 	spinlock_t had_spinlock;
111 	struct device *dev;
112 	struct snd_pcm_chmap *chmap;
113 	int tmds_clock_speed;
114 	int link_rate;
115 
116 	/* ring buffer (BD) position index */
117 	unsigned int bd_head;
118 	/* PCM buffer position indices */
119 	unsigned int pcmbuf_head;	/* being processed */
120 	unsigned int pcmbuf_filled;	/* to be filled */
121 
122 	unsigned int num_bds;		/* number of BDs */
123 	unsigned int period_bytes;	/* PCM period size in bytes */
124 
125 	/* internal stuff */
126 	int irq;
127 	void __iomem *mmio_start;
128 	unsigned int had_config_offset;
129 	union aud_cfg aud_config;	/* AUD_CONFIG reg value cache */
130 	struct work_struct hdmi_audio_wq;
131 	struct mutex mutex; /* for protecting chmap and eld */
132 	bool need_reset;
133 	struct snd_jack *jack;
134 };
135 
136 #endif /* _INTEL_HDMI_AUDIO_ */
137