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, (only PCM supported)
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  */
66 struct sdw_cdns_stream_config {
67 	unsigned int pcm_bd;
68 	unsigned int pcm_in;
69 	unsigned int pcm_out;
70 };
71 
72 /**
73  * struct sdw_cdns_dma_data: Cadence DMA data
74  *
75  * @name: SoundWire stream name
76  * @stream: stream runtime
77  * @pdi: PDI used for this dai
78  * @bus: Bus handle
79  * @stream_type: Stream type
80  * @link_id: Master link id
81  * @hw_params: hw_params to be applied in .prepare step
82  * @suspended: status set when suspended, to be used in .prepare
83  * @paused: status set in .trigger, to be used in suspend
84  */
85 struct sdw_cdns_dma_data {
86 	char *name;
87 	struct sdw_stream_runtime *stream;
88 	struct sdw_cdns_pdi *pdi;
89 	struct sdw_bus *bus;
90 	enum sdw_stream_type stream_type;
91 	int link_id;
92 	struct snd_pcm_hw_params *hw_params;
93 	bool suspended;
94 	bool paused;
95 };
96 
97 /**
98  * struct sdw_cdns - Cadence driver context
99  * @dev: Linux device
100  * @bus: Bus handle
101  * @instance: instance number
102  * @response_buf: SoundWire response buffer
103  * @tx_complete: Tx completion
104  * @defer: Defer pointer
105  * @ports: Data ports
106  * @num_ports: Total number of data ports
107  * @pcm: PCM streams
108  * @registers: Cadence registers
109  * @link_up: Link status
110  * @msg_count: Messages sent on bus
111  */
112 struct sdw_cdns {
113 	struct device *dev;
114 	struct sdw_bus bus;
115 	unsigned int instance;
116 
117 	u32 response_buf[0x80];
118 	struct completion tx_complete;
119 	struct sdw_defer *defer;
120 
121 	struct sdw_cdns_port *ports;
122 	int num_ports;
123 
124 	struct sdw_cdns_streams pcm;
125 
126 	int pdi_loopback_source;
127 	int pdi_loopback_target;
128 
129 	void __iomem *registers;
130 
131 	bool link_up;
132 	unsigned int msg_count;
133 	bool interrupt_enabled;
134 
135 	struct work_struct work;
136 
137 	struct list_head list;
138 };
139 
140 #define bus_to_cdns(_bus) container_of(_bus, struct sdw_cdns, bus)
141 
142 /* Exported symbols */
143 
144 int sdw_cdns_probe(struct sdw_cdns *cdns);
145 extern struct sdw_master_ops sdw_cdns_master_ops;
146 
147 irqreturn_t sdw_cdns_irq(int irq, void *dev_id);
148 irqreturn_t sdw_cdns_thread(int irq, void *dev_id);
149 
150 int sdw_cdns_init(struct sdw_cdns *cdns);
151 int sdw_cdns_pdi_init(struct sdw_cdns *cdns,
152 		      struct sdw_cdns_stream_config config);
153 int sdw_cdns_exit_reset(struct sdw_cdns *cdns);
154 int sdw_cdns_enable_interrupt(struct sdw_cdns *cdns, bool state);
155 
156 bool sdw_cdns_is_clock_stop(struct sdw_cdns *cdns);
157 int sdw_cdns_clock_stop(struct sdw_cdns *cdns, bool block_wake);
158 int sdw_cdns_clock_restart(struct sdw_cdns *cdns, bool bus_reset);
159 
160 #ifdef CONFIG_DEBUG_FS
161 void sdw_cdns_debugfs_init(struct sdw_cdns *cdns, struct dentry *root);
162 #endif
163 
164 struct sdw_cdns_pdi *sdw_cdns_alloc_pdi(struct sdw_cdns *cdns,
165 					struct sdw_cdns_streams *stream,
166 					u32 ch, u32 dir, int dai_id);
167 void sdw_cdns_config_stream(struct sdw_cdns *cdns,
168 			    u32 ch, u32 dir, struct sdw_cdns_pdi *pdi);
169 
170 enum sdw_command_response
171 cdns_reset_page_addr(struct sdw_bus *bus, unsigned int dev_num);
172 
173 enum sdw_command_response
174 cdns_xfer_msg(struct sdw_bus *bus, struct sdw_msg *msg);
175 
176 enum sdw_command_response
177 cdns_xfer_msg_defer(struct sdw_bus *bus,
178 		    struct sdw_msg *msg, struct sdw_defer *defer);
179 
180 u32 cdns_read_ping_status(struct sdw_bus *bus);
181 
182 int cdns_bus_conf(struct sdw_bus *bus, struct sdw_bus_params *params);
183 
184 int cdns_set_sdw_stream(struct snd_soc_dai *dai,
185 			void *stream, int direction);
186 
187 void sdw_cdns_check_self_clearing_bits(struct sdw_cdns *cdns, const char *string,
188 				       bool initial_delay, int reset_iterations);
189 
190 #endif /* __SDW_CADENCE_H */
191