xref: /linux/include/sound/es1688.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 #ifndef __SOUND_ES1688_H
3 #define __SOUND_ES1688_H
4 
5 /*
6  *  Header file for ES488/ES1688
7  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
8  */
9 
10 #include <sound/control.h>
11 #include <sound/pcm.h>
12 #include <linux/interrupt.h>
13 
14 #define ES1688_HW_AUTO		0x0000
15 #define ES1688_HW_688		0x0001
16 #define ES1688_HW_1688		0x0002
17 #define ES1688_HW_UNDEF	0x0003
18 
19 struct snd_es1688 {
20 	struct snd_card *card;
21 	unsigned long port;		/* port of ESS chip */
22 	struct resource *res_port;
23 	unsigned long mpu_port;		/* MPU-401 port of ESS chip */
24 	int irq;			/* IRQ number of ESS chip */
25 	int mpu_irq;			/* MPU IRQ */
26 	int dma8;			/* 8-bit DMA */
27 	unsigned short version;		/* version of ESS chip */
28 	unsigned short hardware;	/* see to ES1688_HW_XXXX */
29 
30 	unsigned short trigger_value;
31 	unsigned char pad;
32 	unsigned int dma_size;
33 
34 	struct snd_pcm *pcm;
35 	struct snd_pcm_substream *playback_substream;
36 	struct snd_pcm_substream *capture_substream;
37 
38 	spinlock_t reg_lock;
39 	spinlock_t mixer_lock;
40 };
41 
42 /* I/O ports */
43 
44 #define ES1688P(codec, x) ((codec)->port + e_s_s_ESS1688##x)
45 
46 #define e_s_s_ESS1688RESET	0x6
47 #define e_s_s_ESS1688READ	0xa
48 #define e_s_s_ESS1688WRITE	0xc
49 #define e_s_s_ESS1688COMMAND	0xc
50 #define e_s_s_ESS1688STATUS	0xc
51 #define e_s_s_ESS1688DATA_AVAIL	0xe
52 #define e_s_s_ESS1688DATA_AVAIL_16 0xf
53 #define e_s_s_ESS1688MIXER_ADDR	0x4
54 #define e_s_s_ESS1688MIXER_DATA	0x5
55 #define e_s_s_ESS1688OPL3_LEFT	0x0
56 #define e_s_s_ESS1688OPL3_RIGHT	0x2
57 #define e_s_s_ESS1688OPL3_BOTH	0x8
58 #define e_s_s_ESS1688ENABLE0	0x0
59 #define e_s_s_ESS1688ENABLE1	0x9
60 #define e_s_s_ESS1688ENABLE2	0xb
61 #define e_s_s_ESS1688INIT1	0x7
62 
63 #define ES1688_DSP_CMD_DMAOFF	0xd0
64 #define ES1688_DSP_CMD_SPKON	0xd1
65 #define ES1688_DSP_CMD_SPKOFF	0xd3
66 #define ES1688_DSP_CMD_DMAON	0xd4
67 
68 #define ES1688_PCM_DEV		0x14
69 #define ES1688_MIC_DEV		0x1a
70 #define ES1688_REC_DEV		0x1c
71 #define ES1688_MASTER_DEV	0x32
72 #define ES1688_FM_DEV		0x36
73 #define ES1688_CD_DEV		0x38
74 #define ES1688_AUX_DEV		0x3a
75 #define ES1688_SPEAKER_DEV	0x3c
76 #define ES1688_LINE_DEV		0x3e
77 #define ES1688_RECLEV_DEV	0xb4
78 
79 #define ES1688_MIXS_MASK	0x17
80 #define ES1688_MIXS_MIC		0x00
81 #define ES1688_MIXS_MIC_MASTER	0x01
82 #define ES1688_MIXS_CD		0x02
83 #define ES1688_MIXS_AOUT	0x03
84 #define ES1688_MIXS_MIC1	0x04
85 #define ES1688_MIXS_REC_MIX	0x05
86 #define ES1688_MIXS_LINE	0x06
87 #define ES1688_MIXS_MASTER	0x07
88 #define ES1688_MIXS_MUTE	0x10
89 
90 /*
91 
92  */
93 
94 void snd_es1688_mixer_write(struct snd_es1688 *chip, unsigned char reg, unsigned char data);
95 
96 int snd_es1688_create(struct snd_card *card,
97 		      struct snd_es1688 *chip,
98 		      unsigned long port,
99 		      unsigned long mpu_port,
100 		      int irq,
101 		      int mpu_irq,
102 		      int dma8,
103 		      unsigned short hardware);
104 int snd_es1688_pcm(struct snd_card *card, struct snd_es1688 *chip, int device);
105 int snd_es1688_mixer(struct snd_card *card, struct snd_es1688 *chip);
106 int snd_es1688_reset(struct snd_es1688 *chip);
107 
108 #endif /* __SOUND_ES1688_H */
109