/* * Universal Interface for Intel High Definition Audio Codec * * Local helper functions * * Copyright (c) 2004 Takashi Iwai <tiwai@suse.de> * *  This program is free software; you can redistribute it and/or modify it *  under the terms of the GNU General Public License as published by the Free *  Software Foundation; either version 2 of the License, or (at your option) *  any later version. * *  This program is distributed in the hope that it will be useful, but WITHOUT *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for *  more details. * *  You should have received a copy of the GNU General Public License along with *  this program; if not, write to the Free Software Foundation, Inc., 59 *  Temple Place - Suite 330, Boston, MA  02111-1307, USA. */#ifndef __SOUND_HDA_LOCAL_H#define __SOUND_HDA_LOCAL_H/* * for mixer controls */#define HDA_COMPOSE_AMP_VAL(nid,chs,idx,dir) \	((nid) | ((chs)<<16) | ((dir)<<18) | ((idx)<<19))/* mono volume with index (index=0,1,...) (channel=1,2) */#define HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx,  \	  .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | \	  	    SNDRV_CTL_ELEM_ACCESS_TLV_READ | \	  	    SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK, \	  .info = snd_hda_mixer_amp_volume_info, \	  .get = snd_hda_mixer_amp_volume_get, \	  .put = snd_hda_mixer_amp_volume_put, \	  .tlv = { .c = snd_hda_mixer_amp_tlv },		\	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }/* stereo volume with index */#define HDA_CODEC_VOLUME_IDX(xname, xcidx, nid, xindex, direction) \	HDA_CODEC_VOLUME_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)/* mono volume */#define HDA_CODEC_VOLUME_MONO(xname, nid, channel, xindex, direction) \	HDA_CODEC_VOLUME_MONO_IDX(xname, 0, nid, channel, xindex, direction)/* stereo volume */#define HDA_CODEC_VOLUME(xname, nid, xindex, direction) \	HDA_CODEC_VOLUME_MONO(xname, nid, 3, xindex, direction)/* mono mute switch with index (index=0,1,...) (channel=1,2) */#define HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, channel, xindex, direction) \	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xcidx, \	  .info = snd_hda_mixer_amp_switch_info, \	  .get = snd_hda_mixer_amp_switch_get, \	  .put = snd_hda_mixer_amp_switch_put, \	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, xindex, direction) }/* stereo mute switch with index */#define HDA_CODEC_MUTE_IDX(xname, xcidx, nid, xindex, direction) \	HDA_CODEC_MUTE_MONO_IDX(xname, xcidx, nid, 3, xindex, direction)/* mono mute switch */#define HDA_CODEC_MUTE_MONO(xname, nid, channel, xindex, direction) \	HDA_CODEC_MUTE_MONO_IDX(xname, 0, nid, channel, xindex, direction)/* stereo mute switch */#define HDA_CODEC_MUTE(xname, nid, xindex, direction) \	HDA_CODEC_MUTE_MONO(xname, nid, 3, xindex, direction)int snd_hda_mixer_amp_volume_info(struct snd_kcontrol *kcontrol,				  struct snd_ctl_elem_info *uinfo);int snd_hda_mixer_amp_volume_get(struct snd_kcontrol *kcontrol,				 struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_amp_volume_put(struct snd_kcontrol *kcontrol,				 struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_amp_tlv(struct snd_kcontrol *kcontrol, int op_flag,			  unsigned int size, unsigned int __user *tlv);int snd_hda_mixer_amp_switch_info(struct snd_kcontrol *kcontrol,				  struct snd_ctl_elem_info *uinfo);int snd_hda_mixer_amp_switch_get(struct snd_kcontrol *kcontrol,				 struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_amp_switch_put(struct snd_kcontrol *kcontrol,				 struct snd_ctl_elem_value *ucontrol);/* lowlevel accessor with caching; use carefully */int snd_hda_codec_amp_read(struct hda_codec *codec, hda_nid_t nid, int ch,			   int direction, int index);int snd_hda_codec_amp_update(struct hda_codec *codec, hda_nid_t nid, int ch,			     int direction, int idx, int mask, int val);int snd_hda_codec_amp_stereo(struct hda_codec *codec, hda_nid_t nid,			     int dir, int idx, int mask, int val);#ifdef SND_HDA_NEEDS_RESUMEvoid snd_hda_codec_resume_amp(struct hda_codec *codec);#endif/* amp value bits */#define HDA_AMP_MUTE	0x80#define HDA_AMP_UNMUTE	0x00#define HDA_AMP_VOLMASK	0x7f/* mono switch binding multiple inputs */#define HDA_BIND_MUTE_MONO(xname, nid, channel, indices, direction) \	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = 0,  \	  .info = snd_hda_mixer_amp_switch_info, \	  .get = snd_hda_mixer_bind_switch_get, \	  .put = snd_hda_mixer_bind_switch_put, \	  .private_value = HDA_COMPOSE_AMP_VAL(nid, channel, indices, direction) }/* stereo switch binding multiple inputs */#define HDA_BIND_MUTE(xname,nid,indices,dir) \	HDA_BIND_MUTE_MONO(xname,nid,3,indices,dir)int snd_hda_mixer_bind_switch_get(struct snd_kcontrol *kcontrol,				  struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_bind_switch_put(struct snd_kcontrol *kcontrol,				  struct snd_ctl_elem_value *ucontrol);/* more generic bound controls */struct hda_ctl_ops {	snd_kcontrol_info_t *info;	snd_kcontrol_get_t *get;	snd_kcontrol_put_t *put;	snd_kcontrol_tlv_rw_t *tlv;};extern struct hda_ctl_ops snd_hda_bind_vol;	/* for bind-volume with TLV */extern struct hda_ctl_ops snd_hda_bind_sw;	/* for bind-switch */struct hda_bind_ctls {	struct hda_ctl_ops *ops;	long values[];};int snd_hda_mixer_bind_ctls_info(struct snd_kcontrol *kcontrol,				 struct snd_ctl_elem_info *uinfo);int snd_hda_mixer_bind_ctls_get(struct snd_kcontrol *kcontrol,				struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_bind_ctls_put(struct snd_kcontrol *kcontrol,				struct snd_ctl_elem_value *ucontrol);int snd_hda_mixer_bind_tlv(struct snd_kcontrol *kcontrol, int op_flag,			   unsigned int size, unsigned int __user *tlv);#define HDA_BIND_VOL(xname, bindrec) \	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \	  .name = xname, \	  .access = SNDRV_CTL_ELEM_ACCESS_READWRITE |\			  SNDRV_CTL_ELEM_ACCESS_TLV_READ |\			  SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK,\	  .info = snd_hda_mixer_bind_ctls_info,\	  .get =  snd_hda_mixer_bind_ctls_get,\	  .put = snd_hda_mixer_bind_ctls_put,\	  .tlv = { .c = snd_hda_mixer_bind_tlv },\	  .private_value = (long) (bindrec) }#define HDA_BIND_SW(xname, bindrec) \	{ .iface = SNDRV_CTL_ELEM_IFACE_MIXER,\	  .name = xname, \	  .info = snd_hda_mixer_bind_ctls_info,\	  .get =  snd_hda_mixer_bind_ctls_get,\	  .put = snd_hda_mixer_bind_ctls_put,\	  .private_value = (long) (bindrec) }/* * SPDIF I/O */int snd_hda_create_spdif_out_ctls(struct hda_codec *codec, hda_nid_t nid);int snd_hda_create_spdif_in_ctls(struct hda_codec *codec, hda_nid_t nid);/* * input MUX helper */#define HDA_MAX_NUM_INPUTS	16struct hda_input_mux_item {	const char *label;	unsigned int index;};struct hda_input_mux {	unsigned int num_items;	struct hda_input_mux_item items[HDA_MAX_NUM_INPUTS];};int snd_hda_input_mux_info(const struct hda_input_mux *imux,			   struct snd_ctl_elem_info *uinfo);int snd_hda_input_mux_put(struct hda_codec *codec,			  const struct hda_input_mux *imux,			  struct snd_ctl_elem_value *ucontrol, hda_nid_t nid,			  unsigned int *cur_val);/* * Channel mode helper */struct hda_channel_mode {	int channels;	const struct hda_verb *sequence;};int snd_hda_ch_mode_info(struct hda_codec *codec,			 struct snd_ctl_elem_info *uinfo,			 const struct hda_channel_mode *chmode,			 int num_chmodes);int snd_hda_ch_mode_get(struct hda_codec *codec,			struct snd_ctl_elem_value *ucontrol,			const struct hda_channel_mode *chmode,			int num_chmodes,			int max_channels);int snd_hda_ch_mode_put(struct hda_codec *codec,			struct snd_ctl_elem_value *ucontrol,			const struct hda_channel_mode *chmode,			int num_chmodes,			int *max_channelsp);/* * Multi-channel / digital-out PCM helper */enum { HDA_FRONT, HDA_REAR, HDA_CLFE, HDA_SIDE }; /* index for dac_nidx */enum { HDA_DIG_NONE, HDA_DIG_EXCLUSIVE, HDA_DIG_ANALOG_DUP }; /* dig_out_used */struct hda_multi_out {	int num_dacs;		/* # of DACs, must be more than 1 */	hda_nid_t *dac_nids;	/* DAC list */	hda_nid_t hp_nid;	/* optional DAC for HP, 0 when not exists */	hda_nid_t extra_out_nid[3];	/* optional DACs, 0 when not exists */	hda_nid_t dig_out_nid;	/* digital out audio widget */	int max_channels;	/* currently supported analog channels */	int dig_out_used;	/* current usage of digital out (HDA_DIG_XXX) */	int no_share_stream;	/* don't share a stream with multiple pins */};int snd_hda_multi_out_dig_open(struct hda_codec *codec,			       struct hda_multi_out *mout);int snd_hda_multi_out_dig_close(struct hda_codec *codec,				struct hda_multi_out *mout);int snd_hda_multi_out_dig_prepare(struct hda_codec *codec,				  struct hda_multi_out *mout,				  unsigned int stream_tag,				  unsigned int format,				  struct snd_pcm_substream *substream);int snd_hda_multi_out_analog_open(struct hda_codec *codec,				  struct hda_multi_out *mout,				  struct snd_pcm_substream *substream);int snd_hda_multi_out_analog_prepare(struct hda_codec *codec,				     struct hda_multi_out *mout,				     unsigned int stream_tag,				     unsigned int format,				     struct snd_pcm_substream *substream);int snd_hda_multi_out_analog_cleanup(struct hda_codec *codec,				     struct hda_multi_out *mout);/* * generic codec parser */#ifdef CONFIG_SND_HDA_GENERICint snd_hda_parse_generic_codec(struct hda_codec *codec);#elsestatic inline int snd_hda_parse_generic_codec(struct hda_codec *codec){	return -ENODEV;}#endif/* * generic proc interface */#ifdef CONFIG_PROC_FSint snd_hda_codec_proc_new(struct hda_codec *codec);#elsestatic inline int snd_hda_codec_proc_new(struct hda_codec *codec) { return 0; }#endif/* * Misc */int snd_hda_check_board_config(struct hda_codec *codec, int num_configs,			       const char **modelnames,			       const struct snd_pci_quirk *pci_list);int snd_hda_add_new_ctls(struct hda_codec *codec,			 struct snd_kcontrol_new *knew);/* * unsolicited event handler */#define HDA_UNSOL_QUEUE_SIZE	64struct hda_bus_unsolicited {	/* ring buffer */	u32 queue[HDA_UNSOL_QUEUE_SIZE * 2];	unsigned int rp, wp;	/* workqueue */	struct work_struct work;	struct hda_bus *bus;};/* * Helper for automatic ping configuration */enum {	AUTO_PIN_MIC,	AUTO_PIN_FRONT_MIC,	AUTO_PIN_LINE,	AUTO_PIN_FRONT_LINE,	AUTO_PIN_CD,	AUTO_PIN_AUX,	AUTO_PIN_LAST};enum {	AUTO_PIN_LINE_OUT,	AUTO_PIN_SPEAKER_OUT,	AUTO_PIN_HP_OUT};extern const char *auto_pin_cfg_labels[AUTO_PIN_LAST];#define AUTO_CFG_MAX_OUTS	5struct auto_pin_cfg {	int line_outs;	/* sorted in the order of Front/Surr/CLFE/Side */	hda_nid_t line_out_pins[AUTO_CFG_MAX_OUTS];	int speaker_outs;	hda_nid_t speaker_pins[AUTO_CFG_MAX_OUTS];	int hp_outs;	int line_out_type;	/* AUTO_PIN_XXX_OUT */	hda_nid_t hp_pins[AUTO_CFG_MAX_OUTS];	hda_nid_t input_pins[AUTO_PIN_LAST];	hda_nid_t dig_out_pin;	hda_nid_t dig_in_pin;};#define get_defcfg_connect(cfg) \	((cfg & AC_DEFCFG_PORT_CONN) >> AC_DEFCFG_PORT_CONN_SHIFT)#define get_defcfg_association(cfg) \	((cfg & AC_DEFCFG_DEF_ASSOC) >> AC_DEFCFG_ASSOC_SHIFT)#define get_defcfg_location(cfg) \	((cfg & AC_DEFCFG_LOCATION) >> AC_DEFCFG_LOCATION_SHIFT)#define get_defcfg_sequence(cfg) \	(cfg & AC_DEFCFG_SEQUENCE)#define get_defcfg_device(cfg) \	((cfg & AC_DEFCFG_DEVICE) >> AC_DEFCFG_DEVICE_SHIFT)int snd_hda_parse_pin_def_config(struct hda_codec *codec,				 struct auto_pin_cfg *cfg,				 hda_nid_t *ignore_nids);/* amp values */#define AMP_IN_MUTE(idx)	(0x7080 | ((idx)<<8))#define AMP_IN_UNMUTE(idx)	(0x7000 | ((idx)<<8))#define AMP_OUT_MUTE	0xb080#define AMP_OUT_UNMUTE	0xb000#define AMP_OUT_ZERO	0xb000/* pinctl values */#define PIN_IN		0x20#define PIN_VREF80	0x24#define PIN_VREF50	0x21#define PIN_OUT		0x40#define PIN_HP		0xc0#define PIN_HP_AMP	0x80/* * get widget capabilities */static inline u32 get_wcaps(struct hda_codec *codec, hda_nid_t nid){	if (nid < codec->start_nid ||	    nid >= codec->start_nid + codec->num_nodes)		return snd_hda_param_read(codec, nid, AC_PAR_AUDIO_WIDGET_CAP);	return codec->wcaps[nid - codec->start_nid];}int snd_hda_override_amp_caps(struct hda_codec *codec, hda_nid_t nid, int dir,			      unsigned int caps);/* * hwdep interface */int snd_hda_create_hwdep(struct hda_codec *codec);/* * power-management */#ifdef CONFIG_SND_HDA_POWER_SAVEvoid snd_hda_schedule_power_save(struct hda_codec *codec);struct hda_amp_list {	hda_nid_t nid;	unsigned char dir;	unsigned char idx;};struct hda_loopback_check {	struct hda_amp_list *amplist;	int power_on;};int snd_hda_check_amp_list_power(struct hda_codec *codec,				 struct hda_loopback_check *check,				 hda_nid_t nid);#endif /* CONFIG_SND_HDA_POWER_SAVE */#endif /* __SOUND_HDA_LOCAL_H */