xref: /linux/drivers/soundwire/cadence_master.h (revision bdd1a21b52557ea8f61d0a5dc2f77151b576eb70)
1 /* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
2 /* Copyright(c) 2015-17 Intel Corporation. */
3 #include <sound/soc.h>
4 
5 #ifndef __SDW_CADENCE_H
6 #define __SDW_CADENCE_H
7 
8 #define SDW_CADENCE_GSYNC_KHZ		4 /* 4 kHz */
9 #define SDW_CADENCE_GSYNC_HZ		(SDW_CADENCE_GSYNC_KHZ * 1000)
10 
11 /**
12  * struct sdw_cdns_pdi: PDI (Physical Data Interface) instance
13  *
14  * @num: pdi number
15  * @intel_alh_id: link identifier
16  * @l_ch_num: low channel for PDI
17  * @h_ch_num: high channel for PDI
18  * @ch_count: total channel count for PDI
19  * @dir: data direction
20  * @type: stream type, PDM or PCM
21  */
22 struct sdw_cdns_pdi {
23 	int num;
24 	int intel_alh_id;
25 	int l_ch_num;
26 	int h_ch_num;
27 	int ch_count;
28 	enum sdw_data_direction dir;
29 	enum sdw_stream_type type;
30 };
31 
32 /**
33  * struct sdw_cdns_streams: Cadence stream data structure
34  *
35  * @num_bd: number of bidirectional streams
36  * @num_in: number of input streams
37  * @num_out: number of output streams
38  * @num_ch_bd: number of bidirectional stream channels
39  * @num_ch_bd: number of input stream channels
40  * @num_ch_bd: number of output stream channels
41  * @num_pdi: total number of PDIs
42  * @bd: bidirectional streams
43  * @in: input streams
44  * @out: output streams
45  */
46 struct sdw_cdns_streams {
47 	unsigned int num_bd;
48 	unsigned int num_in;
49 	unsigned int num_out;
50 	unsigned int num_ch_bd;
51 	unsigned int num_ch_in;
52 	unsigned int num_ch_out;
53 	unsigned int num_pdi;
54 	struct sdw_cdns_pdi *bd;
55 	struct sdw_cdns_pdi *in;
56 	struct sdw_cdns_pdi *out;
57 };
58 
59 /**
60  * struct sdw_cdns_stream_config: stream configuration
61  *
62  * @pcm_bd: number of bidirectional PCM streams supported
63  * @pcm_in: number of input PCM streams supported
64  * @pcm_out: number of output PCM streams supported
65  * @pdm_bd: number of bidirectional PDM streams supported
66  * @pdm_in: number of input PDM streams supported
67  * @pdm_out: number of output PDM streams supported
68  */
69 struct sdw_cdns_stream_config {
70 	unsigned int pcm_bd;
71 	unsigned int pcm_in;
72 	unsigned int pcm_out;
73 	unsigned int pdm_bd;
74 	unsigned int pdm_in;
75 	unsigned int pdm_out;
76 };
77 
78 /**
79  * struct sdw_cdns_dma_data: Cadence DMA data
80  *
81  * @name: SoundWire stream name
82  * @stream: stream runtime
83  * @pdi: PDI used for this dai
84  * @bus: Bus handle
85  * @stream_type: Stream type
86  * @link_id: Master link id
87  * @hw_params: hw_params to be applied in .prepare step
88  * @suspended: status set when suspended, to be used in .prepare
89  */
90 struct sdw_cdns_dma_data {
91 	char *name;
92 	struct sdw_stream_runtime *stream;
93 	struct sdw_cdns_pdi *pdi;
94 	struct sdw_bus *bus;
95 	enum sdw_stream_type stream_type;
96 	int link_id;
97 	struct snd_pcm_hw_params *hw_params;
98 	bool suspended;
99 };
100 
101 /**
102  * struct sdw_cdns - Cadence driver context
103  * @dev: Linux device
104  * @bus: Bus handle
105  * @instance: instance number
106  * @response_buf: SoundWire response buffer
107  * @tx_complete: Tx completion
108  * @defer: Defer pointer
109  * @ports: Data ports
110  * @num_ports: Total number of data ports
111  * @pcm: PCM streams
112  * @pdm: PDM streams
113  * @registers: Cadence registers
114  * @link_up: Link status
115  * @msg_count: Messages sent on bus
116  */
117 struct sdw_cdns {
118 	struct device *dev;
119 	struct sdw_bus bus;
120 	unsigned int instance;
121 
122 	u32 response_buf[0x80];
123 	struct completion tx_complete;
124 	struct sdw_defer *defer;
125 
126 	struct sdw_cdns_port *ports;
127 	int num_ports;
128 
129 	struct sdw_cdns_streams pcm;
130 	struct sdw_cdns_streams pdm;
131 
132 	void __iomem *registers;
133 
134 	bool link_up;
135 	unsigned int msg_count;
136 	bool interrupt_enabled;
137 
138 	struct work_struct work;
139 
140 	struct list_head list;
141 };
142 
143 #define bus_to_cdns(_bus) container_of(_bus, struct sdw_cdns, bus)
144 
145 /* Exported symbols */
146 
147 int sdw_cdns_probe(struct sdw_cdns *cdns);
148 extern struct sdw_master_ops sdw_cdns_master_ops;
149 
150 irqreturn_t sdw_cdns_irq(int irq, void *dev_id);
151 irqreturn_t sdw_cdns_thread(int irq, void *dev_id);
152 
153 int sdw_cdns_init(struct sdw_cdns *cdns);
154 int sdw_cdns_pdi_init(struct sdw_cdns *cdns,
155 		      struct sdw_cdns_stream_config config);
156 int sdw_cdns_exit_reset(struct sdw_cdns *cdns);
157 int sdw_cdns_enable_interrupt(struct sdw_cdns *cdns, bool state);
158 
159 bool sdw_cdns_is_clock_stop(struct sdw_cdns *cdns);
160 int sdw_cdns_clock_stop(struct sdw_cdns *cdns, bool block_wake);
161 int sdw_cdns_clock_restart(struct sdw_cdns *cdns, bool bus_reset);
162 
163 #ifdef CONFIG_DEBUG_FS
164 void sdw_cdns_debugfs_init(struct sdw_cdns *cdns, struct dentry *root);
165 #endif
166 
167 struct sdw_cdns_pdi *sdw_cdns_alloc_pdi(struct sdw_cdns *cdns,
168 					struct sdw_cdns_streams *stream,
169 					u32 ch, u32 dir, int dai_id);
170 void sdw_cdns_config_stream(struct sdw_cdns *cdns,
171 			    u32 ch, u32 dir, struct sdw_cdns_pdi *pdi);
172 
173 enum sdw_command_response
174 cdns_reset_page_addr(struct sdw_bus *bus, unsigned int dev_num);
175 
176 enum sdw_command_response
177 cdns_xfer_msg(struct sdw_bus *bus, struct sdw_msg *msg);
178 
179 enum sdw_command_response
180 cdns_xfer_msg_defer(struct sdw_bus *bus,
181 		    struct sdw_msg *msg, struct sdw_defer *defer);
182 
183 int cdns_bus_conf(struct sdw_bus *bus, struct sdw_bus_params *params);
184 
185 int cdns_set_sdw_stream(struct snd_soc_dai *dai,
186 			void *stream, bool pcm, int direction);
187 #endif /* __SDW_CADENCE_H */
188