sound/pci/au88x0/au88x0.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  */
   4
   5 #ifndef __SOUND_AU88X0_H
   6 #define __SOUND_AU88X0_H
   7
   8 #include <linux/pci.h>
   9 #include <linux/io.h>
  10 #include <sound/core.h>
  11 #include <sound/pcm.h>
  12 #include <sound/rawmidi.h>
  13 #include <sound/mpu401.h>
  14 #include <sound/hwdep.h>
  15 #include <sound/ac97_codec.h>
  16 #include <sound/tlv.h>
  17
  18 #ifndef CHIP_AU8820
  19 #include "au88x0_eq.h"
  20 #include "au88x0_a3d.h"
  21 #endif
  22 #ifndef CHIP_AU8810
  23 #include "au88x0_wt.h"
  24 #endif
  25
  26 #define hwread(x,y) readl((x)+(y))
  27 #define hwwrite(x,y,z) writel((z),(x)+(y))
  28
  29 /* Vortex MPU401 defines. */
  30 #define MIDI_CLOCK_DIV          0x61
  31 /* Standart MPU401 defines. */
  32 #define MPU401_RESET            0xff
  33 #define MPU401_ENTER_UART       0x3f
  34 #define MPU401_ACK              0xfe
  35
  36 // Get src register value to convert from x to y.
  37 #define SRC_RATIO(x,y)          ((((x<<15)/y) + 1)/2)
  38
  39 /* FIFO software state constants. */
  40 #define FIFO_STOP 0
  41 #define FIFO_START 1
  42 #define FIFO_PAUSE 2
  43
  44 /* IRQ flags */
  45 #define IRQ_ERR_MASK    0x00ff
  46 #define IRQ_FATAL       0x0001
  47 #define IRQ_PARITY      0x0002
  48 #define IRQ_REG         0x0004
  49 #define IRQ_FIFO        0x0008
  50 #define IRQ_DMA         0x0010
  51 #define IRQ_PCMOUT      0x0020  /* PCM OUT page crossing */
  52 #define IRQ_TIMER       0x1000
  53 #define IRQ_MIDI        0x2000
  54 #define IRQ_MODEM       0x4000
  55
  56 /* ADB Resource */
  57 #define VORTEX_RESOURCE_DMA     0x00000000
  58 #define VORTEX_RESOURCE_SRC     0x00000001
  59 #define VORTEX_RESOURCE_MIXIN   0x00000002
  60 #define VORTEX_RESOURCE_MIXOUT  0x00000003
  61 #define VORTEX_RESOURCE_A3D     0x00000004
  62 #define VORTEX_RESOURCE_LAST    0x00000005
  63
  64 /* codec io: VORTEX_CODEC_IO bits */
  65 #define VORTEX_CODEC_ID_SHIFT   24
  66 #define VORTEX_CODEC_WRITE      0x00800000
  67 #define VORTEX_CODEC_ADDSHIFT   16
  68 #define VORTEX_CODEC_ADDMASK    0x7f0000
  69 #define VORTEX_CODEC_DATSHIFT   0
  70 #define VORTEX_CODEC_DATMASK    0xffff
  71
  72 /* Check for SDAC bit in "Extended audio ID" AC97 register */
  73 //#define VORTEX_IS_QUAD(x) (((x)->codec == NULL) ?  0 : ((x)->codec->ext_id&0x80))
  74 #define VORTEX_IS_QUAD(x) ((x)->isquad)
  75 /* Check if chip has bug. */
  76 #define IS_BAD_CHIP(x) (\
  77         (x->rev == 0xfe && x->device == PCI_DEVICE_ID_AUREAL_VORTEX_2) || \
  78         (x->rev == 0xfe && x->device == PCI_DEVICE_ID_AUREAL_ADVANTAGE))
  79
  80
  81 /* PCM devices */
  82 #define VORTEX_PCM_ADB          0
  83 #define VORTEX_PCM_SPDIF        1
  84 #define VORTEX_PCM_A3D          2
  85 #define VORTEX_PCM_WT           3
  86 #define VORTEX_PCM_I2S          4
  87 #define VORTEX_PCM_LAST         5
  88
  89 #define MIX_CAPT(x) (vortex->mixcapt[x])
  90 #define MIX_PLAYB(x) (vortex->mixplayb[x])
  91 #define MIX_SPDIF(x) (vortex->mixspdif[x])
  92
  93 #define NR_WTPB 0x20            /* WT channels per each bank. */
  94 #define NR_PCM  0x10
  95
  96 struct pcm_vol {
  97         struct snd_kcontrol *kctl;
  98         int active;
  99         int dma;
 100         int mixin[4];
 101         int vol[4];
 102 };
 103
 104 /* Structs */
 105 typedef struct {
 106         //int this_08;          /* Still unknown */
 107         int fifo_enabled;       /* this_24 */
 108         int fifo_status;        /* this_1c */
 109         u32 dma_ctrl;           /* this_78 (ADB), this_7c (WT) */
 110         int dma_unknown;        /* this_74 (ADB), this_78 (WT). WDM: +8 */
 111         int cfg0;
 112         int cfg1;
 113
 114         int nr_ch;              /* Nr of PCM channels in use */
 115         int type;               /* Output type (ac97, a3d, spdif, i2s, dsp) */
 116         int dma;                /* Hardware DMA index. */
 117         int dir;                /* Stream Direction. */
 118         u32 resources[5];
 119
 120         /* Virtual page extender stuff */
 121         int nr_periods;
 122         int period_bytes;
 123         int period_real;
 124         int period_virt;
 125
 126         struct snd_pcm_substream *substream;
 127 } stream_t;
 128
 129 typedef struct snd_vortex vortex_t;
 130 struct snd_vortex {
 131         /* ALSA structs. */
 132         struct snd_card *card;
 133         struct snd_pcm *pcm[VORTEX_PCM_LAST];
 134
 135         struct snd_rawmidi *rmidi;      /* Legacy Midi interface. */
 136         struct snd_ac97 *codec;
 137
 138         /* Stream structs. */
 139         stream_t dma_adb[NR_ADB];
 140         int spdif_sr;
 141 #ifndef CHIP_AU8810
 142         stream_t dma_wt[NR_WT];
 143         wt_voice_t wt_voice[NR_WT];     /* WT register cache. */
 144         s8 mixwt[(NR_WT / NR_WTPB) * 6];        /* WT mixin objects */
 145 #endif
 146
 147         /* Global resources */
 148         s8 mixcapt[2];
 149         s8 mixplayb[4];
 150 #ifndef CHIP_AU8820
 151         s8 mixspdif[2];
 152         s8 mixa3d[2];   /* mixers which collect all a3d streams. */
 153         s8 mixxtlk[2];  /* crosstalk canceler mixer inputs. */
 154 #endif
 155         u32 fixed_res[5];
 156
 157 #ifndef CHIP_AU8820
 158         /* Hardware equalizer structs */
 159         eqlzr_t eq;
 160         /* A3D structs */
 161         a3dsrc_t a3d[NR_A3D];
 162         /* Xtalk canceler */
 163         int xt_mode;            /* 1: speakers, 0:headphones. */
 164 #endif
 165         struct pcm_vol pcm_vol[NR_PCM];
 166
 167         int isquad;             /* cache of extended ID codec flag. */
 168
 169         /* Gameport stuff. */
 170         struct gameport *gameport;
 171
 172         /* PCI hardware resources */
 173         unsigned long io;
 174         void __iomem *mmio;
 175         unsigned int irq;
 176         spinlock_t lock;
 177
 178         /* PCI device */
 179         struct pci_dev *pci_dev;
 180         u16 vendor;
 181         u16 device;
 182         u8 rev;
 183 };
 184
 185 /* Functions. */
 186
 187 /* SRC */
 188 static void vortex_adb_setsrc(vortex_t * vortex, int adbdma,
 189                               unsigned int cvrt, int dir);
 190
 191 /* DMA Engines. */
 192 static void vortex_adbdma_setbuffers(vortex_t * vortex, int adbdma,
 193                                      int size, int count);
 194 static void vortex_adbdma_setmode(vortex_t * vortex, int adbdma, int ie,
 195                                   int dir, int fmt, int d,
 196                                   u32 offset);
 197 static void vortex_adbdma_setstartbuffer(vortex_t * vortex, int adbdma, int sb);
 198 #ifndef CHIP_AU8810
 199 static void vortex_wtdma_setbuffers(vortex_t * vortex, int wtdma,
 200                                     int size, int count);
 201 static void vortex_wtdma_setmode(vortex_t * vortex, int wtdma, int ie, int fmt, int d,  /*int e, */
 202                                  u32 offset);
 203 static void vortex_wtdma_setstartbuffer(vortex_t * vortex, int wtdma, int sb);
 204 #endif
 205
 206 static void vortex_adbdma_startfifo(vortex_t * vortex, int adbdma);
 207 //static void vortex_adbdma_stopfifo(vortex_t *vortex, int adbdma);
 208 static void vortex_adbdma_pausefifo(vortex_t * vortex, int adbdma);
 209 static void vortex_adbdma_resumefifo(vortex_t * vortex, int adbdma);
 210 static inline int vortex_adbdma_getlinearpos(vortex_t * vortex, int adbdma);
 211 static void vortex_adbdma_resetup(vortex_t *vortex, int adbdma);
 212
 213 #ifndef CHIP_AU8810
 214 static void vortex_wtdma_startfifo(vortex_t * vortex, int wtdma);
 215 static void vortex_wtdma_stopfifo(vortex_t * vortex, int wtdma);
 216 static void vortex_wtdma_pausefifo(vortex_t * vortex, int wtdma);
 217 static void vortex_wtdma_resumefifo(vortex_t * vortex, int wtdma);
 218 static inline int vortex_wtdma_getlinearpos(vortex_t * vortex, int wtdma);
 219 #endif
 220
 221 /* global stuff. */
 222 static void vortex_codec_init(vortex_t * vortex);
 223 static void vortex_codec_write(struct snd_ac97 * codec, unsigned short addr,
 224                                unsigned short data);
 225 static unsigned short vortex_codec_read(struct snd_ac97 * codec, unsigned short addr);
 226 static void vortex_spdif_init(vortex_t * vortex, int spdif_sr, int spdif_mode);
 227
 228 static int vortex_core_init(vortex_t * card);
 229 static int vortex_core_shutdown(vortex_t * card);
 230 static void vortex_enable_int(vortex_t * card);
 231 static irqreturn_t vortex_interrupt(int irq, void *dev_id);
 232 static int vortex_alsafmt_aspfmt(snd_pcm_format_t alsafmt, vortex_t *v);
 233
 234 /* Connection  stuff. */
 235 static void vortex_connect_default(vortex_t * vortex, int en);
 236 static int vortex_adb_allocroute(vortex_t * vortex, int dma, int nr_ch,
 237                                  int dir, int type, int subdev);
 238 static int vortex_adb_checkinout(vortex_t * vortex, int resmap[], int out,
 239                                  int restype);
 240 #ifndef CHIP_AU8810
 241 static int vortex_wt_allocroute(vortex_t * vortex, int dma, int nr_ch);
 242 static void vortex_wt_connect(vortex_t * vortex, int en);
 243 static void vortex_wt_init(vortex_t * vortex);
 244 #endif
 245
 246 static void vortex_route(vortex_t * vortex, int en, unsigned char channel,
 247                          unsigned char source, unsigned char dest);
 248 #if 0
 249 static void vortex_routes(vortex_t * vortex, int en, unsigned char channel,
 250                           unsigned char source, unsigned char dest0,
 251                           unsigned char dest1);
 252 #endif
 253 static void vortex_connection_mixin_mix(vortex_t * vortex, int en,
 254                                         unsigned char mixin,
 255                                         unsigned char mix, int a);
 256 static void vortex_mix_setinputvolumebyte(vortex_t * vortex,
 257                                           unsigned char mix, int mixin,
 258                                           unsigned char vol);
 259 static void vortex_mix_setvolumebyte(vortex_t * vortex, unsigned char mix,
 260                                      unsigned char vol);
 261
 262 /* A3D functions. */
 263 #ifndef CHIP_AU8820
 264 static void vortex_Vort3D_enable(vortex_t * v);
 265 static void vortex_Vort3D_disable(vortex_t * v);
 266 static void vortex_Vort3D_connect(vortex_t * vortex, int en);
 267 static void vortex_Vort3D_InitializeSource(a3dsrc_t *a, int en, vortex_t *v);
 268 #endif
 269
 270 /* Driver stuff. */
 271 static int vortex_gameport_register(vortex_t * card);
 272 static void vortex_gameport_unregister(vortex_t * card);
 273 #ifndef CHIP_AU8820
 274 static int vortex_eq_init(vortex_t * vortex);
 275 static int vortex_eq_free(vortex_t * vortex);
 276 #endif
 277 /* ALSA stuff. */
 278 static int snd_vortex_new_pcm(vortex_t * vortex, int idx, int nr);
 279 static int snd_vortex_mixer(vortex_t * vortex);
 280 static int snd_vortex_midi(vortex_t * vortex);
 281 #endif