1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
4  *
5  * @File	ctatc.h
6  *
7  * @Brief
8  * This file contains the definition of the device resource management object.
9  *
10  * @Author	Liu Chun
11  * @Date 	Mar 28 2008
12  */
13 
14 #ifndef CTATC_H
15 #define CTATC_H
16 
17 #include <linux/types.h>
18 #include <linux/mutex.h>
19 #include <linux/pci.h>
20 #include <linux/timer.h>
21 #include <sound/core.h>
22 
23 #include "ctvmem.h"
24 #include "cthardware.h"
25 #include "ctresource.h"
26 
27 enum CTALSADEVS {		/* Types of alsa devices */
28 	FRONT,
29 	SURROUND,
30 	CLFE,
31 	SIDE,
32 	IEC958,
33 	MIXER,
34 	NUM_CTALSADEVS		/* This should always be the last */
35 };
36 
37 struct ct_atc_chip_sub_details {
38 	u16 subsys;
39 	const char *nm_model;
40 };
41 
42 struct ct_atc_chip_details {
43 	u16 vendor;
44 	u16 device;
45 	const struct ct_atc_chip_sub_details *sub_details;
46 	const char *nm_card;
47 };
48 
49 struct ct_atc;
50 struct ct_timer;
51 struct ct_timer_instance;
52 
53 /* alsa pcm stream descriptor */
54 struct ct_atc_pcm {
55 	struct snd_pcm_substream *substream;
56 	void (*interrupt)(struct ct_atc_pcm *apcm);
57 	struct ct_timer_instance *timer;
58 	unsigned int started:1;
59 
60 	/* Only mono and interleaved modes are supported now. */
61 	struct ct_vm_block *vm_block;
62 	void *src;		/* SRC for interacting with host memory */
63 	void **srccs;		/* SRCs for sample rate conversion */
64 	void **srcimps;		/* SRC Input Mappers */
65 	void **amixers;		/* AMIXERs for routing converted data */
66 	void *mono;		/* A SUM resource for mixing chs to one */
67 	unsigned char n_srcc;	/* Number of converting SRCs */
68 	unsigned char n_srcimp;	/* Number of SRC Input Mappers */
69 	unsigned char n_amixer;	/* Number of AMIXERs */
70 };
71 
72 /* Chip resource management object */
73 struct ct_atc {
74 	struct pci_dev *pci;
75 	struct snd_card *card;
76 	unsigned int rsr; /* reference sample rate in Hz */
77 	unsigned int msr; /* master sample rate in rsr */
78 	unsigned int pll_rate; /* current rate of Phase Lock Loop */
79 
80 	int chip_type;
81 	int model;
82 	const char *chip_name;
83 	const char *model_name;
84 
85 	struct ct_vm *vm; /* device virtual memory manager for this card */
86 	int (*map_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
87 	void (*unmap_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
88 	unsigned long (*get_ptp_phys)(struct ct_atc *atc, int index);
89 
90 	struct mutex atc_mutex;
91 
92 	int (*pcm_playback_prepare)(struct ct_atc *atc,
93 				    struct ct_atc_pcm *apcm);
94 	int (*pcm_playback_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
95 	int (*pcm_playback_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
96 	int (*pcm_playback_position)(struct ct_atc *atc,
97 				     struct ct_atc_pcm *apcm);
98 	int (*spdif_passthru_playback_prepare)(struct ct_atc *atc,
99 					       struct ct_atc_pcm *apcm);
100 	int (*pcm_capture_prepare)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
101 	int (*pcm_capture_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
102 	int (*pcm_capture_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
103 	int (*pcm_capture_position)(struct ct_atc *atc,
104 				    struct ct_atc_pcm *apcm);
105 	int (*pcm_release_resources)(struct ct_atc *atc,
106 				     struct ct_atc_pcm *apcm);
107 	int (*select_line_in)(struct ct_atc *atc);
108 	int (*select_mic_in)(struct ct_atc *atc);
109 	int (*select_digit_io)(struct ct_atc *atc);
110 	int (*line_front_unmute)(struct ct_atc *atc, unsigned char state);
111 	int (*line_surround_unmute)(struct ct_atc *atc, unsigned char state);
112 	int (*line_clfe_unmute)(struct ct_atc *atc, unsigned char state);
113 	int (*line_rear_unmute)(struct ct_atc *atc, unsigned char state);
114 	int (*line_in_unmute)(struct ct_atc *atc, unsigned char state);
115 	int (*mic_unmute)(struct ct_atc *atc, unsigned char state);
116 	int (*spdif_out_unmute)(struct ct_atc *atc, unsigned char state);
117 	int (*spdif_in_unmute)(struct ct_atc *atc, unsigned char state);
118 	int (*spdif_out_get_status)(struct ct_atc *atc, unsigned int *status);
119 	int (*spdif_out_set_status)(struct ct_atc *atc, unsigned int status);
120 	int (*spdif_out_passthru)(struct ct_atc *atc, unsigned char state);
121 	struct capabilities (*capabilities)(struct ct_atc *atc);
122 	int (*output_switch_get)(struct ct_atc *atc);
123 	int (*output_switch_put)(struct ct_atc *atc, int position);
124 	int (*mic_source_switch_get)(struct ct_atc *atc);
125 	int (*mic_source_switch_put)(struct ct_atc *atc, int position);
126 
127 	/* Don't touch! Used for internal object. */
128 	void *rsc_mgrs[NUM_RSCTYP]; /* chip resource managers */
129 	void *mixer;		/* internal mixer object */
130 	struct hw *hw;		/* chip specific hardware access object */
131 	void **daios;		/* digital audio io resources */
132 	void **pcm;		/* SUMs for collecting all pcm stream */
133 	void **srcs;		/* Sample Rate Converters for input signal */
134 	void **srcimps;		/* input mappers for SRCs */
135 	unsigned char n_daio;
136 	unsigned char n_src;
137 	unsigned char n_srcimp;
138 	unsigned char n_pcm;
139 
140 	struct ct_timer *timer;
141 
142 #ifdef CONFIG_PM_SLEEP
143 	int (*suspend)(struct ct_atc *atc);
144 	int (*resume)(struct ct_atc *atc);
145 #define NUM_PCMS (NUM_CTALSADEVS - 1)
146 	struct snd_pcm *pcms[NUM_PCMS];
147 #endif
148 };
149 
150 
151 int ct_atc_create(struct snd_card *card, struct pci_dev *pci,
152 		  unsigned int rsr, unsigned int msr, int chip_type,
153 		  unsigned int subsysid, struct ct_atc **ratc);
154 int ct_atc_create_alsa_devs(struct ct_atc *atc);
155 
156 #endif /* CTATC_H */
157