xref: /linux/include/sound/hdaudio_ext.h (revision ebc733e54a1a79ea2dde2ba5121ae73a188e20d4)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __SOUND_HDAUDIO_EXT_H
3 #define __SOUND_HDAUDIO_EXT_H
4 
5 #include <linux/io-64-nonatomic-lo-hi.h>
6 #include <linux/iopoll.h>
7 #include <sound/hdaudio.h>
8 
9 int snd_hdac_ext_bus_init(struct hdac_bus *bus, struct device *dev,
10 		      const struct hdac_bus_ops *ops,
11 		      const struct hdac_ext_bus_ops *ext_ops);
12 
13 void snd_hdac_ext_bus_exit(struct hdac_bus *bus);
14 void snd_hdac_ext_bus_device_remove(struct hdac_bus *bus);
15 
16 #define HDA_CODEC_REV_EXT_ENTRY(_vid, _rev, _name, drv_data) \
17 	{ .vendor_id = (_vid), .rev_id = (_rev), .name = (_name), \
18 	  .api_version = HDA_DEV_ASOC, \
19 	  .driver_data = (unsigned long)(drv_data) }
20 #define HDA_CODEC_EXT_ENTRY(_vid, _revid, _name, _drv_data) \
21 	HDA_CODEC_REV_EXT_ENTRY(_vid, _revid, _name, _drv_data)
22 
23 void snd_hdac_ext_bus_ppcap_enable(struct hdac_bus *chip, bool enable);
24 void snd_hdac_ext_bus_ppcap_int_enable(struct hdac_bus *chip, bool enable);
25 
26 int snd_hdac_ext_bus_get_ml_capabilities(struct hdac_bus *bus);
27 struct hdac_ext_link *snd_hdac_ext_bus_get_hlink_by_addr(struct hdac_bus *bus, int addr);
28 struct hdac_ext_link *snd_hdac_ext_bus_get_hlink_by_name(struct hdac_bus *bus,
29 							 const char *codec_name);
30 
31 enum hdac_ext_stream_type {
32 	HDAC_EXT_STREAM_TYPE_COUPLED = 0,
33 	HDAC_EXT_STREAM_TYPE_HOST,
34 	HDAC_EXT_STREAM_TYPE_LINK
35 };
36 
37 /**
38  * hdac_ext_stream: HDAC extended stream for extended HDA caps
39  *
40  * @hstream: hdac_stream
41  * @pphc_addr: processing pipe host stream pointer
42  * @pplc_addr: processing pipe link stream pointer
43  * @decoupled: stream host and link is decoupled
44  * @link_locked: link is locked
45  * @link_prepared: link is prepared
46  * @link_substream: link substream
47  */
48 struct hdac_ext_stream {
49 	struct hdac_stream hstream;
50 
51 	void __iomem *pphc_addr;
52 	void __iomem *pplc_addr;
53 
54 	u32 pphcllpl;
55 	u32 pphcllpu;
56 	u32 pphcldpl;
57 	u32 pphcldpu;
58 
59 	bool decoupled:1;
60 	bool link_locked:1;
61 	bool link_prepared;
62 
63 	int (*host_setup)(struct hdac_stream *, bool);
64 
65 	struct snd_pcm_substream *link_substream;
66 };
67 
68 #define hdac_stream(s)		(&(s)->hstream)
69 #define stream_to_hdac_ext_stream(s) \
70 	container_of(s, struct hdac_ext_stream, hstream)
71 
72 int snd_hdac_ext_stream_init_all(struct hdac_bus *bus, int start_idx,
73 				 int num_stream, int dir);
74 void snd_hdac_ext_stream_free_all(struct hdac_bus *bus);
75 void snd_hdac_ext_link_free_all(struct hdac_bus *bus);
76 struct hdac_ext_stream *snd_hdac_ext_stream_assign(struct hdac_bus *bus,
77 					   struct snd_pcm_substream *substream,
78 					   int type);
79 void snd_hdac_ext_stream_release(struct hdac_ext_stream *hext_stream, int type);
80 struct hdac_ext_stream *snd_hdac_ext_cstream_assign(struct hdac_bus *bus,
81 						    struct snd_compr_stream *cstream);
82 void snd_hdac_ext_stream_decouple_locked(struct hdac_bus *bus,
83 					 struct hdac_ext_stream *hext_stream, bool decouple);
84 void snd_hdac_ext_stream_decouple(struct hdac_bus *bus,
85 				struct hdac_ext_stream *azx_dev, bool decouple);
86 
87 void snd_hdac_ext_stream_start(struct hdac_ext_stream *hext_stream);
88 void snd_hdac_ext_stream_clear(struct hdac_ext_stream *hext_stream);
89 void snd_hdac_ext_stream_reset(struct hdac_ext_stream *hext_stream);
90 int snd_hdac_ext_stream_setup(struct hdac_ext_stream *hext_stream, int fmt);
91 int snd_hdac_ext_host_stream_setup(struct hdac_ext_stream *hext_stream, bool code_loading);
92 
93 struct hdac_ext_link {
94 	struct hdac_bus *bus;
95 	int index;
96 	void __iomem *ml_addr; /* link output stream reg pointer */
97 	u32 lcaps;   /* link capablities */
98 	u16 lsdiid;  /* link sdi identifier */
99 
100 	int ref_count;
101 
102 	struct list_head list;
103 };
104 
105 int snd_hdac_ext_bus_link_power_up(struct hdac_ext_link *hlink);
106 int snd_hdac_ext_bus_link_power_down(struct hdac_ext_link *hlink);
107 int snd_hdac_ext_bus_link_power_up_all(struct hdac_bus *bus);
108 int snd_hdac_ext_bus_link_power_down_all(struct hdac_bus *bus);
109 void snd_hdac_ext_bus_link_set_stream_id(struct hdac_ext_link *hlink,
110 					 int stream);
111 void snd_hdac_ext_bus_link_clear_stream_id(struct hdac_ext_link *hlink,
112 					   int stream);
113 
114 int snd_hdac_ext_bus_link_get(struct hdac_bus *bus, struct hdac_ext_link *hlink);
115 int snd_hdac_ext_bus_link_put(struct hdac_bus *bus, struct hdac_ext_link *hlink);
116 
117 void snd_hdac_ext_bus_link_power(struct hdac_device *codec, bool enable);
118 
119 #define snd_hdac_adsp_writeb(chip, reg, value) \
120 	snd_hdac_reg_writeb(chip, (chip)->dsp_ba + (reg), value)
121 #define snd_hdac_adsp_readb(chip, reg) \
122 	snd_hdac_reg_readb(chip, (chip)->dsp_ba + (reg))
123 #define snd_hdac_adsp_writew(chip, reg, value) \
124 	snd_hdac_reg_writew(chip, (chip)->dsp_ba + (reg), value)
125 #define snd_hdac_adsp_readw(chip, reg) \
126 	snd_hdac_reg_readw(chip, (chip)->dsp_ba + (reg))
127 #define snd_hdac_adsp_writel(chip, reg, value) \
128 	snd_hdac_reg_writel(chip, (chip)->dsp_ba + (reg), value)
129 #define snd_hdac_adsp_readl(chip, reg) \
130 	snd_hdac_reg_readl(chip, (chip)->dsp_ba + (reg))
131 #define snd_hdac_adsp_writeq(chip, reg, value) \
132 	snd_hdac_reg_writeq(chip, (chip)->dsp_ba + (reg), value)
133 #define snd_hdac_adsp_readq(chip, reg) \
134 	snd_hdac_reg_readq(chip, (chip)->dsp_ba + (reg))
135 
136 #define snd_hdac_adsp_updateb(chip, reg, mask, val) \
137 	snd_hdac_adsp_writeb(chip, reg, \
138 			(snd_hdac_adsp_readb(chip, reg) & ~(mask)) | (val))
139 #define snd_hdac_adsp_updatew(chip, reg, mask, val) \
140 	snd_hdac_adsp_writew(chip, reg, \
141 			(snd_hdac_adsp_readw(chip, reg) & ~(mask)) | (val))
142 #define snd_hdac_adsp_updatel(chip, reg, mask, val) \
143 	snd_hdac_adsp_writel(chip, reg, \
144 			(snd_hdac_adsp_readl(chip, reg) & ~(mask)) | (val))
145 #define snd_hdac_adsp_updateq(chip, reg, mask, val) \
146 	snd_hdac_adsp_writeq(chip, reg, \
147 			(snd_hdac_adsp_readq(chip, reg) & ~(mask)) | (val))
148 
149 #define snd_hdac_adsp_readb_poll(chip, reg, val, cond, delay_us, timeout_us) \
150 	readb_poll_timeout((chip)->dsp_ba + (reg), val, cond, \
151 			   delay_us, timeout_us)
152 #define snd_hdac_adsp_readw_poll(chip, reg, val, cond, delay_us, timeout_us) \
153 	readw_poll_timeout((chip)->dsp_ba + (reg), val, cond, \
154 			   delay_us, timeout_us)
155 #define snd_hdac_adsp_readl_poll(chip, reg, val, cond, delay_us, timeout_us) \
156 	readl_poll_timeout((chip)->dsp_ba + (reg), val, cond, \
157 			   delay_us, timeout_us)
158 #define snd_hdac_adsp_readq_poll(chip, reg, val, cond, delay_us, timeout_us) \
159 	readq_poll_timeout((chip)->dsp_ba + (reg), val, cond, \
160 			   delay_us, timeout_us)
161 
162 struct hdac_ext_device;
163 
164 /* ops common to all codec drivers */
165 struct hdac_ext_codec_ops {
166 	int (*build_controls)(struct hdac_ext_device *dev);
167 	int (*init)(struct hdac_ext_device *dev);
168 	void (*free)(struct hdac_ext_device *dev);
169 };
170 
171 struct hda_dai_map {
172 	char *dai_name;
173 	hda_nid_t nid;
174 	u32	maxbps;
175 };
176 
177 struct hdac_ext_dma_params {
178 	u32 format;
179 	u8 stream_tag;
180 };
181 
182 int snd_hda_ext_driver_register(struct hdac_driver *drv);
183 void snd_hda_ext_driver_unregister(struct hdac_driver *drv);
184 
185 #endif /* __SOUND_HDAUDIO_EXT_H */
186