xref: /openbmc/linux/sound/pci/cs46xx/cs46xx_lib.h (revision 22246614)
1 /*
2  *  The driver for the Cirrus Logic's Sound Fusion CS46XX based soundcards
3  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
4  *
5  *
6  *   This program is free software; you can redistribute it and/or modify
7  *   it under the terms of the GNU General Public License as published by
8  *   the Free Software Foundation; either version 2 of the License, or
9  *   (at your option) any later version.
10  *
11  *   This program is distributed in the hope that it will be useful,
12  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *   GNU General Public License for more details.
15  *
16  *   You should have received a copy of the GNU General Public License
17  *   along with this program; if not, write to the Free Software
18  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
19  *
20  */
21 
22 #ifndef __CS46XX_LIB_H__
23 #define __CS46XX_LIB_H__
24 
25 /*
26  *  constants
27  */
28 
29 #define CS46XX_BA0_SIZE		  0x1000
30 #define CS46XX_BA1_DATA0_SIZE 0x3000
31 #define CS46XX_BA1_DATA1_SIZE 0x3800
32 #define CS46XX_BA1_PRG_SIZE	  0x7000
33 #define CS46XX_BA1_REG_SIZE	  0x0100
34 
35 
36 
37 #ifdef CONFIG_SND_CS46XX_NEW_DSP
38 #define CS46XX_MIN_PERIOD_SIZE 1
39 #define CS46XX_MAX_PERIOD_SIZE 1024*1024
40 #else
41 #define CS46XX_MIN_PERIOD_SIZE 2048
42 #define CS46XX_MAX_PERIOD_SIZE 2048
43 #endif
44 
45 #define CS46XX_FRAGS 2
46 /* #define CS46XX_BUFFER_SIZE CS46XX_MAX_PERIOD_SIZE * CS46XX_FRAGS */
47 
48 #define SCB_NO_PARENT             0
49 #define SCB_ON_PARENT_NEXT_SCB    1
50 #define SCB_ON_PARENT_SUBLIST_SCB 2
51 
52 /* 3*1024 parameter, 3.5*1024 sample, 2*3.5*1024 code */
53 #define BA1_DWORD_SIZE		(13 * 1024 + 512)
54 #define BA1_MEMORY_COUNT	3
55 
56 /*
57  *  common I/O routines
58  */
59 
60 static inline void snd_cs46xx_poke(struct snd_cs46xx *chip, unsigned long reg, unsigned int val)
61 {
62 	unsigned int bank = reg >> 16;
63 	unsigned int offset = reg & 0xffff;
64 
65 	/*if (bank == 0) printk("snd_cs46xx_poke: %04X - %08X\n",reg >> 2,val); */
66 	writel(val, chip->region.idx[bank+1].remap_addr + offset);
67 }
68 
69 static inline unsigned int snd_cs46xx_peek(struct snd_cs46xx *chip, unsigned long reg)
70 {
71 	unsigned int bank = reg >> 16;
72 	unsigned int offset = reg & 0xffff;
73 	return readl(chip->region.idx[bank+1].remap_addr + offset);
74 }
75 
76 static inline void snd_cs46xx_pokeBA0(struct snd_cs46xx *chip, unsigned long offset, unsigned int val)
77 {
78 	writel(val, chip->region.name.ba0.remap_addr + offset);
79 }
80 
81 static inline unsigned int snd_cs46xx_peekBA0(struct snd_cs46xx *chip, unsigned long offset)
82 {
83 	return readl(chip->region.name.ba0.remap_addr + offset);
84 }
85 
86 struct dsp_spos_instance *cs46xx_dsp_spos_create (struct snd_cs46xx * chip);
87 void cs46xx_dsp_spos_destroy (struct snd_cs46xx * chip);
88 int cs46xx_dsp_load_module (struct snd_cs46xx * chip, struct dsp_module_desc * module);
89 #ifdef CONFIG_PM
90 int cs46xx_dsp_resume(struct snd_cs46xx * chip);
91 #endif
92 struct dsp_symbol_entry *cs46xx_dsp_lookup_symbol (struct snd_cs46xx * chip, char * symbol_name,
93 						   int symbol_type);
94 #ifdef CONFIG_PROC_FS
95 int cs46xx_dsp_proc_init (struct snd_card *card, struct snd_cs46xx *chip);
96 int cs46xx_dsp_proc_done (struct snd_cs46xx *chip);
97 #else
98 #define cs46xx_dsp_proc_init(card, chip)
99 #define cs46xx_dsp_proc_done(chip)
100 #endif
101 int cs46xx_dsp_scb_and_task_init (struct snd_cs46xx *chip);
102 int snd_cs46xx_download (struct snd_cs46xx *chip, u32 *src, unsigned long offset,
103 			 unsigned long len);
104 int snd_cs46xx_clear_BA1(struct snd_cs46xx *chip, unsigned long offset, unsigned long len);
105 int cs46xx_dsp_enable_spdif_out (struct snd_cs46xx *chip);
106 int cs46xx_dsp_enable_spdif_hw (struct snd_cs46xx *chip);
107 int cs46xx_dsp_disable_spdif_out (struct snd_cs46xx *chip);
108 int cs46xx_dsp_enable_spdif_in (struct snd_cs46xx *chip);
109 int cs46xx_dsp_disable_spdif_in (struct snd_cs46xx *chip);
110 int cs46xx_dsp_enable_pcm_capture (struct snd_cs46xx *chip);
111 int cs46xx_dsp_disable_pcm_capture (struct snd_cs46xx *chip);
112 int cs46xx_dsp_enable_adc_capture (struct snd_cs46xx *chip);
113 int cs46xx_dsp_disable_adc_capture (struct snd_cs46xx *chip);
114 int cs46xx_poke_via_dsp (struct snd_cs46xx *chip, u32 address, u32 data);
115 struct dsp_scb_descriptor * cs46xx_dsp_create_scb (struct snd_cs46xx *chip, char * name,
116 						   u32 * scb_data, u32 dest);
117 #ifdef CONFIG_PROC_FS
118 void cs46xx_dsp_proc_free_scb_desc (struct dsp_scb_descriptor * scb);
119 void cs46xx_dsp_proc_register_scb_desc (struct snd_cs46xx *chip,
120 					struct dsp_scb_descriptor * scb);
121 #else
122 #define cs46xx_dsp_proc_free_scb_desc(scb)
123 #define cs46xx_dsp_proc_register_scb_desc(chip, scb)
124 #endif
125 struct dsp_scb_descriptor * cs46xx_dsp_create_timing_master_scb (struct snd_cs46xx *chip);
126 struct dsp_scb_descriptor *
127 cs46xx_dsp_create_codec_out_scb(struct snd_cs46xx * chip,
128 				char * codec_name, u16 channel_disp, u16 fifo_addr,
129 				u16 child_scb_addr, u32 dest,
130 				struct dsp_scb_descriptor * parent_scb,
131 				int scb_child_type);
132 struct dsp_scb_descriptor *
133 cs46xx_dsp_create_codec_in_scb(struct snd_cs46xx * chip, char * codec_name,
134 			       u16 channel_disp, u16 fifo_addr,
135 			       u16 sample_buffer_addr, u32 dest,
136 			       struct dsp_scb_descriptor * parent_scb,
137 			       int scb_child_type);
138 void cs46xx_dsp_remove_scb (struct snd_cs46xx *chip,
139 			    struct dsp_scb_descriptor * scb);
140 struct dsp_scb_descriptor *
141 cs46xx_dsp_create_codec_in_scb(struct snd_cs46xx * chip, char * codec_name,
142 			       u16 channel_disp, u16 fifo_addr,
143 			       u16 sample_buffer_addr, u32 dest,
144 			       struct dsp_scb_descriptor * parent_scb,
145 			       int scb_child_type);
146 struct dsp_scb_descriptor *
147 cs46xx_dsp_create_src_task_scb(struct snd_cs46xx * chip, char * scb_name,
148 			       int sample_rate, u16 src_buffer_addr,
149 			       u16 src_delay_buffer_addr, u32 dest,
150 			       struct dsp_scb_descriptor * parent_scb,
151 			       int scb_child_type, int pass_through);
152 struct dsp_scb_descriptor *
153 cs46xx_dsp_create_mix_only_scb(struct snd_cs46xx * chip, char * scb_name,
154 			       u16 mix_buffer_addr, u32 dest,
155 			       struct dsp_scb_descriptor * parent_scb,
156 			       int scb_child_type);
157 
158 struct dsp_scb_descriptor *
159 cs46xx_dsp_create_vari_decimate_scb(struct snd_cs46xx * chip, char * scb_name,
160 				    u16 vari_buffer_addr0, u16 vari_buffer_addr1, u32 dest,
161 				    struct dsp_scb_descriptor * parent_scb,
162 				    int scb_child_type);
163 struct dsp_scb_descriptor *
164 cs46xx_dsp_create_asynch_fg_rx_scb(struct snd_cs46xx * chip, char * scb_name,
165 				   u32 dest, u16 hfg_scb_address, u16 asynch_buffer_address,
166 				   struct dsp_scb_descriptor * parent_scb,
167 				   int scb_child_type);
168 struct dsp_scb_descriptor *
169 cs46xx_dsp_create_spio_write_scb(struct snd_cs46xx * chip, char * scb_name, u32 dest,
170 				 struct dsp_scb_descriptor * parent_scb,
171 				 int scb_child_type);
172 struct dsp_scb_descriptor *
173 cs46xx_dsp_create_mix_to_ostream_scb(struct snd_cs46xx * chip, char * scb_name,
174 				     u16 mix_buffer_addr, u16 writeback_spb, u32 dest,
175 				     struct dsp_scb_descriptor * parent_scb,
176 				     int scb_child_type);
177 struct dsp_scb_descriptor *
178 cs46xx_dsp_create_magic_snoop_scb(struct snd_cs46xx * chip, char * scb_name,
179 				  u32 dest, u16 snoop_buffer_address,
180 				  struct dsp_scb_descriptor * snoop_scb,
181 				  struct dsp_scb_descriptor * parent_scb,
182 				  int scb_child_type);
183 struct dsp_pcm_channel_descriptor *
184 cs46xx_dsp_create_pcm_channel (struct snd_cs46xx * chip, u32 sample_rate,
185 			       void * private_data, u32 hw_dma_addr,
186 			       int pcm_channel_id);
187 void cs46xx_dsp_destroy_pcm_channel (struct snd_cs46xx * chip,
188 				     struct dsp_pcm_channel_descriptor * pcm_channel);
189 int cs46xx_dsp_pcm_unlink (struct snd_cs46xx * chip,
190 			   struct dsp_pcm_channel_descriptor * pcm_channel);
191 int cs46xx_dsp_pcm_link (struct snd_cs46xx * chip,
192 			 struct dsp_pcm_channel_descriptor * pcm_channel);
193 struct dsp_scb_descriptor *
194 cs46xx_add_record_source (struct snd_cs46xx *chip, struct dsp_scb_descriptor * source,
195 			  u16 addr, char * scb_name);
196 int cs46xx_src_unlink(struct snd_cs46xx *chip, struct dsp_scb_descriptor * src);
197 int cs46xx_src_link(struct snd_cs46xx *chip, struct dsp_scb_descriptor * src);
198 int cs46xx_iec958_pre_open (struct snd_cs46xx *chip);
199 int cs46xx_iec958_post_close (struct snd_cs46xx *chip);
200 int cs46xx_dsp_pcm_channel_set_period (struct snd_cs46xx * chip,
201 				       struct dsp_pcm_channel_descriptor * pcm_channel,
202 				       int period_size);
203 int cs46xx_dsp_pcm_ostream_set_period (struct snd_cs46xx * chip, int period_size);
204 int cs46xx_dsp_set_dac_volume (struct snd_cs46xx * chip, u16 left, u16 right);
205 int cs46xx_dsp_set_iec958_volume (struct snd_cs46xx * chip, u16 left, u16 right);
206 #endif /* __CS46XX_LIB_H__ */
207