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 172struct 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 205struct 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 212struct 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 219struct snd_ymfpci_pcm; 220struct snd_ymfpci; 221 222enum snd_ymfpci_voice_type { 223 YMFPCI_PCM, 224 YMFPCI_SYNTH, 225 YMFPCI_MIDI 226}; 227 228struct 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 241enum 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 252struct 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 271static 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 300static 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 312static_assert(DSXG_PCI_NUM_SAVED_LEGACY_REGS <= DSXG_PCI_NUM_SAVED_REGS); 313 314struct 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 396int snd_ymfpci_create(struct snd_card *card, 397 struct pci_dev *pci, 398 u16 old_legacy_ctrl); 399void snd_ymfpci_free_gameport(struct snd_ymfpci *chip); 400 401extern const struct dev_pm_ops snd_ymfpci_pm; 402 403int snd_ymfpci_pcm(struct snd_ymfpci *chip, int device); 404int snd_ymfpci_pcm2(struct snd_ymfpci *chip, int device); 405int snd_ymfpci_pcm_spdif(struct snd_ymfpci *chip, int device); 406int snd_ymfpci_pcm_4ch(struct snd_ymfpci *chip, int device); 407int snd_ymfpci_mixer(struct snd_ymfpci *chip, int rear_switch); 408int snd_ymfpci_timer(struct snd_ymfpci *chip, int device); 409 410#endif /* __SOUND_YMFPCI_H */ 411