1 // SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) 2 // Copyright(c) 2015-17 Intel Corporation. 3 4 #ifndef __SDW_BUS_H 5 #define __SDW_BUS_H 6 7 #define DEFAULT_BANK_SWITCH_TIMEOUT 3000 8 9 #if IS_ENABLED(CONFIG_ACPI) 10 int sdw_acpi_find_slaves(struct sdw_bus *bus); 11 #else 12 static inline int sdw_acpi_find_slaves(struct sdw_bus *bus) 13 { 14 return -ENOTSUPP; 15 } 16 #endif 17 18 void sdw_extract_slave_id(struct sdw_bus *bus, 19 u64 addr, struct sdw_slave_id *id); 20 21 enum { 22 SDW_MSG_FLAG_READ = 0, 23 SDW_MSG_FLAG_WRITE, 24 }; 25 26 /** 27 * struct sdw_msg - Message structure 28 * @addr: Register address accessed in the Slave 29 * @len: number of messages 30 * @dev_num: Slave device number 31 * @addr_page1: SCP address page 1 Slave register 32 * @addr_page2: SCP address page 2 Slave register 33 * @flags: transfer flags, indicate if xfer is read or write 34 * @buf: message data buffer 35 * @ssp_sync: Send message at SSP (Stream Synchronization Point) 36 * @page: address requires paging 37 */ 38 struct sdw_msg { 39 u16 addr; 40 u16 len; 41 u8 dev_num; 42 u8 addr_page1; 43 u8 addr_page2; 44 u8 flags; 45 u8 *buf; 46 bool ssp_sync; 47 bool page; 48 }; 49 50 #define SDW_DOUBLE_RATE_FACTOR 2 51 52 extern int rows[SDW_FRAME_ROWS]; 53 extern int cols[SDW_FRAME_COLS]; 54 55 /** 56 * sdw_port_runtime: Runtime port parameters for Master or Slave 57 * 58 * @num: Port number. For audio streams, valid port number ranges from 59 * [1,14] 60 * @ch_mask: Channel mask 61 * @transport_params: Transport parameters 62 * @port_params: Port parameters 63 * @port_node: List node for Master or Slave port_list 64 * 65 * SoundWire spec has no mention of ports for Master interface but the 66 * concept is logically extended. 67 */ 68 struct sdw_port_runtime { 69 int num; 70 int ch_mask; 71 struct sdw_transport_params transport_params; 72 struct sdw_port_params port_params; 73 struct list_head port_node; 74 }; 75 76 /** 77 * sdw_slave_runtime: Runtime Stream parameters for Slave 78 * 79 * @slave: Slave handle 80 * @direction: Data direction for Slave 81 * @ch_count: Number of channels handled by the Slave for 82 * this stream 83 * @m_rt_node: sdw_master_runtime list node 84 * @port_list: List of Slave Ports configured for this stream 85 */ 86 struct sdw_slave_runtime { 87 struct sdw_slave *slave; 88 enum sdw_data_direction direction; 89 unsigned int ch_count; 90 struct list_head m_rt_node; 91 struct list_head port_list; 92 }; 93 94 /** 95 * sdw_master_runtime: Runtime stream parameters for Master 96 * 97 * @bus: Bus handle 98 * @stream: Stream runtime handle 99 * @direction: Data direction for Master 100 * @ch_count: Number of channels handled by the Master for 101 * this stream, can be zero. 102 * @slave_rt_list: Slave runtime list 103 * @port_list: List of Master Ports configured for this stream, can be zero. 104 * @stream_node: sdw_stream_runtime master_list node 105 * @bus_node: sdw_bus m_rt_list node 106 */ 107 struct sdw_master_runtime { 108 struct sdw_bus *bus; 109 struct sdw_stream_runtime *stream; 110 enum sdw_data_direction direction; 111 unsigned int ch_count; 112 struct list_head slave_rt_list; 113 struct list_head port_list; 114 struct list_head stream_node; 115 struct list_head bus_node; 116 }; 117 118 struct sdw_dpn_prop *sdw_get_slave_dpn_prop(struct sdw_slave *slave, 119 enum sdw_data_direction direction, 120 unsigned int port_num); 121 int sdw_configure_dpn_intr(struct sdw_slave *slave, int port, 122 bool enable, int mask); 123 124 int sdw_transfer(struct sdw_bus *bus, struct sdw_msg *msg); 125 int sdw_transfer_defer(struct sdw_bus *bus, struct sdw_msg *msg, 126 struct sdw_defer *defer); 127 128 #define SDW_READ_INTR_CLEAR_RETRY 10 129 130 int sdw_fill_msg(struct sdw_msg *msg, struct sdw_slave *slave, 131 u32 addr, size_t count, u16 dev_num, u8 flags, u8 *buf); 132 133 /* Read-Modify-Write Slave register */ 134 static inline int 135 sdw_update(struct sdw_slave *slave, u32 addr, u8 mask, u8 val) 136 { 137 int tmp; 138 139 tmp = sdw_read(slave, addr); 140 if (tmp < 0) 141 return tmp; 142 143 tmp = (tmp & ~mask) | val; 144 return sdw_write(slave, addr, tmp); 145 } 146 147 #endif /* __SDW_BUS_H */ 148