[thirdparty/linux.git] / sound / x86 / intel_hdmi_audio.h

/*
 * Copyright (C) 2016 Intel Corporation
 *  Authors:	Sailaja Bandarupalli <sailaja.bandarupalli@intel.com>
 *		Ramesh Babu K V	<ramesh.babu@intel.com>
 *		Vaibhav Agarwal <vaibhav.agarwal@intel.com>
 *		Jerome Anand <jerome.anand@intel.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files
 * (the "Software"), to deal in the Software without restriction,
 * including without limitation the rights to use, copy, modify, merge,
 * publish, distribute, sublicense, and/or sell copies of the Software,
 * and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the
 * next paragraph) shall be included in all copies or substantial
 * portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

#ifndef _INTEL_HDMI_AUDIO_H_
#define _INTEL_HDMI_AUDIO_H_

#include "intel_hdmi_lpe_audio.h"

#define MAX_PB_STREAMS		1
#define MAX_CAP_STREAMS		0
#define BYTES_PER_WORD		0x4
#define INTEL_HAD		"HdmiLpeAudio"

/*
 *	CEA speaker placement:
 *
 *	FL  FLC   FC   FRC   FR
 *
 *						LFE
 *
 *	RL  RLC   RC   RRC   RR
 *
 *	The Left/Right Surround channel _notions_ LS/RS in SMPTE 320M
 *	corresponds to CEA RL/RR; The SMPTE channel _assignment_ C/LFE is
 *	swapped to CEA LFE/FC.
 */
enum cea_speaker_placement {
	FL  = (1 <<  0),        /* Front Left           */
	FC  = (1 <<  1),        /* Front Center         */
	FR  = (1 <<  2),        /* Front Right          */
	FLC = (1 <<  3),        /* Front Left Center    */
	FRC = (1 <<  4),        /* Front Right Center   */
	RL  = (1 <<  5),        /* Rear Left            */
	RC  = (1 <<  6),        /* Rear Center          */
	RR  = (1 <<  7),        /* Rear Right           */
	RLC = (1 <<  8),        /* Rear Left Center     */
	RRC = (1 <<  9),        /* Rear Right Center    */
	LFE = (1 << 10),        /* Low Frequency Effect */
};

struct cea_channel_speaker_allocation {
	int ca_index;
	int speakers[8];

	/* derived values, just for convenience */
	int channels;
	int spk_mask;
};

struct channel_map_table {
	unsigned char map;              /* ALSA API channel map position */
	unsigned char cea_slot;         /* CEA slot value */
	int spk_mask;                   /* speaker position bit mask */
};

struct pcm_stream_info {
	struct snd_pcm_substream *substream;
	int substream_refcount;
};

/*
 * struct snd_intelhad - intelhad driver structure
 *
 * @card: ptr to hold card details
 * @connected: the monitor connection status
 * @stream_info: stream information
 * @eld: holds ELD info
 * @curr_buf: pointer to hold current active ring buf
 * @valid_buf_cnt: ring buffer count for stream
 * @had_spinlock: driver lock
 * @aes_bits: IEC958 status bits
 * @buff_done: id of current buffer done intr
 * @dev: platoform device handle
 * @chmap: holds channel map info
 */
struct snd_intelhad {
	struct snd_intelhad_card *card_ctx;
	bool		connected;
	struct		pcm_stream_info stream_info;
	unsigned char	eld[HDMI_MAX_ELD_BYTES];
	bool dp_output;
	unsigned int	aes_bits;
	spinlock_t had_spinlock;
	struct device *dev;
	struct snd_pcm_chmap *chmap;
	int tmds_clock_speed;
	int link_rate;
	int port; /* fixed */
	int pipe; /* can change dynamically */

	/* ring buffer (BD) position index */
	unsigned int bd_head;
	/* PCM buffer position indices */
	unsigned int pcmbuf_head;	/* being processed */
	unsigned int pcmbuf_filled;	/* to be filled */

	unsigned int num_bds;		/* number of BDs */
	unsigned int period_bytes;	/* PCM period size in bytes */

	/* internal stuff */
	union aud_cfg aud_config;	/* AUD_CONFIG reg value cache */
	struct work_struct hdmi_audio_wq;
	struct mutex mutex; /* for protecting chmap and eld */
	bool need_reset;
	struct snd_jack *jack;
};

struct snd_intelhad_card {
	struct snd_card	*card;
	struct device *dev;

	/* internal stuff */
	int irq;
	void __iomem *mmio_start;
	int num_pipes;
	int num_ports;
	struct snd_intelhad pcm_ctx[3]; /* one for each port */
};

#endif /* _INTEL_HDMI_AUDIO_ */
Commit	Line	Data
5dab11d8 JA	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
5dab11d8 JA	33	#include "intel_hdmi_lpe_audio.h"
5dab11d8 JA	34
5dab11d8 JA	35	#define MAX_PB_STREAMS 1
5dab11d8 JA	36	#define MAX_CAP_STREAMS 0
5dab11d8	37	#define BYTES_PER_WORD 0x4
77531bee TI	38	#define INTEL_HAD "HdmiLpeAudio"
	39
	40	/*
	41	* CEA speaker placement:
	42	*
	43	* FL FLC FC FRC FR
	44	*
	45	* LFE
	46	*
	47	* RL RLC RC RRC RR
	48	*
	49	* The Left/Right Surround channel _notions_ LS/RS in SMPTE 320M
	50	* corresponds to CEA RL/RR; The SMPTE channel _assignment_ C/LFE is
	51	* swapped to CEA LFE/FC.
	52	*/
	53	enum cea_speaker_placement {
	54	FL = (1 << 0), /* Front Left */
	55	FC = (1 << 1), /* Front Center */
	56	FR = (1 << 2), /* Front Right */
	57	FLC = (1 << 3), /* Front Left Center */
	58	FRC = (1 << 4), /* Front Right Center */
	59	RL = (1 << 5), /* Rear Left */
	60	RC = (1 << 6), /* Rear Center */
	61	RR = (1 << 7), /* Rear Right */
	62	RLC = (1 << 8), /* Rear Left Center */
	63	RRC = (1 << 9), /* Rear Right Center */
	64	LFE = (1 << 10), /* Low Frequency Effect */
	65	};
5dab11d8	66
77531bee TI	67	struct cea_channel_speaker_allocation {
	68	int ca_index;
	69	int speakers[8];
5dab11d8	70
77531bee TI	71	/* derived values, just for convenience */
	72	int channels;
	73	int spk_mask;
	74	};
	75
	76	struct channel_map_table {
	77	unsigned char map; /* ALSA API channel map position */
	78	unsigned char cea_slot; /* CEA slot value */
	79	int spk_mask; /* speaker position bit mask */
	80	};
5dab11d8 JA	81
5dab11d8 JA	82	struct pcm_stream_info {
313d9f28	83	struct snd_pcm_substream *substream;
313d9f28	84	int substream_refcount;
5dab11d8 JA	85	};
5dab11d8 JA	86
03c34377	87	/*
5dab11d8 JA	88	* struct snd_intelhad - intelhad driver structure
	89	*
	90	* @card: ptr to hold card details
91b0cb0c	91	* @connected: the monitor connection status
5dab11d8	92	* @stream_info: stream information
da864809	93	* @eld: holds ELD info
5dab11d8 JA	94	* @curr_buf: pointer to hold current active ring buf
	95	* @valid_buf_cnt: ring buffer count for stream
	96	* @had_spinlock: driver lock
	97	* @aes_bits: IEC958 status bits
	98	* @buff_done: id of current buffer done intr
	99	* @dev: platoform device handle
5dab11d8	100	* @chmap: holds channel map info
5dab11d8 JA	101	*/
5dab11d8 JA	102	struct snd_intelhad {
b4eb0d52	103	struct snd_intelhad_card *card_ctx;
91b0cb0c	104	bool connected;
5dab11d8	105	struct pcm_stream_info stream_info;
df0435db	106	unsigned char eld[HDMI_MAX_ELD_BYTES];
964ca808	107	bool dp_output;
5dab11d8	108	unsigned int aes_bits;
5dab11d8	109	spinlock_t had_spinlock;
5dab11d8	110	struct device *dev;
5dab11d8	111	struct snd_pcm_chmap *chmap;
da864809 TI	112	int tmds_clock_speed;
da864809 TI	113	int link_rate;
8a2d6ae1 VS	114	int port; /* fixed */
8a2d6ae1 VS	115	int pipe; /* can change dynamically */
da864809	116
e1b239f3 TI	117	/* ring buffer (BD) position index */
	118	unsigned int bd_head;
	119	/* PCM buffer position indices */
	120	unsigned int pcmbuf_head; /* being processed */
	121	unsigned int pcmbuf_filled; /* to be filled */
	122
	123	unsigned int num_bds; /* number of BDs */
	124	unsigned int period_bytes; /* PCM period size in bytes */
	125
da864809	126	/* internal stuff */
40ce4b5d	127	union aud_cfg aud_config; /* AUD_CONFIG reg value cache */
da864809	128	struct work_struct hdmi_audio_wq;
0e9c67d7	129	struct mutex mutex; /* for protecting chmap and eld */
e2acecf2	130	bool need_reset;
b9bacf27	131	struct snd_jack *jack;
5dab11d8 JA	132	};
5dab11d8 JA	133
b4eb0d52 VS	134	struct snd_intelhad_card {
	135	struct snd_card *card;
	136	struct device *dev;
	137
	138	/* internal stuff */
	139	int irq;
	140	void __iomem *mmio_start;
8a2d6ae1	141	int num_pipes;
b4eb0d52	142	int num_ports;
8a2d6ae1	143	struct snd_intelhad pcm_ctx[3]; /* one for each port */
b4eb0d52 VS	144	};
b4eb0d52 VS	145
5dab11d8	146	#endif /* _INTEL_HDMI_AUDIO_ */