1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  *  The driver for the Cirrus Logic's Sound Fusion CS46XX based soundcards
4  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
5  */
6 
7 #ifndef __CS46XX_LIB_H__
8 #define __CS46XX_LIB_H__
9 
10 /*
11  *  constants
12  */
13 
14 #define CS46XX_BA0_SIZE		  0x1000
15 #define CS46XX_BA1_DATA0_SIZE 0x3000
16 #define CS46XX_BA1_DATA1_SIZE 0x3800
17 #define CS46XX_BA1_PRG_SIZE	  0x7000
18 #define CS46XX_BA1_REG_SIZE	  0x0100
19 
20 
21 
22 #ifdef CONFIG_SND_CS46XX_NEW_DSP
23 #define CS46XX_MIN_PERIOD_SIZE 64
24 #define CS46XX_MAX_PERIOD_SIZE 1024*1024
25 #else
26 #define CS46XX_MIN_PERIOD_SIZE 2048
27 #define CS46XX_MAX_PERIOD_SIZE 2048
28 #endif
29 
30 #define CS46XX_FRAGS 2
31 /* #define CS46XX_BUFFER_SIZE CS46XX_MAX_PERIOD_SIZE * CS46XX_FRAGS */
32 
33 #define SCB_NO_PARENT             0
34 #define SCB_ON_PARENT_NEXT_SCB    1
35 #define SCB_ON_PARENT_SUBLIST_SCB 2
36 
37 /* 3*1024 parameter, 3.5*1024 sample, 2*3.5*1024 code */
38 #define BA1_DWORD_SIZE		(13 * 1024 + 512)
39 #define BA1_MEMORY_COUNT	3
40 
41 /*
42  *  common I/O routines
43  */
44 
snd_cs46xx_poke(struct snd_cs46xx * chip,unsigned long reg,unsigned int val)45 static inline void snd_cs46xx_poke(struct snd_cs46xx *chip, unsigned long reg, unsigned int val)
46 {
47 	unsigned int bank = reg >> 16;
48 	unsigned int offset = reg & 0xffff;
49 
50 	/*
51 	if (bank == 0)
52 		printk(KERN_DEBUG "snd_cs46xx_poke: %04X - %08X\n",
53 		       reg >> 2,val);
54 	*/
55 	writel(val, chip->region.idx[bank+1].remap_addr + offset);
56 }
57 
snd_cs46xx_peek(struct snd_cs46xx * chip,unsigned long reg)58 static inline unsigned int snd_cs46xx_peek(struct snd_cs46xx *chip, unsigned long reg)
59 {
60 	unsigned int bank = reg >> 16;
61 	unsigned int offset = reg & 0xffff;
62 	return readl(chip->region.idx[bank+1].remap_addr + offset);
63 }
64 
snd_cs46xx_pokeBA0(struct snd_cs46xx * chip,unsigned long offset,unsigned int val)65 static inline void snd_cs46xx_pokeBA0(struct snd_cs46xx *chip, unsigned long offset, unsigned int val)
66 {
67 	writel(val, chip->region.name.ba0.remap_addr + offset);
68 }
69 
snd_cs46xx_peekBA0(struct snd_cs46xx * chip,unsigned long offset)70 static inline unsigned int snd_cs46xx_peekBA0(struct snd_cs46xx *chip, unsigned long offset)
71 {
72 	return readl(chip->region.name.ba0.remap_addr + offset);
73 }
74 
75 struct dsp_spos_instance *cs46xx_dsp_spos_create (struct snd_cs46xx * chip);
76 void cs46xx_dsp_spos_destroy (struct snd_cs46xx * chip);
77 int cs46xx_dsp_load_module (struct snd_cs46xx * chip, struct dsp_module_desc * module);
78 #ifdef CONFIG_PM_SLEEP
79 int cs46xx_dsp_resume(struct snd_cs46xx * chip);
80 #endif
81 struct dsp_symbol_entry *cs46xx_dsp_lookup_symbol (struct snd_cs46xx * chip, char * symbol_name,
82 						   int symbol_type);
83 #ifdef CONFIG_SND_PROC_FS
84 int cs46xx_dsp_proc_init (struct snd_card *card, struct snd_cs46xx *chip);
85 int cs46xx_dsp_proc_done (struct snd_cs46xx *chip);
86 #else
87 #define cs46xx_dsp_proc_init(card, chip)
88 #define cs46xx_dsp_proc_done(chip)
89 #endif
90 int cs46xx_dsp_scb_and_task_init (struct snd_cs46xx *chip);
91 int snd_cs46xx_download (struct snd_cs46xx *chip, u32 *src, unsigned long offset,
92 			 unsigned long len);
93 int snd_cs46xx_clear_BA1(struct snd_cs46xx *chip, unsigned long offset, unsigned long len);
94 int cs46xx_dsp_enable_spdif_out (struct snd_cs46xx *chip);
95 int cs46xx_dsp_enable_spdif_hw (struct snd_cs46xx *chip);
96 int cs46xx_dsp_disable_spdif_out (struct snd_cs46xx *chip);
97 int cs46xx_dsp_enable_spdif_in (struct snd_cs46xx *chip);
98 int cs46xx_dsp_disable_spdif_in (struct snd_cs46xx *chip);
99 int cs46xx_dsp_enable_pcm_capture (struct snd_cs46xx *chip);
100 int cs46xx_dsp_disable_pcm_capture (struct snd_cs46xx *chip);
101 int cs46xx_dsp_enable_adc_capture (struct snd_cs46xx *chip);
102 int cs46xx_dsp_disable_adc_capture (struct snd_cs46xx *chip);
103 int cs46xx_poke_via_dsp (struct snd_cs46xx *chip, u32 address, u32 data);
104 struct dsp_scb_descriptor * cs46xx_dsp_create_scb (struct snd_cs46xx *chip, char * name,
105 						   u32 * scb_data, u32 dest);
106 #ifdef CONFIG_SND_PROC_FS
107 void cs46xx_dsp_proc_free_scb_desc (struct dsp_scb_descriptor * scb);
108 void cs46xx_dsp_proc_register_scb_desc (struct snd_cs46xx *chip,
109 					struct dsp_scb_descriptor * scb);
110 #else
111 #define cs46xx_dsp_proc_free_scb_desc(scb)
112 #define cs46xx_dsp_proc_register_scb_desc(chip, scb)
113 #endif
114 struct dsp_scb_descriptor * cs46xx_dsp_create_timing_master_scb (struct snd_cs46xx *chip);
115 struct dsp_scb_descriptor *
116 cs46xx_dsp_create_codec_out_scb(struct snd_cs46xx * chip,
117 				char * codec_name, u16 channel_disp, u16 fifo_addr,
118 				u16 child_scb_addr, u32 dest,
119 				struct dsp_scb_descriptor * parent_scb,
120 				int scb_child_type);
121 struct dsp_scb_descriptor *
122 cs46xx_dsp_create_codec_in_scb(struct snd_cs46xx * chip, char * codec_name,
123 			       u16 channel_disp, u16 fifo_addr,
124 			       u16 sample_buffer_addr, u32 dest,
125 			       struct dsp_scb_descriptor * parent_scb,
126 			       int scb_child_type);
127 void cs46xx_dsp_remove_scb (struct snd_cs46xx *chip,
128 			    struct dsp_scb_descriptor * scb);
129 struct dsp_scb_descriptor *
130 cs46xx_dsp_create_codec_in_scb(struct snd_cs46xx * chip, char * codec_name,
131 			       u16 channel_disp, u16 fifo_addr,
132 			       u16 sample_buffer_addr, u32 dest,
133 			       struct dsp_scb_descriptor * parent_scb,
134 			       int scb_child_type);
135 struct dsp_scb_descriptor *
136 cs46xx_dsp_create_src_task_scb(struct snd_cs46xx * chip, char * scb_name,
137 			       int sample_rate, u16 src_buffer_addr,
138 			       u16 src_delay_buffer_addr, u32 dest,
139 			       struct dsp_scb_descriptor * parent_scb,
140 			       int scb_child_type, int pass_through);
141 struct dsp_scb_descriptor *
142 cs46xx_dsp_create_mix_only_scb(struct snd_cs46xx * chip, char * scb_name,
143 			       u16 mix_buffer_addr, u32 dest,
144 			       struct dsp_scb_descriptor * parent_scb,
145 			       int scb_child_type);
146 
147 struct dsp_scb_descriptor *
148 cs46xx_dsp_create_vari_decimate_scb(struct snd_cs46xx * chip, char * scb_name,
149 				    u16 vari_buffer_addr0, u16 vari_buffer_addr1, u32 dest,
150 				    struct dsp_scb_descriptor * parent_scb,
151 				    int scb_child_type);
152 struct dsp_scb_descriptor *
153 cs46xx_dsp_create_asynch_fg_rx_scb(struct snd_cs46xx * chip, char * scb_name,
154 				   u32 dest, u16 hfg_scb_address, u16 asynch_buffer_address,
155 				   struct dsp_scb_descriptor * parent_scb,
156 				   int scb_child_type);
157 struct dsp_scb_descriptor *
158 cs46xx_dsp_create_spio_write_scb(struct snd_cs46xx * chip, char * scb_name, u32 dest,
159 				 struct dsp_scb_descriptor * parent_scb,
160 				 int scb_child_type);
161 struct dsp_scb_descriptor *
162 cs46xx_dsp_create_mix_to_ostream_scb(struct snd_cs46xx * chip, char * scb_name,
163 				     u16 mix_buffer_addr, u16 writeback_spb, u32 dest,
164 				     struct dsp_scb_descriptor * parent_scb,
165 				     int scb_child_type);
166 struct dsp_scb_descriptor *
167 cs46xx_dsp_create_magic_snoop_scb(struct snd_cs46xx * chip, char * scb_name,
168 				  u32 dest, u16 snoop_buffer_address,
169 				  struct dsp_scb_descriptor * snoop_scb,
170 				  struct dsp_scb_descriptor * parent_scb,
171 				  int scb_child_type);
172 struct dsp_pcm_channel_descriptor *
173 cs46xx_dsp_create_pcm_channel (struct snd_cs46xx * chip, u32 sample_rate,
174 			       void * private_data, u32 hw_dma_addr,
175 			       int pcm_channel_id);
176 void cs46xx_dsp_destroy_pcm_channel (struct snd_cs46xx * chip,
177 				     struct dsp_pcm_channel_descriptor * pcm_channel);
178 int cs46xx_dsp_pcm_unlink (struct snd_cs46xx * chip,
179 			   struct dsp_pcm_channel_descriptor * pcm_channel);
180 int cs46xx_dsp_pcm_link (struct snd_cs46xx * chip,
181 			 struct dsp_pcm_channel_descriptor * pcm_channel);
182 struct dsp_scb_descriptor *
183 cs46xx_add_record_source (struct snd_cs46xx *chip, struct dsp_scb_descriptor * source,
184 			  u16 addr, char * scb_name);
185 int cs46xx_src_unlink(struct snd_cs46xx *chip, struct dsp_scb_descriptor * src);
186 int cs46xx_src_link(struct snd_cs46xx *chip, struct dsp_scb_descriptor * src);
187 int cs46xx_iec958_pre_open (struct snd_cs46xx *chip);
188 int cs46xx_iec958_post_close (struct snd_cs46xx *chip);
189 int cs46xx_dsp_pcm_channel_set_period (struct snd_cs46xx * chip,
190 				       struct dsp_pcm_channel_descriptor * pcm_channel,
191 				       int period_size);
192 int cs46xx_dsp_pcm_ostream_set_period (struct snd_cs46xx * chip, int period_size);
193 int cs46xx_dsp_set_dac_volume (struct snd_cs46xx * chip, u16 left, u16 right);
194 int cs46xx_dsp_set_iec958_volume (struct snd_cs46xx * chip, u16 left, u16 right);
195 #endif /* __CS46XX_LIB_H__ */
196