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 * The Cadence IP supports up to 32 entries in the FIFO, though implementations 13 * can configure the IP to have a smaller FIFO. 14 */ 15 #define CDNS_MCP_IP_MAX_CMD_LEN 32 16 17 #define SDW_CADENCE_MCP_IP_OFFSET 0x4000 18 19 /** 20 * struct sdw_cdns_pdi: PDI (Physical Data Interface) instance 21 * 22 * @num: pdi number 23 * @intel_alh_id: link identifier 24 * @l_ch_num: low channel for PDI 25 * @h_ch_num: high channel for PDI 26 * @ch_count: total channel count for PDI 27 * @dir: data direction 28 * @type: stream type, (only PCM supported) 29 */ 30 struct sdw_cdns_pdi { 31 int num; 32 int intel_alh_id; 33 int l_ch_num; 34 int h_ch_num; 35 int ch_count; 36 enum sdw_data_direction dir; 37 enum sdw_stream_type type; 38 }; 39 40 /** 41 * struct sdw_cdns_streams: Cadence stream data structure 42 * 43 * @num_bd: number of bidirectional streams 44 * @num_in: number of input streams 45 * @num_out: number of output streams 46 * @num_ch_bd: number of bidirectional stream channels 47 * @num_ch_bd: number of input stream channels 48 * @num_ch_bd: number of output stream channels 49 * @num_pdi: total number of PDIs 50 * @bd: bidirectional streams 51 * @in: input streams 52 * @out: output streams 53 */ 54 struct sdw_cdns_streams { 55 unsigned int num_bd; 56 unsigned int num_in; 57 unsigned int num_out; 58 unsigned int num_ch_bd; 59 unsigned int num_ch_in; 60 unsigned int num_ch_out; 61 unsigned int num_pdi; 62 struct sdw_cdns_pdi *bd; 63 struct sdw_cdns_pdi *in; 64 struct sdw_cdns_pdi *out; 65 }; 66 67 /** 68 * struct sdw_cdns_stream_config: stream configuration 69 * 70 * @pcm_bd: number of bidirectional PCM streams supported 71 * @pcm_in: number of input PCM streams supported 72 * @pcm_out: number of output PCM streams supported 73 */ 74 struct sdw_cdns_stream_config { 75 unsigned int pcm_bd; 76 unsigned int pcm_in; 77 unsigned int pcm_out; 78 }; 79 80 /** 81 * struct sdw_cdns_dai_runtime: Cadence DAI runtime data 82 * 83 * @name: SoundWire stream name 84 * @stream: stream runtime 85 * @pdi: PDI used for this dai 86 * @bus: Bus handle 87 * @stream_type: Stream type 88 * @link_id: Master link id 89 * @suspended: status set when suspended, to be used in .prepare 90 * @paused: status set in .trigger, to be used in suspend 91 * @direction: stream direction 92 */ 93 struct sdw_cdns_dai_runtime { 94 char *name; 95 struct sdw_stream_runtime *stream; 96 struct sdw_cdns_pdi *pdi; 97 struct sdw_bus *bus; 98 enum sdw_stream_type stream_type; 99 int link_id; 100 bool suspended; 101 bool paused; 102 int direction; 103 }; 104 105 /** 106 * struct sdw_cdns - Cadence driver context 107 * @dev: Linux device 108 * @bus: Bus handle 109 * @instance: instance number 110 * @ip_offset: version-dependent offset to access IP_MCP registers and fields 111 * @response_buf: SoundWire response buffer 112 * @tx_complete: Tx completion 113 * @ports: Data ports 114 * @num_ports: Total number of data ports 115 * @pcm: PCM streams 116 * @registers: Cadence registers 117 * @link_up: Link status 118 * @msg_count: Messages sent on bus 119 * @dai_runtime_array: runtime context for each allocated DAI. 120 * @status_update_lock: protect concurrency between interrupt-based and delayed work 121 * status update 122 */ 123 struct sdw_cdns { 124 struct device *dev; 125 struct sdw_bus bus; 126 unsigned int instance; 127 128 u32 ip_offset; 129 130 /* 131 * The datasheet says the RX FIFO AVAIL can be 2 entries more 132 * than the FIFO capacity, so allow for this. 133 */ 134 u32 response_buf[CDNS_MCP_IP_MAX_CMD_LEN + 2]; 135 136 struct completion tx_complete; 137 138 struct sdw_cdns_port *ports; 139 int num_ports; 140 141 struct sdw_cdns_streams pcm; 142 143 int pdi_loopback_source; 144 int pdi_loopback_target; 145 146 void __iomem *registers; 147 148 bool link_up; 149 unsigned int msg_count; 150 bool interrupt_enabled; 151 152 struct work_struct work; 153 struct delayed_work attach_dwork; 154 155 struct list_head list; 156 157 struct sdw_cdns_dai_runtime **dai_runtime_array; 158 159 struct mutex status_update_lock; /* add mutual exclusion to sdw_handle_slave_status() */ 160 }; 161 162 #define bus_to_cdns(_bus) container_of(_bus, struct sdw_cdns, bus) 163 164 /* Exported symbols */ 165 166 int sdw_cdns_probe(struct sdw_cdns *cdns); 167 168 irqreturn_t sdw_cdns_irq(int irq, void *dev_id); 169 irqreturn_t sdw_cdns_thread(int irq, void *dev_id); 170 171 int sdw_cdns_soft_reset(struct sdw_cdns *cdns); 172 int sdw_cdns_init(struct sdw_cdns *cdns); 173 int sdw_cdns_pdi_init(struct sdw_cdns *cdns, 174 struct sdw_cdns_stream_config config); 175 int sdw_cdns_exit_reset(struct sdw_cdns *cdns); 176 int sdw_cdns_enable_interrupt(struct sdw_cdns *cdns, bool state); 177 178 bool sdw_cdns_is_clock_stop(struct sdw_cdns *cdns); 179 int sdw_cdns_clock_stop(struct sdw_cdns *cdns, bool block_wake); 180 int sdw_cdns_clock_restart(struct sdw_cdns *cdns, bool bus_reset); 181 182 #ifdef CONFIG_DEBUG_FS 183 void sdw_cdns_debugfs_init(struct sdw_cdns *cdns, struct dentry *root); 184 #endif 185 186 struct sdw_cdns_pdi *sdw_cdns_alloc_pdi(struct sdw_cdns *cdns, 187 struct sdw_cdns_streams *stream, 188 u32 ch, u32 dir, int dai_id); 189 void sdw_cdns_config_stream(struct sdw_cdns *cdns, 190 u32 ch, u32 dir, struct sdw_cdns_pdi *pdi); 191 192 enum sdw_command_response 193 cdns_xfer_msg(struct sdw_bus *bus, struct sdw_msg *msg); 194 195 enum sdw_command_response 196 cdns_xfer_msg_defer(struct sdw_bus *bus); 197 198 u32 cdns_read_ping_status(struct sdw_bus *bus); 199 200 int cdns_bus_conf(struct sdw_bus *bus, struct sdw_bus_params *params); 201 202 int cdns_set_sdw_stream(struct snd_soc_dai *dai, 203 void *stream, int direction); 204 205 void sdw_cdns_check_self_clearing_bits(struct sdw_cdns *cdns, const char *string, 206 bool initial_delay, int reset_iterations); 207 208 void sdw_cdns_config_update(struct sdw_cdns *cdns); 209 int sdw_cdns_config_update_set_wait(struct sdw_cdns *cdns); 210 211 #endif /* __SDW_CADENCE_H */ 212