xref: /openbmc/linux/sound/pci/ymfpci/ymfpci.h (revision 11696c5e)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 #ifndef __SOUND_YMFPCI_H
3 #define __SOUND_YMFPCI_H
4 
5 /*
6  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
7  *  Definitions for Yahama YMF724/740/744/754 chips
8  */
9 
10 #include <sound/pcm.h>
11 #include <sound/rawmidi.h>
12 #include <sound/ac97_codec.h>
13 #include <sound/timer.h>
14 #include <linux/gameport.h>
15 
16 /*
17  *  Direct registers
18  */
19 
20 #define YMFREG(chip, reg)		(chip->port + YDSXGR_##reg)
21 
22 #define	YDSXGR_INTFLAG			0x0004
23 #define	YDSXGR_ACTIVITY			0x0006
24 #define	YDSXGR_GLOBALCTRL		0x0008
25 #define	YDSXGR_ZVCTRL			0x000A
26 #define	YDSXGR_TIMERCTRL		0x0010
27 #define	YDSXGR_TIMERCOUNT		0x0012
28 #define	YDSXGR_SPDIFOUTCTRL		0x0018
29 #define	YDSXGR_SPDIFOUTSTATUS		0x001C
30 #define	YDSXGR_EEPROMCTRL		0x0020
31 #define	YDSXGR_SPDIFINCTRL		0x0034
32 #define	YDSXGR_SPDIFINSTATUS		0x0038
33 #define	YDSXGR_DSPPROGRAMDL		0x0048
34 #define	YDSXGR_DLCNTRL			0x004C
35 #define	YDSXGR_GPIOININTFLAG		0x0050
36 #define	YDSXGR_GPIOININTENABLE		0x0052
37 #define	YDSXGR_GPIOINSTATUS		0x0054
38 #define	YDSXGR_GPIOOUTCTRL		0x0056
39 #define	YDSXGR_GPIOFUNCENABLE		0x0058
40 #define	YDSXGR_GPIOTYPECONFIG		0x005A
41 #define	YDSXGR_AC97CMDDATA		0x0060
42 #define	YDSXGR_AC97CMDADR		0x0062
43 #define	YDSXGR_PRISTATUSDATA		0x0064
44 #define	YDSXGR_PRISTATUSADR		0x0066
45 #define	YDSXGR_SECSTATUSDATA		0x0068
46 #define	YDSXGR_SECSTATUSADR		0x006A
47 #define	YDSXGR_SECCONFIG		0x0070
48 #define	YDSXGR_LEGACYOUTVOL		0x0080
49 #define	YDSXGR_LEGACYOUTVOLL		0x0080
50 #define	YDSXGR_LEGACYOUTVOLR		0x0082
51 #define	YDSXGR_NATIVEDACOUTVOL		0x0084
52 #define	YDSXGR_NATIVEDACOUTVOLL		0x0084
53 #define	YDSXGR_NATIVEDACOUTVOLR		0x0086
54 #define	YDSXGR_ZVOUTVOL			0x0088
55 #define	YDSXGR_ZVOUTVOLL		0x0088
56 #define	YDSXGR_ZVOUTVOLR		0x008A
57 #define	YDSXGR_SECADCOUTVOL		0x008C
58 #define	YDSXGR_SECADCOUTVOLL		0x008C
59 #define	YDSXGR_SECADCOUTVOLR		0x008E
60 #define	YDSXGR_PRIADCOUTVOL		0x0090
61 #define	YDSXGR_PRIADCOUTVOLL		0x0090
62 #define	YDSXGR_PRIADCOUTVOLR		0x0092
63 #define	YDSXGR_LEGACYLOOPVOL		0x0094
64 #define	YDSXGR_LEGACYLOOPVOLL		0x0094
65 #define	YDSXGR_LEGACYLOOPVOLR		0x0096
66 #define	YDSXGR_NATIVEDACLOOPVOL		0x0098
67 #define	YDSXGR_NATIVEDACLOOPVOLL	0x0098
68 #define	YDSXGR_NATIVEDACLOOPVOLR	0x009A
69 #define	YDSXGR_ZVLOOPVOL		0x009C
70 #define	YDSXGR_ZVLOOPVOLL		0x009E
71 #define	YDSXGR_ZVLOOPVOLR		0x009E
72 #define	YDSXGR_SECADCLOOPVOL		0x00A0
73 #define	YDSXGR_SECADCLOOPVOLL		0x00A0
74 #define	YDSXGR_SECADCLOOPVOLR		0x00A2
75 #define	YDSXGR_PRIADCLOOPVOL		0x00A4
76 #define	YDSXGR_PRIADCLOOPVOLL		0x00A4
77 #define	YDSXGR_PRIADCLOOPVOLR		0x00A6
78 #define	YDSXGR_NATIVEADCINVOL		0x00A8
79 #define	YDSXGR_NATIVEADCINVOLL		0x00A8
80 #define	YDSXGR_NATIVEADCINVOLR		0x00AA
81 #define	YDSXGR_NATIVEDACINVOL		0x00AC
82 #define	YDSXGR_NATIVEDACINVOLL		0x00AC
83 #define	YDSXGR_NATIVEDACINVOLR		0x00AE
84 #define	YDSXGR_BUF441OUTVOL		0x00B0
85 #define	YDSXGR_BUF441OUTVOLL		0x00B0
86 #define	YDSXGR_BUF441OUTVOLR		0x00B2
87 #define	YDSXGR_BUF441LOOPVOL		0x00B4
88 #define	YDSXGR_BUF441LOOPVOLL		0x00B4
89 #define	YDSXGR_BUF441LOOPVOLR		0x00B6
90 #define	YDSXGR_SPDIFOUTVOL		0x00B8
91 #define	YDSXGR_SPDIFOUTVOLL		0x00B8
92 #define	YDSXGR_SPDIFOUTVOLR		0x00BA
93 #define	YDSXGR_SPDIFLOOPVOL		0x00BC
94 #define	YDSXGR_SPDIFLOOPVOLL		0x00BC
95 #define	YDSXGR_SPDIFLOOPVOLR		0x00BE
96 #define	YDSXGR_ADCSLOTSR		0x00C0
97 #define	YDSXGR_RECSLOTSR		0x00C4
98 #define	YDSXGR_ADCFORMAT		0x00C8
99 #define	YDSXGR_RECFORMAT		0x00CC
100 #define	YDSXGR_P44SLOTSR		0x00D0
101 #define	YDSXGR_STATUS			0x0100
102 #define	YDSXGR_CTRLSELECT		0x0104
103 #define	YDSXGR_MODE			0x0108
104 #define	YDSXGR_SAMPLECOUNT		0x010C
105 #define	YDSXGR_NUMOFSAMPLES		0x0110
106 #define	YDSXGR_CONFIG			0x0114
107 #define	YDSXGR_PLAYCTRLSIZE		0x0140
108 #define	YDSXGR_RECCTRLSIZE		0x0144
109 #define	YDSXGR_EFFCTRLSIZE		0x0148
110 #define	YDSXGR_WORKSIZE			0x014C
111 #define	YDSXGR_MAPOFREC			0x0150
112 #define	YDSXGR_MAPOFEFFECT		0x0154
113 #define	YDSXGR_PLAYCTRLBASE		0x0158
114 #define	YDSXGR_RECCTRLBASE		0x015C
115 #define	YDSXGR_EFFCTRLBASE		0x0160
116 #define	YDSXGR_WORKBASE			0x0164
117 #define	YDSXGR_DSPINSTRAM		0x1000
118 #define	YDSXGR_CTRLINSTRAM		0x4000
119 
120 #define YDSXG_AC97READCMD		0x8000
121 #define YDSXG_AC97WRITECMD		0x0000
122 
123 #define PCIR_DSXG_LEGACY		0x40
124 #define PCIR_DSXG_ELEGACY		0x42
125 #define PCIR_DSXG_CTRL			0x48
126 #define PCIR_DSXG_PWRCTRL1		0x4a
127 #define PCIR_DSXG_PWRCTRL2		0x4e
128 #define PCIR_DSXG_FMBASE		0x60
129 #define PCIR_DSXG_SBBASE		0x62
130 #define PCIR_DSXG_MPU401BASE		0x64
131 #define PCIR_DSXG_JOYBASE		0x66
132 
133 #define YDSXG_DSPLENGTH			0x0080
134 #define YDSXG_CTRLLENGTH		0x3000
135 
136 #define YDSXG_DEFAULT_WORK_SIZE		0x0400
137 
138 #define YDSXG_PLAYBACK_VOICES		64
139 #define YDSXG_CAPTURE_VOICES		2
140 #define YDSXG_EFFECT_VOICES		5
141 
142 #define YMFPCI_LEGACY_SBEN	(1 << 0)	/* soundblaster enable */
143 #define YMFPCI_LEGACY_FMEN	(1 << 1)	/* OPL3 enable */
144 #define YMFPCI_LEGACY_JPEN	(1 << 2)	/* joystick enable */
145 #define YMFPCI_LEGACY_MEN	(1 << 3)	/* MPU401 enable */
146 #define YMFPCI_LEGACY_MIEN	(1 << 4)	/* MPU RX irq enable */
147 #define YMFPCI_LEGACY_IOBITS	(1 << 5)	/* i/o bits range, 0 = 16bit, 1 =10bit */
148 #define YMFPCI_LEGACY_SDMA	(3 << 6)	/* SB DMA select */
149 #define YMFPCI_LEGACY_SBIRQ	(7 << 8)	/* SB IRQ select */
150 #define YMFPCI_LEGACY_MPUIRQ	(7 << 11)	/* MPU IRQ select */
151 #define YMFPCI_LEGACY_SIEN	(1 << 14)	/* serialized IRQ */
152 #define YMFPCI_LEGACY_LAD	(1 << 15)	/* legacy audio disable */
153 
154 #define YMFPCI_LEGACY2_FMIO	(3 << 0)	/* OPL3 i/o address (724/740) */
155 #define YMFPCI_LEGACY2_SBIO	(3 << 2)	/* SB i/o address (724/740) */
156 #define YMFPCI_LEGACY2_MPUIO	(3 << 4)	/* MPU401 i/o address (724/740) */
157 #define YMFPCI_LEGACY2_JSIO	(3 << 6)	/* joystick i/o address (724/740) */
158 #define YMFPCI_LEGACY2_MAIM	(1 << 8)	/* MPU401 ack intr mask */
159 #define YMFPCI_LEGACY2_SMOD	(3 << 11)	/* SB DMA mode */
160 #define YMFPCI_LEGACY2_SBVER	(3 << 13)	/* SB version select */
161 #define YMFPCI_LEGACY2_IMOD	(1 << 15)	/* legacy IRQ mode */
162 /* SIEN:IMOD 0:0 = legacy irq, 0:1 = INTA, 1:0 = serialized IRQ */
163 
164 #if IS_REACHABLE(CONFIG_GAMEPORT)
165 #define SUPPORT_JOYSTICK
166 #endif
167 
168 /*
169  *
170  */
171 
172 struct snd_ymfpci_playback_bank {
173 	__le32 format;
174 	__le32 loop_default;
175 	__le32 base;			/* 32-bit address */
176 	__le32 loop_start;		/* 32-bit offset */
177 	__le32 loop_end;		/* 32-bit offset */
178 	__le32 loop_frac;		/* 8-bit fraction - loop_start */
179 	__le32 delta_end;		/* pitch delta end */
180 	__le32 lpfK_end;
181 	__le32 eg_gain_end;
182 	__le32 left_gain_end;
183 	__le32 right_gain_end;
184 	__le32 eff1_gain_end;
185 	__le32 eff2_gain_end;
186 	__le32 eff3_gain_end;
187 	__le32 lpfQ;
188 	__le32 status;
189 	__le32 num_of_frames;
190 	__le32 loop_count;
191 	__le32 start;
192 	__le32 start_frac;
193 	__le32 delta;
194 	__le32 lpfK;
195 	__le32 eg_gain;
196 	__le32 left_gain;
197 	__le32 right_gain;
198 	__le32 eff1_gain;
199 	__le32 eff2_gain;
200 	__le32 eff3_gain;
201 	__le32 lpfD1;
202 	__le32 lpfD2;
203  };
204 
205 struct snd_ymfpci_capture_bank {
206 	__le32 base;			/* 32-bit address */
207 	__le32 loop_end;		/* 32-bit offset */
208 	__le32 start;			/* 32-bit offset */
209 	__le32 num_of_loops;		/* counter */
210 };
211 
212 struct snd_ymfpci_effect_bank {
213 	__le32 base;			/* 32-bit address */
214 	__le32 loop_end;		/* 32-bit offset */
215 	__le32 start;			/* 32-bit offset */
216 	__le32 temp;
217 };
218 
219 struct snd_ymfpci_pcm;
220 struct snd_ymfpci;
221 
222 enum snd_ymfpci_voice_type {
223 	YMFPCI_PCM,
224 	YMFPCI_SYNTH,
225 	YMFPCI_MIDI
226 };
227 
228 struct snd_ymfpci_voice {
229 	struct snd_ymfpci *chip;
230 	int number;
231 	unsigned int use: 1,
232 	    pcm: 1,
233 	    synth: 1,
234 	    midi: 1;
235 	struct snd_ymfpci_playback_bank *bank;
236 	dma_addr_t bank_addr;
237 	void (*interrupt)(struct snd_ymfpci *chip, struct snd_ymfpci_voice *voice);
238 	struct snd_ymfpci_pcm *ypcm;
239 };
240 
241 enum snd_ymfpci_pcm_type {
242 	PLAYBACK_VOICE,
243 	CAPTURE_REC,
244 	CAPTURE_AC97,
245 	EFFECT_DRY_LEFT,
246 	EFFECT_DRY_RIGHT,
247 	EFFECT_EFF1,
248 	EFFECT_EFF2,
249 	EFFECT_EFF3
250 };
251 
252 struct snd_ymfpci_pcm {
253 	struct snd_ymfpci *chip;
254 	enum snd_ymfpci_pcm_type type;
255 	struct snd_pcm_substream *substream;
256 	struct snd_ymfpci_voice *voices[2];	/* playback only */
257 	unsigned int running: 1,
258 		     use_441_slot: 1,
259 	             output_front: 1,
260 	             output_rear: 1,
261 	             swap_rear: 1;
262 	unsigned int update_pcm_vol;
263 	u32 period_size;		/* cached from runtime->period_size */
264 	u32 buffer_size;		/* cached from runtime->buffer_size */
265 	u32 period_pos;
266 	u32 last_pos;
267 	u32 capture_bank_number;
268 	u32 shift;
269 };
270 
271 static const int saved_regs_index[] = {
272 	/* spdif */
273 	YDSXGR_SPDIFOUTCTRL,
274 	YDSXGR_SPDIFOUTSTATUS,
275 	YDSXGR_SPDIFINCTRL,
276 	/* volumes */
277 	YDSXGR_PRIADCLOOPVOL,
278 	YDSXGR_NATIVEDACINVOL,
279 	YDSXGR_NATIVEDACOUTVOL,
280 	YDSXGR_BUF441OUTVOL,
281 	YDSXGR_NATIVEADCINVOL,
282 	YDSXGR_SPDIFLOOPVOL,
283 	YDSXGR_SPDIFOUTVOL,
284 	YDSXGR_ZVOUTVOL,
285 	YDSXGR_LEGACYOUTVOL,
286 	/* address bases */
287 	YDSXGR_PLAYCTRLBASE,
288 	YDSXGR_RECCTRLBASE,
289 	YDSXGR_EFFCTRLBASE,
290 	YDSXGR_WORKBASE,
291 	/* capture set up */
292 	YDSXGR_MAPOFREC,
293 	YDSXGR_RECFORMAT,
294 	YDSXGR_RECSLOTSR,
295 	YDSXGR_ADCFORMAT,
296 	YDSXGR_ADCSLOTSR,
297 };
298 #define YDSXGR_NUM_SAVED_REGS	ARRAY_SIZE(saved_regs_index)
299 
300 static const int pci_saved_regs_index[] = {
301 	/* All Chips */
302 	PCIR_DSXG_LEGACY,
303 	PCIR_DSXG_ELEGACY,
304 	/* YMF 744/754 */
305 	PCIR_DSXG_FMBASE,
306 	PCIR_DSXG_SBBASE,
307 	PCIR_DSXG_MPU401BASE,
308 	PCIR_DSXG_JOYBASE,
309 };
310 #define DSXG_PCI_NUM_SAVED_REGS	ARRAY_SIZE(pci_saved_regs_index)
311 #define DSXG_PCI_NUM_SAVED_LEGACY_REGS	2
312 static_assert(DSXG_PCI_NUM_SAVED_LEGACY_REGS <= DSXG_PCI_NUM_SAVED_REGS);
313 
314 struct snd_ymfpci {
315 	int irq;
316 
317 	unsigned int device_id;	/* PCI device ID */
318 	unsigned char rev;	/* PCI revision */
319 	unsigned long reg_area_phys;
320 	void __iomem *reg_area_virt;
321 
322 	u16 old_legacy_ctrl;
323 #ifdef SUPPORT_JOYSTICK
324 	struct gameport *gameport;
325 #endif
326 
327 	struct snd_dma_buffer *work_ptr;
328 
329 	unsigned int bank_size_playback;
330 	unsigned int bank_size_capture;
331 	unsigned int bank_size_effect;
332 	unsigned int work_size;
333 
334 	void *bank_base_playback;
335 	void *bank_base_capture;
336 	void *bank_base_effect;
337 	void *work_base;
338 	dma_addr_t bank_base_playback_addr;
339 	dma_addr_t bank_base_capture_addr;
340 	dma_addr_t bank_base_effect_addr;
341 	dma_addr_t work_base_addr;
342 	struct snd_dma_buffer ac3_tmp_base;
343 
344 	__le32 *ctrl_playback;
345 	struct snd_ymfpci_playback_bank *bank_playback[YDSXG_PLAYBACK_VOICES][2];
346 	struct snd_ymfpci_capture_bank *bank_capture[YDSXG_CAPTURE_VOICES][2];
347 	struct snd_ymfpci_effect_bank *bank_effect[YDSXG_EFFECT_VOICES][2];
348 
349 	int start_count;
350 
351 	u32 active_bank;
352 	struct snd_ymfpci_voice voices[64];
353 	int src441_used;
354 
355 	struct snd_ac97_bus *ac97_bus;
356 	struct snd_ac97 *ac97;
357 	struct snd_rawmidi *rawmidi;
358 	struct snd_timer *timer;
359 	unsigned int timer_ticks;
360 
361 	struct pci_dev *pci;
362 	struct snd_card *card;
363 	struct snd_pcm *pcm;
364 	struct snd_pcm *pcm2;
365 	struct snd_pcm *pcm_spdif;
366 	struct snd_pcm *pcm_4ch;
367 	struct snd_pcm_substream *capture_substream[YDSXG_CAPTURE_VOICES];
368 	struct snd_pcm_substream *effect_substream[YDSXG_EFFECT_VOICES];
369 	struct snd_kcontrol *ctl_vol_recsrc;
370 	struct snd_kcontrol *ctl_vol_adcrec;
371 	struct snd_kcontrol *ctl_vol_spdifrec;
372 	unsigned short spdif_bits, spdif_pcm_bits;
373 	struct snd_kcontrol *spdif_pcm_ctl;
374 	int mode_dup4ch;
375 	int rear_opened;
376 	int spdif_opened;
377 	struct snd_ymfpci_pcm_mixer {
378 		u16 left;
379 		u16 right;
380 		struct snd_kcontrol *ctl;
381 	} pcm_mixer[32];
382 
383 	spinlock_t reg_lock;
384 	spinlock_t voice_lock;
385 	wait_queue_head_t interrupt_sleep;
386 	atomic_t interrupt_sleep_count;
387 	struct snd_info_entry *proc_entry;
388 	const struct firmware *dsp_microcode;
389 	const struct firmware *controller_microcode;
390 
391 	u32 saved_regs[YDSXGR_NUM_SAVED_REGS];
392 	u32 saved_ydsxgr_mode;
393 	u16 saved_dsxg_pci_regs[DSXG_PCI_NUM_SAVED_REGS];
394 };
395 
396 int snd_ymfpci_create(struct snd_card *card,
397 		      struct pci_dev *pci,
398 		      u16 old_legacy_ctrl);
399 void snd_ymfpci_free_gameport(struct snd_ymfpci *chip);
400 
401 extern const struct dev_pm_ops snd_ymfpci_pm;
402 
403 int snd_ymfpci_pcm(struct snd_ymfpci *chip, int device);
404 int snd_ymfpci_pcm2(struct snd_ymfpci *chip, int device);
405 int snd_ymfpci_pcm_spdif(struct snd_ymfpci *chip, int device);
406 int snd_ymfpci_pcm_4ch(struct snd_ymfpci *chip, int device);
407 int snd_ymfpci_mixer(struct snd_ymfpci *chip, int rear_switch);
408 int snd_ymfpci_timer(struct snd_ymfpci *chip, int device);
409 
410 #endif /* __SOUND_YMFPCI_H */
411