drivers/soundwire/cadence_master.h

   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 */